设置 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”

上一页
概览
下一页
客户端库