Google Apps Script – Kurzanleitung

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

In den Kurzanleitungen wird erläutert, 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 Zugriffsdaten auswählen, die für Ihre App geeignet sind.

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

Lernziele

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

Vorbereitung

  • Eine Google Workspace-Domain mit aktiviertem API-Zugriff
  • Ein Google-Konto in dieser Domain mit Administratorberechtigungen.

  • Zugriff auf Google Drive

Script erstellen

  1. Erstellen Sie ein neues Script unter script.google.com/create.
  2. Ersetzen Sie den Inhalt des Script-Editors durch den folgenden Code:

people/quickstart/quickstart.gs
/**
 * Print the display name if available for 10 connections.
 */
function listConnectionNames() {
  try {
    /**
     * List the 10 connections/contacts of user
     * @see https://developers.google.com/people/api/rest/v1/people.connections/list
     */
    const connections = People.People.Connections.list('people/me', {
      pageSize: 10,
      personFields: 'names,emailAddresses'
      // use other query parameter here if needed.
    });
    connections.connections.forEach((person) => {
      // if contacts/connections is available, print the name of person.
      if (person.names && person.names.length === 0) {
        console.log('No display name found for connection.');
        return;
      }
      console.log(person.names[0].displayName);
    });
  } catch (err) {
    // TODO (developer) - Handle exception from People 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.

Script konfigurieren

People 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 „People 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