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 o uso das 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 que mostram 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 com isso. Se você vincular uma propriedade do Google Analytics à sua conta do Google Ads, também poderá analisar a atividade do cliente no seu site. Essas informações podem indicar qual parcela das vendas ou do tráfego é gerada pelo Google Ads. Assim, é possível aprimorar seus anúncios e seu site. Saiba mais sobre como vincular contas do Analytics e do Google Ads no guia do artigo Configurar o Analytics para um site e/ou app na Central de Ajuda.
- Google BigQuery
- Você pode carregar grandes quantidades de dados no Google Cloud Storage e consultar esses dados usando o Google BigQuery. Por exemplo, é possível 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 desempenho 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
- O script pode exportar detalhes ou estatísticas da campanha para o Google Slides e 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 desempenho 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
- O script pode usar a API Merchant para fazer upload e gerenciar suas fichas de produtos e contas do Google Merchant Center. Nos scripts, isso pode ser útil para verificar as fichas de 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 mais sobre como vincular sua conta do Google Merchant Center no guia Registrar-se como desenvolvedor.
- Conteúdo do Shopping
- O script pode usar a API Content for Shopping do Google para fazer upload e gerenciar suas fichas de produtos e contas do Google Merchant Center. Nos scripts, isso pode ser útil para verificar as fichas de 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. Use a API Merchant, descrita na seção anterior.
- YouTube e YouTube Analytics
- Você pode recuperar e atualizar seus vídeos, playlists etc., bem como os dados de performance dos 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 do editor na parte de cima para mostrar a caixa de diálogo APIs avançadas. Selecione as APIs que você quer ativar.
Clique em Salvar para salvar suas seleções e voltar ao editor de scripts. As novas APIs serão ativadas para o script e estarão disponíveis na lista de preenchimento automático.
Outras considerações
Há algumas coisas a 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 as APIs, um script usa as permissões do usuário que o autorizou. Confira se o usuário que autorizou o script tem o acesso necessário a todos os 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.
Considerações para scripts criados antes de maio de 2019
Para scripts criados antes de maio de 2019, talvez seja necessário ativar manualmente as APIs relevantes no projeto associado do Google Cloud do script. Você saberá se o script foi afetado se vir 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:
- Clique no botão APIs avançadas. Na janela de diálogo a seguir, clique no link para o console do Google Cloud.
- Se o projeto ainda não estiver selecionado, selecione-o na lista suspensa Projeto.
- Pesquise as APIs que você quer usar no script digitando o nome da API na barra de pesquisa.
- 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 vai receber uma solicitação para ativar as dependências de API avançadas novamente, bem como reautorizar o script.