常见错误

本页介绍了 Google Ad Manager API 返回的最常见错误。错误以 Error.REASON 格式返回：

实体限制错误

EntityChildrenLimitReachedError

摘要
已达到该实体允许的子项数上限，无法再向该实体添加子项。
处理建议
为已达到允许的子级数量上限的实体创建一个新类型，并将您尝试创建的子实体添加到新实体中。例如，如果您收到 LINE_ITEM_LIMIT_FOR_ORDER_REACHED，则需要创建一个新订单，并将要创建的订单项添加到该新订单中。

配额错误

QuotaError.EXCEEDED_QUOTA

摘要
每秒发出的请求数量过高，已超出允许的上限。
处理建议
  • 使用 updateLineItems 等批处理方法，在本地收集更改，然后发出一个请求来一次性完成这些更改。
  • 等待大约 5 秒钟，然后重试该请求。请注意，这并不能保证请求一定会成功。如果再次失败，请尝试增加等待时间。对于与 Ad Manager 集成的实时互动式应用，建议使用此选项。
  • 将 Ad Manager 广告联盟限制为每秒 2 次请求，或将 Ad Manager 360 广告联盟限制为每秒 8 次请求。同样，这并不能保证每个请求都会成功，但可能有助于减少您收到此错误的次数。对于没有实时互动（例如生成夜间报表）且与 Ad Manager 集成的应用，建议使用此方法。

身份验证错误

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

摘要
用户尝试使用已与某个广告联盟关联的帐号创建测试广告联盟。
常见原因
在调用 NetworkService.makeTestNetwork() 之前，用户未先创建新的 Google 帐号。
处理建议
在调用 NetworkService.makeTestNetwork() 之前创建一个全新的帐号。如需了解详情，请参阅如何创建测试广告联盟。

AuthenticationError.NETWORK_CODE_REQUIRED

摘要
用户未提供networkCode。如需发出请求，必须提供广告资源网代码。
常见原因
除了 NetworkService.getAllNetworks() 和 NetworkService.makeTestNetwork() 之外，所有请求都需要提供广告联盟代码。
处理建议
在请求标头中添加要处理的网络的网络代码。仅使用适用于您的账号登录信息的广告联盟代码。您可以在 Ad Manager 网站上为您的帐号找到该代码，具体位置在“管理”>“广告资源网设置”页面上的“广告资源网代码”旁边。如需详细了解如何设置网络代码，请参阅 SOAP XML 请求和响应标头页面。

AuthenticationError.NETWORK_NOT_FOUND

摘要
由于未在服务器上找到配置中提供的网络代码，因此无法发出请求。
常见原因
您在自己的配置中指定的广告资源网代码不正确。
处理建议
错误日志的“trigger”字段通常会为用户建议正确的网络。

AuthenticationError.NO_NETWORKS_TO_ACCESS

摘要
用户未与任何广告网络关联。
常见原因
您尚未为生产帐号启用 API 访问权限。
处理建议
启用对生产环境的 API 访问权限。如需了解相关信息，请参阅启用 API 访问权限。

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

摘要
客户不在 API 访问权限的白名单中。
常见原因
您的广告资源网不在生产环境的白名单中，但您在 SOAP 标头中提供了广告资源网代码。
处理建议
启用 API 访问权限。

权限错误

PermissionError.PERMISSION_DENIED

摘要
用户不具备执行请求所需的权限。
常见原因
  • 您尝试访问其他广告资源网中的对象。
  • 您尝试访问广告联盟中存在的对象，但您无权读取或更新。
  • 您尝试执行的任务需要为您的账号启用其他功能。
处理建议
  • 如果您要创建界面，请向用户表明他们无权执行此操作，然后咨询管理员。
  • 如果您尝试执行某项任务，例如涉及您的广告资源网没有相应权限的高级功能，请向您的客户经理咨询如何启用此功能。
  • 请注意，默认情况下，测试广告联盟不是 Ad Manager 360 广告联盟，这意味着它们不含 Ad Manager 360 广告联盟中的高级功能。如需启用测试广告资源网的功能，请与您的客户经理联系。

版本错误

ApiVersionError.UPDATE_TO_NEWER_VERSION

摘要
应用：发起了需要更高版本才能成功的请求；或者发起了对已弃用版本的请求。
常见原因
  • 此 API 调用版本已弃用。请订阅我们的博客，以便接收相关的弃用公告。
  • 您发出的请求需要较新版本的 API 才能成功。这种情况通常发生在界面中，并且为了使 API 正确发送对象，需要更高版本的 API。
处理建议
  • 及时掌握 API 版本的最新动态；做好定期升级计划。
  • 请订阅我们的博客，以便接收相关的停用通知。

404 错误

摘要
您的请求未到达服务器。
常见原因
您的互联网连接或代理可能配置有误。此外，您要调用的 API 版本可能已停用。
处理建议
检查您的互联网或代理配置，并确保您使用的是最新版本的 API。您可能还需要将客户端库升级到最新版本。
预防建议
请订阅 Ad Manager API 论坛并查看我们的博客，及时了解最新的 Ad Manager API 资讯。

取消编组错误

摘要
请求中的 SOAP XML 不符合 WSDL 规范。
常见原因
请求包含未包含在 WSDL 规范中或位于错误的命名空间中的字段或实体。
请求中存在类型不匹配的情况（例如，整数字段包含字符串值）。
处理建议
确保您的请求符合 WSDL 规范。
使用客户端库生成有效的 SOAP，然后使用该 SOAP 进行比较。所有客户端库都支持记录 SOAP 请求和响应。