概览

您可以使用 Authorized Buyers Marketplace API（可公开 curators.dataSegments 资源）创建和管理数据细分受众群。这是一个 REST API，具有可用于集成的生成的客户端库。

设置身份验证

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

  1. 如果您尚未创建 Google Cloud 项目，请创建一个 Google Cloud 项目，用于托管您访问 API 时使用的凭据。
  2. 前往 Google Cloud 控制台“已启用的 API”页面。 选择您之前创建的项目。

  3. 您会看到已启用的 API 和服务的列表。如需访问 Marketplace API，您必须启用该 API。 如果 Marketplace API 未启用，请点击 +启用 API 和服务，然后按照以下说明操作：

    1. 系统会将您引导至一个带有搜索框的页面。搜索 Authorized Buyers Marketplace API。
    2. 在结果页面中选择 Authorized Buyers Marketplace API。
    3. 点击启用。
  4. 在导航菜单中，选择凭据。
  5. 点击 +创建凭据，然后在随即显示的下拉菜单中选择服务账号。
  6. 输入服务账号的名称。系统会在创建时自动生成服务账号 ID，请记下此值，因为您稍后会在第 14 步中用到它。（可选）输入说明。点击创建并继续。
  7. 您可以选择为服务账号配置权限，然后点击继续。
  8. （可选）配置可以以服务账号身份执行操作的用户或群组，然后点击完成。
  9. 您的新服务账号会列在服务账号下。找到并点击您刚创建的服务账号 ID。
  10. 点击密钥标签页。
  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。

后续步骤