將代理程式連接至 Google 雲端硬碟（測試版）

你可以將 Notion 代理程式 或 自訂代理程式 連接至 Google 雲端硬碟，讓代理程式即時搜尋、讀取、寫入及更新檔案。

連接會綁定設定連接的人。代理程式使用 Google 雲端硬碟時，會即時查看你的雲端硬碟；Notion 不會儲存內容或建立索引。代理程式只能存取你擁有的檔案、他人與你共享的檔案，以及你有權存取的共用雲端硬碟。

• 請確認你可以登入要使用的 Google 帳號。

• 你必須是工作空間成員，而非訪客，且工作空間必須已開啟 Notion AI。

• 連接前，你的 Google Workspace 擁有者可能需要先核准「Custom Agents For Drive」。如果工作空間尚未核准 Google 雲端硬碟，請工作空間擁有者核准。工作空間擁有者連接 Google 雲端硬碟後，系統會自動為該工作空間核准。

• 允許存取前，請先確認 Google 顯示的權限。

• 如果你的工作空間會控管可使用的連接，工作空間擁有者可能需要為自訂代理程式開啟 Google 雲端硬碟。

• 將自訂代理程式連接至 Google 雲端硬碟，與用於 Notion 代理程式 的 Notion AI Google 雲端硬碟連接器 不同。

連接 Google 雲端硬碟有兩種方式：你可以先在設定中連接 Google 帳號，再將連接新增至任一代理程式；也可以在設定特定代理程式時，直接新增 Google 雲端硬碟。

從設定連接

如果想讓 Notion 代理程式存取 Google 雲端硬碟，或讓多個代理程式使用同一個 Google 帳號，請從設定連接。

1. 前往 設定 → 連接。

2. 選取 Google 雲端硬碟。

3. 選取 你的帳號 → 連接你的 Google 雲端硬碟帳號。

4. 選擇 有限權限 或 全部權限，然後選取 連接。

5. 閱讀提醒訊息後，選取 繼續前往 Google。

6. 使用你要連接的 Google 帳號登入。

7. 在下一個 Google 畫面中，勾選所有雲端硬碟權限選項。只要有任何一項未勾選，代理程式就無法執行。

Google 帳號已連接至 Notion。你可以在任何自訂代理程式的「工具與存取權限」設定中新增 Google 雲端硬碟。

從代理程式連接

1. 開啟要更新的自訂代理程式。

   • Notion 代理程式會使用您在

     設定 → 連接 中連接的 Google 帳號。Notion 代理程式無需額外設定。

2. 前往代理程式的 設定 → 工具與存取權限。

3. 選取 + 新增連接 → Google 雲端硬碟。

4. 依照步驟登入 Google 並允許存取。接著，在 Google 畫面中勾選所有雲端硬碟權限選項。只要有任何一項未勾選，代理程式就無法執行。

   • 選用：選取特定的共用雲端硬碟或資料夾，限制代理程式的存取範圍。

5. 選取 儲存。

連接後，你可以指定代理程式能存取哪些內容。前往代理程式的 工具與存取權限 設定，選取允許代理程式瀏覽或編輯的特定雲端硬碟檔案或資料夾。

想讓代理程式準確搜尋或更新雲端硬碟檔案時，請在自訂代理程式的指示，或傳給 Notion 代理程式的文字指令中提及 Google 雲端硬碟。

新增 Google 雲端硬碟時，你可以設定代理程式的操作權限，之後也能變更。

• 有限權限：代理程式可以讀取使用者有權讀取的所有檔案，但只能編輯由代理程式建立或使用者選取的檔案。

• 全部權限：代理程式會沿用使用者現有的雲端硬碟權限，可讀取及編輯使用者有權讀取及編輯的所有檔案。

存取層級適用於你的所有代理程式。若要變更，請重新連接 Google 雲端硬碟，並選取 更新雲端硬碟存取權限。Notion 代理程式一律使用你的全部權限。若要將自訂代理程式的存取範圍限制在特定檔案或資料夾，請使用該代理程式的 工具與存取權限 設定。

Google 會要求你核准存取權：這是正常的設定流程。請選取你想要的 Google 帳號，審閱要求的權限，然後繼續。接著，Google 會顯示你所選存取層級的 Google 雲端硬碟權限。當 Notion 顯示 Google 雲端硬碟已連接時，即表示你已完成連接。

你可能不需要管理員審核：許多 Google Workspace 允許使用者自行連接新應用程式。如果管理員尚未針對 Custom Agents For Drive 設定特殊規則，你或許可以直接連接。一旦管理員為該應用程式設定規則，就以該規則為準。

Notion 顯示「已連接」但你從未看過 Google 登入畫面：Notion 可能會重複使用你之前設定的 Google 雲端硬碟連接。如果該連接仍可運作，這是正常的。如果它使用的是錯誤的 Google 帳號，或者雲端硬碟無法運作，請在 工具與存取權 下移除 Google 雲端硬碟，然後重新連接並選擇你想要的帳號。

你可以從使用 Google 雲端硬碟的所有代理程式中移除它，也可以只從其中一個代理程式移除。

從所有代理程式移除你的帳號

這會解除你的 Google 帳號與所有正在使用該帳號的代理程式之間的連接。

• 前往 設定 → 連接，然後選取 Google 雲端硬碟。

• 選取 你的帳號。

• 在已連接的帳號旁，選取 解除連接 並確認。

從單一代理程式移除 Google 雲端硬碟

1. 開啟該代理程式並前往 工具與存取權。

2. 選取 Google 雲端硬碟連接旁邊的三個點。

3. 選取 解除連接。

將自訂代理程式連接至 Google 雲端硬碟時，你可以設定觸發條件，讓代理程式檢查雲端硬碟中的變更。只要指定資料夾（或雲端硬碟連結），再選擇檢查頻率即可。有變更時，代理程式就會偵測並執行。你可以監控資料夾或共用雲端硬碟，但系統只會監控資料夾中的第一層檔案。子資料夾中的變更不會觸發代理程式，也無法監控整個 我的雲端硬碟。

試試以下指令，測試代理程式與 Google 雲端硬碟的連接：

• 「搜尋 Google 雲端硬碟中的『roadmap』並告訴我你找到了什麼。」

• 「建立一份名為『每週回顧』的 Google 文件，簡短摘要本週內容。」

連接至 Google 雲端硬碟後，代理程式可以：

• 搜尋你有權存取的文件、試算表和簡報。

• 依據你授予的存取權限，編輯現有的 Google 文件、試算表和簡報。至於 PDF 或 Word 文件等其他檔案，代理程式可以將更新後的版本另存為新檔案。

• 複製、移動、重新命名檔案，以及將檔案移至垃圾桶。

• 即時讀取檔案內容並產生摘要。

• 讀取 PDF 的文字。

• 建立新文件、試算表、簡報和資料夾。

• 檔案更新時，透過觸發條件執行代理程式。

代理程式可以處理的檔案類型

代理程式可以讀取 Google 文件、試算表和簡報，以及 PDF、Word、Excel、PowerPoint、CSV 和純文字檔案（包括 HTML、JSON、XML 和 YAML）。上傳檔案（例如 PDF 和 Office 檔案）的大小上限為 10 MB。如果 Google 文件、試算表或簡報非常大，代理程式一次可能只能讀取部分內容。

代理程式無法讀取 Google 繪圖、Google 地圖、Google 表單、圖片、影片、音訊或 ZIP 檔案。如果你指定其中一種檔案，代理程式會告訴你無法開啟。對於 Google 繪圖和其他 Google 檔案類型，代理程式會請你改到 Google 雲端硬碟開啟。

代理程式只能存取已連接的 Google 帳號有權存取的內容。如果該帳號失去某個檔案或資料夾的存取權限，代理程式也會失去存取權限。

編輯者可以移除自訂代理程式的 Google 雲端硬碟連接。只有將代理程式連接至 Google 雲端硬碟的人，才能擴大存取範圍（例如加入更多資料夾）。

建議只讓自訂代理程式存取必要的共用雲端硬碟或資料夾，幫助代理程式專注處理任務，同時降低風險。

對於已共享的自訂代理程式，任何有權存取該代理程式的人都可以查詢已連接的 Google 雲端硬碟。

• 每個代理程式無法連接多個 Google 帳號。

• 此連接僅適用於你所在 Google Workspace 中的檔案。如果檔案由其他 Google Workspace 分享而來，自訂代理程式就無法存取。

• 如果自訂代理程式已共享，任何能使用該代理程式的人，也能搜尋與它連接的 Google 雲端硬碟。

「你所在機構的管理員需要審核這個應用程式」

如果你的機構尚未核准應用程式所需的一項或多項權限，就會看到這則訊息。此問題只能由管理員處理。

1. 選取「要求存取權」。

2. 你的 Google Workspace 管理員會在「待審核的應用程式」中收到申請。

3. 管理員核准應用程式及其所有權限後，請再試著連接。

「存取遭封鎖：授權錯誤」

如果管理員禁止你的帳號或群組使用這個應用程式，就會看到這則訊息。請聯絡 Google Workspace 管理員；管理員必須先允許你的群組使用 Custom Agents For Drive，你才能連接。

之前可以使用，但現在無法使用了

你的 Google 存取權限可能已過期或停用，也可能是管理員變更了規則。

1. 請前往「工具與存取權」重新連接 Google 雲端硬碟

2. 如果 Google 顯示管理員封鎖訊息，請聯絡你的 Google Workspace 管理員。

3. 如果可以登入 Google，但 Notion 仍無法連接，請聯絡 Notion 支援團隊，並提供畫面上的錯誤訊息。

若要讓使用者連接，請允許其所屬群組（機構單位）使用 Custom Agents For Drive，並核准該存取層級要求的所有 Google 權限。

Google 如何決定使用者可以連接哪些應用程式

在管理員主控台中，依序前往「API 控制項」→「設定」→「未設定的第三方應用程式」。預設情況下，使用者可以自行連接新應用程式。只要你未針對 Custom Agents For Drive 設定個別規則，使用者就能直接連接，無需你審核。

其他設定則只允許存取基本的 Google 登入資訊，或封鎖所有新應用程式。你為特定應用程式設定的規則會覆蓋預設設定。訪客則透過各自所屬的群組管理。

此設定涵蓋應用程式登入存取權。Google Workspace Marketplace 的安裝作業則另外管理。

設定 Notion Agents For Drive

只要由你設定應用程式，即使新應用程式只能存取基本登入資訊或受到封鎖，使用者仍可連接。

1. 開啟 管理員主控台 → 安全性 → 存取權與資料控管 → API 控制項 → 應用程式存取權控管。

2. 開啟「已設定的應用程式」，然後選取 設定新應用程式。

3. 使用此確切的 OAuth 用戶端 ID 進行搜尋：

   69206789846-avkmfeq0epeducrkoutjo361r8p5h103.apps.googleusercontent.com

4. 選取需要連接的使用者所屬群組。

5. 選擇 受信任 以允許應用程式要求的每一項權限，或選擇 特定 Google 資料 並納入連線所需的所有 Drive 和 Google 登入權限。

6. 檢查您的選擇，然後選取 完成。

7. 請該使用者在變更生效後再次嘗試連線。

審核應用程式要求

審核要求時，請確認下列事項：

• 該應用程式為 Custom Agents For Drive。

• 該使用者所屬的群組已獲准使用。

• 所有 Drive 和 Google 登入權限皆已核准。

• 確認子群組規則沒有封鎖該應用程式。

如果選擇 特定 Google 資料，請選取連接所需的所有權限。

Google Workspace 的變更可能需要一些時間才會生效。請該使用者在變更生效後再次嘗試連接。