Guia de início rápido do Google Apps Script

Conclua as etapas descritas no restante desta página e, em poucos minutos, você terá um Google Apps Script simples que faz solicitações à API YouTube Data.

O aplicativo de exemplo demonstra como adicionar dados do canal do YouTube a uma planilha.

Pré-requisitos

Para executar este guia de início rápido, você precisa de:

  • Acesso à Internet e a um navegador da Web.
  • Uma Conta do Google.
  • Acesso ao Google Drive.

Etapa 1: criar o script

  1. Abra o Google Drive no navegador da Web.
  2. Clique em Novo > Google Planilhas.
  3. Na nova planilha, clique em Extensões > Apps Script.
  4. Substitua o conteúdo do editor de scripts pelo seguinte código: 
    // Note: Apps Script automatically requests authorization
// based on the API's used in the code.

function channelsListByUsername(part, params) {
  var response = YouTube.Channels.list(part,
                                       params);
  var channel = response.items[0];
  var dataRow = [channel.id, channel.snippet.title, channel.statistics.viewCount];
  SpreadsheetApp.getActiveSpreadsheet().appendRow(dataRow);
}

function getChannel() {
  var ui = SpreadsheetApp.getUi();
  var channelName = ui.prompt("Enter the channel name: ").getResponseText();
  channelsListByUsername('snippet,contentDetails,statistics',
                         {'forUsername': channelName});
}

function getGoogleDevelopersChannel() {
  channelsListByUsername('snippet,contentDetails,statistics',
                         {'forUsername': 'GoogleDevelopers'});
}

function onOpen() {
  var firstCell = SpreadsheetApp.getActiveSheet().getRange(1, 1).getValue();
  if (firstCell != 'ID') {
    var headerRow = ["ID", "Title", "View count"];
    SpreadsheetApp.getActiveSpreadsheet().appendRow(headerRow);
  }
  var ui = SpreadsheetApp.getUi();
  ui.createMenu('YouTube Data')
  .addItem('Add channel data', 'getChannel')
  .addSeparator()
  .addItem('Add GoogleDevelopers data', 'getGoogleDevelopersChannel')
  .addToUi();
}
  5. Clique em Salvar .
  6. Clique em Projeto sem título no canto superior esquerdo, digite Início rápido e clique em Renomear.

Etapa 2: ativar a API YouTube Data

  1. À esquerda, clique em Editor .
  2. À esquerda, ao lado de "Serviços", clique em Adicionar um serviço .
  3. Clique em API YouTube Data e em Adicionar.

Etapa 3: executar a amostra

  1. Recarregue a planilha. Se for a primeira vez que você carrega a planilha depois de adicionar o código, a primeira linha será preenchida com os ID, Título e Contagem de visualizações cabeçalhos.

  2. Na barra de menus, clique em Dados do YouTube > Adicionar dados do GoogleDevelopers para incluir informações sobre o canal do GoogleDevelopers na planilha. O menu "Dados do YouTube" vai aparecer ao lado dos menus padrão: "Arquivo", "Editar", "Exibir" etc.

    Na primeira vez que você executar a amostra, será necessário autorizar o acesso:

    1. Clique em Analisar permissões.
    2. Escolha uma conta.
    3. Clique em Permitir.

  3. Na barra de menus, clique em Dados do YouTube > Adicionar dados do canal para incluir dados de um canal de sua escolha. Quando solicitado, insira o nome do canal (por exemplo, "GoogleDevelopers" ou "SaturdayNightLive") e clique em OK. O script recupera os dados desse canal e os adiciona à planilha.

Leitura adicional

Solução de problemas

ReferenceError: "[API NAME]" is not defined

Esse erro ocorre quando a API não está ativada no editor de código do Apps Script. Revise a etapa 2.b e verifique se a opção correspondente está definida como ativada.