常见问题解答

哪些人可以使用结构化数据文件 (SDF) 上传 API 试用版功能?

advertisers.sdfuploadtasks.upload 方法仅 适用于已添加到许可名单的 Google Cloud 项目。

哪些 API 版本支持试用版功能?

SDF 上传 API 试用版仅在 Display &Video 360 API v4 中受支持。

试用版支持哪些 SDF 版本?

我们建议您在使用 SDF 上传 API 试用版时使用 SDF v9.2 或更高版本。

如何判断我的项目是否已添加到许可清单?

在此网址中插入从您的项目生成的 API 密钥,然后将该网址复制并粘贴到浏览器中:

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

如果您看到 API 的 JSON 说明,则表示您的项目已添加到许可名单。如果您看到错误,则表示您的项目尚未添加。

支持哪些客户端库?

只有 Python 版 Google API 客户端库 可用于访问 Display & Video 360 API 试用版功能。请参阅我们的配置步骤,以 创建可使用试用版功能的授权服务对象。

SDF 中的条目数量是否有限制?

SDF 的条目数量上限为 10,000。尝试上传超出此限制的文件会导致错误。

我可以上传的 SDF 数量是否有限制?

Google Cloud 项目每天只能使用 Display &Video 360 API 为每个广告客户上传 30 个 SDF。一天从美国太平洋时区 (PST) 的午夜开始。

如果 advertisers.sdfuploadtasks.upload 请求失败,或者上传 Operation 以错误结束,则尝试不会计入相关配额。

一次可以上传多少个 SDF?

每个 advertisers.sdfuploadtasks.upload 请求只能 上传一个文件。

单个 Display &Video 360 用户一次只能处理 20 个 SDF 上传任务。如果您已上传 20 个文件,则必须等到其中一个文件处理完毕后,才能上传另一个文件。

为什么我会收到 429 错误?

如果您收到 429 错误,则可能是因为您已超出在单个广告客户下每天可以上传的 SDF 数量。请等到第二天,再使用 Display &Video 360 API 在相关广告客户下上传其他 SDF。

如果您认为自己超出了其他配额,请参阅我们的标准 API 使用量 限制,了解限制定义;并参阅我们的配额优化 指南,了解限制配额使用量的最佳实践。