Krótkie wprowadzenie do Google Apps Script

Wykonaj czynności opisane na końcu tej strony, a za kilka minut otrzymasz prosty Google Apps Script, który będzie wysyłał żądania do YouTube Data API.

Przykładowa aplikacja pokazuje, jak dodać dane kanału YouTube do arkusza kalkulacyjnego.

Wymagania wstępne

Aby uruchomić ten krótki przewodnik, musisz mieć:

  • Dostęp do internetu i przeglądarki.
  • Musisz mieć konto Google.
  • Dostęp do Dysku Google.

Krok 1. Utwórz skrypt

  1. Otwórz Dysk Google w przeglądarce.
  2. Kliknij Nowy > Arkusze Google.
  3. W nowym arkuszu kalkulacyjnym kliknij Rozszerzenia > Apps Script.
  4. Zastąp zawartość edytora skryptem tym kodem:
    // 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. Kliknij Zapisz .
  6. Kliknij Projekt bez tytułu w lewym górnym rogu, wpisz Quickstart i kliknij Zmień nazwę.

Krok 2. Włącz YouTube Data API

  1. Po lewej stronie kliknij Edytor .
  2. Po lewej stronie obok sekcji „Usługi” kliknij Dodaj usługę .
  3. Kliknij YouTube Data API, a następnie Dodaj.

Krok 3. Uruchom przykład

  1. Odśwież arkusz kalkulacyjny. Jeśli po raz pierwszy wczytujesz arkusz kalkulacyjny po dodaniu kodu, w pierwszym wierszu powinny pojawić się nagłówki ID, Title i View View.
  2. Na pasku menu kliknij Dane YouTube > Dodaj dane Google Developers, aby dodać do arkusza kalkulacyjnego informacje o kanale Google Developers. Obok menu standardowych – Plik, Edycja, Wyświetl itd. – powinno pojawić się menu Dane YouTube.

    Przy pierwszym uruchomieniu przykładu zobaczysz prośbę o autoryzację dostępu:

    1. Kliknij Sprawdź uprawnienia.
    2. Wybrać konto.
    3. Kliknij Zezwól.
  3. Na pasku menu kliknij Dane YouTube > Dodaj dane kanału, aby dodać dane wybranego przez siebie kanału. Gdy pojawi się prośba, wpisz nazwę kanału (np. „GoogleDevelopers” lub „SaturdayNightLive”) i kliknij OK. Skrypt pobiera dane kanału i dodaje go do arkusza kalkulacyjnego.

Więcej informacji

Rozwiązywanie problemów

ReferenceError: atrybut „[API NAME]” nie jest zdefiniowany

Ten błąd występuje, jeśli interfejs API nie został włączony w edytorze kodu Apps Script. Wróć do kroku 2.b i sprawdź, czy przełącznik jest włączony.