O token de acesso do OAuth 2.0 não tem os escopos necessários.
Causas comuns
A solicitação é negada porque o token de acesso fornecido não inclui o escopo OAuth 2.0 da API Google Ads.
Como proceder
Verifique se o token de acesso tem os escopos necessários. Um motivo comum para esse erro é que você está reutilizando um token de acesso gerado com um conjunto diferente de escopos do OAuth. Consulte os parâmetros de autorização do OAuth para ver um exemplo de como gerar um novo token de acesso com os escopos necessários.
Dicas de prevenção
Verifique se o token de acesso tem os escopos necessários. Reautentique o usuário com os escopos necessários para receber um acesso com os escopos necessários. Se o aplicativo usa vários escopos do OAuth, talvez seja necessário implementar permissões granulares do OAuth.
google.auth.exceptions.RefreshError
invalid_grant
Resumo
O 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 e um status de publicação Testing recebe um token de atualização que expira em sete dias.
Como proceder
O status de publicação do seu projeto do Google é Testing. Por isso, 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 para evitar que o token de atualização expire em sete dias.
Esse operador não pode ser usado com uma subclasse de anúncio.
Causas comuns
Tentando modificar atributos diferentes do status do anúncio.
Como proceder
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 MutateAdGroupAds.
INVALID_INPUT
Resumo
Um dos campos em um anúncio contém caracteres inválidos.
Causas comuns
Usar caracteres especiais em URLs.
Como proceder
N/A
Dicas de prevenção
Valide os URLs no seu app antes de fazer a solicitação de API.
LINE_TOO_WIDE
Resumo
Um dos campos em um anúncio era maior do que o comprimento máximo permitido. Consulte Sobre os anúncios de texto.
Causas comuns
Ter uma linha de texto muito longa.
Como proceder
N/A
Dicas de prevenção
Valide o comprimento da linha antes de fazer a solicitação de API.
123-456-7890 deve ser 1234567890. Consulte Começar para mais detalhes.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Resumo
O 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 proceder
N/A
Dicas de prevenção
O ID de cliente é obrigatório em todas as chamadas. Portanto, especifique um no cabeçalho HTTP. Considere usar nossas bibliotecas de cliente, que fazem isso por você.
CUSTOMER_NOT_FOUND
Resumo
Nenhuma conta foi encontrada para o ID de cliente adicionado ao cabeçalho.
Causas comuns
Tentativa de acessar uma conta recém-criada antes que ela seja estabelecida no back-end.
Como proceder
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.
GOOGLE_ACCOUNT_COOKIE_INVALID
Resumo
O token de acesso no cabeçalho da solicitação é inválido ou expirou.
Causas comuns
O token de acesso foi invalidado.
Como proceder
Solicite um novo token. Se você estiver usando uma das nossas bibliotecas de cliente, consulte a documentação dela para saber como atualizar o token.
Dicas de prevenção
Armazene e reutilize os tokens de acesso até que eles expirem.
NOT_ADS_USER
Resumo
A Conta do Google usada para gerar o token de acesso não está associada a nenhuma 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 proceder
Faça login com uma conta do Google Ads válida (normalmente sua conta de administrador) para o fluxo OAuth. Você também pode convidar a Conta do Google para acessar uma conta do Google Ads fazendo login na sua conta de administrador, selecionando a conta de cliente ou de administrador em questão, navegando até Tools and Settings > Access and security e adicionando o endereço de e-mail da Conta do Google.
Dicas de prevenção
N/A
OAUTH_TOKEN_INVALID
Resumo
O token de acesso do Oauth no cabeçalho é inválido.
Causas comuns
O token de acesso transmitido no cabeçalho HTTP estava incorreto.
Como proceder
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 uma credencial que possa acessar todas as contas de cliente em uma conta de administrador, verifique se você tem o token de atualização da conta de administrador. Consulte o guia de autenticação do usuário.
O projeto do Google Cloud tem acesso somente para teste e não pode ser usado para acessar contas de produção.
Causas comuns
Um projeto na nuvem do Google com o nível de acesso de teste foi usado para fazer uma solicitação em uma conta do Google Ads que não é de teste (produção). Nas versões 24 e anteriores da API, essa condição retorna AuthorizationError.ACTION_NOT_PERMITTED.
Não é possível acessar a conta do cliente porque ela não está ativada.
Causas comuns
Isso ocorre quando a conta do cliente não concluiu a inscrição ou foi desativada.
Como proceder
Faça login na interface do Google Ads e verifique se você concluiu o processo de inscrição para essa conta. Para contas desativadas, consulte Reativar uma conta do Google Ads cancelada.
Dicas de prevenção
Para verificar se uma conta de cliente está desativada, procure o status CANCELLED.
USER_PERMISSION_DENIED
Resumo
O cliente autorizado não tem acesso ao cliente operacional.
Causas comuns
Autenticar como um usuário com acesso a uma conta de administrador, mas não especificar login-customer-id na solicitação.
Como proceder
N/A
Dicas de prevenção
Especifique o login-customer-id como o ID da conta de administrador sem hifens (-). As bibliotecas de cliente têm suporte integrado para isso.
Uma 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 proceder
Registre o erro e apresente uma mensagem ao usuário, sugerindo um nome de campanha exclusivo ou mostrando a lista de nomes em uso.
Dicas de prevenção
N/A
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
Resumo
Tentativa de mudar a configuração de tipo de correspondência de palavra-chave no nível da campanha em uma campanha com a IA Max ativada.
Causas comuns
Com a IA Max ativada, as configurações de correspondência ampla no nível da campanha são descontinuadas porque todas as palavras-chave são tratadas como correspondência ampla por padrão. Tentar definir ou modificar esse campo vai acionar o erro.
Como proceder
Oriente o usuário a usar o parâmetro `disable_search_term_matching` no nível do grupo de anúncios em vez de definir a correspondência ampla no nível da campanha.
Dicas de prevenção
Evite definir "keyword_match_type" como "BROAD" (ou qualquer outro valor) na campanha se "ai_max_setting.enable_ai_max" estiver definido como "true". Ative ou desative a correspondência de termo de pesquisa no nível do grupo de anúncios usando "disable_search_term_matching".
A solicitação expirou e não foi possível concluí-la a tempo de retornar uma resposta.
Causas comuns
Uma solicitação de pesquisa gerou uma resposta muito grande, ou uma solicitação de mutação era muito grande para ser processada.
Como proceder
Aguarde cerca de 30 segundos e reenvie a solicitação. Se o erro persistir, tente dividir a solicitação em várias outras menores que possam ser concluídas mais rapidamente.
Ocorreu um evento inesperado durante o processamento da solicitação.
Causas comuns
A API não está funcionando corretamente devido a um bug.
Como proceder
Tente de novo as solicitações que falharam com esse erro usando um cronograma de espera exponencial para as novas tentativas.
Dicas de prevenção
N/A
TRANSIENT_ERROR
Resumo
Ocorreu um erro interno temporário. Tente de novo.
Causas comuns
Esse erro ocorre quando a API encontra um problema temporário internamente.
Como proceder
Tente de novo as solicitações que falharam com esse erro usando um cronograma de espera exponencial para as novas tentativas.
Dicas de prevenção
N/A
InvalidGrantError
invalid_grant (malformed auth code)
Resumo
O código de autorização trocado por tokens OAuth estava malformado.
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 usuário autorizador.
Como proceder
Para regenerar um token de atualização para uma determinada combinação de usuário autorizador e credenciais de cliente OAuth, revogue um token de atualização atual. Revogar um token o torna inutilizável para acesso à API Google Ads e invalida todos os tokens de acesso que foram gerados com ele.
Dicas de prevenção
Armazene o token de atualização em um local seguro para evitar a necessidade de regeneração.
A solicitação se referia a um recurso que não foi encontrado.
Causas comuns
A solicitação tentou mudar ou referenciar um recurso que não existe ou foi removido. Ou o nome do recurso fornecido está malformado.
Como proceder
Use uma solicitação de pesquisa para extrair o nome de um recurso antes de enviar uma solicitação de mutação. Consulte nossos guias da biblioteca de cliente, que incluem documentação sobre como criar nomes de recursos válidos em todas as linguagens 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.
A solicitação está tentando criar um recurso que faria com que o número total desses recursos excedesse um limite especificado.
Causas comuns
Há vários limites para o número de recursos que podem existir em determinados contextos.
Como proceder
Identifique o limite que está sendo encontrado revisando os Limites do sistema. 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2026-09-29 UTC."],[],[]]
