Erros comuns

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nesta página, listamos os erros mais comuns e damos dicas sobre como evitá-los e resolvê-los. Para ver uma lista completa de erros, consulte as referências de erros. Para mais suporte, acesse nosso fórum.

google.auth.exceptions.RefreshError

invalid_grant
ResumoO token expirou ou foi revogado.
Causas comuns Um projeto do Google Cloud Platform com uma tela de permissão OAuth configurada para um tipo de usuário externo com status de publicação Testing recebe um token de atualização expirando em sete dias.
Como lidar O status de publicação do seu projeto do Google é Testing, então o token de atualização expira a cada sete dias e recebe um erro invalid_grant. Acesse o Console de APIs do Google e navegue até a tela de permissão OAuth. Em seguida, mude o status de publicação para In production seguindo estas instruções para evitar que o token de atualização expire em sete dias.
Dicas de prevenção Consulte Apps não verificados.

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
ResumoEsse operador não pode ser usado com uma subclasse de anúncio.
Causas comuns Tentando modificar atributos diferentes do status do anúncio.
Como lidar N/A
Dicas de prevenção Não é possível modificar um anúncio depois de criá-lo. Se você quiser modificar o anúncio, é preciso criar um novo e remover o antigo. No entanto, o status do anúncio pode ser modificado usando ValueProviderGroupAds.
INVALID_INPUT
ResumoUm dos campos em um anúncio contém caracteres inválidos.
Causas comuns Usar caracteres especiais em URLs.
Como lidar N/A
Dicas de prevenção Valide os URLs no seu app antes de fazer a solicitação de API.
LINE_TOO_WIDE
ResumoUm dos campos de um anúncio era maior do que o tamanho máximo permitido. Consulte Sobre anúncios de texto.
Causas comuns Ter uma linha de texto muito longa.
Como lidar N/A
Dicas de prevenção Valide o comprimento da linha antes de fazer a solicitação de API.

AdGroupAdError

AD_GROUP_AD_LABEL_ALREADY_EXISTS
ResumoEsse rótulo já está associado a alguns dos anúncios.
Causas comuns Tentando associar o rótulo a anúncios que já foram associados.
Como lidar N/A
Dicas de prevenção Primeiro, verifique se o rótulo a ser adicionado já está associado aos anúncios.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD
ResumoUma operação tentou atualizar um anúncio removido.
Causas comuns Depois que um anúncio é removido, ele não pode mais ser atualizado, o que inclui alterações no status.
Como lidar N/A
Dicas de prevenção Verifique se seu código não tenta atualizar anúncios removidos.

AdGroupCriterionError

INVALID_KEYWORD_TEXT
ResumoO texto da palavra-chave contém caracteres inválidos. Consulte Adicionar palavras-chave.
Causas comuns O texto da palavra-chave contém caracteres inválidos.
Como lidar N/A
Dicas de prevenção Valide o texto da palavra-chave no seu app antes de fazer uma solicitação à API.

AdGroupError

DUPLICATE_ADGROUP_NAME
ResumoUm grupo de anúncio está sendo adicionado ou renomeado, mas o nome já é usado por outro grupo.
Causas comuns Criar um novo grupo de anúncios com o nome de um grupo ativo ou pausado.
Como lidar Registre o erro e apresente uma mensagem de erro ao usuário. Como alternativa, sugira um nome exclusivo para o grupo de anúncios ou mostre a lista de nomes em uso.
Dicas de prevenção N/A

AssetError

DUPLICATE_ASSET
ResumoDuas operações em uma única solicitação contêm uma operação de criação para um recurso com os mesmos dados binários.
Causas comuns Uma solicitação de modificação com operações de criação duplicadas contendo os mesmos dados binários.
Como lidar Crie o recurso em uma solicitação separada e vincule a ele na solicitação seguinte ou use um ID temporário na mesma solicitação.
Dicas de prevenção N/A

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
ResumoO ID de cliente não é um número.
Causas comuns Usar um ID de cliente incorreto.
Como lidar N/A
Dicas de prevenção 123-456-7890 é 1234567890. Veja mais detalhes no guia de início rápido.
CLIENT_CUSTOMER_ID_IS_REQUIRED
ResumoO ID de cliente não foi especificado no cabeçalho HTTP.
Causas comuns Não especificar um ID de cliente no cabeçalho HTTP.
Como lidar N/A
Dicas de prevenção O ID de cliente é obrigatório para todas as chamadas. Portanto, verifique se você especificou um no cabeçalho HTTP. Considere usar nossas bibliotecas de cliente porque elas gerenciam esse processo automaticamente.
CUSTOMER_NOT_FOUND
ResumoNenhuma conta foi encontrada para o ID de cliente adicionado ao cabeçalho.
Causas comuns Tentar acessar uma conta recém-criada antes de ela ser estabelecida no back-end.
Como lidar Aguarde cinco minutos inicialmente e depois repita o processo a cada 30 segundos.
Dicas de prevenção Aguarde alguns minutos após a criação da conta para emitir solicitações nela.
ResumoO token de acesso no cabeçalho da solicitação é inválido ou expirou.
Causas comuns O token de acesso foi invalidado.
Como lidar Solicite um novo token. Se você estiver usando uma de nossas bibliotecas cliente, consulte sua documentação sobre como atualizar o token.
Dicas de prevenção Armazene e reutilize os tokens de acesso até que eles expirem.
NOT_ADS_USER
ResumoA Conta do Google usada para gerar o token de acesso não está associada a uma conta do Google Ads.
Causas comuns As informações de login enviadas correspondem a uma Conta do Google que não tem o Google Ads ativado.
Como lidar Faça login com uma conta válida do Google Ads (normalmente sua conta de administrador) para o fluxo do OAuth. Você também pode convidar a Conta do Google para acessar uma conta do Google Ads. Para isso, faça login na sua conta de administrador, selecione o cliente ou a conta de administrador em questão, acesse Tools and Settings > Access and security e adicione o endereço de e-mail da Conta do Google.
Dicas de prevenção N/A
OAUTH_TOKEN_INVALID
ResumoO token de acesso do Oauth no cabeçalho é inválido.
Causas comuns O token de acesso transmitido no cabeçalho HTTP estava incorreto.
Como lidar N/A
Dicas de prevenção Verifique se você enviou o token de acesso correto associado à sua conta. Às vezes, eles podem ser confundidos com tokens de atualização e códigos de autorização. Se você quiser receber uma credencial de acesso a todas as contas de cliente em uma conta de administrador, gere o token de atualização dessa conta. Para mais detalhes, consulte nosso guia sobre token de acesso e token de atualização e OAuth2.

AuthorizationError

CUSTOMER_NOT_ENABLED
ResumoA conta de cliente não pode ser acessada porque não está em estado ativado.
Causas comuns Isso ocorre quando a conta do cliente não terminou a inscrição ou foi desativada.
Como lidar Faça login na IU do Google Ads e conclua o processo de inscrição para essa conta. Para contas desativadas, consulte Reativar uma conta do Google Ads cancelada.
Dicas de prevenção Para saber se uma conta de cliente foi desativada, confira o status de CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
ResumoO token de desenvolvedor só é aprovado para uso com contas de teste e tentou acessar uma conta que não é de teste.
Causas comuns Um token de desenvolvedor de teste foi usado para acessar uma conta que não é de teste.
Como lidar Confirme se você realmente quer acessar uma conta que não seja de teste. Nesse caso, você precisará solicitar o upgrade do token de desenvolvedor para o acesso padrão ou básico.
Dicas de prevenção N/A
DEVELOPER_TOKEN_PROHIBITED
ResumoO token de desenvolvedor não é permitido com o projeto enviado na solicitação.
Causas comuns Cada projeto do Console de APIs do Google pode ser associado ao token de desenvolvedor de apenas uma conta de administrador. Depois que você fizer uma solicitação da API Google Ads, o token de desenvolvedor será pareado permanentemente ao projeto do Console de APIs do Google. Se você não usar um novo projeto do Console de APIs do Google, um erro DEVELOPER_TOKEN_PROHIBITED será exibido ao fazer uma solicitação.
Como lidar N/A
Dicas de prevenção Se você mudar para um token de desenvolvedor de uma nova conta de administrador, precisará criar um novo projeto do Console de APIs do Google para as solicitações da API Google Ads que usam o token do novo administrador.
USER_PERMISSION_DENIED
ResumoO cliente autorizado não tem acesso ao cliente operacional.
Causas comuns Autenticação como um usuário com acesso a uma conta de administrador, mas sem especificar login-customer-id na solicitação.
Como lidar N/A
Dicas de prevenção Especifique login-customer-id como o ID da conta de administrador sem hifens (-). As bibliotecas de cliente já oferecem suporte a esse recurso.

BiddingError

BID_TOO_MANY_FRACTIONAL_DIGITS
ResumoO valor do lance não é um múltiplo exato da unidade mínima na moeda da conta. Por exemplo, US$ 0,015 (15000 em micros) não é um lance válido.
Causas comuns N/A
Como lidar N/A
Dicas de prevenção Verifique se os lances são múltiplos da unidade mínima para a moeda da conta.
BID_TOO_BIG
ResumoO erro é retornado, mesmo que o lance esteja dentro do orçamento da campanha.
Causas comuns N/A
Como lidar N/A
Dicas de prevenção Verifique se a conta está participando do Google Ad Grants. Se for o caso, restrinja os lances de CPC ao máximo recomendado pelo programa.

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC
ResumoO valor do orçamento é muito baixo.
Causas comuns N/A
Como lidar N/A
Dicas de prevenção Verifique se o valor do orçamento é maior ou igual à unidade mínima na moeda da conta.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
ResumoO valor do orçamento terá muitas casas decimais quando for convertido de um valor micro para um valor na moeda da conta.
Causas comuns N/A
Como lidar N/A
Dicas de prevenção Verifique se o valor do orçamento é divisível pela unidade mínima para a moeda da conta.

CampaignError

DUPLICATE_CAMPAIGN_NAME
ResumoUma campanha está sendo adicionada ou renomeada, mas o nome já é usado por outra campanha.
Causas comuns Criar uma nova campanha com um nome já existente em uma campanha ativa ou pausada.
Como lidar Registre o erro e apresente uma mensagem de erro ao usuário. Como alternativa, sugira um nome de campanha exclusivo ou mostre a lista de nomes em uso.
Dicas de prevenção N/A

CriterionError

KEYWORD_HAS_INVALID_CHARS
ResumoAdicionar ou editar palavras-chave que contêm caracteres inválidos.
Causas comuns Use caracteres especiais, como ! @ % *, nas palavras-chave.
Como lidar N/A
Dicas de prevenção Evite usar caracteres não permitidos nas palavras-chave. Consulte Adicionar palavras-chave.

DistinctError

DUPLICATE_ELEMENT
ResumoA solicitação contém dois parâmetros idênticos e redundantes.
Causas comuns N/A
Como lidar N/A
Dicas de prevenção Remova cópias (operações, parâmetros, elementos de lista) antes de fazer a solicitação. Procure campos que tenham a restrição DistinctElements.

InternalError

DEADLINE_EXCEEDED
ResumoA solicitação expirou e não pôde ser concluída com rapidez suficiente para retornar uma resposta.
Causas comuns Foi feita uma solicitação de pesquisa que gerou uma resposta muito grande ou que uma solicitação de mutação era muito grande para ser processada.
Como lidar Aguarde cerca de 30 segundos e envie a solicitação de novo. Se o erro persistir, tente dividir a solicitação em várias solicitações menores que podem ser concluídas mais rapidamente.
Dicas de prevenção Leia com atenção a segmentação para entender como isso pode afetar o tamanho de uma resposta. Conheça as limitações da camada de transporte do gRPC.
INTERNAL_ERROR
ResumoOcorreu um evento inesperado durante o processamento da solicitação.
Causas comuns A API não está funcionando corretamente devido a um bug.
Como lidar Repita todas as solicitações que falharam com esse erro e use uma programação de espera exponencial para as novas tentativas.
Dicas de prevenção N/A
TRANSIENT_ERROR
ResumoOcorreu um erro interno temporário, e você precisa tentar novamente.
Causas comuns Esse erro ocorre quando a API encontra um problema temporário internamente.
Como lidar Repita todas as solicitações que falharam com esse erro e use uma programação de espera exponencial para as novas tentativas.
Dicas de prevenção N/A

InvalidGrantError

invalid_grant (malformed auth code)
ResumoO código de autorização trocado por tokens OAuth estava incorreto.
Causas comuns Isso acontece ao tentar gerar um token de atualização para um usuário que já recebeu acesso ao aplicativo solicitante. Por exemplo, isso pode acontecer ao executar o exemplo de geração de credenciais de usuário mais de uma vez para as mesmas credenciais de cliente OAuth e a autorização do usuário.
Como lidar Para gerar um novo token de atualização para uma combinação específica de credenciais de usuário e cliente OAuth, revogue um token de atualização existente. A revogação de um token o torna inutilizável para o acesso à API do Google Ads e invalida todos os tokens de acesso que o token de atualização foi usado para gerar.
Dicas de prevenção Armazene o token de atualização em um local seguro para evitar a necessidade de gerar novamente.

MutateError

RESOURCE_NOT_FOUND
ResumoA solicitação se refere a um recurso que não foi encontrado.
Causas comuns A solicitação tentou modificar ou referenciar um recurso que não existe ou foi removido. Ou o nome do recurso fornecido está incorreto.
Como lidar Use uma solicitação de pesquisa para recuperar o nome de um recurso atual antes de enviar uma solicitação de modificação. Consulte os guias da biblioteca de cliente, que incluem documentação sobre como criar nomes de recursos válidos em todos os idiomas compatíveis.
Dicas de prevenção Não crie nomes de recursos manualmente. Use um dos métodos auxiliares oferecidos pelas nossas bibliotecas de cliente.

NotEmptyError

EMPTY_LIST
ResumoUma lista obrigatória está vazia.
Causas comuns Transmitindo uma lista vazia de operações para um método mutate.
Como lidar N/A
Dicas de prevenção N/A

QuotaError

RESOURCE_EXHAUSTED
ResumoUm limite de frequência do sistema foi excedido.
Causas comuns N/A
Como lidar N/A
Dicas de prevenção Configure atrasos curtos entre solicitações ou combine mais operações em menos solicitações.

RangeError

TOO_LOW
ResumoUm valor é mais baixo do que o mínimo permitido.
Causas comuns Esquecer de especificar um ID, o que resulta na transmissão de um valor de 0.
Como lidar N/A
Dicas de prevenção Verifique se há limitações de período documentadas na referência da API.

RequestError

INVALID_INPUT
ResumoA solicitação está formatada incorretamente.
Causas comuns O URL ou o conteúdo da solicitação está incorreto.
Como lidar N/A
Dicas de prevenção N/A
REQUIRED_FIELD_MISSING
ResumoA solicitação não tem informações obrigatórias.
Causas comuns Campos obrigatórios ausentes ao tentar adicionar uma entidade.
Como lidar Registre o erro e apresente uma mensagem de erro ao usuário. O atributo fieldPath do erro indica qual campo está ausente.
Dicas de prevenção Consulte a referência da API para saber quais campos são obrigatórios.

ResourceCountLimitExceededError

RESOURCE_LIMIT
ResumoA solicitação está tentando criar um recurso que faria com que o número total desses recursos excedesse um limite especificado.
Causas comuns Existem vários limites para o número de recursos que podem existir em determinados contextos.
Como lidar Consulte Limites do sistema para identificar o limite encontrado. Reutilize um recurso atual ou remova recursos para criar espaço para novos.
Dicas de prevenção Use consultas de pesquisa para monitorar o número de recursos que têm limitações.

StringLengthError

TOO_LONG
ResumoA string atribuída ao campo especificado é maior que o limite.
Causas comuns Os títulos ou as descrições dos anúncios contêm muito texto.
Como lidar Identifique o limite que está sendo encontrado, modifique a string adequadamente e reenvie a solicitação.
Dicas de prevenção Esteja ciente dos limites de comprimento da string.