Esta página descreve os erros mais frequentes retornados pela API Google Ad Manager. Os erros são retornados no formato 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
- Erro 404
- Erros de desmarcação
Erros de limite de entidades
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.
Erros de cota
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.
Erros de autenticação
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()
eNetworkService.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.
Erros de permissão
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.
Erros de versão
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.