Guida rapida di Google Apps Script

Completa i passaggi descritti nel resto di questa pagina e in pochi minuti potrai utilizzare un semplice Google Apps Script che invia richieste all'API di dati di YouTube.

L'applicazione di esempio mostra come aggiungere i dati dei canali YouTube a un foglio di lavoro.

Prerequisiti

Per eseguire questa guida rapida, devi disporre di:

  • Accesso a Internet e a un browser web.
  • Un Account Google.
  • Accesso a Google Drive.

Passaggio 1: crea lo script

  1. Apri Google Drive nel tuo browser web.
  2. Fai clic su Nuovo > Fogli Google.
  3. Nel nuovo foglio di lavoro, fai clic su Estensioni > Apps Script.
  4. Sostituisci i contenuti dell'editor di script con il seguente codice: 
    // 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. Fai clic su Salva .
  6. Fai clic su Progetto senza titolo in alto a sinistra, digita Avvio rapido e fai clic su Rinomina.

Passaggio 2: attiva l'API YouTube Data

  1. Fai clic su Editor a sinistra.
  2. A sinistra, accanto a "Servizi", fai clic su Aggiungi un servizio .
  3. Fai clic su API YouTube Data, quindi su Aggiungi.

Passaggio 3: esegui l'esempio

  1. Ricarica il foglio di lavoro. Se è la prima volta che carichi il foglio di lavoro dopo aver aggiunto il codice, la prima riga dovrebbe essere completata con le intestazioni ID, Titolo e Numero di visualizzazioni.

  2. Nella barra dei menu, fai clic su Dati di YouTube > Aggiungi dati GoogleDevelopers per aggiungere informazioni sul canale GoogleDevelopers al foglio di lavoro. Il menu Dati di YouTube dovrebbe apparire accanto ai menu standard: File, Modifica, Visualizza e così via.

    La prima volta che esegui l'esempio, ti verrà richiesto di autorizzare l'accesso:

    1. Fai clic su Esamina autorizzazioni.
    2. Scegli un account.
    3. Fai clic su Consenti.

  3. Nella barra dei menu, fai clic su Dati di YouTube > Aggiungi dati del canale per aggiungere i dati relativi a un canale di tua scelta. Quando richiesto, inserisci il nome del canale (ad es. "GoogleDevelopers" o "SaturdayNightLive") e fai clic su OK. Lo script recupera i dati relativi al canale e lo aggiunge al foglio di lavoro.

Per approfondire

Risoluzione dei problemi

Error di riferimento: "[API API]" non è definito

Questo errore si verifica quando l'API non è stata attivata nell'editor di codice Apps Script. Torna al passaggio 2.b e assicurati che l'opzione di attivazione/disattivazione corrispondente sia impostata su on.