總覽

您可以使用 Curation Partners API 建立及管理資料區隔，這個 API 會公開 curators.dataSegments 資源。這是 REST API，其中包含產生的用戶端程式庫，可用於整合。

設定驗證方法

Google API 使用 OAuth 2.0 通訊協定進行驗證及授權。如要存取 Curation Partners API，請按照下列步驟設定服務帳戶。

  1. 如果您尚未建立 Google Cloud 專案，請先建立專案，並在該專案中儲存用於存取 API 的憑證。

  2. 前往 Google Cloud 控制台的「已啟用 API」頁面。選取您先前建立的專案。

  3. 查看已啟用的 API 和服務清單。如要存取 Curation Partners API，請先啟用該 API。如果 Curation Partners API 尚未啟用，請按一下「+ 啟用 API 和服務」，然後按照下列指示操作：

    1. 使用搜尋框搜尋「Curation Partners API」。
    2. 在結果頁面中選取「Curation Partners API」。
    3. 按一下「啟用」。

    已知問題：您可能無法使用 Google Cloud 控制台搜尋方塊找到 Curation Partners API。您也可以改用 Google Cloud CLI 啟用 API。安裝 gcloud CLI 後，您可以執行下列指令啟用 Curation Partners API：

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. 在導覽選單中選取「憑證」。

  5. 按一下「+建立憑證」，然後在隨即顯示的下拉式選單中選取「服務帳戶」。

  6. 輸入服務帳戶的「名稱」。系統會在建立服務帳戶時自動產生「服務帳戶 ID」，請記下這個值，因為稍後在步驟 14 中會用到。視需要輸入說明。按一下「建立並繼續」。

  7. 視需要設定服務帳戶的權限，然後按一下「繼續」。

  8. 視需要設定可透過服務帳戶執行動作的使用者或群組，然後按一下「完成」。

  9. 新的服務帳戶會列在「服務帳戶」下方。找出並點選您剛建立的服務帳戶 ID。

  10. 按一下「Keys」(金鑰) 分頁標籤。

  11. 在「新增金鑰」下拉式選單中，選取「建立新的金鑰」。

  12. 選取「JSON」做為金鑰類型，然後按一下「建立」。

  13. 將金鑰下載至目前使用的目錄。如要進一步瞭解如何安全儲存金鑰，請參閱「管理服務帳戶金鑰」。應用程式會使用這個金鑰發出 API 呼叫。

  14. 向客戶技術顧問提供服務帳戶 ID，將服務帳戶連結至您的帳戶。

API 範圍

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

如何識別 API 中的資料區隔與即時收錄中的資料區隔

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

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

在即時精選中識別與廣告商機相關的資料區隔時，請指定 DATA_SEGMENT_ID 資源 ID 的值，而非 API 在 name 欄位中提供的完整資源名稱。

後續步驟