本页介绍了 Google Ad Manager API 返回的最常见错误。错误会以 Error.REASON 格式返回：
-
EntityChildrenLimitReachedError -
QuotaError.EXCEEDED_QUOTA -
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK -
AuthenticationError.NETWORK_CODE_REQUIRED -
AuthenticationError.NETWORK_NOT_FOUND -
AuthenticationError.NO_NETWORKS_TO_ACCESS -
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS -
PermissionError.PERMISSION_DENIED -
ApiVersionError.UPDATE_TO_NEWER_VERSION - 404 错误
- 解组错误
实体限制错误
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
权限错误
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 请求和响应。