本页介绍了您在使用 Display & Video 360 API 时可能会遇到的不同类型的错误和警告。
API 错误
对 API 发出的无法完成的请求会返回错误消息。返回错误的请求会计入用户配额,并会在审核额外配额请求时考虑在内。应处理和处理错误响应,以免日后出现错误。
错误响应采用以下格式,并包含 HTTP 响应代码、错误消息和 Google RPC 代码状态:
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
下面列出了常见的 API 错误以及在出现这些错误时建议采取的措施:
代码 | RPC | 建议采取的措施 |
---|---|---|
400
|
INVALID_ARGUMENT
|
您的请求存在一些问题。查看错误响应中的“message”字段,并相应地修改您的请求。 |
401
|
UNAUTHENTICATED
|
无法对您的请求进行正确身份验证。 请验证您是否在请求中添加了有效的 OAuth 凭据。如需了解详情,请参阅我们的入门指南。 |
403
|
PERMISSION_DENIED
|
您没有完成请求所需的权限。验证您的用户账号是否拥有相应合作伙伴或广告客户的适当权限。 |
404
|
NOT_FOUND
|
找不到您尝试检索的资源。请验证您使用的 ID 是否正确,以及是否适用于要检索的资源类型。 |
409
|
ABORTED
|
您尝试修改的资源正在其他位置被修改。请等待几秒钟,然后重试请求。 |
429
|
RESOURCE_EXHAUSTED
|
您已超出速率限制或每日请求配额。使用 Google API 控制台检查您的 API 用量,并修改您的工作流程以在现有配额限制范围内运行。如需了解详情,请参阅配额优化页面。 |
500
|
INTERNAL
|
API 发生了内部错误。请等待几秒钟,然后重试请求。如果此错误仍然存在,请与支持团队联系。 |
504
|
DEADLINE_EXCEEDED
|
API 完成请求所需的时间过长。 请等待几秒钟,然后重试请求。如果此错误仍然存在,请与支持团队联系。 |
SDF 错误
Display & Video 360 API 使用异步方法生成和下载结构化数据文件 (SDF)。因此,在 SDF 生成期间抛出的错误会在完成的 SDF 下载任务中返回。在 error
中完成的 SDF 下载任务被标记为已完成,但 response
字段中填充的是错误字段,而不是媒体资源名称,如以下截断示例所示:
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
如果您在尝试生成 SDF 时收到可操作的错误消息,则应相应地采取行动。如果错误消息没有明确的操作步骤,我们建议您执行以下操作:
- 验证您的用户是否对父级合作伙伴或广告客户资源拥有适当的权限。
- 确认过滤条件中提供的 ID 准确无误、与预期的资源类型相符,并且位于给定根 ID 的上下文中。
- 确保您未超过每位用户 20 个并发 SDF 下载任务的上限。
如果您仍然遇到错误,请与支持团队联系来报告问题。
非阻塞警告
系统会向订单项分配非阻止性警告,以指明可能影响订单项投放的问题。系统会通过通知横幅在界面中显示类似的警告。这些警告是被动的,会列在订单项的 warningMessages
字段中。
虽然这些警告是被动的,但导致这些警告的问题可能会影响订单项的投放,甚至完全阻止其投放。
预防
通过正确配置订单项设置,可以避免许多导致非阻塞警告的问题,包括:
- 投放期:如果订单项的投放期无效,或者父级广告订单的投放期已过,该订单项将生成警告,并且不会投放。为避免出现后一种问题,请确保订单项的排期不晚于其父级广告订单的排期。
- 分配的广告素材:如果订单项未分配有效的广告素材,系统会生成警告,并且订单项将不会投放。
- 定位条件:如果订单项的定位条件未正确分配,系统可能会针对该订单项生成警告,并且投放可能会受到影响或完全无法投放。
如果您要从现有订单项复制配置,请确保现有订单项不会生成任何意外警告。
监控
订单项投放期间可能会出现导致非阻塞警告的问题。为确保您的订单项正常投放,请监控有效订单项,以了解是否有新生成的警告。您可以使用 advertisers.lineItems.list
函数批量检索订单项。如果订单项生成意外警告,您应立即解决此问题,以减少对广告投放的影响。
即使订单项的设置或定位条件没有更改,也可能会出现问题。 例如,父级广告订单暂停或到期,以及用户名单或其他定位条件被弃用。