Erros comuns

Nesta página, descrevemos os erros mais frequentes retornados pela API Ad Manager. Os erros são retornados no formato Error.REASON:

Erros de limite de entidade

EntityChildrenLimitReachedError

Resumo
O número máximo de filhos permitidos foi atingido para a entidade e não é possível adicionar mais filhos a ela.
Soluções recomendadas
Crie um novo tipo de entidade que tenha atingido o número máximo permitido de filhos e adicione a entidade filha que você está tentando criar à nova. Por exemplo, se você receber LINE_ITEM_LIMIT_FOR_ORDER_REACHED, crie um novo pedido e adicione 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 as mudanças localmente e fazendo uma única solicitação para concluir todas as mudanças de uma só vez.
  • Aguarde cerca de 5 segundos e envie a solicitação de novo. Isso não garante que a solicitação será bem-sucedida. Se falhar de novo, aumente o tempo de espera. Recomendado para aplicativos interativos integrados ao Ad Manager que são usados em tempo real.
  • Limite as solicitações a 2 por segundo para redes do Ad Manager ou 8 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 que se integram ao Ad Manager e não têm interação em tempo real, como a execuçã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 Conta do Google antes de chamar NetworkService.makeTestNetwork().
Soluções recomendadas
Crie uma conta antes de chamar NetworkService.makeTestNetwork(). Consulte 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 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 abordada no cabeçalho da solicitação. Use apenas um código de rede disponível para o login da sua conta. Você pode encontrar o código no site do Ad Manager da sua conta, na página Administrador > Configurações de rede, ao lado de "Código da rede". Para mais informações sobre como definir seu código de rede, acesse a página Cabeçalhos de solicitação e resposta XML 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 "trigger" 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 nenhuma rede.
Causas comuns
Você não ativou sua conta de produção para acesso à API.
Soluções recomendadas
Ative o acesso à API no 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 para acesso à API.
Causas comuns
Sua rede não está na lista de permissões para 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 realizar uma tarefa que exige um recurso adicional ativado na sua conta.
Soluções recomendadas
  • Se você estiver criando uma interface, indique ao usuário que ele não tinha permissão para realizar essa ação e que precisa falar com o administrador.
  • Se você tentou realizar uma tarefa, como uma que envolva um recurso exclusivo para assinantes premium que sua rede não tem permissão para usar, converse com seu gerente de conta sobre a ativação desse recurso.
  • As redes de teste não são redes do Ad Manager 360 por padrão. Isso 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 sua 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 para ser concluída 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 avisos sobre descontinuação.
  • A solicitação feita exige uma versão mais recente da API para ser concluída. Isso geralmente acontece quando um recurso é introduzido na interface e, para que a API envie o objeto corretamente, ela precisa de uma versão mais recente.
Soluções recomendadas
  • Mantenha-se atualizado sobre as versões da API e planeje upgrades regulares.
  • Assine nosso 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 pode estar configurada incorretamente. A versão da API que você está chamando também pode ser desativada.
Soluções recomendadas
Verifique sua configuração de Internet ou proxy e confira se você está usando uma versão recente da API. Também é recomendável fazer upgrade da biblioteca de cliente para a versão mais recente.
Dicas de prevenção
Confira a Comunidade de Ajuda do Ad Manager e nosso blog para ficar por dentro das novidades da API Ad Manager.

Erro de unmarshalling

Resumo
O XML 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 tipos na solicitação (por exemplo, um campo inteiro tem um valor de string).
Soluções recomendadas
Verifique se a solicitação está em conformidade com a especificação WSDL.
Use uma biblioteca de cliente para gerar SOAP válido e use isso para comparação. Todas as bibliotecas de cliente são compatíveis com o registro de solicitações e respostas SOAP.