设置 Auth

DV360 卖方 API 初始配置

为 DV360 卖方 API 引入 API 需要完成几个主要步骤。DV360 Seller API 以基于许可名单的 Google Cloud API 的形式公开,并使用 OAuth 进行身份验证。

如需处理许可名单流程,请与 DV360 卖方 API 团队联系。

授权参与步骤:

  1. 前往 https://console.cloud.google.com/ 注册 Google 账号
    • 此账号将用于管理生产客户端的访问令牌。请勿使用您的个人 Gmail 账号。
    • 该账号不能是 Google 群组。
    • 如果您使用的是现有 Google Cloud 项目:该账号必须是项目的管理员。
  2. 请联系 Google DV360,提供您注册的账号信息,以将其添加到许可名单。
  3. 等待您的账号被添加到许可名单。
  4. 可选且非阻塞操作:为您的应用提交 OAuth 验证审核请求,以便访问范围(doubleclickbidmanager)。
  5. 前往 https://console.cloud.google.com/。依次前往“API 和服务”->“库”->“私有”。您应该会看到 DV360 卖方 API 列为可供您使用的 API 之一。
  6. 启用 DV360 Seller API
  7. 依次选择“凭据”->“创建凭据”->“服务账号密钥”。请按照以下说明操作:https://developers.google.com/identity/protocols/OAuth2ServiceAccount

    设置服务账号:

    注意:如果您想重复使用现有服务账号(例如 DV360 Reporting API),请告诉我们。

    Google Cloud API 身份验证和授权(通常分组为“身份验证”)通常使用服务账号来完成。借助服务账号,您的代码可以将应用凭据直接发送到 Cloud API。与用户账号类似,服务账号由电子邮件地址表示。但是,与用户账号不同的是,一个服务账号只属于一个应用,只能用于访问为其创建的 API。作为示例,我们将介绍如何使用 Google Cloud Platform 控制台创建服务账号凭据。

    使用 Google Cloud Console

    在 Google Cloud 控制台的 API 管理器→凭据页面中,依次选择“创建凭据→服务账号密钥”。

    alt_text

    接下来,从“服务账号”下拉列表中选择“新服务账号”。

    alt_text

    输入该服务账号的“名称”。此名称将用作“服务账号 ID”的默认名称(生成的服务账号 ID 地址中“@”左侧的部分),但您可以根据需要更改该服务账号 ID 名称。这些名称可任意设置;只要您能记住就行。在“密钥类型”下,我们建议您保留“JSON”值。点击“创建”,GCP 控制台将生成 JSON 密钥(作为 .json 文本文件),提示您将文件下载到计算机,并显示服务账号已创建对话框。

    alt_text

    生成的 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"
    }

    安全存储该 JSON 文件,因为其中包含您的私钥(而且该文件是该密钥的唯一副本)。如果您想要将凭据发送到 Google Cloud Platform API,将需要在代码中引用该服务账号密钥文件。

  8. 使用您创建的 服务账号 信息与 DV360 联系。具体而言,我们需要此服务账号的电子邮件地址。这是授权的另一个许可名单流程。
  9. 您的服务账号获得调用 API 的授权后,您可以参阅 https://developers.google.com/display-video/seller 查看 API 文档。如需手动获取身份验证令牌,请参阅以下说明:https://github.com/google/oauth2l。(您需要已下载服务账号密钥的 JSON 版本)。您还可以访问以下网址,详细了解如何以编程方式获取 Oauth 令牌:https://cloud.google.com/docs/authentication/production

重要提示:OAuth 范围需要为“doubleclickbidmanager”