Szybki start z Google Apps Script

Utwórz Google Apps Script, który wysyła żądania do interfejsu Google Sheets API.

Przewodniki Szybki start wyjaśniają, jak skonfigurować i uruchomić aplikację, która wywołuje interfejs API Google Workspace. W tym krótkim wprowadzeniu użyjemy uproszczonego podejścia do uwierzytelniania, które jest odpowiednie w środowisku testowym. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z informacjami o uwierzytelnianiu i autoryzacji przed wybraniem danych logowania odpowiednich dla Twojej aplikacji.

W Apps Script przewodniki Szybki start Google Workspace używają zaawansowanych usług Google do wywoływania interfejsów API Google Workspace i obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji.

Cele

  • Skonfiguruj środowisko.
  • Utwórz i skonfiguruj skrypt.
  • Uruchom skrypt.

Wymagania wstępne

  • konto Google;
  • Dostęp do Dysku Google

Tworzenie skryptu

  1. Utwórz nowy skrypt w edytorze Apps Script, otwierając stronę script.google.com/create.
  2. Zastąp zawartość edytora skryptów tym kodem:

sheets/quickstart/quickstart.gs
/**
 * Creates a Sheets API service object and prints the names and majors of
 * students in a sample spreadsheet:
 * https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit
 * @see https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/get
 */
function logNamesAndMajors() {
  const spreadsheetId = '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms';
  const rangeName = 'Class Data!A2:E';
  try {
    // Get the values from the spreadsheet using spreadsheetId and range.
    const values = Sheets.Spreadsheets.Values.get(spreadsheetId, rangeName).values;
    //  Print the values from spreadsheet if values are available.
    if (!values) {
      console.log('No data found.');
      return;
    }
    console.log('Name, Major:');
    for (const row in values) {
      // Print columns A and E, which correspond to indices 0 and 4.
      console.log(' - %s, %s', values[row][0], values[row][4]);
    }
  } catch (err) {
    // TODO (developer) - Handle Values.get() exception from Sheet API
    console.log(err.message);
  }
}

  1. Kliknij Zapisz .
  2. Kliknij Projekt bez tytułu, wpisz Szybki start i kliknij Zmień nazwę.

Konfigurowanie skryptu

Włączanie interfejsu Google Sheets API

Otwórz projekt Apps Script.

  1. Kliknij Edytor .
  2. Obok opcji Usługi kliknij Dodaj usługę  .
  3. Wybierz Sheets API i kliknij Add (Dodaj).

Uruchamianie przykładu

W edytorze Apps Script kliknij Uruchom.

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

  1. Kliknij Przejrzyj uprawnienia.
  2. Wybierz konto.
  3. Kliknij Zezwól.

Dziennik wykonania skryptu pojawi się u dołu okna.

Dalsze kroki