常见错误

本页介绍了 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

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

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 帮助社区和我们的博客，及时了解最新的 Ad Manager API 资讯。

反序列化错误

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