本页讨论了您在使用 Display & Video 360 API 时可能会遇到的不同类型的错误和警告。
API 错误
如果向 API 发出的请求无法完成，将返回错误消息。返回错误的请求会计入用户配额，并且在审核额外配额的请求时将被纳入考虑范围。您应该处理和处理错误响应，以避免将来出现错误。
错误响应采用以下格式，其中包含 HTTP 响应代码、错误消息和 Google RPC 代码状态：
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
下面列出了常见的 API 错误，以及在返回这些错误时建议采取的操作：
| 编码 | RPC | 建议采取的措施 |
|---|---|---|
400
|
INVALID_ARGUMENT
|
您的请求存在一些问题。请查看错误响应中的消息字段，并相应地修改您的请求。 |
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 的上下文中。
- 确保您未超出每位用户最多二十个并发 SDF 下载任务的限制。
如果您仍然遇到错误，请与支持团队联系以报告您的问题。
非阻塞警告
系统会为订单项分配非阻塞警告，以指示可能会影响订单项投放的问题。类似的警告会通过通知横幅在界面中传达。这些警告是被动警告，并且会列在订单项的 warningMessages 字段中。
虽然是被动问题，但导致这些警告的问题可能会影响订单项的投放，导致订单项完全无法投放。
预防
通过正确配置订单项设置，可以避免许多会导致非阻塞警告的问题，其中包括：
- 排期：如果订单项的排期无效，或者父级广告订单的排期已过期，该订单项会生成警告，且不会投放。为避免后一种问题，请确保订单项的排期的结束日期不会晚于其父级广告订单的排期。
- 已分配的广告素材：如果没有为订单项分配有效的广告素材，该订单项便会生成警告，并且不会投放。
- 定位条件：如果未正确分配订单项的定位条件，该订单项可能会生成警告，并可能会受到或完全阻止其投放。
如果您要从现有订单项复制配置，请确保现有订单项不会生成任何意外警告。
Monitoring
在订单项投放期间，可能会出现导致非阻塞警告的问题。为了确保您的订单项正确投放，请监控有效订单项是否出现了新生成的警告。您可以使用 advertisers.lineItems.list 函数批量检索订单项。如果某个订单项生成了意外警告，您应立即解决问题，以减少对投放的影响。
即使订单项的设置或定位条件并未更改，也可能会出现一些问题。 例如，父级广告订单被暂停或过期，以及弃用用户名单或其他定位条件。