常见问题解答

常规

API 的最新版本是什么？

本文档介绍的 API 的最新版本为 v4。

我可以使用此 API 检索效果数据吗？

不可以。您可以使用 Bid Manager API 创建、检索和运行 Display & Video 360 离线报告。

使用 API

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

https://displayvideo.googleapis.com

支持哪些身份验证方法？

OAuth 2.0 是唯一受支持的身份验证方法。

Display & Video 360 API 请求必须获得以下范围的授权：

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

对 users 服务的请求还必须获得以下额外范围的授权：

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

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

请参阅客户端库指南。

如果我不想使用客户端库，该怎么办？

我们建议您使用我们的某个客户端库，但您也可以使用直接 HTTP 请求与 Display & Video 360 API 交互。

一些更复杂的方法（例如 advertisers.assets.upload 和 media.upload）更难直接转换为 HTTP 请求。如需查看使用 c网址 向这些方法发出 HTTP 请求的示例，请参阅我们的广告素材和自定义出价指南。

我需要哪些 Display & Video 360 权限？

如需使用 Display & Video 360 API，进行身份验证的 Google 账号必须是 Display & Video 360 用户，并且有权访问相关合作伙伴或广告客户。

Display & Video 360 用户必须具有以下某个用户角色，相关合作伙伴或广告客户才能执行以下操作：

• 只读：使用 get 或 list 调用检索资源，不包括 user 资源。
• 标准：检索、创建和更新资源。检索对同一合作伙伴或广告客户拥有权限的 user 资源。
• 管理员：检索、创建和更新资源。为您管理的合作伙伴或广告客户检索、创建和授予对 user 资源的访问权限。

如何使用 API 更新 YouTube & Partners 资源？

Display & Video 360 API 不支持创建或更新 YouTube 和合作伙伴资源。在 Display & Video 360 界面中上传结构化数据文件 (SDF)，批量创建或更新 YouTube 及合作伙伴资源。如需详细了解如何使用 SDF 上传功能，请参阅我们的 指南页面，了解 YouTube 及合作伙伴资源。

如何定位到地理位置？

您可以使用以下定位类型为订单项指定地理位置定位条件：

• TARGETING_TYPE_GEO_REGION
• TARGETING_TYPE_POI
• TARGETING_TYPE_BUSINESS_CHAIN
• TARGETING_TYPE_REGIONAL_LOCATION_LIST
• TARGETING_TYPE_PROXIMITY_LOCATION_LIST

使用 targetingTypes.targetingOptions.search 检索前三种定位类型的定位选项 ID。使用 advertisers.locationLists 服务检索和管理位置列表资源。

此外，您还可以构建 TARGETING_TYPE_POI 定位选项 ID，以直接定位到特定纬度/经度坐标周围的邻近区域。

我了解到，可以使用 API 下载结构化数据文件 (SDF)，但如何上传这些文件？

Display & Video 360 API 不支持 SDF 上传。我们建议您改为通过 API 提供的 CREATE、PATCH 和 DELETE 方法管理资源。如果您仍想使用 SDF 管理资源，可以通过 Display & Video 360 界面更新这些文件。

支持

API 是否存在任何已知问题或限制？

您的项目每秒可以发出的请求数受到限制，具体限制详见我们的使用限制指南。