APIs avançadas

Com as APIs avançadas nos scripts do Google Ads, os desenvolvedores podem se conectar a determinadas APIs públicas do Google com menos configuração do que usando as interfaces HTTP. É possível usar essas APIs como os serviços integrados dos scripts, e elas oferecem as mesmas conveniências, como preenchimento automático e autorização automática.

Consulte nossa página de snippets de código para ver alguns exemplos de como usar essas APIs.

APIs avançadas disponíveis

Google Analytics

Você pode usar o Google Analytics para acompanhar o tráfego que chega ao seu site e ajustar os lances da campanha de acordo. Se você vincular uma propriedade do Google Analytics à sua conta do Google Ads, também poderá analisar a atividade dos clientes no seu site. Essas informações podem indicar qual parcela do tráfego ou das vendas do seu site é gerada pelo Google Ads. Assim, é possível melhorar seus anúncios e seu site. Saiba mais sobre como vincular contas do Analytics e do Google Ads no guia da Central de Ajuda Configurar o Google Analytics para um site e/ou app.

Google BigQuery

É possível carregar grandes quantidades de dados no Google Cloud Storage e consultar esses dados usando o Google BigQuery. Por exemplo, você pode carregar dados públicos de clima dos últimos 10 anos e consultar a temperatura média de uma região em um script que usa essas informações para ajustar os lances. Outro uso seria fazer cálculos com os dados de performance da sua conta ao longo de vários anos.

Google Agenda

O script pode criar eventos para tarefas futuras (por exemplo, gerar um relatório de performance das suas campanhas daqui a duas semanas) ou realizar ações com base em uma entrada criada na sua agenda (por exemplo, ativar uma campanha em uma data específica).

Google Slides

Seu script pode exportar detalhes ou estatísticas da campanha para o Google Apresentações para publicar essas informações em um formato apresentável.

Google Tarefas

O script pode criar uma lista de lembretes para tarefas futuras (por exemplo, gerar um relatório de performance das suas campanhas daqui a duas semanas) ou realizar ações com base em uma entrada criada na lista (por exemplo, ativar uma campanha em uma data específica).

API Merchant

Seu script pode usar a API Merchant para fazer upload e gerenciar as informações dos produtos e as contas do Google Merchant Center. Em scripts, isso pode ser útil para verificar as informações dos produtos e vincular produtos específicos a anúncios específicos. A API Merchant tem sub-APIs que podem ser ativadas individualmente na caixa de diálogo APIs avançadas. Saiba como vincular sua conta do Google Merchant Center no guia Registrar-se como desenvolvedor.

Conteúdo do Shopping

Seu script pode usar a API Content for Shopping do Google para fazer upload e gerenciar as informações dos produtos e as contas do Google Merchant Center. Em scripts, isso pode ser útil para verificar as informações dos produtos e vincular produtos específicos a anúncios específicos. Observação:a API Content for Shopping será desativada em 18 de agosto de 2026. Em vez disso, use a API Merchant, que é descrita na seção anterior.

YouTube e YouTube Analytics

Você pode recuperar e atualizar seus vídeos, playlists etc., além dos dados de performance dos seus vídeos para tomar decisões de lances.

Ativar APIs avançadas

Para ver quais APIs do Google estão disponíveis como APIs avançadas, clique no botão APIs avançadas na barra de edição superior.

A caixa de diálogo APIs avançadas é exibida. Marque as APIs que você quer ativar.

Em seguida, clique no link Console de APIs do Google para abrir a página Console de APIs no console, com o projeto associado ao seu script. Se o projeto ainda não estiver selecionado, escolha na lista suspensa "Projeto". Pesquise as APIs que você quer usar no script inserindo o nome delas na barra de pesquisa.

Nos resultados da pesquisa, selecione a API e, na página seguinte, escolha Ativar. Se você encontrar um botão Desativar, significa que a API já está ativada. Repita essa ação para cada API que você deseja ativar.

Para conferir a lista de APIs ativadas para o projeto, selecione a página Painel. Verifique se todas as APIs avançadas que você quer usar no script estão listadas.

Agora, feche a caixa de diálogo "APIs avançadas" para retornar ao editor. As novas APIs serão ativadas para seu script e estarão disponíveis na lista de preenchimento automático.

Considerações finais

Há algumas coisas a serem consideradas ao trabalhar com as APIs avançadas.

ID do projeto

Cada script do Google Ads tem um ID do projeto do Google Cloud (também conhecido como número do projeto) associado a ele. Para encontrar o número do projeto do script, abra a página do console de APIs do Google na caixa de diálogo APIs avançadas. Esse ID do projeto é criado quando você cria o script e está vinculado ao usuário que o criou. Se o usuário que criou o script for removido da conta, um usuário que tentar acessar o script vai precisar autorizar o script novamente e configurar as dependências avançadas da API. Um novo ID de projeto do Google Developers também será criado, e você precisará configurar as APIs avançadas novamente, conforme explicado anteriormente neste documento.

Dependências

Somente o usuário que criou o script na conta pode mudar as dependências das APIs avançadas.

Permissões

Ao acessar as APIs, um script usa as permissões do usuário que autorizou o script. Confira se o usuário que autorizou o script tem o acesso necessário a todas as APIs avançadas usadas e aos dados de que o script precisa. Se você estiver usando a API Google Analytics, verifique se o usuário que autorizou o script tem as permissões necessárias para a conta do Analytics que está sendo acessada.

Termos e Condições

Cada uma das APIs avançadas pode ter Termos e Condições próprios, que você precisa aceitar ao ativar a API no console de APIs do Google.

Cota

A maioria das APIs avançadas tem uma cota diária sem custo financeiro associada. Quando o script exceder essa cota, a API vai parar de funcionar até que você solicite mais dados ou a cota sem custo financeiro seja renovada. É possível monitorar a cota usada pelo script abrindo o Console de APIs do Google para o script na caixa de diálogo APIs avançadas. O Console de APIs do Google também oferece uma maneira de solicitar cota adicional para a API.

Faturamento

Algumas APIs avançadas exigem que você pague pelo uso. Esses pagamentos são gerenciados pelo projeto do Google Cloud associado ao seu script, e não pelo Google Ads. Consulte nossa documentação para mais detalhes sobre como ativar o faturamento no projeto na nuvem do Google Cloud do seu script.