Kurzanleitung für Google Apps Script

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

In 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 der 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 Gmail API sendet.

Zielsetzungen

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

Voraussetzungen

  • Ein Google-Konto mit aktiviertem Gmail.

  • Zugriff auf Google Drive

Skript erstellen

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

gmail/quickstart/quickstart.gs
/**
 * Lists all labels in the user's mailbox
 * @see https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list
 */
function listLabels() {
  try {
    // Gmail.Users.Labels.list() API returns the list of all Labels in user's mailbox
    const response = Gmail.Users.Labels.list('me');
    if (!response || response.labels.length === 0) {
      // TODO (developer) - No labels are returned from the response
      console.log('No labels found.');
      return;
    }
    // Print the Labels that are available.
    console.log('Labels:');
    for (const label of response.labels ) {
      console.log('- %s', label.name);
    }
  } catch (err) {
    // TODO (developer) - Handle exception on Labels.list() API
    console.log('Labels.list() API failed with error %s', err.toString());
  }
}

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

Gmail API aktivieren

  1. Öffnen Sie das Apps Script-Projekt.
  2. Klicken Sie auf Editor .
  3. Klicken Sie neben Dienste auf „Dienst hinzufügen“ .
  4. Wählen Sie die Gmail 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 unten im Fenster angezeigt.

Nächste Schritte