常见问题解答

常规

API 的最新版本是什么？

本文档介绍的 API 的最新版本是 v1beta2。 此版本是私有 Beta 版，仅面向受信任的测试人员提供。

哪些人可以访问 API？

只有列入许可名单的 Google API 控制台项目才能访问 v1beta2。对 API 文档的访问权限由单独的用户许可名单控制。

如何判断我的控制台项目是否已列入许可名单？

点击以下网址中的 API_KEY 元素，从项目中选择一个 API 密钥。如果所选项目没有 API 密钥，系统会提示您创建一个。完成后，将生成的网址复制并粘贴到浏览器中。

https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEY

如果您看到 API 的 JSON 说明，则说明您的项目已列入许可名单。如果您看到错误，则说明您的项目未列入许可名单。

使用 API

我使用哪个网址来访问 API？

https://displayvideo.googleapis.com

支持哪些身份验证方法？

OAuth 2.0 是唯一受支持的身份验证方法。所有请求都必须获得以下范围的授权：

• https://www.googleapis.com/auth/display-video

我想编写代码。在哪里可以找到客户端库？

Python

您可以使用公开提供的 Python 版 Google API 客户端库 来访问此 API。如需安装该库并创建授权服务对象，请按照以下步骤操作。

1. 安装 google-api-python-client

   pip install --upgrade google-api-python-client
   

2. 获取授权的 credentials 对象。如需查看示例，请参阅设置应用指南。

3. 使用发现服务创建授权服务对象。

   api_key = 'API_KEY'
   api_name = 'displayvideo'
   api_url = 'https://%s.googleapis.com/' % api_name
   api_version = 'v1beta2'
   
   discovery_url = (
       '%s/$discovery/rest?key=%s&version=%s&labels=%s'
       % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER')
   )
   
   service = discovery.build(api_name, api_version,
                             discoveryServiceUrl=discovery_url,
                             http=credentials)