Erros comuns

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

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Resumo 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. Uma causa comum desse erro é a reutilização de um token de acesso gerado com um conjunto diferente de escopos do OAuth. Consulte os parâmetros de autorização do OAuth para conferir 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. Faça a autenticação novamente do usuário com os escopos necessários para ter acesso a eles. Se o aplicativo usar 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 consentimento do OAuth configurada para um tipo de usuário externo e um status de publicação de 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, então o token de atualização expira a cada 7 dias e recebe um erro invalid_grant. Acesse o Google API Console e navegue até a tela de consentimento do 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.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Resumo O ID de cliente não é um número. Causas comuns Usar um ID de cliente incorreto. Como proceder N/A Dicas de prevenção 123-456-7890 precisa 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 do cliente no cabeçalho HTTP. Como proceder N/A Dicas de prevenção O ID do cliente do cliente é obrigatório para 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 Tentar acessar uma conta que acabou de ser criada antes de ser 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 sobre 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 válida do Google Ads (geralmente a conta de administrador) para o fluxo OAuth. Também é possível convidar a conta do Google para acessar uma conta do Google Ads existente. Para isso, faça login na sua conta de administrador, selecione a conta de cliente ou 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	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 ter uma credencial que possa acessar todas as contas de cliente em uma conta de administrador, confira o token de atualização dela. Para mais detalhes, consulte nosso guia sobre tokens de acesso e de atualização e OAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Resumo O token de desenvolvedor já está associado a uma organização do Google Cloud e não pode ser associado a outra. Causas comuns O token de desenvolvedor não está associado a um projeto do Google Cloud na mesma organização do Google Cloud que o projeto usado para fazer solicitações originalmente. Como proceder Verifique se o ID do cliente OAuth está associado a projetos do Google Cloud na mesma organização do Google Cloud se você já fez solicitações de API com o token de desenvolvedor. Dicas de prevenção Todos os seus projetos do Google Cloud precisam estar associados à mesma organização do Google Cloud. Um projeto do Google Cloud pode ser associado a apenas um token de desenvolvedor, mas um token de desenvolvedor pode ser associado a vários projetos na organização.
DEVELOPER_TOKEN_INVALID	Resumo O token do desenvolvedor é inválido. Causas comuns As causas comuns desse erro incluem erros de digitação no token do desenvolvedor ou a configuração incorreta do token em um cabeçalho de solicitação diferente. Como proceder Copie o token do desenvolvedor do Centro de APIs para evitar erros de digitação. Encontre o Centro da API na sua conta de administrador do Google Ads. Além disso, verifique se você está definindo o token de desenvolvedor no cabeçalho correto. Os tokens do desenvolvedor às vezes são confundidos com tokens de atualização do OAuth e códigos de autorização. Saiba mais sobre os diferentes cabeçalhos de solicitação aqui. Dicas de prevenção N/A

AuthorizationError
CUSTOMER_NOT_ENABLED	Resumo Não é possível acessar a conta do cliente porque ela não está ativa. Causas comuns Isso ocorre quando a conta do cliente não concluiu o processo de 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, verifique se o status é CANCELADO.
DEVELOPER_TOKEN_NOT_APPROVED	Resumo O token de desenvolvedor foi aprovado apenas 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 proceder Confira se você realmente quer acessar uma conta que não seja de teste. Nesse caso, você precisa solicitar o upgrade do token de desenvolvedor para o acesso padrão ou básico. Dicas de prevenção N/A
DEVELOPER_TOKEN_PROHIBITED	Resumo O token de desenvolvedor não é permitido com o projeto enviado na solicitação. Causas comuns Cada projeto do Google API Console pode ser associado ao token de desenvolvedor de apenas uma conta de administrador. Depois que você faz uma solicitação da API Google Ads, o token do desenvolvedor é permanentemente associado ao projeto do console. Se você não usar um novo projeto do Console de APIs do Google, vai receber um erro DEVELOPER_TOKEN_PROHIBITED ao fazer uma solicitação. Como proceder N/A Dicas de prevenção Se você mudar para um token de desenvolvedor em uma nova conta de administrador, vai ser necessário criar um novo projeto no Console de APIs do Google para as solicitações da API Google Ads que usam o token do novo administrador.
USER_PERMISSION_DENIED	Resumo O 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 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.