Uma nova experiência de integração para desenvolvedores da API Google Ads

Quinta-feira, 10 de setembro de 2026

Para melhorar a experiência de integração e uso dos desenvolvedores, criamos uma nova página inicial para a API Google Ads no Console do Google Cloud. Os aplicativos de acesso básico agora são automatizados para desenvolvedores que concluíram a verificação de marca. Esta postagem do blog aborda várias mudanças relacionadas que vão começar a ser implementadas hoje. Os desenvolvedores precisam consultar a seção ação necessária desta postagem para garantir uma transição tranquila.

Mudanças no gerenciamento de acesso à API

Estamos atualizando a forma como você se inscreve e gerencia o acesso à API Google Ads.

Nova experiência de integração para a API Google Ads: agora é possível se inscrever para acessar a API Google Ads diretamente no console do Google Cloud, sem precisar de uma conta de administrador do Google Ads. Estamos desativando todas as novas funcionalidades de inscrição e gerenciamento de acesso à API na página da Central de APIs nas contas de administrador e migrando para a página de visão geral da API Google Ads no console do Google Cloud. Você ainda pode acessar a página da Central de APIs para consultar os detalhes antigos do desenvolvedor. Esta página será desativada no futuro.

Os níveis de acesso à API estão associados aos projetos na nuvem do Google Cloud: estamos desativando os tokens de desenvolvedor. O nível de acesso atual e ativo do seu token de desenvolvedor é transferido automaticamente para os projetos na nuvem do Google Cloud com base na atividade recente da API. Você pode continuar enviando tokens de desenvolvedor nos cabeçalhos de chamada de API, mas isso é opcional e ignorado pelos servidores de API. Seu código atual vai continuar funcionando sem mudanças. Agora, os níveis de acesso à API são determinados pelo projeto na nuvem do Google Cloud que você usou para gerar as credenciais do OAuth. Consulte nossa página de perguntas frequentes para saber mais sobre essa mudança e resolver problemas que possam surgir.

Novo código de erro: a versão v25 da API Google Ads vai gerar um erro CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION se você tentar usar um projeto do Google Cloud com o nível de acesso à conta de teste para fazer chamadas para uma conta de produção. As versões mais antigas da API vão gerar um erro ACTION_NOT_PERMITTED. Se você encontrar esse erro, acesse a página de visão geral da API Google Ads do seu projeto na nuvem do Google Cloud e solicite acesso ao Explorer.

Mudanças no processo de análise de APIs

Verificação de marca necessária para acesso básico e padrão: para novos aplicativos de acesso básico e padrão, é necessário concluir a verificação de marca do seu projeto do Google Cloud . Os titulares de acesso atuais não precisam concluir a verificação de marca, mas é recomendável que o façam.

Aprovações de acesso básico automatizadas: as solicitações de acesso básico agora são automatizadas e serão analisadas em minutos após a verificação e o envio da marca.

Rejeição única de solicitações de acesso básico pendentes: devido a essas atualizações de processo, todas as solicitações de acesso básico à API pendentes serão encerradas como parte dessa transição. Os candidatos afetados vão receber um e-mail com detalhes e precisarão solicitar novamente o acesso à API na página de visão geral da API Google Ads.

Ação necessária

Verifique seu acesso à API: confira se o nível de acesso à API do seu projeto corresponde ao token de desenvolvedor atual:

  1. Encontre o nível de acesso do seu token de desenvolvedor na Central de API da sua conta de administrador do Google Ads.
  2. Confirme se o projeto na nuvem do Google Cloud tem o mesmo nível de acesso na página de visão geral da API Google Ads.
  3. Se os níveis de acesso não forem iguais, solicite novamente o acesso à API na página de visão geral da API Google Ads ou entre em contato com o suporte da API Google Ads se precisar de ajuda.

Atualize seu endereço de e-mail para contato da API: acesse a página do IAM (Identity and Access Management) do seu projeto na nuvem. Verifique se a lista de usuários nos papéis de proprietário e editor está atualizada. Vamos começar a enviar avisos obrigatórios de serviço (MSAs, na sigla em inglês) para esses endereços de e-mail para informar sobre mudanças futuras na API Google Ads.

Mudanças no código: recomendamos que você atualize o código do aplicativo para deixar de enviar tokens de desenvolvedor como parte das chamadas de API. Publicamos novas versões das bibliotecas de cliente que permitem fazer chamadas de API sem definir um token de desenvolvedor. Vamos começar a rejeitar tokens de desenvolvedor em chamadas de API em uma versão principal futura da API Google Ads.

Solicite novamente o acesso à API, se aplicável: se o seu pedido pendente de acesso básico à API foi encerrado como parte dessa transição, solicite novamente na página de visão geral da API Google Ads do console do Google Cloud.

Publicamos uma documentação atualizada para ajudar você a entender essas mudanças. Para suporte técnico, consulte nossa página de perguntas frequentes ou entre em contato com o suporte da API Google Ads. Se tiver dúvidas ou quiser discutir este post, entre em contato com a gente no servidor do Discord da Comunidade de Publicidade e Medição do Google.

Marcadores: google-ads-api, release