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, consulte as referências de erros. Para receber mais suporte, acesse nosso
fórum.
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 seguindo estas instruções para evitar que o token de atualização expire em sete dias.
123-456-7890 deve ser 1234567890. Consulte o artigo 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 para todas as chamadas, portanto, especifique um no cabeçalho HTTP. Recomendamos que você use nossas bibliotecas de cliente para lidar com isso.
CUSTOMER_NOT_FOUND
Resumo
Nenhuma conta foi encontrada para o ID de cliente adicionado ao cabeçalho.
Causas comuns
Tentativa de acessar uma conta que acabou de ser criada antes do estabelecimento dela 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 do OAuth. Você também pode convidar a Conta do Google para acessar uma conta existente do Google Ads. Para isso, faça login na sua conta de administrador, selecione a conta de cliente ou administrador em questão, navegue até 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 receber uma credencial que possa acessar todas as contas de cliente em uma conta de administrador, use o token de atualização da conta de administrador. Para mais detalhes, consulte nosso guia sobre token de acesso e token de atualização e OAuth2.
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 nessa conta. Para contas desativadas, consulte Reativar uma conta do Google Ads cancelada.
Dicas de prevenção
Você pode verificar de forma proativa se a conta de um cliente está desativada verificando o status CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
Resumo
O uso do token de desenvolvedor só é aprovado com contas de teste e tenta 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.
O token de desenvolvedor não é permitido com o projeto enviado na solicitação.
Causas comuns
Cada projeto do Console de APIs do Google só pode ser associado ao token de desenvolvedor de uma conta de administrador. Quando você faz uma solicitação à API Google Ads, o token de desenvolvedor é permanentemente pareado com o projeto do Console de APIs do Google. Se não usar um novo projeto do Console de APIs do Google, você receberá um erro DEVELOPER_TOKEN_PROHIBITED ao fazer uma solicitação.
Como proceder
N/A
Dicas de prevenção
Se você estiver mudando 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 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
Autenticando 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 login-customer-id como o ID da conta de administrador sem hifens (-). As bibliotecas de cliente têm suporte integrado para isso.
