开始使用

Display & Video 360 API 是 Display & Video 360 平台的编程接口。您可以使用 Display & Video 360 API 自动执行复杂的 Display & Video 360 工作流程。下面列举了一些使用 Display & Video 360 API 可以执行的任务:

本指南介绍了如何开始使用 Display & Video 360 API。

前提条件

在使用 Display & Video 360 API 之前,您必须执行以下操作:

  1. 您必须拥有 Google 帐号。您需要拥有一个 Google 帐号才能在 Google API 控制台中创建项目。如果您已经有帐号了,那就大功告成了。您可能还需要使用一个单独的 Google 帐号进行测试。

  2. 您必须拥有 Display & Video 360 的访问权限。您需要拥有 Display & Video 360 产品的访问权限,才能使用此 API。如果贵组织已有 Display & Video 360 合同,请确保已为您的 Google 帐号创建具有相应权限的用户个人资料。如果没有,请与我们的销售团队联系以获取更多信息。

  3. 建议您试用 Display & Video 360。本 API 文档假定您使用过 Display & Video 360,并且熟悉网络编程概念和网络数据格式。如果您尚未使用过 Display & Video 360,请在开始编码之前试用网页界面

选择一个项目

您需要在 Google API 控制台中创建或选择一个项目,并启用该 API

您可以创建新项目,也可以使用现有项目。

创建一个新项目

按照 Google API 控制台中的步骤创建一个项目并自动启用 Display & Video 360 API。

使用现有项目

下文介绍了如何为现有项目手动启用 Display & Video 360 API。

如需为您的项目启用 API,请执行以下操作:

  1. 在 Google API 控制台中打开 API 库。如果出现提示,请选择一个项目或创建一个新项目。API 库中列出了所有可用的 API(按产品系列和热门程度分组)。
  2. 如果列表中没有显示您要启用的 API,请使用搜索功能查找该 API。
  3. 选择您要启用的 API,然后点击启用按钮。
  4. 如果系统提示,请启用结算功能。
  5. 如果系统提示,请接受该 API 的服务条款。

生成凭据

您向 Display & Video 360 API 发出的所有请求都必须获得授权。如需简要了解授权,请参阅如何向 Google 授权和识别您的应用

以下说明将引导您完成创建 OAuth 2.0 客户端 ID(以便在“已安装的应用”流程中使用)的整个过程。如需生成用于“服务帐号”流程的凭据,请参阅服务帐号指南。

  1. 按照相应步骤配置一个 Google API 控制台项目

  2. 打开 API 控制台中的“凭据”页面
  3. 点击创建凭据 > OAuth 客户端 ID

  4. 出现提示时,请选择最合适的应用类型。在这些指南中提供的 Java 和 Python 代码段假定为桌面应用,而 PHP 代码段假定为 Web 应用

  5. 输入任何其他必填信息。

    • 如果这是您首次创建客户端 ID,除了可以选择应用类型之外,还可以通过点击配置同意屏幕按钮来配置同意屏幕。在您首次配置同意屏幕后,系统就不会再提示您配置该屏幕,不过您可以随时更新这些信息。
  6. 点击创建

完成后,系统会显示一个 OAuth 2.0 客户端 ID 和客户端密钥,您可以将其下载为 JSON 格式进行保存以备后用。

使用 OAuth 2.0 进行身份验证时,您的用户需同意向用户显示同意屏幕上显示的条款,才能完成身份验证。

如需设置项目的权限请求页面,请执行以下操作:

  1. 在 Google API 控制台中打开“同意屏幕”页面。 如果出现提示,请选择一个项目或创建一个新项目。
  2. 填写表单并点击保存