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 之前,您必须执行以下操作:
您必须拥有 Google 账号。您需要拥有一个 Google 账号才能在 Google API 控制台中创建项目。如果您已经拥有账号,则无需进行任何操作。您可能还需要一个用来测试的单独 Google 账号。
您必须有权访问 Display & Video 360。您需要有权访问 Display & Video 360 产品,才能使用此 API。如果贵组织已签订 Display & Video 360 合约,请确保已为您的 Google 账号创建具有适当权限的用户个人资料。如果没有,请与我们的销售团队联系,了解详情。
您应该试用 Display & Video 360。本 API 文档假定您已使用 Display & Video 360,并且熟悉 Web 编程概念和 Web 数据格式。如果您尚未使用过 Display & Video 360,请在开始编码前,试用和熟悉一下网站界面。
选择项目
您需要在 Google API 控制台中创建或选择一个项目,并启用该 API。
您可以创建新项目,也可以使用现有项目。
创建新项目
按照 Google API 控制台中的步骤创建项目,并自动启用 Display & Video 360 API。
使用现有项目
下面介绍了如何手动为现有项目启用 Display & Video 360 API。
如需为您的项目启用 API,请执行以下操作:
- 在 Google API 控制台中打开 API 库。如果系统提示,请选择一个项目或创建一个新项目。API 库中列出了所有可用的 API(按产品系列和热门程度分组)。
- 如果列表中没有显示您要启用的 API,请使用搜索功能查找该 API。
- 选择您要启用的 API,然后点击启用按钮。
- 如果系统提示,请启用结算功能。
- 如果系统提示,请接受该 API 的服务条款。
生成凭据
向 Display & Video 360 API 发出的所有请求都必须获得授权。如需简要了解授权,请参阅如何进行授权和让 Google 识别您的应用。
以下说明将引导您完成创建 OAuth 2.0 客户端 ID(以便在“已安装的应用”流程中使用)的整个过程。如需生成用于在“服务账号”流程中访问 API 的凭据,请参阅服务账号指南。
按照相应步骤配置一个 Google API 控制台项目。
- 打开 API 控制台中的“凭据”页面。
点击创建凭据 > OAuth 客户端 ID。
当系统提示时,选择最适合的应用类型。这些指南中提供的 Java 和 Python 代码段假定为桌面应用,而 PHP 代码段假定为网站应用。
输入任何其他必要信息。
- 如果这是您首次创建客户端 ID,除了可以选择应用类型之外,还可以通过点击配置同意屏幕按钮来配置您的同意屏幕。在您首次配置同意屏幕后,系统就不会再提示您配置该屏幕了,不过您可以随时对所配置的这些信息进行更新。
点击创建。
完成后,系统会显示一个 OAuth 2.0 客户端 ID 和客户端密钥,您可以将其下载为 JSON 格式进行保存,以备日后使用。
配置用户同意屏幕
当您使用 OAuth 2.0 进行身份验证时,您的用户需要先接受用户同意屏幕上显示的条款,才能完成身份验证。
如需设置项目的权限请求页面,请执行以下操作:
- 在 Google API 控制台中打开“同意屏幕”页面。 如果系统提示,请选择一个项目或创建一个新项目。
- 填写表单并点击保存。