As APIs avançadas nos scripts do Google Ads permitem que desenvolvedores experientes se conectem a determinadas APIs públicas do Google com menos configuração do que o uso das interfaces HTTP. Você usa essas APIs de maneira semelhante aos serviços integrados de scripts, e elas oferecem as mesmas facilidades, como preenchimento automático e autorização automática.
Possíveis aplicações das APIs avançadas
- 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 as contas do Google Analytics e do Google Ads na Central de Ajuda.
- 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 os lances. Outro uso seria fazer a computação de números com os dados de desempenho da sua conta ao longo de vários anos.
- YouTube e YouTube Analytics
- É possível recuperar e atualizar vídeos, playlists etc., bem como os dados de performance dos vídeos para tomar decisões de lances.
- Google Agenda
- O script pode criar eventos para tarefas futuras (por exemplo, gerar um relatório de performance para suas campanhas em 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).
- Conteúdo do Shopping
- O script pode usar a API Google Content for Shopping no Apps Script. Essa API permite que os usuários do Google Merchant Center façam upload e gerenciem as listagens de produtos e as contas do Merchant Center. Em scripts, isso pode ser útil para verificar informações de produtos e vincular produtos específicos a anúncios específicos.
- Google Tarefas
- O script pode criar uma lista de lembretes para tarefas futuras (por exemplo, gerar um relatório de performance para suas campanhas daqui a duas semanas) ou realizar ações com base em uma entrada criada na lista de lembretes (por exemplo, ativar uma campanha em uma data específica).
- Apresentações Google
- O script pode exportar detalhes ou estatísticas da campanha para as Apresentações Google e publicar essas informações em um formato apresentável.
Ativar APIs avançadas
Para saber quais APIs do Google estão disponíveis como APIs avançadas, clique no botão APIs avançadas na barra de editor na parte de cima.
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 script. 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.
Nos resultados da pesquisa, selecione a API e, na página seguinte, escolha Ativar. Se um botão Desativar aparecer, 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.
APIs disponíveis
As seguintes APIs estão disponíveis para uso:
| Nome da API | Documentação |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Google Agenda | https://developers.google.com/apps-script/advanced/calendar |
| Apresentações Google | https://developers.google.com/apps-script/advanced/slides |
| Google Tarefas | https://developers.google.com/apps-script/advanced/tasks |
| Conteúdo do Shopping | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
Consulte também nossa página de snippets de código para conferir alguns exemplos de como usar essas APIs.
Considerações finais
É preciso considerar alguns pontos ao trabalhar com as APIs avançadas.
ID do projeto
Cada script do Google Ads tem um ID de projeto (também conhecido como número de projeto) do Google Cloud Platform associado a ele. Para encontrar o número de projeto do script, abra a página do Console de APIs do Google na caixa de diálogo APIs avançadas. Esse ID de projeto é criado quando você cria o script e é vinculado ao usuário que criou o script do Google Ads. Se o usuário que criou o script for removido da conta, um usuário que tentar acessar o script vai receber uma solicitação para reautorizar o script e configurar as dependências da API avançada novamente. Um novo ID de projeto do desenvolvedor do Google 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 de APIs avançadas dele.
Permissões
Ao acessar as APIs, um script usa as permissões do usuário que autorizou o script. Verifique se o usuário que autorizou o script tem o acesso necessário a todas as APIs avançadas usadas, bem como aos dados necessários para o script. Se você estiver usando a API Google Analytics, verifique se o usuário que autorizou o script tem as permissões necessárias para acessar a conta do Analytics.
Termos e Condições
Cada uma das APIs avançadas pode ter os próprios Termos e Condições, que você precisa aceitar ao ativar a API no Google API Console.
Cota
A maioria das APIs avançadas tem uma cota diária gratuita associada a ela. Quando o script ultrapassa essa cota, a API para 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 Google API Console para o script na caixa de diálogo APIs avançadas. O Console de APIs do Google também oferece uma maneira de solicitar mais cota para a API.
Faturamento
Algumas APIs avançadas exigem que você pague pelo uso. Esses pagamentos são gerenciados pelo projeto do Google Cloud Platform associado ao seu script, e não pelo Google Ads. Consulte nossa documentação para mais detalhes sobre como ativar o faturamento do projeto do Google Cloud Platform do seu script.