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, revise 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 e um status de publicação de Testing recebe um token de atualização que expira em sete dias.
Como lidar O status de publicação do seu projeto do Google é Testing. Portanto, 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.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
ResumoO ID de cliente não é um número.
Causas comuns Usar um ID de cliente inadequado.
Como lidar N/A
Dicas de prevenção 123-456-7890 precisa ser 1234567890. Consulte o artigo Começar para mais detalhes.
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 do 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 para você.
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 de cliente, consulte a documentação dela 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 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 lidar Faça login com uma conta do Google Ads válida (normalmente, sua conta de administrador) no fluxo do OAuth. Também é possível convidar a Conta do Google para acessar uma conta do Google Ads. Para isso, faça login na sua conta de administrador, selecione a conta de cliente ou 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 que possa acessar todas as contas de clientes de uma conta de administrador, é necessário ter o token de atualização para a conta de administrador. Para mais detalhes, consulte nosso guia sobre token de acesso e token de atualização e OAuth2.

AuthorizationError
CUSTOMER_NOT_ENABLED
ResumoNã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 terminou a inscrição ou foi desativada.
Como lidar Faça login na interface do Google Ads e conclua o processo de inscrição dessa conta. Para contas desativadas, consulte Reativar uma conta do Google Ads cancelada.
Dicas de prevenção Você pode verificar proativamente se a conta de um cliente está desativada verificando o status CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
ResumoO token de desenvolvedor só foi aprovado para uso com contas de teste e tentou acessar uma conta que não seja de teste.
Causas comuns Um token de desenvolvedor de teste foi usado para acessar uma conta que não é de teste.
Como lidar Verifique se você realmente quer acessar uma conta que não seja de teste. Em caso afirmativo, solicite o upgrade do seu 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. Quando você faz uma solicitação à API Google Ads, o token de desenvolvedor é pareado permanentemente com o projeto do Console de APIs do Google. 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 lidar N/A
Dicas de prevenção Se você mudar para um token de desenvolvedor em uma nova conta de administrador, será necessário criar um novo projeto do Console de APIs do Google para as solicitações da API Google Ads que usam o token do novo gerente.
USER_PERMISSION_DENIED
ResumoO cliente autorizado não tem acesso ao cliente operacional.
Causas comuns autenticar 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 o login-customer-id como o ID da conta de administrador sem hifens (-). As bibliotecas de cliente são compatíveis com isso.

Anterior
Fazer uma chamada de API
Próxima
Próximas etapas