預先發布版

這項產品或功能 適用《服務專屬條款》。 正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

Google 雲端硬碟連接器

您可以使用 Google 雲端硬碟連接器，在 Integration Connectors 中建立及設定 Google 雲端硬碟連線。您可以在商用應用程式中使用這個連線，與 Google 雲端硬碟安全地交換資料及執行作業。

如需支援的實體和作業清單，請參閱「支援的實體和作業」。如要瞭解支援哪些連接器專屬動作，請參閱「支援的動作」。

Integration Connectors 中的所有連線都會為基礎服務物件提供一層抽象化。這些物件會公開為可管理的實體，讓您執行標準作業或使用連接器專屬動作。

Google 雲端硬碟連接器版本

Google 雲端硬碟連接器支援兩個版本：

• Google 雲端硬碟第 1 版：使用這個連結器版本存取 Google 雲端硬碟第 3 版 API。
• Google 雲端硬碟 v2：使用這個連結器版本存取 Google 雲端硬碟 v2 API。

如要瞭解如何建立 Google 雲端硬碟連線，請參閱「建立及設定 Google 雲端硬碟連接器」。

支援的實體和作業

Google 雲端硬碟連接器支援下列實體和作業：

實體	說明	作業
File	代表 Google 雲端硬碟中的檔案。	Get、List、Create、Update、Delete
Folder	代表 Google 雲端硬碟中的資料夾。	Get、List、Create、Update、Delete
Permission	代表 Google 雲端硬碟中檔案或資料夾的權限。	Get、List、Create、Update、Delete
Drive	代表 Google 雲端硬碟中的雲端硬碟。	Get、List、Create、Update、Delete

如需應用程式整合的用途範例，請參閱「應用程式整合的用途範例」。

支援的動作

Google 雲端硬碟連接器支援下列動作：

CopyResource

說明：在 Google 雲端硬碟中建立指定資源的副本。您可以提供上層資料夾 ID 清單，為複製的檔案定義新名稱，並指定目的地資料夾。

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要複製的資源 ID。
NewName	字串	是	複製檔案的新名稱。
ParentIDs	字串	否	以半形逗號分隔的父項資料夾 ID 清單，複製的檔案會放在這些資料夾中。如未指定，檔案會複製到檔案所在資料夾。
IgnoreDefaultVisibility	布林值	否	決定是否要略過新建立檔案的預設瀏覽權限設定。 如果網域已設定為預設顯示所有上傳的檔案，將這項參數設為 true 即可針對這項特定要求覆寫該行為。 預設值為 false。
IncludeLabels	字串	否	以半形逗號分隔的標籤 ID 清單，用於在回應的 labelInfo 部分中加入標籤。
IncludePermissionsForView	字串	是	這個欄位會指定要在回應中加入哪些額外的檢視權限。發布支援的值。
KeepRevisionForever	布林值	否	指出是否要永久保留檔案的修訂版本。 這項功能僅適用於 Google 雲端硬碟中有二進位內容的檔案。每個檔案最多可永久保留 200 個修訂版本。如果已達上限，您必須刪除現有修訂版本，才能新增版本。預設值為 false。
OCRLanguage	字串	否	匯入圖片檔案時，這個欄位會提供 OCR (光學字元辨識) 的語言提示。 使用 ISO 639-1 雙字母語言代碼指定語言，例如 en 代表英文，de 代表德文。
SupportsAllDrives	布林值	是	這個參數表示是否要追蹤「我的雲端硬碟」和共用雲端硬碟中的變更。 將這個參數設為 true，即可啟用共用雲端硬碟的存取權。預設值為 false。

輸出參數

參數名稱	資料類型	說明
CopiedFileID	字串	複製檔案的 ID。
Success	字串	這個參數會指出作業是否成功。

使用案例範例

以下範例說明如何在應用程式整合中設定 CopyResource 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「CopyResource」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]
         

---

CreateFolder

說明：在 Google 雲端硬碟中建立新資料夾。您必須提供新資料夾的名稱，並提供上層資料夾的 ID 來指定資料夾位置。你也可以視需要加上說明，並將資料夾標示為已加星號。

輸入參數

參數名稱	資料類型	必填	說明
Name	字串	是	資料夾的標題。
Description	字串	否	資料夾的說明。
Starred	布林值	否	這個參數表示資料夾是否已加上星號。 預設值為 false。
ParentIds	字串	是	以半形逗號分隔的清單，列出要建立新資料夾的上層資料夾 ID。

輸出參數

參數名稱	資料類型	說明
Success	字串	這個參數會指出作業是否成功。
Id	字串	新資料夾的 ID。

使用案例範例

以下範例說明如何在應用程式整合中設定 CreateFolder 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「CreateFolder」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
         

---

DeleteResource

說明：從 Google 雲端硬碟永久移除檔案或資料夾。如要使用這項動作，請提供要刪除資源的專屬 ID。

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要刪除的資源 ID。

輸出參數

參數名稱	資料類型	說明
Success	字串	這個參數會指出作業是否成功。

使用案例範例

以下範例說明如何在應用程式整合中設定 DeleteResource 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「DeleteResource」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [{"Success": "TRUE"}]
         

---

DownloadFile

說明：從 Google 雲端硬碟下載檔案

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要下載的檔案 ID。
LocalFile	字串	否	檔案的儲存路徑和檔案名稱，如要將檔案儲存在記憶體中，請留空。
Encoding	字串	否	檔案資料的編碼類型。如果 LocalFile 為空，系統會以指定編碼傳回檔案資料。允許的值為 NONE 和 BASE64。預設值為 BASE64。
Overwrite	布林值	否	這個參數會決定下載時，是否要覆寫現有檔案。 預設值為 false，請將參數設為 TRUE 來覆寫檔案。
FileFormat	字串	否	檔案下載格式，檔案大小上限為 10 MB。如要下載原始格式的檔案，請將這個參數留空。支援的格式包括 DOCX、ODT、RTF、HTML、TXT 和 PDF。

輸出參數

參數名稱	資料類型	說明
FileData	字串	如果未提供 LocalFile，系統會使用指定的編碼方式傳回檔案資料。
Success	字串	這個參數會指出作業是否成功。

使用案例範例

以下範例說明如何在應用程式整合中設定 DownloadFile 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「DownloadFile」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [{"FileData": "This is a test file.", "Success": "TRUE"}]
         

---

MoveResource

說明：將檔案或資料夾移至 Google 雲端硬碟中的其他位置。您需要提供要移動的資源 ID 和新父項資料夾的 ID。

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要移動的資源 ID。
ParentIDs	字串	是	以半形逗號分隔的 ID 清單，做為父項資料夾。 共用雲端硬碟中的資源只能有一個父項資料夾，且只有具備「檔案管理員」或「管理員」角色的使用者，才能在共用雲端硬碟中移動檔案和資料夾。

輸出參數

參數名稱	資料類型	說明
Success	字串	這個參數會指出作業是否成功。

使用案例範例

以下範例說明如何在應用程式整合中設定 MoveResource 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「MoveResource」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [{"Success": "TRUE"}]
         

---

UpdateResource

說明：更新 Google 雲端硬碟中檔案或資料夾的中繼資料。您可以修改名稱、說明、MIME 類型，以及是否加上星號。

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要更新的資源 ID。
Name	字串	是	更新後的新檔案名稱。
Description	字串	否	檔案或資料夾的說明。
MIMEType	字串	否	檔案的 MIME 類型。
Starred	字串	否	這個參數會指出資源是否已加上星號。 預設值為 false。

輸出參數

參數名稱	資料類型	說明
Success	字串	這個參數會指出作業是否成功。

使用案例範例

以下範例說明如何在應用程式整合中設定 UpdateResource 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「UpdateResource」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [{"Success": "TRUE"}]
         

---

UploadFile

說明：將檔案上傳至 Google 雲端硬碟。您必須提供檔案資料和 MIME 類型。您也可以指定檔案要放置的上層資料夾，以及上傳檔案的名稱。

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要上傳的檔案 ID。
FileData	字串	是	要上傳的檔案資料。
MIMEType	字串	是	檔案的 MIME 類型。
ParentIDs	字串	否	以半形逗號分隔的父項資料夾 ID 清單，上傳的檔案會放在這些資料夾中。如未指定，檔案會上傳至使用者「我的雲端硬碟」的根資料夾。
Filename	字串	否	要上傳的檔案名稱。

輸出參數

參數名稱	資料類型	說明
Success	字串	這個參數會指出作業是否成功。

使用案例範例

以下範例說明如何在應用程式整合中設定 UploadFile 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「UploadFile」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [{"Success": "TRUE"}]
         

---

SubscribeToFileChanges

說明：訂閱 Google 雲端硬碟中特定檔案的變更通知。

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要訂閱的檔案 ID。
Token	字串	是	用於訂閱檔案變更的權杖。

輸出參數

參數名稱	資料類型	說明
Success	字串	這個參數會指出作業是否成功。

使用案例範例

以下範例說明如何在應用程式整合中設定 SubscribeToFileChanges 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「SubscribeToFileChanges」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           {
             "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
             "Id": "Id11752060129918",
             "Address": "https://cloudsearch.googleapis.net/notifications",
             "ChannelToken": "token"
           }
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [
             {
               "Kind": "api#channel",
               "Id": "Id11752060129918",
               "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
               "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
               "Token": "token",
               "Expiration": "1752063731000"
             }
           ]
         

---

SubscribeToUserChanges

說明：訂閱 Google 雲端硬碟中特定使用者所做的變更通知。

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要訂閱的使用者 ID。
Token	字串	是	用於訂閱使用者變更的權杖。

使用案例範例

以下範例說明如何在應用程式整合中設定 SubscribeToUserChanges 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「SubscribeToUserChanges」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           {
             "Id": "11752060129918",
             "Address": "https://cloudsearch.googleapis.net/notifications",
             "ChannelToken": "token"
           }
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [
             {
               "Kind": "api#channel",
               "Id": "Id11752060129918",
               "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
               "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
               "Token": "token",
               "Expiration": "1752063731000"
             }
           ]
         

---

StopWatchingResources

說明：取消訂閱先前觀看資源的通知。

輸入參數

參數名稱	資料類型	必填	說明
Id	字串	是	要停止監控的資源 ID。
Token	字串	是	用於停止監看資源的符記。

使用案例範例

以下範例說明如何在應用程式整合中設定 StopWatchingResources 動作：

1. 在「設定連接器工作」對話方塊中，按一下「動作」。
2. 選取「StopWatchingResources」動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

           {
             "Id": "Id11752060129918",
             "Token": "token"
           }
         

   如果動作成功，連接器工作的 connectorOutputPayload 回應參數會包含類似以下內容的值：

           [
             {
               "Kind": "api#channel",
               "Id": "stopid1751971586168",
               "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
               "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
               "Token": null,
               "Expiration": "1751975186000"
             }
           ]
   

系統限制

每個節點的 Google 雲端硬碟連線器每秒最多可處理 2 QPS 交易，超過此限制的交易都會遭到節流。根據預設，整合連接器會為連線分配 2 個節點 (提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。

注意：整合連接器節點的數量會根據用量自動動態調整。不過，如果您想預留大量容量，不必等待自動調度資源，可以調整連線的節點數量下限。如要處理連線的更多交易，就需要更多節點。反之，如果連線處理的交易較少，則需要的節點也較少。如要設定節點值，請按照下列步驟操作：

• 如果您是隨用隨付方案客戶，請在編輯連線頁面中設定節點的最小值和最大值。
• 如果您是訂閱型客戶，請與支援團隊聯絡。

節點可處理的最大交易量取決於多項因素。因此，建議您先檢查後端系統是否已完成最佳化設定，可處理所需流量，再調整節點下限以提升輸送量。

後續步驟

• 瞭解如何建立及設定 Google 雲端硬碟連線。
• 瞭解如何暫停及恢復連線。
• 瞭解如何監控連結器用量。
• 瞭解如何查看連接器記錄。

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連結器，請前往 Cloud 論壇的 Google Cloud 社群。