Guida rapida di Google Apps Script

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

L'applicazione di esempio mostra come aggiungere i dati del canale 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 il copione

  1. Apri Google Drive nel 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', 'getCh
    annel')
 
         .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 Guida rapida e fai clic su Rinomina.

Passaggio 2: attiva l'API YouTube Data

  1. A sinistra, fai clic su Editor .
  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 il campione

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

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

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

    1. Fai clic su Rivedi 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 di un canale a tua scelta. Quando richiesto, inserisci il nome del canale (ad es. "GoogleDevelopers" o "SaturdayNightLive") e fai clic su Ok. Lo script recupera i dati per quel canale e li aggiunge al foglio di lavoro.

Per approfondire

Risoluzione dei problemi

ReferenceError: "[API NAME]" is not defined

Questo errore si verifica quando l'API non è stata attivata nell'editor di codice Apps Script. Rivedi il passaggio 2b e assicurati che l'opzione corrispondente sia impostata su On.