Szybki start z Google Apps Script

Tworzenie skryptu Google Apps Script , który wysyła żądania do interfejsu pakietu Admin SDK API

Krótkie wprowadzenia wyjaśniają, jak skonfigurować i uruchomić aplikację, która wywołuje interfejs Google Workspace API. W tym krótkim wprowadzeniu używamy uproszczonego podejścia do uwierzytelniania, które jest odpowiednie dla środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z uwierzytelnianiem i autoryzacją przed wybraniem danych logowania, które są odpowiednie dla Twojej aplikacji.

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

Cele

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

Wymagania wstępne

  • Dostęp do Dysku Google

Tworzenie skryptu

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

adminSDK/reports/quickstart.gs
/**
 * List login events for a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list
 */
function listLogins() {
  const userKey = "all";
  const applicationName = "login";
  const optionalArgs = {
    maxResults: 10,
  };
  if (!AdminReports || !AdminReports.Activities) {
    throw new Error("Enable the AdminReports Advanced Service.");
  }
  const response = AdminReports.Activities.list(
    userKey,
    applicationName,
    optionalArgs,
  );
  const activities = response.items;
  if (!activities || activities.length === 0) {
    console.log("No logins found.");
    return;
  }
  // Print login events
  console.log("Logins:");
  for (const activity of activities) {
    if (
      activity.id?.time &&
      activity.actor?.email &&
      activity.events?.[0]?.name
    ) {
      console.log(
        "%s: %s (%s)",
        activity.id.time,
        activity.actor.email,
        activity.events[0].name,
      );
    }
  }
}

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

Konfigurowanie skryptu

Włączanie interfejsu Admin SDK API

Otwórz projekt Apps Script.

  1. Kliknij Edytor .
  2. Obok opcji Usługi kliknij Dodaj usługę .
  3. Wybierz pakiet Admin SDK API i kliknij Dodaj.

Uruchamianie przykładu

W edytorze skryptów Apps Script kliknij Uruchom.

Gdy uruchomisz przykład po raz pierwszy, pojawi się prośba o autoryzację dostępu:

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

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

Dalsze kroki