Erros comuns
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página descreve os erros mais frequentes retornados pela API Google Ad Manager. Os erros são retornados no formato Error.REASON:
EntityChildrenLimitReachedError
- Resumo
- O número máximo de filhos permitidos foi atingido e nenhum outro filho pode ser adicionado a essa entidade.
- Soluções recomendadas
- Crie um novo tipo da entidade que atingiu o número máximo permitido de filhos e adicione a entidade filha que você está tentando criar a essa nova entidade.
Por exemplo, se você receber LINE_ITEM_LIMIT_FOR_ORDER_REACHED, será necessário criar um novo pedido e adicionar o item de linha que você está tentando criar a ele.
QuotaError.EXCEEDED_QUOTA
- Resumo
- O número de solicitações feitas por segundo é muito alto e excedeu o
limite permitido.
- Soluções recomendadas
-
- Use métodos em lote, como updateLineItems reunindo alterações localmente e fazendo uma única solicitação para preenchê-las de uma só vez.
- Aguarde cerca de cinco segundos e tente enviar a solicitação novamente. Isso não garante que a solicitação será bem-sucedida. Se ela falhar novamente, tente aumentar o
tempo de espera. Isso é recomendado para aplicativos interativos integrados ao Ad Manager que são usados em tempo real.
- Limite as solicitações a duas por segundo para redes do Ad Manager ou a oito por
segundo para redes do Ad Manager 360. Isso não garante que todas as solicitações serão bem-sucedidas, mas pode ajudar a reduzir o número de vezes que você recebe esse erro. Isso é recomendado para aplicativos integrados ao Ad Manager que não têm interação em tempo real, como a geração de relatórios noturnos.
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
- Resumo
- O usuário tentou criar uma rede de teste usando uma conta que já está associada a uma rede.
- Causas comuns
- O usuário não criou uma nova Conta do Google antes de chamar
NetworkService.makeTestNetwork().
- Soluções recomendadas
- Crie uma nova conta antes de chamar
NetworkService.makeTestNetwork(). Saiba como criar uma rede de teste para mais informações.
AuthenticationError.NETWORK_CODE_REQUIRED
- Resumo
- O usuário não forneceu um
networkCode. Para fazer a solicitação,
é necessário ter um código de rede.
- Causas comuns
- Os códigos de rede são obrigatórios para todas as solicitações, exceto
NetworkService.getAllNetworks() e
NetworkService.makeTestNetwork().
- Soluções recomendadas
- Inclua o código da rede que está sendo endereçada no cabeçalho
da solicitação. Use apenas o código de rede disponível no login da sua conta. O código está disponível no site do Ad Manager da sua conta, na página Administrador > Configurações de rede, ao lado de "Código de rede". Veja mais informações sobre como configurar seu código de rede na página Solicitação XML e cabeçalhos de resposta de SOAP.
AuthenticationError.NETWORK_NOT_FOUND
- Resumo
- Não foi possível fazer a solicitação porque o código de rede fornecido na configuração não foi encontrado no servidor.
- Causas comuns
- Você especificou um código de rede incorreto na sua configuração.
- Soluções recomendadas
- O campo "gatilho" do registro de erros geralmente sugere a rede correta para o usuário.
AuthenticationError.NO_NETWORKS_TO_ACCESS
- Resumo
- O usuário não está associado a uma rede.
- Causas comuns
- Você não ativou sua conta de produção para acesso à API.
- Soluções recomendadas
- Ativar o acesso da API ao ambiente de produção. Consulte Como ativar o acesso à API para mais informações.
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS
- Resumo
- O cliente não está na lista de permissões de acesso à API.
- Causas comuns
- Sua rede não está na lista de permissões da produção, mas você forneceu um código de rede no cabeçalho SOAP.
-
- Soluções recomendadas
- Ative o acesso à API.
-
PermissionError.PERMISSION_DENIED
- Resumo
- O usuário não tem a permissão necessária para a solicitação.
- Causas comuns
-
- Você tentou acessar um objeto que existe em outra rede.
- Você tentou acessar um objeto que existe na sua rede, mas não tem permissão para ler ou atualizar.
- Você tentou executar uma tarefa que exige a ativação de um recurso adicional na sua conta.
- Soluções recomendadas
-
- Se você estiver criando uma interface, indique ao usuário que ele não tem
permissão para realizar essa ação e fale com o
administrador.
- Se você tentou executar uma tarefa, como uma que envolva um recurso exclusivo
premium, para a qual sua rede não tem permissão, fale com o
gerente da conta sobre como ativar esse recurso.
- Por padrão, as redes de teste não são redes do Ad Manager 360,
o que significa que elas não têm os recursos premium encontrados nas redes
do Ad Manager 360. Fale com seu gerente de contas para ativar recursos na rede de teste.
ApiVersionError.UPDATE_TO_NEWER_VERSION
- Resumo
- O aplicativo iniciou uma solicitação que exige uma versão mais recente ou iniciou uma solicitação para uma versão descontinuada.
- Causas comuns
-
- A versão da chamada de API foi descontinuada. Inscreva-se no nosso blog para receber anúncios de suspensão de uso.
- A solicitação que você fez exige uma versão mais recente da API para funcionar.
Geralmente, isso acontece quando um recurso é introduzido na interface e precisa de uma versão mais recente da API para que ela envie o objeto corretamente.
- Soluções recomendadas
-
- Fique por dentro das versões da API e faça upgrades regularmente.
- Inscreva-se no blog para receber notificações sobre descontinuações.
Erro 404
- Resumo
- Sua solicitação não chegou ao servidor.
- Causas comuns
- Sua conexão de Internet ou proxy podem estar mal configurados. A versão da API que você está chamando também pode ter sido desativada.
-
- Soluções recomendadas
- Verifique a configuração da Internet ou do proxy e confira se você está usando uma
versão recente da API. Também é possível atualizar sua biblioteca de cliente para a versão mais recente.
-
- Dicas de prevenção
- Inscreva-se no fórum
da API Ad Manager e confira nosso blog
para ficar por dentro das notícias mais recentes sobre a API Ad Manager.
Erro de desmarcamento
- Resumo
- O XML de SOAP na sua solicitação não estava em conformidade com a especificação
WSDL.
- Causas comuns
- A solicitação contém campos ou entidades não incluídos na especificação WSDL ou no namespace errado.
-
- Há uma incompatibilidade de tipo na solicitação (por exemplo, um campo de número inteiro tem um
valor de string).
-
- Soluções recomendadas
- Verifique se a solicitação está em conformidade com a especificação do WSDL.
-
- Use uma biblioteca de cliente para gerar um SOAP válido e use-o para comparação. Todas as bibliotecas de cliente são compatíveis com a geração de registros de solicitações e respostas de SOAP.
-
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[null,null,["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eThis page lists common Google Ad Manager API errors and offers troubleshooting tips.\u003c/p\u003e\n"],["\u003cp\u003eErrors are categorized by type, such as authentication, permission, and quota errors.\u003c/p\u003e\n"],["\u003cp\u003eEach error description includes a summary, common causes, and recommended handling tips.\u003c/p\u003e\n"],["\u003cp\u003eUsers are encouraged to stay updated on API versions and subscribe to the Ad Manager API forum and blog for the latest news.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing client libraries for generating valid SOAP requests is recommended to avoid unmarshalling errors.\u003c/p\u003e\n"]]],[],null,["# Common Errors\n\nThis page describes the most frequently encountered errors returned by the\nGoogle Ad Manager API. Errors are returned in the format\n`Error.REASON`:\n\n- [`EntityChildrenLimitReachedError`](#EntityChildrenLimitReachedError)\n- [`QuotaError.EXCEEDED_QUOTA`](#QuotaError.EXCEEDED_QUOTA)\n- [`AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`](#AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK)\n- [`AuthenticationError.NETWORK_CODE_REQUIRED`](#AuthenticationError.NETWORK_CODE_REQUIRED)\n- [`AuthenticationError.NETWORK_NOT_FOUND`](#AuthenticationError.NETWORK_NOT_FOUND)\n- [`AuthenticationError.NO_NETWORKS_TO_ACCESS`](#AuthenticationError.NO_NETWORKS_TO_ACCESS)\n- [`AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`](#AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS)\n- [`PermissionError.PERMISSION_DENIED`](#PermissionError.PERMISSION_DENIED)\n- [`ApiVersionError.UPDATE_TO_NEWER_VERSION`](#ApiVersionError.UPDATE_TO_NEWER_VERSION)\n- [404 Error](#404Error)\n- [Unmarshalling Errors](#Unmarshalling)\n\n[Entity limit errors](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError)\n-------------------------------------------------------------------------------------------------------\n\n### `EntityChildrenLimitReachedError`\n\nSummary\n: The maximum number of allowed children has been reached for the entity\n and no more children can be added to that entity.\n\nRecommended handling tips\n: Create a new type of the entity that has reached the max allowed number\n of children and add the child entity you are trying to create to the new one.\n For example if you receive [LINE_ITEM_LIMIT_FOR_ORDER_REACHED](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError.Reason#LINE_ITEM_LIMIT_FOR_ORDER_REACHED),\n then you will need to create a new order and add the line item you are trying\n to create to that new order.\n\n[Quota errors](/ad-manager/api/reference/latest/NetworkService.QuotaError)\n--------------------------------------------------------------------------\n\n### `QuotaError.EXCEEDED_QUOTA`\n\nSummary\n: The number of requests made per second is too high and has exceeded the\n allowable limit.\n\nRecommended handling tips\n:\n - Use batch methods such as [updateLineItems](/ad-manager/api/reference/latest/LineItemService#updateLineItems) by gathering changes locally and making a single request to fulfill those changes all at once.\n - Wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. This is recommended for interactive applications integrating with Ad Manager that are used in real time.\n - Limit requests to 2 per second for Ad Manager networks, or 8 per second for Ad Manager 360 networks. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error. This is recommended for applications integrating with Ad Manager that do not have real time interaction, such as running nightly reports.\n\n[Authentication errors](/ad-manager/api/reference/latest/NetworkService.AuthenticationError)\n--------------------------------------------------------------------------------------------\n\n### `AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`\n\nSummary\n: The user tried to create a test network using an account that already is\n associated with a network.\n\nCommon causes\n: The user did not create a new Google account first before calling\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Create a brand new account before calling\n `NetworkService.makeTestNetwork()`. See [how to create a test network](/ad-manager/api/start#enable_api) for more\n information.\n\n### `AuthenticationError.NETWORK_CODE_REQUIRED`\n\nSummary\n: The user did not provide a `networkCode`. To make the request,\n a network code is required.\n\nCommon causes\n: Network codes are required for all requests except\n `NetworkService.getAllNetworks()` and\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Include the network code of the network being addressed in the request\n header. Only use a network code available to your account login. You can find\n the code on the Ad Manager website for your account, on the Admin \\\u003e Network\n Settings page next to \"Network code\". More information about setting your\n network code can be found on the [SOAP XML request and\n response headers](/ad-manager/api/soap_xml) page.\n\n### `AuthenticationError.NETWORK_NOT_FOUND`\n\nSummary\n: The request could not be made because the network code provided in the\n configuration is not found on the server.\n\nCommon causes\n: You have specified an incorrect network code in your configuration.\n\nRecommended handling tips\n: The \"trigger\" field of the error log will often suggest the correct\n network for the user.\n\n### `AuthenticationError.NO_NETWORKS_TO_ACCESS`\n\nSummary\n: The user is not associated with any network.\n\nCommon causes\n: You have not enabled your production account for API access.\n\nRecommended handling tips\n: Enable API access to your production environment. See [Enabling API Access](/ad-manager/api/start#enable_api) for information.\n\n### `AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`\n\nSummary\n: The customer is not whitelisted for API access.\n\nCommon causes\n: Your network is not whitelisted for production, but you provided a [network code](/ad-manager/api/soap_xml) in the SOAP Header.\n:\n\nRecommended handling tips\n: Enable [API access](/ad-manager/api/start#enable_api).\n:\n\n[Permission errors](/ad-manager/api/reference/latest/NetworkService.PermissionError)\n------------------------------------------------------------------------------------\n\n### `PermissionError.PERMISSION_DENIED`\n\nSummary\n: The user does not have the required permission for the request.\n\nCommon causes\n:\n - You tried to access an object that exists in another network.\n - You tried to access an object that exists in your network, but you don't have permission to read or update.\n - You tried to perform a task that requires an additional feature to enabled on your account.\n\nRecommended handling tips\n:\n - If you are creating a UI, indicate to the user that they did not have permission to perform this action and to speak to their Administrator.\n - If you tried performing a task, such as one involving a premium-only feature that your network does not have permission to do, speak to your account manager about enabling this feature.\n - Remember, test networks are, by default, not Ad Manager 360 networks, meaning that they do not have the premium features found in Ad Manager 360 networks. Speak to your account manager to enable features on your test network.\n\n[Version errors](/ad-manager/api/reference/latest/NetworkService.ApiVersionError)\n---------------------------------------------------------------------------------\n\n### `ApiVersionError.UPDATE_TO_NEWER_VERSION`\n\nSummary\n: The application either: initiated a request that requires a newer version\n to succeed; or initiated a request to a deprecated version.\n\nCommon causes\n:\n - The version of the API call has been deprecated. Please subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) for deprecation announcements.\n - The request you made requires a newer version of the API to succeed. This is often the case where a feature has been introduced in the UI and in order for the API to send the object correctly, it needs a newer version of the API.\n\nRecommended handling tips\n:\n - Stay up to date on API versions; plan on upgrading regularly.\n - Subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) to be notified about deprecations.\n\n404 Error\n---------\n\nSummary\n: Your request did not reach the server.\n\nCommon causes\n: Your internet connection or proxy may be misconfigured. The version of\n the API you are calling may also be sunsetted.\n:\n\nRecommended handling tips\n: Check your internet or proxy configuration and make sure you are using a\n recent version of the API. You may want to upgrade your client library to\n the most recent version as well.\n:\n\nPrevention tips\n: Subscribe to the [Ad\n Manager API forum](//groups.google.com/group/google-doubleclick-for-publishers-api) and check our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api)\n to stay updated on the latest Ad Manager API news.\n\nUnmarshalling Error\n-------------------\n\nSummary\n: The SOAP XML in your request did not conform to the WSDL\n specification.\n\nCommon causes\n: The request contains fields or entities not included in the WSDL\n specification, or in the wrong namespace.\n:\n: There is a type mismatch in the request (e.g., an integer field has a\n string value).\n:\n\nRecommended handling tips\n: Ensure that your request conforms to the WSDL specification.\n:\n: Use a [client library](/ad-manager/api/clients) to generate\n valid SOAP, and use this for comparison. All client libraries support\n logging of SOAP requests and responses.\n:"]]
