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 de dados do YouTube.

Com o aplicativo de amostra, é possível adicionar dados de um canal do YouTube a uma planilha.

Pré-requisitos

Para executar este guia de início rápido, você 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 seu 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', 'getChannel')
          .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 Guia de 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 esta for a primeira vez que você carrega a planilha após adicionar o código, a primeira linha precisa ser preenchida com cabeçalhos ID, Title e View count.

  2. Na barra de menus, clique em Dados do YouTube > Adicionar dados do Google Developers 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", "Ver" etc.

    Na primeira execução da amostra, você precisará 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 inserir os dados de um canal. 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]" não foi definido

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 o botão correspondente está definido como on.