Krótkie wprowadzenie do Google Apps Script

Krótkie wprowadzenia wyjaśniają, jak skonfigurować i uruchomić aplikację, która wywołuje interfejs Google Workspace API.

Krótkie wprowadzenia do Google Workspace wykorzystują biblioteki klienta interfejsu API do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji. Na potrzeby własnych aplikacji zalecamy używanie bibliotek klienta. W tym krótkim wprowadzeniu używamy uproszczonej metody uwierzytelniania, która jest odpowiednia dla środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z uwierzytelnianiem i autoryzacją przed wybraniem danych logowania odpowiednich dla aplikacji.

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

Cele

  • Utwórz skrypt.
  • Włącz interfejs API Kalendarza Google.
  • Uruchom próbkę.

Wymagania wstępne

  • konto Google z włączonym Kalendarzem Google,

  • Dostęp do Dysku Google

Tworzenie skryptu

  1. Utwórz nowy skrypt. W tym celu wejdź na script.google.com/create.
  2. Zastąp zawartość edytora skryptów tym kodem:

calendar/quickstart/quickstart.gs
/**
 * Lists 10 upcoming events in the user's calendar.
 * @see https://developers.google.com/calendar/api/v3/reference/events/list
 */
function listUpcomingEvents() {
  const calendarId = 'primary';
  // Add query parameters in optionalArgs
  const optionalArgs = {
    timeMin: (new Date()).toISOString(),
    showDeleted: false,
    singleEvents: true,
    maxResults: 10,
    orderBy: 'startTime'
    // use other optional query parameter here as needed.
  };
  try {
    // call Events.list method to list the calendar events using calendarId optional query parameter
    const response = Calendar.Events.list(calendarId, optionalArgs);
    const events = response.items;
    if (events.length === 0) {
      console.log('No upcoming events found');
      return;
    }
    // Print the calendar events
    for (const event of events) {
      let when = event.start.dateTime;
      if (!when) {
        when = event.start.date;
      }
      console.log('%s (%s)', event.summary, when);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Calendar API
    console.log('Failed with error %s', err.message);
  }
}

  1. Kliknij Zapisz .
  2. Kliknij Projekt bez nazwy, wpisz Krótkie wprowadzenie i kliknij Zmień nazwę.

Włączanie interfejsu Google Calendar API

  1. Otwórz projekt Apps Script.
  2. Kliknij Edytor .
  3. Obok opcji Usługi kliknij Dodaj usługę .
  4. Wybierz interfejs API Kalendarza i kliknij Dodaj.

Uruchamianie przykładowego

W edytorze Apps Script kliknij Uruchom.

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

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

Dziennik wykonywania skryptu pojawi się na dole okna.

Dalsze kroki