APIs avançadas

Com as APIs avançadas nos scripts do Google Ads, desenvolvedores experientes podem se conectar a determinadas APIs públicas do Google usando menos configuração do que com as interfaces HTTP. Você usa essas APIs de forma semelhante aos serviços integrados dos scripts, e elas oferecem as mesmas vantagens, como preenchimento e autorização automáticos.

Possíveis aplicações das APIs avançadas

Google Analytics
Use o Google Analytics para acompanhar o tráfego que chega ao seu site e ajustar os lances da campanha conforme necessário. Se você vincular uma propriedade do 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 do seu site é gerada pelo Google Ads. Assim, é possível aprimorar os anúncios e o 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 consultá-los usando o Google BigQuery. Por exemplo, é possível carregar dados meteorológicos públicos dos últimos 10 anos e, em seguida, 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 uma análise detalhada dos dados de performance da sua conta ao longo de vários anos.
YouTube e YouTube Analytics
É possível recuperar e atualizar seus vídeos, playlists etc., bem como os dados de performance dos seus vídeos, para tomar decisões sobre lances.
Google Agenda
O script pode criar eventos para tarefas futuras (por exemplo, gerar um relatório de desempenho para suas campanhas daqui a duas semanas) ou realizar ações com base em uma entrada que você criou na agenda (por exemplo, ativar uma campanha em uma data específica).
Conteúdo do Shopping
Seu script pode usar a API Content for Shopping no Apps Script. Com essa API, os usuários do Google Merchant Center conseguem fazer upload e gerenciar as informações dos produtos e as contas do Merchant Center. Em scripts, isso pode ser útil para verificar as listagens de produtos e vincular produtos específicos a anúncios específicos.
Google Tarefas
Seu script pode criar uma lista de lembretes para tarefas futuras (por exemplo, gerar um relatório de desempenho para suas campanhas a partir de duas semanas a partir de hoje) ou realizar ações com base em uma entrada que você criou na sua lista de lembretes (por exemplo, ativar uma campanha em uma data específica).
Apresentações Google
Seu script pode exportar detalhes ou estatísticas da campanha para o app Apresentações Google para publicar essas informações em um formato apresentável.

Ativar APIs avançadas

Para conferir quais APIs do Google estão disponíveis como APIs avançadas, clique no botão APIs avançadas na parte de cima da barra do editor.

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

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

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

Para ver 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 vão estar 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 (em inglês)
Google Agenda https://developers.google.com/apps-script/advanced/calendar (em inglês)
Apresentações Google https://developers.google.com/apps-script/advanced/slides (em inglês)
Google Tarefas https://developers.google.com/apps-script/advanced/tasks (em inglês)
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

Você também pode consultar nossa página de snippets de código para ver alguns exemplos sobre como usar essas APIs.

Considerações finais

Há alguns pontos a serem considerados ao trabalhar com as APIs avançadas.

ID do projeto

Cada script do Google Ads tem um ID do projeto (também conhecido como número de projeto) do Google Cloud Platform associado a ele. Você pode encontrar o número do projeto do seu script abrindo a página do Console de APIs do Google na caixa de diálogo APIs avançadas. Esse ID é criado quando você cria o script e está vinculado ao usuário que criou o script do Google Ads. Se o usuário que criou o script for removido da conta depois, um usuário que tentar acessar o script receberá uma solicitação para autorizar o script novamente e configurar as dependências da API avançada novamente. 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 alterar as dependências das 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 em uso, bem como aos dados de que o script precisa. Se você usa 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 API avançada pode ter seus próprios Termos e Condições, 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 a ela. Quando o script exceder essa cota, a API deixará 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 cotas adicionais para a API.

Faturamento

Algumas APIs avançadas exigem que você pague pelo uso. Esses pagamentos são gerenciados por meio do 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.