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.

W krótkich wprowadzeniu do Google Workspace do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji używane są biblioteki klienta interfejsu API. Na potrzeby własnych aplikacji zalecamy używanie bibliotek klienta. W tym krótkim wprowadzeniu zastosowano uproszczoną metodę uwierzytelniania odpowiednią do środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z uwierzytelnianiem i autoryzacją przed wybraniem danych logowania odpowiednich do aplikacji.

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

Cele

  • Utwórz skrypt.
  • Włącz interfejs Admin SDK API.
  • Uruchom przykład.

Wymagania wstępne

  • Dostęp do Dysku Google

Tworzenie skryptu

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

adminSDK/raporty/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
  };
  try {
    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) {
      console.log('%s: %s (%s)', activity.id.time, activity.actor.email,
          activity.events[0].name);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Report  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 Admin SDK API

  1. Otwórz projekt Apps Script.
  2. Kliknij Edytor .
  3. Obok opcji Usługi kliknij Dodaj usługę .
  4. Wybierz interfejs Admin Reports 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 Sprawdź uprawnienia.
  2. Wybierz konto.
  3. Kliknij Zezwól.

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

Dalsze kroki