Szybki start z Google Apps Script

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

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

Wymagania wstępne

Aby uruchomić ten przewodnik Szybki start, musisz mieć:

  • dostęp do internetu i przeglądarki internetowej;
  • 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', 'getChannel')
  .addSeparator()
  .addItem('Add GoogleDevelopers data', 'getGoogleDevelopersChannel')
  .addToUi();
}
  5. Kliknij Zapisz .
  6. W lewym górnym rogu kliknij Projekt bez tytułu , 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 potem Dodaj.

Krok 3. Uruchom przykład

  1. Odśwież arkusz kalkulacyjny. Jeśli po dodaniu kodu otwierasz arkusz kalkulacyjny po raz pierwszy, w pierwszym wierszu powinny się pojawić nagłówkiIdentyfikator, Tytuł i Liczba wyświetleń.

  2. Aby dodać do arkusza kalkulacyjnego informacje o kanale GoogleDevelopers, na pasku menu kliknij Dane YouTube > Dodaj dane GoogleDevelopers. (Menu Dane YouTube powinno się pojawić obok standardowych menu – Plik, Edytuj, Widok itp.).

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

    1. Kliknij Sprawdź uprawnienia.
    2. Wybierz konto.
    3. Kliknij Zezwól.

  3. Aby dodać dane wybranego kanału, na pasku menu kliknij Dane YouTube > Dodaj dane kanału. Gdy pojawi się prośba, wpisz nazwę kanału (np. „GoogleDevelopers” lub „SaturdayNightLive”) i kliknij OK. Skrypt pobierze dane tego kanału i doda 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 na włączony.