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

DV360 Exchange Reporting API 作为基于许可名单的 Google Cloud 提供 该 API 使用 OAuth。许可名单流程由 DV360 广告交易平台处理 Reporting API 团队。

过程

以下是 DV360 Exchange 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 文件，因为该文件包含您的私钥， 文件是该密钥的唯一副本。需要此文件中的凭据 。

  4. 联系 DV360，提供您创建的服务账号信息。 具体来说就是服务账号的电子邮件地址。这是 将 API 访问权限列入许可名单的流程。

访问令牌

您的服务账号获授权调用该 API 后，您可以 请继续按照 API 指南中的示例操作如需手动获取访问令牌，请按以下步骤操作： 您可以使用 oauth2l 等工具；或者，使用其中一个 的客户 库 以编程方式进行身份验证