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 |
| 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 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.
|
|---|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
| Resumo | Esse operador não pode ser usado com uma subclasse de anúncio. |
|---|
| Causas comuns |
Tentativas de 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 MutateAdGroupAds.
|
|---|
|
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 em um anúncio excede o tamanho máximo permitido. Consulte Sobre anúncios de texto. |
|---|
| Causas comuns |
Uma linha de texto muito longa.
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Valide o tamanho da linha antes de fazer a solicitação de API.
|
|---|
|
|
AD_GROUP_AD_LABEL_ALREADY_EXISTS |
| Resumo | Esse rótulo já está associado a alguns dos anúncios. |
|---|
| Causas comuns |
Tentativa de associar o rótulo a anúncios que já foram associados.
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Primeiro, verifique se o rótulo a ser adicionado já está associado aos anúncios.
|
|---|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD |
| Resumo | Uma operação tentou atualizar um anúncio removido. |
|---|
| Causas comuns |
Depois que um anúncio é removido, ele não pode mais ser atualizado, o que inclui alterações no status.
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Verifique se seu código não tenta atualizar anúncios removidos.
|
|---|
|
|
INVALID_KEYWORD_TEXT |
| Resumo | O texto da palavra-chave contém caracteres inválidos. Consulte Adicionar palavras-chave. |
|---|
| Causas comuns |
O texto da palavra-chave contém caracteres inválidos.
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Validar o texto da palavra-chave no app antes de fazer uma solicitação à API.
|
|---|
|
|
DUPLICATE_ADGROUP_NAME |
| Resumo | 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 um grupo existente ativo ou pausado.
|
|---|
| Como lidar |
Registre o erro e apresente uma mensagem de erro ao usuário. Você pode sugerir um nome exclusivo de grupo de anúncios ou mostrar a lista de nomes em uso.
|
|---|
| Dicas de prevenção |
N/A
|
|---|
|
|
DUPLICATE_ASSET |
| Resumo | Duas operações em uma única solicitação contêm uma operação de criação para um recurso com os mesmos dados binários. |
|---|
| Causas comuns |
Uma solicitação mutate com operações create duplicadas contendo os mesmos dados binários.
|
|---|
| Como lidar |
Crie o recurso em outra solicitação e vincule-o na solicitação seguinte ou use um ID temporário na mesma solicitação.
|
|---|
| Dicas de prevenção |
N/A
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| Resumo | O 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 |
| 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 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 |
| 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 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 |
| 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 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 |
| 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 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.
|
|---|
|
|
CUSTOMER_NOT_ENABLED |
| Resumo | 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 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 |
| Resumo | O 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 |
| Resumo | 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. 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 |
| Resumo | O 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.
|
|---|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
| Resumo | O valor do lance não é um múltiplo exato da unidade mínima da moeda da conta. Por exemplo, US$ 0,015 (15000 em micros) não é um lance válido. |
|---|
| Causas comuns |
N/A
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Verifique se os lances são múltiplos da unidade mínima da moeda da conta.
|
|---|
|
BID_TOO_BIG |
| Resumo | O erro é retornado, mesmo que o lance esteja dentro do orçamento da campanha. |
|---|
| Causas comuns |
N/A
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Verifique se a conta está participando do Google Ad Grants. Nesse caso, restrinja os lances de CPC ao máximo recomendado pelo programa.
|
|---|
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
| Resumo | O valor do orçamento é muito baixo. |
|---|
| Causas comuns |
N/A
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Verifique se o valor do orçamento é maior ou igual à unidade mínima na moeda da conta.
|
|---|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT |
| Resumo | O valor do orçamento terá muitas casas decimais quando convertido de um valor micro para um valor na moeda da conta. |
|---|
| Causas comuns |
N/A
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Verifique se o valor do orçamento é divisível pela unidade mínima da moeda da conta.
|
|---|
|
|
DUPLICATE_CAMPAIGN_NAME |
| Resumo | Uma campanha está sendo adicionada ou renomeada, mas o nome já é usado por outra campanha. |
|---|
| Causas comuns |
Criar uma nova campanha com um nome já existente em uma campanha ativa ou pausada.
|
|---|
| Como lidar |
Registre o erro e apresente uma mensagem de erro ao usuário. Como opção, ele sugere um nome de campanha exclusivo ou mostra a lista de nomes em uso.
|
|---|
| Dicas de prevenção |
N/A
|
|---|
|
|
KEYWORD_HAS_INVALID_CHARS |
| Resumo | Adicionar ou editar palavras-chave que contêm caracteres inválidos. |
|---|
| Causas comuns |
Use caracteres especiais, como ! @ % *, nas palavras-chave.
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Evite usar caracteres não permitidos nas palavras-chave. Consulte Adicionar palavras-chave.
|
|---|
|
|
DUPLICATE_ELEMENT |
| Resumo | A solicitação contém dois parâmetros idênticos e redundantes. |
|---|
| Causas comuns |
N/A
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Remova duplicatas (operações, parâmetros, elementos de lista) antes de fazer a solicitação. Procure campos que tenham a restrição DistinctElements.
|
|---|
|
|
DEADLINE_EXCEEDED |
| Resumo | 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 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 possam ser concluídas mais rapidamente.
|
|---|
| Dicas de prevenção |
Consulte Segmentação para entender como ela pode afetar o tamanho de uma resposta. Esteja ciente das limitações da camada de transporte do gRPC.
|
|---|
|
INTERNAL_ERROR |
| Resumo | 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, 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 uma nova tentativa deve ser realizada. |
|---|
| Causas comuns |
Esse erro ocorre quando a API encontra internamente um problema temporário.
|
|---|
| Como lidar |
Repita todas 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 incorreto. |
|---|
| Causas comuns |
Isso acontece na tentativa de 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 autorizar o usuário.
|
|---|
| Como lidar |
Para gerar novamente um token de atualização para uma determinada combinação de credenciais de cliente OAuth e de usuário, revogue um token de atualização existente. Ao revogar um token, ele não pode ser usado na API Google Ads e invalida todos os tokens de acesso que o token de atualização foi usado para gerar.
|
|---|
| Dicas de prevenção |
Guarde o token de atualização em um local seguro para evitar a necessidade de nova geração.
|
|---|
|
|
RESOURCE_NOT_FOUND |
| Resumo | A solicitação fez referência a um recurso não 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 de recurso fornecido para o recurso está malformado.
|
|---|
| Como lidar |
Use uma solicitação de pesquisa para recuperar o nome de um recurso existente antes de enviar uma solicitação de mutação. Consulte nossos guias da biblioteca cliente, que incluem documentação sobre como construir nomes de recursos válidos em todas as linguagens suportadas
|
|---|
| Dicas de prevenção |
Não crie nomes de recursos manualmente. Use um dos métodos auxiliares oferecidos por nossas bibliotecas de cliente.
|
|---|
|
|
EMPTY_LIST |
| Resumo | Uma lista obrigatória está vazia. |
|---|
| Causas comuns |
Transmitir uma lista de operações vazia para um método mutate.
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
N/A
|
|---|
|
|
RESOURCE_EXHAUSTED |
| Resumo | Um limite de frequência do sistema foi excedido. |
|---|
| Causas comuns |
N/A
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Configure atrasos curtos entre solicitações ou combine mais operações em menos solicitações.
|
|---|
|
|
TOO_LOW |
| Resumo | Um valor é mais baixo do que o mínimo permitido. |
|---|
| Causas comuns |
Esquecer de especificar um ID, o que resulta na transmissão de um valor 0.
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
Verifique se há limitações de período documentadas na referência da API.
|
|---|
|
|
INVALID_INPUT |
| Resumo | A solicitação está formatada incorretamente. |
|---|
| Causas comuns |
O URL ou conteúdo da solicitação está incorreto.
|
|---|
| Como lidar |
N/A
|
|---|
| Dicas de prevenção |
N/A
|
|---|
|
REQUIRED_FIELD_MISSING |
| Resumo | A solicitação não tem informações obrigatórias. |
|---|
| Causas comuns |
Campos obrigatórios ausentes durante a tentativa de adicionar uma entidade.
|
|---|
| Como lidar |
Registre o erro e mostre uma mensagem ao usuário. O atributo fieldPath do erro indica qual campo está ausente.
|
|---|
| Dicas de prevenção |
Consulte a referência da API para saber quais campos são obrigatórios.
|
|---|
|
|
RESOURCE_LIMIT |
| Resumo | A solicitação está tentando criar um recurso que faria com que o número total desses recursos excedesse um limite especificado. |
|---|
| Causas comuns |
Há vários limites para o número de recursos que podem existir em determinados contextos.
|
|---|
| Como lidar |
Identifique o limite encontrado em Limites do sistema. Reutilize um recurso atual ou remova recursos para criar espaço para novos.
|
|---|
| Dicas de prevenção |
Usar consultas de pesquisa para monitorar o número de recursos com limitações.
|
|---|
|
|
TOO_LONG |
| Resumo | A string atribuída ao campo especificado é maior que o limite. |
|---|
| Causas comuns |
Os títulos ou as descrições dos anúncios contêm muito texto.
|
|---|
| Como lidar |
Identifique o limite que está sendo encontrado, modifique a string de acordo e reenvie a solicitação.
|
|---|
| Dicas de prevenção |
Esteja ciente dos limites de tamanho de string.
|
|---|
|
