Nível de programação: iniciante
Duração: 20 minutos
Tipo de projeto: automação com um acionador baseado em tempo
Objetivos
- Entenda o que a solução faz.
- Entenda o que os serviços do Apps Script fazem na solução.
- Configure o script.
- Execute o script.
Sobre esta solução
Essa solução acompanha o desempenho de vídeos públicos do YouTube, incluindo visualizações, marcações "Gostei" e comentários, em uma planilha do Planilhas Google. O gatilho verifica se há informações atualizadas todos os dias e envia um e-mail se os vídeos têm uma nova atividade de comentário para que você possa interagir com perguntas e comentários.
Como funciona
O script usa o serviço avançado do YouTube para receber detalhes e estatísticas do vídeo do YouTube referentes aos URLs dos vídeos listados na coluna Link do vídeo em cada planilha. Se o número de comentários de um vídeo listado aumentar, o script enviará uma notificação para o endereço de e-mail que leva o nome da planilha.
Serviços do Apps Script
Essa solução usa os seguintes serviços:
- Serviço Planilhas: recebe as informações do URL do YouTube da planilha.
- Serviço avançado da API YouTube Data: mostra os detalhes e as estatísticas do vídeo do YouTube para cada URL de vídeo.
- Serviço de e-mail: cria e envia um e-mail com uma lista de vídeos com novos comentários.
Pré-requisitos
Para usar essa amostra, você precisa dos seguintes pré-requisitos:
- Uma Conta do Google (contas do Google Workspace podem exigir a aprovação do administrador).
- Um navegador da Web com acesso à Internet.
Configurar o script
Criar o projeto do Apps Script
- Clique no botão a seguir para fazer uma cópia da planilha Rastrear visualizações e comentários de vídeos do YouTube. O projeto do Apps Script para
esta solução está anexado à planilha.
Fazer uma cópia - Na planilha copiada, altere o nome da planilha Your_Email_Address para seu endereço de e-mail.
- Adicione os URLs dos vídeos do YouTube que você quer rastrear ou use os URLs fornecidos para
testes. Os URLs precisam começar com o formato
www.youtube.com/watch?v=
. - Clique em Extensões > Apps Script. Se o YouTube já estiver listado em Serviços, pule para as próximas duas etapas.
- Ao lado de Serviços, clique em Adicionar um serviço .
- Na lista, selecione API YouTube Data e clique em Adicionar.
Criar um gatilho
- No projeto do Apps Script, clique em Gatilhos > Adicionar gatilho.
- Em Escolha qual função será executada, selecione markVídeos.
- Em Selecionar origem do evento, escolha Baseado em tempo.
- Em Selecionar o tipo de gatilho baseado em tempo, escolha Timer diário.
- Em Selecionar hora do dia, escolha um horário.
- Quando solicitado, autorize o script. Se a tela de permissão OAuth mostrar o aviso Este app não foi verificado, continue selecionando Avançado > Acessar {Nome do projeto} (não seguro).
Executar o script
O acionador configurado executa o script uma vez por dia. Execute o script manualmente para testá-lo.
- No projeto do Apps Script, clique em Editor .
- No menu suspenso de funções, selecione markVideos.
- Clique em Executar.
- Volte para a planilha para analisar as informações que o script adicionou à planilha.
- Abra seu e-mail para analisar a mensagem com a lista de vídeos que têm mais de nenhum comentário. Quando o script for executado no futuro, ele enviará apenas um e-mail com vídeos cuja contagem de comentários aumentou desde a última execução.
Revisar o código
Para analisar o código do Apps Script para esta solução, clique em Ver código-fonte abaixo:
Ver o código-fonte
Code.gs
email.html
Colaboradores
Esta amostra é mantida pelo Google com a ajuda de especialistas do Google Developers.