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

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

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

Pré-requisitos

Para executar este guia de início rápido, você vai precisar do seguinte:

  • 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 > Planilhas Google.
  3. Na nova planilha, clique em Extensões > Apps Script.
  4. Substitua o conteúdo do editor de script 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', 'getCh
    annel')
 
         .addSeparator()
  .addItem('Add GoogleDevelopers data', 'getGoogleDevelopersChannel')
  .addToUi();
}
quickstart.gs
  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. Atualize 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 cabeçalhos ID, Título e Número de visualizações.

  2. Na barra de menus, clique em Dados do YouTube > Adicionar dados do GoogleDevelopers para incluir informações sobre o canal GoogleDevelopers na sua 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 Revisar 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 informações de um canal da sua escolha. Quando solicitado, digite 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 foi ativada no editor de código do Apps Script. Revise a etapa 2.b e verifique se a chave correspondente está definida como ativada.