Como trabalhar com APIs avançadas

Com os serviços avançados nos scripts do Google AdWords, os desenvolvedores experientes podem se conectar com 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 conveniências, como preenchimento e autorização automáticos.

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 website e ajustar os lances da sua campanha da forma adequada. Se vincular uma propriedade do Google Analytics à sua conta do Google AdWords, você também poderá analisar a atividade do cliente no seu website. Essas informações podem indicar qual parcela das vendas ou do tráfego do seu website é gerada pelo Google AdWords. Assim, é possível aprimorar seus anúncios e website. Aprenda mais sobre como vincular as contas do Google Analytics e do Google AdWords na nossa 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, você pode carregar dados meteorológicos públicos dos últimos dez anos e, em seguida, consultar a temperatura média de uma região em um script que usa essas informações no ajuste dos lances. Outra aplicação seria fazer uma análise detalhada dos dados numéricos relacionados ao desempenho da sua conta ao longo de vários anos.
YouTube e YouTube Analytics
Você pode recuperar e atualizar seus vídeos, listas de reprodução etc., bem como os dados de desempenho dos seus vídeos para tomar decisões de lances.
Google Agenda
Seu script pode criar eventos para tarefas futuras (por exemplo, gerar um relatório de desempenho para suas campanhas de hoje até duas semanas depois) ou realizar ações com base em uma entrada que você criou na sua agenda (por exemplo, ativar uma campanha em uma data específica).
Conteúdo do Shopping
Seu script pode usar a Google Content API for Shopping em Apps Script. Com essa API, os usuários do Google Merchant Center podem fazer o upload das fichas de produtos e gerenciá-las, além de administrar as contas do Google Merchant Center.
Google Tarefas
Seu script pode criar uma lista de lembretes para tarefas futuras (por exemplo, gerar um relatório de desempenho para suas campanhas de hoje até duas semanas depois) 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).
Google Prediction
Você pode usar os dados do histórico para treinar o mecanismo de previsão do Google e realizar a análise de tendências. Por exemplo, se você administra uma farmácia e tem os dados do histórico sobre o clima do dia e a venda de remédios para resfriado, pode treinar um modelo usando o mecanismo de previsão do Google e utilizá-lo para fazer a previsão de vendas em uma determinada temporada. Da mesma forma, se você vende casacos, pode usar os dados do histórico do clima e seus números de vendas para treinar o modelo do mecanismo de previsão do Google. É possível usar a combinação desses dados com a previsão do clima em um determinado dia para prever as vendas do dia, além de ajustar seus lances e orçamentos da forma adequada.

Ativação de APIs avançadas

Para ver quais APIs do Google estão disponíveis como serviços avançados, clique no botão APIs avançadas na parte superior da barra do editor.

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

Em seguida, clique no link Google API Console para abrir a página Gerenciador de API no Console, com o projeto associado ao seu script (se seu projeto não estiver selecionado, escolha-o na lista suspensa do projeto). Para procurar as APIs que você deseja usar no seu script, insira o nome da API na barra de pesquisa.

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

Para visualizar a lista de APIs ativas para o projeto, na página "Visão geral", selecione a guia APIs ativas e verifique se todas as APIs avançadas que você deseja 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 ficarão disponíveis na lista de preenchimento automático.

Quais APIs estão disponíveis?

A partir de agora, 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
Google Fusion Tables https://developers.google.com/apps-script/advanced/fusion-tables
Google Prediction https://developers.google.com/apps-script/advanced/prediction
Conteúdo do Shopping https://developers.google.com/apps-script/advanced/shopping-content
Google Tarefas https://developers.google.com/apps-script/advanced/tasks
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

Lembre-se de algumas informações ao trabalhar com as APIs avançadas.

ID de projeto

Todo script do Google AdWords tem um ID de projeto do Google Developer (também conhecido como número de projeto) associado a ele. Você pode encontrar o número de projeto do seu script abrindo a página do Google Developers Console na caixa de diálogo APIs avançadas. Esse ID de projeto é criado quando você cria o script e está vinculado ao usuário que criou o script do Google AdWords. Se o usuário que criou o script posteriormente for removido da conta e outro usuário tentar acessar o script, solicitaremos que este último autorize o script novamente e reconfigure as dependências da API avançada. Um novo ID de projeto do Google Developer também será criado, e você precisará configurar novamente as APIs avançadas, conforme já explicado neste documento.

Modificação das dependências de APIs avançadas

Apenas o usuário que criou o script na conta pode alterar as dependências das APIs avançadas no script em questão.

Permissões de script

Ao acessar as APIs, o script utilizará as permissões do usuário que o autorizou. Verifique se o usuário que autorizou o script tem o acesso necessário a todas as APIs avançadas que estão sendo utilizadas, bem como aos dados de que o script precisa. Se você usar a Google Analytics API, garanta que o usuário que autorizou o script tenha as permissões necessárias para a conta do Google Analytics que está sendo acessada.

Termos e Condições

Cada API avançada pode ter seus próprios Termos e Condições, que você deve aceitar quando ativar a Google Developers Console API.

Cota

A maioria das APIs avançadas tem uma cota diária gratuita associada a ela. Quando seu script excede essa cota, a API para de funcionar até que você solicite dados adicionais ou que a cota gratuita seja renovada. É possível monitorar a cota usada pelo seu script abrindo o Google Developers Console do script na caixa de diálogo APIs avançadas. O Google Developers Console também fornece uma forma de solicitar cotas adicionais para a API.

Faturamento

Em algumas APIs avançadas, você precisa pagar pelo uso. Esses pagamentos são gerenciados por meio do projeto do Google Developers Console associado ao seu script, e não por meio do Google AdWords. Consulte nossa documentação para ver mais detalhes sobre como ativar o faturamento para o projeto do Google Developers Console do seu script.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.