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();
    }
    
  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.