Szybki start z Google Apps Script

Wykonaj czynności opisane na tej stronie, a w ciągu kilku minut uzyskasz prosty skrypt Google Apps Script, który wysyła żądania do interfejsu YouTube Data API.

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

Wymagania wstępne

Aby uruchomić ten przewodnik, musisz mieć:

  • Dostęp do internetu i przeglądarki.
  • 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 skryptów 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', 'getCh .addSeparator()
      .addItem('Add GoogleDevelopers data', 'getGoogleDevelopersChannel')
      .addToUi();
    }
    quickstart.gs
  5. Kliknij Zapisz .
  6. W lewym górnym rogu kliknij Projekt bez nazwy, wpisz Szybki start i kliknij Zmień nazwę.

Krok 2. Włącz interfejs YouTube Data API

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

Krok 3. Uruchom przykład

  1. Załaduj ponownie arkusz kalkulacyjny. Jeśli po dodaniu kodu arkusz kalkulacyjny jest wczytywany po raz pierwszy, w pierwszym wierszu powinny pojawić się nagłówki ID, TytułLiczba wyświetleń.
  2. Na pasku menu kliknij Dane YouTube > Dodaj dane GoogleDevelopers, aby dodać do arkusza informacje o kanale GoogleDevelopers. (Menu Dane YouTube powinno pojawić się obok standardowych menu – Plik, Edytuj, Widok itp.).

    Przy pierwszym uruchomieniu przykładu pojawi się prośba o autoryzację dostępu:

    1. Kliknij Przejrzyj uprawnienia.
    2. Wybierz konto.
    3. Kliknij Zezwól.
  3. Na pasku menu kliknij Dane YouTube > Dodaj dane kanału, aby dodać dane wybranego kanału. Po wyświetleniu prośby wpisz nazwę kanału (np. „GoogleDevelopers” lub „SaturdayNightLive”) i kliknij OK. Skrypt pobiera dane dotyczące tego kanału i dodaje je do arkusza kalkulacyjnego.

Więcej informacji

Rozwiązywanie problemów

ReferenceError: „[API NAME]” is not defined

Ten błąd występuje, gdy interfejs API nie został włączony w edytorze kodu Apps Script. Wróć do kroku 2.b i upewnij się, że odpowiedni przełącznik jest ustawiony w pozycji włączonej.