错误和警告

本页介绍了您在使用 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 函数批量检索订单项。如果订单项生成意外警告,您应立即解决此问题,以减少对广告投放的影响。

即使订单项的设置或定位条件没有更改,也可能会出现问题。 例如,父级广告订单暂停或到期,以及用户名单或其他定位条件被弃用。