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
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 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.
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 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
Resumo
Um 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
Resumo
Um 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.
Um 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.
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 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
Resumo
Nenhuma 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.
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 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
Resumo
A 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
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 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.
O 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
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 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.
A 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.
Ocorreu 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
Resumo
Ocorreu 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)
Resumo
O 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.
A 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.
