APIs avançadas

As APIs avançadas nos scripts do Google Ads permitem que os desenvolvedores se conectem a determinadas APIs públicas do Google com menos configuração do que usando as interfaces HTTP. É possível usar essas APIs de maneira semelhante aos 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
Observação: a API avançada Analytics na caixa de diálogo APIs avançadas segmenta a API Universal Analytics v3, que foi desativada, e as solicitações para ela falham. Os scripts do Google Ads não são compatíveis com os serviços avançados AnalyticsData ou AnalyticsAdmin do Google Analytics 4. Para consultar dados do Google Analytics 4 em um script, envie solicitações HTTPS para a API Google Analytics Data usando o serviço UrlFetchApp e o OAuth 2.0. Também é possível vincular uma propriedade do Google Analytics 4 à sua conta do Google Ads para compartilhar dados de conversão do site e do app diretamente. Para instruções de configuração, consulte o guia de configuração do Analytics.
Google BigQuery
É possível carregar grandes quantidades de dados no Google Cloud Storage e, em seguida, consultar esses dados usando o Google BigQuery. Por exemplo, é possível carregar dados meteorológicos públicos dos últimos 10 anos e consultar a temperatura média de uma região em um script que usa essas informações para ajustar lances. Outro uso seria fazer cálculos com os dados de performance da sua conta ao longo de vários anos.
Google Agenda
Seu 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 as Apresentações Google para publicar essas informações em um formato apresentável.
Google Tarefas
Seu 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 sua lista de lembretes (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. Nos scripts, isso pode ser útil para verificar as informações do produto 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 mais sobre como vincular sua conta do Google Merchant Center no guia Registrar-se como desenvolvedor.
Conteúdo com merchandising
Seu script pode usar a API Content for Shopping para fazer upload e gerenciar suas informações de produtos e contas do Google Merchant Center. Nos scripts, isso pode ser útil para verificar as informações do produto 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
É possível 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 em APIs avançadas na barra superior do editor para exibir a caixa de diálogo APIs avançadas. Selecione as APIs que você quer ativar.

Clique em Salvar para salvar as seleções e voltar ao editor de scripts. As novas APIs serão ativadas para seu script e disponibilizadas na lista de preenchimento automático.

Outras considerações

Há alguns pontos que você precisa considerar ao trabalhar com as APIs avançadas.

Dependências

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

Permissões

Ao acessar APIs avançadas, um script usa as permissões do usuário que o autorizou. O usuário que autoriza precisa ter o acesso necessário a todos os dados de que o script precisa. Por exemplo, para usar a API avançada BigQuery, o usuário autorizador precisa ter as permissões necessárias para o projeto na nuvem de destino do Google Cloud e o conjunto de dados do BigQuery.

Considerações sobre scripts anteriores a maio de 2019

Para scripts criados antes de maio de 2019, talvez seja necessário ativar manualmente as APIs relevantes no projeto do Google Cloud associado ao script. Você vai saber se seu script foi afetado se houver um link para o console do Google Cloud na caixa de diálogo de APIs avançadas.

Ativar APIs avançadas

Para scripts anteriores a 2019, é necessário ativar manualmente cada API avançada que você quer usar no script:

  1. Clique no botão APIs avançadas. Na janela de diálogo a seguir, clique no link para o console do Google Cloud.
  2. Se o projeto ainda não estiver selecionado, selecione-o na lista suspensa "Projeto".
  3. Pesquise as APIs que você quer usar no script inserindo o nome delas na barra de pesquisa.
  4. Selecione a API nos resultados da pesquisa e clique no botão "Ativar" na página seguinte.

Se o usuário que criou o script for removido da conta, qualquer novo usuário que tentar acessar o script precisará ativar as dependências da API avançada novamente e autorizar o script de novo.