Google Apps Script – Kurzanleitung

Erstellen Sie ein Google Apps Script, mit dem Anfragen an die Admin SDK API gesendet werden.

In Kurzanleitungen wird beschrieben, wie Sie eine App einrichten und ausführen, die eine Google Workspace API aufruft. In dieser Kurzanleitung wird ein vereinfachtes Authentifizierungsverfahren verwendet, das für eine Testumgebung geeignet ist. Für eine Produktionsumgebung empfehlen wir, sich mit Authentifizierung und Autorisierung vertraut zu machen, bevor Sie die für Ihre App geeigneten Zugangsdaten auswählen.

In Apps Script verwenden Google Workspace-Schnellstarts erweiterte Google-Dienste, um Google Workspace APIs aufzurufen und einige Details des Authentifizierungs- und Autorisierungsablaufs zu verarbeiten.

Ziele

  • Konfigurieren Sie die Umgebung.
  • Erstellen und konfigurieren Sie das Skript.
  • Führen Sie das Skript aus.

Vorbereitung

  • Eine Google Workspace-Domain, für die API-Zugriff aktiviert ist.
  • Ein Google-Konto in dieser Domain mit Administratorberechtigungen.

  • Zugriff auf Google Drive

Skript erstellen

  1. Erstellen Sie ein neues Skript unter script.google.com/create.
  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 Schnellstart ein und klicken Sie auf Umbenennen.

Skript konfigurieren

Admin SDK API aktivieren

Öffnen Sie das Apps Script-Projekt.

  1. Klicken Sie auf Editor .
  2. Klicken Sie neben Dienste auf „Dienst hinzufügen“  .
  3. Wählen Sie „Admin SDK 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 ansehen.
  2. Wählen Sie ein Konto aus.
  3. Klicken Sie auf Zulassen.

Das Ausführungsprotokoll des Skripts wird unten im Fenster angezeigt.

Nächste Schritte