建立及設定 Google 雲端硬碟連線

本頁面說明如何在 Integration Connectors 中建立及設定 Google 雲端硬碟連線。如要進一步瞭解 Google 雲端硬碟連接器，請參閱「Google 雲端硬碟連接器總覽」。

事前準備

在 Google Cloud 專案中執行下列工作：

  • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
  • 將 roles/connectors.admin IAM 角色授予設定連結器的使用者。
  • 將 roles/secretmanager.viewer 和 roles/secretmanager.secretAccessor IAM 角色授予要用於連接器的服務帳戶。
  • 啟用下列服務：
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    如要瞭解如何啟用服務，請參閱「啟用服務」。如果先前未啟用這些服務或權限，系統會在您設定連結器時提示啟用。

建立 Google 雲端硬碟連線

如要建立 Google 雲端硬碟連線，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，依序前往「Integration Connectors」>「Connections」頁面。

    前往「連線」頁面

  2. 按一下「建立連線」。

    系統隨即會顯示「建立連線」頁面。

  3. 在「位置」部分：
    1. 按一下「區域」，然後選取連線位置。

      如需所有支援地區的清單，請參閱「位置」一文。

    2. 點選「下一步」。
  4. 在「連線詳細資料」部分，提供下列詳細資料：
    1. 連結器：選取「Google 雲端硬碟」。
    2. 連接器版本：選取要使用的連接器版本。

      選取的連接器版本取決於要使用的 Google 雲端硬碟 API 版本。詳情請參閱「Google 雲端硬碟連線版本」。

    3. 連線名稱：輸入連線名稱。
    4. 說明：(選用) 輸入連線說明。
    5. 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為 Error。
    6. 服務帳戶：選取要用於連線的服務帳戶。確認服務帳戶具備相關的身分與存取權管理角色和權限。
    7. 支援所有雲端硬碟：勾選這個核取方塊，即可啟用共用雲端硬碟的存取權。這個選項僅適用於 Google 雲端硬碟第 2 版。
    8. 連線節點設定：(選用) 設定連線節點設定。
      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連線器定價的影響，請參閱「 連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。

    9. 點選「下一步」。
  5. 在「Authentication」部分，選取並設定連線的驗證類型：

    服務帳戶

    如果您的應用程式在 Google Cloud 虛擬機器上執行，且應使用 VM 附加的服務帳戶進行驗證，請選取這個選項。

    如要使用這類驗證方式，您必須擁有服務帳戶，並具備驗證所需的相關 IAM 角色和權限。

    如要瞭解如何建立服務帳戶，請參閱「建立及管理服務帳戶」。如要瞭解如何將角色授予服務帳戶，請參閱「授予、變更及撤銷資源存取權」一文。

    服務帳戶驗證類型的連線詳細資料範例

    欄位名稱 詳細資料
    位置 us-central1
    連接器 Google 雲端硬碟
    連接器版本 2
    連線名稱 googledrive-ws-gcpaccount
    啟用 Cloud Logging 是
    服務帳戶 123456789012-compute@developer.gserviceaccount.com
    節點數量下限 2
    節點數量上限 50
    驗證 服務帳戶驗證

    OAuth 2.0 - JWT 持有者

    如要設定 OAuth 2.0 JWT 不記名驗證類型，請按照下列步驟操作：

    1. 建立服務帳戶 JSON 金鑰，然後下載 JSON 金鑰檔案。這個金鑰檔案會做為連線的 JWT 憑證。
    2. 建立密鑰，用來儲存 JSON 金鑰檔案或 JWT 憑證。
    3. 在 Integration Connectors 中建立連線時，請提供密鑰詳細資料：
      • JWT 憑證：選擇含有 JWT 憑證的密鑰。
      • 密鑰版本：選取所選密鑰的密鑰版本。
      • JWT 主體：(選用) 輸入要用於連線的 JWT 主體。這會做為 JWT 權杖中的 sub 欄位。

    OAuth 2.0 - JWT 不記名驗證類型的連線詳細資料範例

    欄位名稱 詳細資料
    位置 us-central1
    連接器 Google 雲端硬碟
    連接器版本 2
    連線名稱 googledrivejwt
    啟用 Cloud Logging 是
    服務帳戶 123456789012-compute@developer.gserviceaccount.com
    節點數量下限 2
    節點數量上限 50
    驗證 OAuth 2.0 - JWT 持有者
    JWT 憑證 
    {
  "type": "service_account",
  "project_id": "sm****-****-******",
  "private_key_id": "0b***************************",
  "private_key": "-----BEGIN PRIVATE KEY-----\nO********************************************=\n-----END PRIVATE KEY-----\n",
  "client_email": "go**********************************8",
  "client_id": "10**********************",
  "auth_uri": "https:***********************",
  "token_uri": "https:************************",
  "auth_provider_x509_cert_url": "https:*********************",
  "client_x509_cert_url": "https:****************************************************",
  "universe_domain": "go********"
}
    密鑰版本 2

    OAuth 2.0 授權碼

    如果您的應用程式需要透過瀏覽器登入與使用者互動，請使用這個方法。

    如要設定 OAuth 2.0 授權碼驗證類型，請按照下列步驟操作：

    1. 為網路應用程式建立 OAuth 2.0 憑證。這個程序會建立用戶端 ID 和用戶端密鑰 JSON 檔案。
    2. 找出要授予應用程式的存取權範圍。
    3. 建立密碼，儲存 OAuth 2.0 憑證 (client_secret.json)。
    4. 在 Integration Connectors 中建立連線時，請提供用戶端 ID、範圍和密鑰詳細資料：
      • 「Client ID」(用戶端 ID)：輸入為網頁應用程式建立的用戶端 ID。
      • 範圍：輸入以半形逗號分隔的所需範圍清單。
      • 用戶端密鑰：選擇包含 OAuth 2.0 憑證的密鑰。
      • 密鑰版本：選取所選密鑰的密鑰版本。

    Oauth 2.0 授權碼驗證類型的連線詳細資料範例

    欄位名稱 詳細資料
    位置 europe-west1
    連接器 Google 雲端硬碟
    連接器版本 2
    連線名稱 googledrive-wsconn-code
    啟用 Cloud Logging 是
    服務帳戶 123456789012-compute@developer.gserviceaccount.com
    節點數量下限 2
    節點數量上限 50
    驗證 OAuth 2.0 - 授權碼
    用戶端 ID CLIENT_ID
    範圍 https://www.googleapis.com/auth/drive、https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file、https://www.googleapis.com/auth/drive.appdata、https://www.googleapis.com/auth/drive.appfolder、https://www.googleapis.com/auth/drive.install、https://www.googleapis.com/auth/drive.metadata、https://www.googleapis.com/auth/drive.metadata.readonly、https://www.googleapis.com/auth/drive.activity、https://www.googleapis.com/auth/drive.activity.readonly、https://www.googleapis.com/auth/drive.apps.readonly、https://www.googleapis.com/auth/drive.scripts 和 https://www.googleapis.com/auth/drive.meet.readonly
    用戶端密鑰 CLIENT_SECRET
    密鑰版本 2
  6. 啟用驗證覆寫：(選用) 選取這個核取方塊，即可在執行階段啟用連線，動態接受其他驗證。
  7. 點選「下一步」。
  8. 在「查看」部分，查看連線和驗證詳細資料。如有需要，您隨時可以點選先前的任何部分進行變更。
  9. 按一下 [建立]。

    Integration Connectors 會開始為提供的設定建立連線。此程序需要幾分鐘才能完成。連線建立完成後，系統會將您重新導向至「連線」頁面。

在整合服務中使用 Google 雲端硬碟連線

建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。

  • 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。
  • 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。

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

Application Integration 的應用實例

下列範例示範如何在 Application Integration 中使用「連線器」工作，透過已設定的 Google 雲端硬碟連線執行作業。

範例 - 列出所有檔案

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Files。
  3. 選取「List」作業，然後按一下「完成」。
  4. 在「連線器」工作的「工作輸入」部分，您可以根據客戶需求設定 filterClause。

    5. filterClause 的值一律應以單引號 (') 括住，並採用這種格式傳遞。

    您可以透過 filterClause，根據任何資料欄篩選特定記錄集。

範例 - 取得檔案詳細資料

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Files。
  3. 選取「Get」作業，然後按一下「完成」。
  4. 將 entityId 設為「1wsHFAusizqFe5O2」，這是要傳遞的金鑰。如要設定 entityId，請在「資料對應」的「資料對應器」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "1wsHFAusizqFe5O2"，並選擇 entityId 做為本機變數。

    5. entityId 的值必須直接傳遞，例如「1wsHFAusizqFe5O2」。其中「1wsHFAusizqFe5O2」是傳遞的唯一主鍵值。

範例 - 刪除檔案

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Files。
  3. 選取「Delete」作業，然後按一下「完成」。
  4. 將 entityId 設為「1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L」，這是要傳遞的鍵。如要設定 entityId，請在「資料對應」的「資料對應器」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L"，並選擇 entityId 做為本機變數。

    5. 如果實體有兩個複合式商家或主鍵，除了指定 entityId，您也可以將 filterClause 設為 id='1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L'。

範例 - 建立檔案

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Files。
  3. 選取「Create」作業，然後按一下「完成」。
  4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId/connectorInputPayload 做為本機變數。
    5.   { "FileData": " ",
  "Name": "creategcpshareddrivedocxfile.docx", 
  "MIMEType": "application/vnd.google-apps.document",
  "Encoding": "BASE64"}

    如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

    { "Id": "1C48uLda6lyeakx2hOUdwnib-qtFOAhlpR_Ja2AmPvTU"}

範例 - 建立共用雲端硬碟

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Drives。
  3. 選取「Create」作業，然後按一下「完成」。
  4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId/connectorInputPayload 做為本機變數。
    5.   {"Name": "SharedDrive7"}

    如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      {"Id": "0AN6y5wEvVrmPUk9PVA"}

範例 - 建立檔案、資料夾或共用雲端硬碟的權限

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Permissions。
  3. 選取「Create」作業，然後按一下「完成」。
  4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId/connectorInputPayload 做為本機變數。
    5.   {"ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L",
  "Role": "COMMENTER",
  "Type": "USER",
  "EmailAddress": "charlie@altostrat.com"}

    如果整合成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

      { "PermissionId": "10596783046483894074",
  "ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L"}

範例 - 更新檔案詳細資料

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Files。
  3. 選取「Update」作業，然後按一下「完成」。
  4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId/connectorInputPayload/filterClause 做為本機變數。 
      {"Name": "New Updated file"}
  5. 設定檔案的 entityId。如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId/connectorInputPayload/filterClause 做為本機變數。

    您也可以將 filterClause 設為 1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm，不必指定 entityId。

    6. 執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

    {"Id": "1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm">}

範例 - 更新檔案、資料夾或共用雲端硬碟的權限

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Permissions。
  3. 選取「Update」作業，然後按一下「完成」。
  4. 在「資料對應」工作的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId/connectorInputPayload/filterClause 做為本機變數。
    5. (PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA')
{ "Role": "READER"}
  5. 設定權限的 entityId。如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId/connectorInputPayload/filterClause 做為本機變數。

    除了指定 entityId，您也可以將 filterClause 設為 PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA'。

    執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

      {"PermissionId": "10596783046483894074",
  "ResourceId": "0AKfRSSy6kZbfUk9PVA"}