設定 API 存取權

以下說明如何使用 SDK 或 REST 設定 Data Manager API 的存取權。

選擇要使用的設定程序類型：

必要條件

使用 Data API 前，請先確認下列事項：

  1. Google Cloud 專案。
  2. 在 Google Cloud 專案中具有 serviceusage.services.enable 權限的 Google 帳戶，或具有包含該權限的角色。舉例來說，roles/owner 和 roles/serviceusage.serviceUsageAdmin 都包含 serviceusage.services.enable 權限。如要查看權限，請參閱「查看目前的存取權」。
  3. 已安裝 Google Cloud 指令列介面。

啟用 API

如果尚未啟用 Data Manager API，請按一下「啟用 Data Manager API」，或按照操作說明手動執行這個步驟。

啟用 Data Manager API

如果找不到 Data Manager API 或啟用 Data Manager API 失敗，請確認 Google 帳戶符合必要條件。

設定驗證方法

除了 API 金鑰，您也可以使用Google 的任何驗證方法。建議您參閱「為您的用途選擇合適的驗證方法」，決定適合您用途的方法。

常見的驗證方法有使用者帳戶和服務帳戶：

  • 使用者帳戶：代表直接與 Google API 和服務互動的使用者。
  • 服務帳戶：代表應用程式，而非使用者。可讓應用程式管理驗證和授權。舉例來說，如果應用程式需要存取 Google Cloud 資源。

整合項目可以使用應用程式預設憑證 (ADC)，自動從環境中尋找憑證，因此您不必變更用戶端程式碼進行驗證。

選擇「使用者帳戶」或「服務帳戶模擬」來設定 ADC：

如要使用使用者帳戶憑證進行驗證，請按照下列步驟操作：

  1. 為專案設定 Google Auth Platform。

    1. 在 Google Cloud 控制台中開啟「品牌」頁面。

    2. 選取專案。

    3. 填寫表單，然後按一下「建立」。

  2. 由於 Data Manager API 範圍屬於機密範圍，因此必須執行下列步驟：

    1. 前往專案的「資料存取權」設定。

    2. 按一下「新增或移除範圍」。

    3. 在範圍清單中，勾選「Data Manager API」旁的方塊，然後按一下「更新」。

    4. 按一下 [儲存]。

    5. 前往 Google Cloud 控制台的「Audience」(目標對象)，然後更新「Publishing status」(發布狀態) 和「User type」(使用者類型)。如要進一步瞭解這些設定，請參閱「管理應用程式目標對象」。

  3. 按一下「建立 OAuth2 用戶端」，在專案中建立 OAuth2 用戶端，或按照操作說明建立「桌面」OAuth2 用戶端。如果您已有要用於 Data Manager API 的桌面 OAuth2 用戶端，可以略過這個步驟。

    如果按一下「建立 OAuth2 用戶端」，系統會提示您「設定 OAuth 用戶端」，請選取「桌面應用程式」，以便在後續步驟中使用該用戶端。

    建立 OAuth2 用戶端

    在最後一個步驟中，按一下「下載用戶端設定」，並記下您選擇的下載位置。

  4. 執行下列指令，產生本機 ADC 檔案。這個指令會啟動網路流程，提示您登入 API 使用的 Google 帳戶。

    將 PATH_TO_CLIENT_JSON 替換成您下載的 JSON 檔案名稱。

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    如要使用相同的憑證存取 Data Manager API 和 Google Ads API，請在 --scopes 清單中加入 Google Ads API 範圍：

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    如要使用相同的憑證存取 Data Manager API 和 Display & Video 360 API，請在 --scopes 清單中加入 Display & Video 360 API 範圍：

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. 使用下列指令確認憑證設定正確無誤。 如果執行成功，指令會將存取權杖列印至控制台。

    gcloud auth application-default print-access-token

如要進一步瞭解應用程式的驗證和憑證，請參閱「Google 的驗證方式」和「應用程式預設憑證的運作方式」。

設定帳戶存取權

授予與使用者帳戶相關聯的電子郵件地址存取權，以便存取 Destination。

  • 如果使用 Google Ads 帳戶，請按照操作說明，將使用者電子郵件地址新增至 Google Ads 帳戶或上層 Google Ads 管理員帳戶。
  • 如果使用 Display & Video 360 帳戶，請按照操作說明將使用者的電子郵件地址新增至帳戶。
  • 如果使用 Google Analytics 資源，請按照操作說明將使用者的電子郵件地址新增至帳戶。

後續步驟

安裝用戶端程式庫並執行程式碼範例，嘗試發出第一個 Data Manager API 要求。

下一頁
安裝用戶端程式庫