常见问题解答

哪些人可以访问结构化数据文件 (SDF) 上传 API 试点功能?

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

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

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

该小规模测试支持哪些 SDF 版本?

使用 SDF 上传 API 试验版时,我们建议您使用 SDF v9.2。 如果您要从低于 SDF v9 的版本迁移,请参阅 v9 迁移指南

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

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

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

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

支持哪些客户端库?

只有 Python 版 Google API 客户端库可用于访问 { api_name } 实验性功能。请参阅我们的配置步骤,创建可使用 Beta 版功能的授权服务对象。

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 用量限额,了解限额定义;并参阅我们的配额优化指南,了解有关限制配额用量的最佳实践。