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 conferir 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 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.
Esse operador não pode ser usado com uma subclasse de anúncio.
Causas comuns
Tentativa de 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 da API.
LINE_TOO_WIDE
Resumo
Um dos campos de um anúncio era mais longo do que o comprimento máximo permitido. Consulte Sobre os anúncios de texto.
Causas comuns
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 da API.
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 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 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.
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.
O token do 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, será necessário criar um novo projeto no 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
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.
A solicitação expirou e não foi concluída rápido o suficiente para retornar uma resposta.
Causas comuns
Uma solicitação de pesquisa foi feita e gerou uma resposta muito grande ou uma solicitação de mutação foi 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 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 proceder
Repita as solicitações que falharam com esse erro usando 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 é necessário tentar novamente.
Causas comuns
Esse erro ocorre quando a API encontra um problema temporário internamente.
Como proceder
Repita as solicitações que falharam com esse erro usando 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 com formato inválido.
Causas comuns
Isso acontece ao tentar gerar um token de atualização para um usuário que já recebeu acesso ao aplicativo solicitante. Isso pode acontecer, por exemplo, ao executar o exemplo de geração de credenciais do usuário mais de uma vez para as mesmas credenciais do cliente OAuth e o usuário autorizado.
Como proceder
Para regenerar um token de atualização para uma determinada combinação de credenciais do usuário autorizador e do cliente OAuth, revogue um token de atualização existente. A revogação de um token o torna inutilizável para o acesso à API Google Ads e invalida todos os tokens de acesso que o token de atualização foi usado para gerar.
Dicas de prevenção
Armazene seu 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 modificar ou fazer referência a um recurso que não existe ou foi removido. Ou o nome do recurso fornecido está incorreto.
Como proceder
Use uma solicitação de pesquisa para extrair o nome de um recurso antes de enviar uma solicitação de alteração. Consulte nossos guias da biblioteca de cliente, que incluem documentação sobre como criar nomes de recursos válidos em todas as linguagens com suporte.
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 exceda 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 analisando 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 com 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 2024-12-02 UTC."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]
