DV360 Exchange Reporting API 初始配置和 OAuth 设置

DV360 广告交易平台报告 API 可让第三方广告交易平台 (3PE) 合作伙伴以程序化方式访问 Display & Video 360 中的效果报告。

DV360 广告资源交易平台报告 API 是基于许可名单的 Google Cloud API，使用 OAuth。许可名单流程由 DV360 Exchange Reporting API 团队负责处理。

过程

以下是 DV360 交易平台 Reporting API 的初始配置步骤：

  1. 在 Google Cloud 控制台中注册 Google 账号。

    请注意，此账号用于管理生产客户端的访问令牌，因此请勿使用您的个人 Gmail 账号。

  2. 请与 Google DV360 联系，提供账号信息，以便将其添加到许可名单中。

  3. 收到您已加入许可名单的通知后，请申请 OAuth 验证审核，以便您的应用获得 doubleclickbidmanager 范围的访问权限。

  4. 登录 Google Cloud 控制台。

    依次前往 API 和服务 > 库 > 私有。您应该会看到 DV360 Exchange Reporting API 列为可供您使用的 API 之一。启用 DV360 Exchange Reporting API。

  5. 依次前往凭据 > 创建凭据 > 服务账号密钥。按照说明创建服务账号。

服务账号

通过服务账号，您的代码可以将应用凭据直接发送到 API。与用户账号类似，服务账号由电子邮件地址表示。但是，与用户账号不同的是，服务账号只属于一个应用，只能用于访问为其创建的 API。

以下是使用 Google Cloud 控制台创建服务账号凭据的步骤：

  1. 在 API 管理器 > 凭据页面中，选择创建凭据→服务账号密钥。

  2. 从服务账号下拉菜单中选择新的服务账号。

    输入该服务账号的名称。此名称用作服务账号 ID 的默认名称，在生成的服务账号 ID 地址中位于 @ 左侧。

    在密钥类型下，我们建议您保留 JSON 值。点击创建以生成 JSON 密钥作为 .json 文本文件。系统提示时，将文件下载到计算机，然后显示服务账号已创建对话框。

    以下是一个 JSON 密钥示例：

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. 请妥善存储该 JSON 文件，因为其中包含您的私钥，而且该文件是该密钥的唯一副本。当您的代码调用 API 时，需要使用此文件中的凭据。

  4. 使用您创建的服务账号信息（具体来说，是服务账号的电子邮件地址）与 DV360 联系。这是 API 访问权限许可名单流程的一部分。

访问令牌

在您的服务账号获得调用 API 的授权后，您可以继续学习 API 指南中的示例。如需手动获取访问令牌，您可以使用 oauth2l 等工具；或者，使用我们的某个客户端库以编程方式进行身份验证。