本页讨论了您可能会遇到的不同类型的错误和警告 在使用展示广告和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 控制台并修改您的
在现有配额内运行的工作流
限制。如需了解详情，请参阅我们的页面
配额优化一文。 如果您的操作无法在 指定每日配额 申请更多配额。 |
500
|
INTERNAL
|
API 出现内部错误。稍等片刻 秒，然后重试请求。如果错误 仍然存在，请与支持团队联系。 |
504
|
DEADLINE_EXCEEDED
|
API 完成请求用时过长。 等待几秒钟，然后重试请求。如果 此错误仍然存在， 与支持团队联系。 |
SDF 错误
展示广告与Video 360 API 使用异步方法
生成和下载结构化数据文件 (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 函数批量创建。如果
某个订单项会生成意外警告，您应解决该问题，
以降低对投放的影响。
即使订单项的设置或定位条件未更改，也可能会出现问题。 例如，父级广告订单的暂停或过期以及 弃用用户名单或其他定位条件。