常见问题解答

一般措施

该 API 的最新版本是什么？

本文档介绍的 API 的最新版本是 v1beta2。此版本是非公开 Beta 版，可供受信任的测试人员使用。

谁可以访问 API？

“v1beta2”访问权限仅适用于允许列出的 Google API 控制台项目。对 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。如需安装该库并创建授权服务对象，请按以下步骤操作。

安装 google-api-python-client

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

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

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

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)