Krótkie wprowadzenie do Google Apps Script

Przewodniki szybkiego startu wyjaśniają, jak skonfigurować i uruchamiać aplikację, która wywołuje interfejs Google Workspace API.

Szybkie starty Google Workspace korzystają z bibliotek klienta interfejsu API do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji. Zalecamy używanie bibliotek klienta w przypadku własnych aplikacji. W tym krótkim wprowadzeniu użyjemy uproszczonego podejścia do uwierzytelniania, które jest odpowiednie dla środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z informacjami na temat uwierzytelniania i autoryzacji, zanim wybierzesz odpowiednie dla swojej aplikacji poświadczenia dostępu.

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

Cele

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

Wymagania wstępne

  • Konto Google z włączonym Gmailem.

  • Dostęp do Dysku Google

Tworzenie skryptu

  1. Aby utworzyć nowy skrypt, otwórz stronę script.google.com/create.
  2. Zastąp zawartość edytora skryptu tym kodem:

gmail/quickstart/quickstart.gs
/**
 * Lists all labels in the user's mailbox
 * @see https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list
 */
function listLabels() {
  try {
    // Gmail.Users.Labels.list() API returns the list of all Labels in user's mailbox
    const response = Gmail.Users.Labels.list('me');
    if (!response || response.labels.length === 0) {
      // TODO (developer) - No labels are returned from the response
      console.log('No labels found.');
      return;
    }
    // Print the Labels that are available.
    console.log('Labels:');
    for (const label of response.labels ) {
      console.log('- %s', label.name);
    }
  } catch (err) {
    // TODO (developer) - Handle exception on Labels.list() API
    console.log('Labels.list() API failed with error %s', err.toString());
  }
}

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

Konfigurowanie skryptu

Włączanie interfejsu Gmail API

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

Uruchamianie przykładu

W edytorze Apps Script kliknij Uruchom.

Gdy uruchomisz próbkę po raz pierwszy, pojawi się prośba o autoryzację dostępu:

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

U dołu okna pojawi się dziennik wykonania skryptu.

Dalsze kroki