常见问题解答

常规

该 API 的最新版本是什么？

本文档介绍的 API 的最新版本是 v3。

我可以使用此 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 及合作伙伴资源？

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 是否有任何已知问题或限制？

您的项目每秒可以发出的请求数存在限制，请参阅我们的用量限额指南。