Google Apps Script-Kurzanleitung

In Kurzanleitungen wird erläutert, wie Sie eine Anwendung einrichten und ausführen, die eine Google Workspace API aufruft.

Bei Google Workspace-Kurzanleitungen werden einige Details des Authentifizierungs- und Autorisierungsvorgangs mithilfe der API-Clientbibliotheken verarbeitet. Wir empfehlen, die Clientbibliotheken für Ihre eigenen Anwendungen zu verwenden. In dieser Kurzanleitung wird ein vereinfachter Authentifizierungsansatz verwendet, der für eine Testumgebung geeignet ist. Für eine Produktionsumgebung sollten Sie sich mit den Informationen zur Authentifizierung und Autorisierung vertraut machen, bevor Sie die für Ihre Anwendung geeigneten Anmeldedaten auswählen.

Erstellen Sie ein Google Apps Script, das Anfragen an die Admin SDK API sendet.

Zielsetzungen

  • Erstellen Sie das Skript.
  • Aktivieren Sie die Admin SDK API.
  • Führen Sie das Beispiel aus.

Voraussetzungen

  • Sie benötigen eine Google Workspace-Domain mit aktiviertem API-Zugriff.
  • Ein Google-Konto in dieser Domain mit Administratorberechtigungen.

  • Zugriff auf Google Drive

Skript erstellen

  1. Rufen Sie script.google.com/create auf, um ein neues Skript zu erstellen.
  2. Ersetzen Sie den Inhalt des Skripteditors durch den folgenden Code:

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
  };
  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. Klicken Sie auf „Speichern“ .
  2. Klicken Sie auf Unbenanntes Projekt, geben Sie Kurzanleitung ein und klicken Sie auf Umbenennen.

Admin SDK API aktivieren

  1. Öffnen Sie das Apps Script-Projekt.
  2. Klicke auf Editor .
  3. Klicken Sie neben Dienste auf „Dienst hinzufügen“ .
  4. Wählen Sie die Admin Reports API aus und klicken Sie auf Hinzufügen.

Beispiel ausführen

Klicken Sie im Apps Script-Editor auf Ausführen.

Wenn Sie das Beispiel zum ersten Mal ausführen, werden Sie aufgefordert, den Zugriff zu autorisieren:

  1. Klicken Sie auf Berechtigungen prüfen.
  2. Wählen Sie ein Konto aus.
  3. Klicke auf Zulassen.

Das Ausführungsprotokoll des Skripts wird am unteren Rand des Fensters angezeigt.

Nächste Schritte