概览

您可以使用甄选合作伙伴 API（该 API 会公开 curators.dataSegments 资源）创建和管理数据细分。这是一个具有生成的客户端库的 REST API，可用于集成。

设置身份验证

Google API 使用 OAuth 2.0 协议进行身份验证和授权。以下是设置服务账号以访问 Curation Partners API 的方法。

  1. 如果您尚未创建 Google Cloud 项目，请创建一个 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. 点击密钥标签页。

  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 字段中提供的完整资源名称。

后续步骤