问题排查

在很多情况下,您都可能会在使用 展示广告与Video 360 API。这可能与代码中的错误、无效的用户输入或 甚至是 API 本身的问题无论出于什么原因, 排查错误是开发过程的一个重要环节。本指南 将为您提供一些最佳做法提示,帮助您快速入门。

基础知识回顾

  1. 查看前提条件指南。确保您有权访问 展示广告与Video 360 和正确配置的 API 项目。
  2. 如果您的响应包含 HTTP 错误,请务必仔细查看这些错误 并确保向正确的 API 和服务发出请求。
  3. 查看授权指南。请确保您的请求包含 所需的 OAuth 2.0 凭据
  4. 验证您使用的凭据是否正确。请参阅 设置您的应用指南,详细了解如何生成 身份验证凭据。您还可以将访问令牌传递给 Google OAuth2 API 的 tokeninfo 端点可验证该端点 已发布到正确的 API 项目,并针对正确的范围授权:

    POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}
    
    200 OK
    
    {
     "issued_to": "{API_PROJECT_CLIENT_ID}",
     "audience": "...",
     "scope": "{API_SCOPES}",
     "expires_in": ...
    }
    

了解错误

当 API 遇到错误时,它通常会返回一个 JSON 响应,其中包含 一个 error 对象。此对象可提供有关特定行业的 错误。

{
 "error": {
  "code": 404,
  "message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
  "status": "NOT_FOUND"
 }
}

通常,error 对象的内容将包含足够的信息, 可帮助您找出问题所在。如果不是,您可能需要 以便弄清错误的意义

研究错误

  1. 请参阅常见错误部分,其中 了解一些最常见错误的详细信息。

  2. 如果“常见错误”部分未涵盖该错误,请参阅 参考文档,并尝试搜索错误代码, 状态和消息

  3. 如果您遇到未记录到的任何错误,请告知我们。

确定根本原因

至此,您已经确定了错误并了解了错误的含义。否则, 您可以回到了解错误部分, 如果您认为自己遇到了 API 错误,请获取帮助 您无法自行修复这类问题

您需要先找出导致该错误的原因,然后才能修正该错误。经常 则可能是代码中的错误或输入值无效。

要确定问题是否与代码中的 bug 有关,您需要 首先应验证您的代码是否按预期工作。首先 建议查看导致测试失败的代码部分, 检查是否存在明显问题。在某些情况下,您可能需要使用 调试工具逐行检查代码,确保其能够正常运行 正确。

检查 HTTP 请求是发现潜在错误的另一种实用方法, 以及出现无效输入的情况。许多官方客户端库 配置为记录 HTTP 请求和响应;请查看 获取更多信息HTTP 代理(如 CharlesSquidFiddler 也可用于捕获请求和响应日志。获得这些 请查看日志,确保 您的申请信息正确且符合预期。

确定导致错误的 bug 或无效输入后, 问题就很明显了如果您遇到问题或不确定如何 但您可以在学习过程中 以获取帮助。

获取帮助

如果您无法自行解决错误,可以与我们的支持团队联系 此表单(位于展示广告系列和Video 360 帮助中心。

填写此表单时,您应提供尽可能多的信息 和已经执行过的问题排查步骤 。有用的信息包括:

  • HTTP 请求和响应日志。请务必隐去敏感信息 例如 OAuth 2.0 访问令牌、电子邮件地址等
  • 代码段。如果您能将问题隔离到 或怀疑问题与特定语言相关,请加入一小段代码, 清晰明了地说明你正在做什么
  • 其他信息,例如运行时/解释器版本和平台 这对于尝试重现问题的其他人可能很有用。

解决问题

在确定问题的原因并找出解决方案后, 来实施修复。请尽可能在 环境(例如专门为广告客户配置 然后针对一系列优质和不良输入进行测试) 生产环境。