Display & Video 360 API 可能会返回多种错误和警告。正常的 API 解决方案必须能够处理这些错误。
API 错误
如果向 API 发出的请求未能执行预期操作，则会返回错误。应捕获并处理错误响应。
API 错误响应包含 HTTP 响应代码、错误消息和 Google RPC 代码状态。其格式如下：
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
以下是常见 API 错误和建议的操作：
| 错误代码 | |
|---|---|
400 |
INVALID_ARGUMENT您的请求存在问题。查看错误响应中的消息字段，并相应地更新请求。 |
401 |
UNAUTHENTICATED无法正确验证您的请求。验证您是否在请求中包含有效的 OAuth 凭据。如需了解详情，请参阅我们的快速入门指南。 |
403 |
PERMISSION_DENIED您没有完成请求所需的权限。验证您的用户账号是否拥有相关合作伙伴或广告客户的适当权限。 |
404 |
NOT_FOUND找不到您尝试检索的资源。验证您使用的 ID 是否正确，以及是否与正在检索的资源类型相符。 |
409 |
ABORTED您尝试修改的资源正在其他位置被修改。等待几秒钟，然后重试请求。 |
429 |
RESOURCE_EXHAUSTED您已超出速率限制或每日请求配额。使用 Google Cloud 控制台检查 API 使用情况。更新工作流程，使其在现有配额限制范围内运行。如需了解详情，请参阅我们的使用情况优化指南。 |
500 |
INTERNALAPI 遇到了内部错误。等待几秒钟，然后重试请求。如果此错误仍然存在，请与支持团队联系。 |
504 |
DEADLINE_EXCEEDEDAPI 完成请求所需的时间过长。等待几秒钟，然后重试请求。如果此错误仍然存在，请与支持团队联系。 |
SDF 错误
Display & Video 360 API 使用长时间运行的任务来生成结构化数据文件 (SDF)。创建 SDF 时出现的错误会返回到已完成的 operation 中。error 字段将包含详细信息。请参阅以下截断的示例：
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
如果错误消息不明确，我们建议您执行以下操作：
- 验证您的用户是否至少拥有父级合作伙伴或广告客户的标准用户角色。
- 确认过滤条件中提供的 ID 准确无误。 ID 必须与预期资源类型相对应，并且必须是根 ID 的子资源。
- 确保您的用户同时进行的 SDF 下载任务不超过 20 个。
如果您仍然看到错误，请与支持团队联系。
非阻塞性警告
非屏蔽警告表示存在可能会影响订单项广告投放的问题。界面中也会显示类似的警告。这些警告是被动的，并列在订单项中。
警告的根本原因可能会影响订单项的投放。在某些情况下，这可能会完全阻止广告投放。
预防
部分非阻塞性警告是由订单项配置错误引起的：
- 排期：如果订单项的排期无效或其广告订单的排期已过期，则该订单项不会投放广告。确保订单项的排期在相应广告订单的排期内。
- 已分配的广告素材：如果订单项未分配有效的广告素材，则无法投放。
- 定位：如果订单项的定位未正确分配，则可能会影响或完全阻止该订单项的广告投放。
在将现有订单项的配置用于新订单项之前，请确保现有订单项未生成任何警告。
监控
订单项投放期间可能会出现非阻塞性警告。监控有效订单项是否有新警告，确保它们正常投放。使用 list 请求批量获取订单项。如果某个订单项返回了意外警告，请尽快解决相应问题，以减少对投放的影响。
即使设置或定位条件没有变化，系统也可能会添加警告。例如：
- 相应广告订单已暂停或已过期。
- 用户名单或定位选项已被弃用。