總覽

您可以使用 Authorized Buyers Marketplace API 建立及管理資料區隔，該 API 會公開 curators.dataSegments 資源。這是 REST API，附有產生的用戶端程式庫，可用於整合。

設定驗證方法

Google API 使用 OAuth 2.0 通訊協定進行驗證及授權。以下說明如何設定服務帳戶，以便存取 Marketplace API。

  1. 如果您尚未建立 Google Cloud 專案，請先建立專案，該專案會代管用於存取 API 的憑證。
  2. 前往 Google Cloud 控制台的「已啟用 API」頁面。 選取您先前建立的專案。

  3. 系統隨即會顯示已啟用的 API 和服務清單。如要存取 Marketplace API，請先啟用這項功能。 如果尚未啟用 Marketplace API，請按一下「+啟用 API 和服務」，然後按照下列操作說明逐步完成：

    1. 系統會將你導向含有搜尋框的頁面。搜尋 Authorized Buyers Marketplace API。
    2. 在結果頁面中選取「Authorized Buyers Marketplace API」。
    3. 按一下「啟用」。
  4. 在導覽選單中選取「憑證」。
  5. 按一下「+建立憑證」，然後在隨即顯示的下拉式選單中選取「服務帳戶」。
  6. 輸入服務帳戶的「名稱」。系統會在建立服務帳戶時自動產生「服務帳戶 ID」，請記下這個值，因為您會在步驟 14 中用到。視需要輸入說明。按一下「建立並繼續」。
  7. 視需要設定服務帳戶的權限，然後按一下「繼續」。
  8. 視需要設定可透過服務帳戶執行動作的使用者或群組，然後按一下「完成」。
  9. 新的服務帳戶會列在「Service Accounts」(服務帳戶) 下方。找出並點選您剛建立的服務帳戶 ID。
  10. 按一下「Keys」(金鑰) 分頁標籤。
  11. 在「新增金鑰」下拉式選單中，選取「建立新的金鑰」。
  12. 選取「JSON」做為金鑰類型，然後按一下「建立」。
  13. 將金鑰下載至工作目錄。如要進一步瞭解如何安全儲存金鑰，請參閱「管理服務帳戶金鑰」。應用程式會使用這個金鑰發出 API 呼叫。
  14. 將服務帳戶 ID 提供給客戶技術經理，以便將服務帳戶連結至您的帳戶。

API 範圍

逐步完成 OAuth 2.0 流程，取得用於發出 API 呼叫的存取權杖時，您必須指定可使用該權杖存取的 API。如果是 Authorized Buyers Marketplace API，範圍為 https://www.googleapis.com/auth/authorized-buyers-marketplace。

如何透過 API 與即時收錄功能識別資料區隔

在 Marketplace API 中，資料區隔會以 API 專屬的資源名稱識別，例如：

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

在即時精選中找出與廣告商機相關的資料區隔時，請指定 DATA_SEGMENT_ID 資源 ID 的值，而非 API 使用的完整資源 name。

後續步驟