Google Apps Script – Kurzanleitung

Erstellen Sie ein Google Apps Script , das Anfragen an die Directory API stellt.

In Kurzanleitungen wird beschrieben, wie Sie eine App einrichten und ausführen, die eine Google Workspace API aufruft. In dieser Kurzanleitung wird ein vereinfachter Authentifizierungsansatz verwendet, der 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 Kurzanleitungen erweiterte Google-Dienste, um Google Workspace APIs aufzurufen und einige Details des Authentifizierungs und Autorisierungsablaufs zu verarbeiten.

Ziele

  • Umgebung konfigurieren
  • Script erstellen und konfigurieren
  • Script ausführen

Vorbereitung

  • Eine Google Workspace-Domain, in der der API-Zugriff aktiviert ist.
  • Ein Google-Konto in dieser Domain mit Administratorrechten.

  • Zugriff auf Google Drive

Script erstellen

  1. Erstellen Sie im Apps Script-Editor ein neues Script. Rufen Sie dazu script.google.com/create auf.
  2. Ersetzen Sie den Inhalt des Script-Editors durch den folgenden Code:

adminSDK/directory/quickstart.gs
/**
 * Lists users in a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list
 */
function listUsers() {
  const optionalArgs = {
    customer: "my_customer",
    maxResults: 10,
    orderBy: "email",
  };
  if (!AdminDirectory || !AdminDirectory.Users) {
    throw new Error("Enable the AdminDirectory Advanced Service.");
  }
  const response = AdminDirectory.Users.list(optionalArgs);
  const users = response.users;
  if (!users || users.length === 0) {
    console.log("No users found.");
    return;
  }
  // Print the list of user's full name and email
  console.log("Users:");
  for (const user of users) {
    if (user.primaryEmail) {
      if (user.name?.fullName) {
        console.log("%s (%s)", user.primaryEmail, user.name.fullName);
      } else {
        console.log("%s", user.primaryEmail);
      }
    }
  }
}

  1. Klicken Sie auf „Speichern“ .
  2. Klicken Sie auf Unbenanntes Projekt, geben Sie Kurzanleitung ein und klicken Sie auf Umbenennen.

Script konfigurieren

Directory 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 Directory 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 Scripts wird unten im Fenster angezeigt.

Nächste Schritte