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, consulte as referências de erro. Se precisar de mais ajuda, entre em contato com o suporte.

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
ResumoO token de acesso do OAuth 2.0 não tem os escopos necessários.
Causas comuns A solicitação é negada porque o token de acesso fornecido não inclui o escopo OAuth 2.0 da API Google Ads.
Como proceder Verifique se o token de acesso tem os escopos necessários. Um motivo comum para esse erro é que você está reutilizando um token de acesso gerado com um conjunto diferente de escopos do OAuth. Consulte os parâmetros de autorização do OAuth para ver um exemplo de como gerar um novo token de acesso com os escopos necessários.
Dicas de prevenção Verifique se o token de acesso tem os escopos necessários. Reautentique o usuário com os escopos necessários para receber um acesso com os escopos necessários. Se o aplicativo usa vários escopos do OAuth, talvez seja necessário implementar permissões granulares do OAuth.

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 Testing recebe um token de atualização com validade de 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 para evitar que o token de atualização expire em sete dias.
Dicas de prevenção Consulte Apps não verificados.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
ResumoEsse 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
ResumoUm 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 de API.
LINE_TOO_WIDE
ResumoUm dos campos em um anúncio era maior do que o comprimento máximo permitido. Consulte Sobre os anúncios de texto.
Causas comuns Ter 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 de API.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS
ResumoEsse 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 proceder 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
ResumoUma operação tentou atualizar um anúncio removido.
Causas comuns Depois que um anúncio é removido, não é possível atualizá-lo, incluindo mudanças no status.
Como proceder N/A
Dicas de prevenção Verifique se seu código não tenta atualizar anúncios removidos.

AdGroupCriterionError
INVALID_KEYWORD_TEXT
ResumoO 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 proceder N/A
Dicas de prevenção Valide o texto da palavra-chave no seu app antes de fazer uma solicitação à API.

AdGroupError
DUPLICATE_ADGROUP_NAME
ResumoUm grupo de anúncio está sendo adicionado ou renomeado, mas o nome já é usado por outro grupo.
Causas comuns Criar um grupo de anúncios com o nome de um grupo de anúncios ativo ou pausado.
Como proceder Registre o erro e apresente uma mensagem de erro ao usuário, sugerindo opcionalmente um nome exclusivo para o grupo de anúncios ou mostrando a lista de nomes em uso.
Dicas de prevenção N/A

AssetError