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

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

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

• 請確認你能登入想使用的 Google 帳號。

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

• 連接前，你的 Google Workspace 擁有者可能需要先核准「適用於雲端硬碟的自訂代理程式」。如果工作空間尚未核准 Google 雲端硬碟，請工作空間擁有者核准。工作空間擁有者連接 Google 雲端硬碟後，系統就會自動核准該工作空間使用。

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

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

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

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

從設定連接

如果你想讓多個代理程式使用同一個 Google 帳號，這是最快的方法。

1. 前往 設定 → 連接。

2. 選取 Google 雲端硬碟。

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

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

5. 閱讀提醒內容，然後選取 繼續前往 Google。

6. 登入你想使用的 Google 帳號。

7. 在下一個 Google 畫面中，勾選所有 Google 雲端硬碟相關的核取方塊。只要有任何一項未勾選，代理程式就無法執行。

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

從代理程式連接

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

   • Notion 代理程式會使用你在

     設定 → 連接 中連接的 Google 帳號。你不需要在 Notion 代理程式中進行額外設定。

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

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

4. 依照步驟登入 Google 並允許存取。在下一個 Google 畫面中，勾選所有 Google 雲端硬碟相關的核取方塊。只要有任何一項未勾選，代理程式就無法執行。

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

5. 選取 儲存。

完成連接後，你可以指定代理程式能存取的內容。在代理程式的 工具與存取權限 設定中，選取要讓代理程式檢視或編輯的 Google 雲端硬碟檔案或資料夾。

如果你希望代理程式搜尋或更新 Google 雲端硬碟檔案，請在自訂代理程式的指示，或給 Notion 代理程式的（文字）指令中提及 Google 雲端硬碟，以獲得更好的結果。

新增 Google 雲端硬碟時，你可以選擇代理程式的存取層級，之後也能變更。

• 基礎版權限：代理程式可以讀取你有權讀取的所有檔案，但只能編輯代理程式建立或你選取的檔案。

• 全部權限：代理程式會沿用你現有的 Google 雲端硬碟權限，能讀取和編輯你有權讀取和編輯的所有檔案。

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

Google 會要求你核准存取權限：這是正常的設定流程。選擇要使用的 Google 帳號，確認要求的權限，然後繼續。接著，Google 會顯示你所選存取層級對應的雲端硬碟權限。當 Notion 顯示 Google 雲端硬碟已連接，就代表連接完成。

你可能不需要管理員審核：許多 Google Workspace 環境允許使用者自行連接新應用程式。如果管理員尚未針對「適用於雲端硬碟的自訂代理程式」設定特殊規則，你或許可以直接連接。管理員一旦為這個應用程式設定規則，就會以該規則為準。

Notion 顯示「已連接」，但你沒看到 Google 登入畫面：Notion 可能沿用你先前設定的 Google 雲端硬碟連接。只要連接仍可正常使用，這就沒問題。如果連接的是其他 Google 帳號，或無法使用雲端硬碟，請到 工具與存取權 移除 Google 雲端硬碟，再重新連接並選擇要使用的帳號。

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

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

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

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

• 選取 你的帳號。

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

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

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

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

3. 選取 解除連接。

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

嘗試使用下列其中一個文字指令，測試你的代理程式與 Google 雲端硬碟的連接：

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

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

連接至 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 分享而來，自訂代理程式就無法存取。

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

「您的機構管理員需要審核此應用程式」

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

1. 選取 要求存取權。

2. 你的 Google Workspace 管理員會在 待審核的應用程式 中收到這項要求。

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

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

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

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

您的 Google 存取權可能已過期或遭到停用，或者您的管理員可能變更了規則。

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

2. 如果 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 資料」，納入連接所需的所有雲端硬碟及 Google 登入權限

6. 確認選擇後，選取「完成」

7. 變更生效後，請使用者再試一次連接

審核應用程式要求

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

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

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

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

• 沒有子群組規則阻擋這個應用程式。

若選取「特定 Google 資料」，請核准連接所需的所有權限

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