In den Kurzanleitungen wird erklärt, wie Sie eine App einrichten und ausführen, die eine Google Workspace API
In Google Workspace-Kurzanleitungen werden die API-Clientbibliotheken Details zum Authentifizierungs- und Autorisierungsvorgang. Wir empfehlen, Clientbibliotheken für Ihre eigenen Apps verwenden. In dieser Kurzanleitung wird ein vereinfachten Authentifizierungsansatz, der für Tests geeignet ist, zu verbessern. Für eine Produktionsumgebung empfehlen wir, sich über Authentifizierung und Autorisierung vorher Anmeldedaten auswählen die für Ihre App geeignet sind.
Erstellen: Google Apps Script die Anfragen an die Google Chat API sendet.
Zielsetzungen
- Konfigurieren Sie die Umgebung.
- Erstellen und konfigurieren Sie das Skript.
- Führen Sie das Skript aus.
Vorbereitung
- Ein Business- oder Enterprise-Google Workspace-Konto mit Zugriff auf Google Chat.
Cloud-Projekt konfigurieren
Wenn Sie für diese Kurzanleitung ein neues Google Cloud-Projekt verwenden, müssen Sie konfigurieren Sie es und fügen Sie sich selbst als Testnutzer hinzu. Wenn Sie bereits Sie diese Schritte für Ihr Cloud-Projekt ausgeführt haben, fahren Sie mit dem nächsten Abschnitt fort.
Cloud-Projekt in der Google Cloud Console öffnen
Falls noch nicht geschehen, öffnen Sie das gewünschte Cloud-Projekt. für dieses Beispiel:
- Rufen Sie in der Google Cloud Console die Seite Projekt auswählen auf.
- Wählen Sie das Google Cloud-Projekt aus, das Sie verwenden möchten. Oder klicken Sie auf Projekt erstellen und folgen Sie der Anleitung auf dem Bildschirm. Wenn Sie ein Google Cloud-Projekt erstellen, müssen Sie möglicherweise die Abrechnung für das Projekt aktivieren.
Chat API aktivieren
Bevor Sie Google APIs verwenden können, müssen Sie sie in einem Google Cloud-Projekt aktivieren. Sie können eine oder mehrere APIs in einem einzelnen Google Cloud-Projekt aktivieren.Aktivieren Sie in der Google Cloud Console die Google Chat API.
OAuth-Zustimmungsbildschirm konfigurieren
- Öffnen Sie in der Google Cloud Console das Menü > APIs und Dienste > OAuth-Zustimmungsbildschirm. .
- Wählen Sie für Nutzertyp die Option Intern aus und klicken Sie dann auf Erstellen.
- Füllen Sie das Formular zur App-Registrierung aus und klicken Sie dann auf Speichern und fortfahren.
Vorerst können Sie das Hinzufügen von Bereichen überspringen und auf Speichern und fortfahren klicken. Wenn Sie in Zukunft eine App erstellen, die außerhalb Ihres Google Workspace-Organisation verwenden, müssen Sie den Nutzertyp in Extern ändern. fügen Sie die Autorisierungsbereiche hinzu, die Ihre Anwendung benötigt.
- Überprüfen Sie Ihre App-Registrierungsübersicht. Wenn Sie Änderungen vornehmen möchten, klicken Sie auf Bearbeiten. Wenn die App mit der Registrierung in Ordnung ist, klicken Sie auf Zurück zum Dashboard.
Google Chat App konfigurieren
Zum Aufrufen der Google Chat API müssen Sie eine Google Chat App. Bei Schreibanfragen verwendet Google Chat weist die Google Chat App in der Benutzeroberfläche mithilfe von die folgenden Informationen.
Rufen Sie in der Google Cloud Console die Seite Konfiguration der Chat API auf:
Geben Sie unter Anwendungsinformationen folgende Informationen ein:
- Geben Sie im Feld App-Name den Wert
Chat API quickstart app
ein. - Geben Sie im Feld Avatar URL (Avatar-URL) Folgendes ein:
https://developers.google.com/chat/images/quickstart-app-avatar.png
- Geben Sie im Feld Beschreibung den Text
Quickstart for calling the Chat API
ein.
- Geben Sie im Feld App-Name den Wert
Klicken Sie unter Interaktive Features auf Interaktive Features aktivieren. stellen Sie die Ein/Aus-Schaltfläche auf „Aus“, um interaktive Funktionen für die Chat-App.
Klicken Sie auf Speichern.
Skript erstellen
- Erstellen Sie ein neues Skript. Rufen Sie dazu script.google.com/create auf.
- Ersetzen Sie den Inhalt des Script-Editors durch den folgenden Code:
- Klicken Sie auf „Speichern“ .
- Klicken Sie auf Unbenanntes Projekt und geben Sie Schnellstart und klicken Sie auf Umbenennen.
Skript konfigurieren
Cloud-Projektnummer kopieren
- Öffnen Sie in der Google Cloud Console das Menü > IAM und Verwaltung > Einstellungen. .
- Kopieren Sie den Wert im Feld Projektnummer.
Google Cloud-Projekt verknüpfen
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie auf Projekteinstellungen .
- Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf Projekt ändern.
- Fügen Sie in GCP-Projektnummer die Google Cloud-Projektnummer ein.
- Klicken Sie auf Projekt festlegen.
Google Chat API aktivieren
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie auf Projekteinstellungen .
- Aktivieren Sie unter Allgemeine Einstellungen die Option "appsscript.json" anzeigen Manifestdatei im Editor.
- Klicken Sie auf Bearbeiter
appscript.json
und ersetzen Sie den Inhalt durch den folgenden Code:
und wählen Sie das
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:
- Klicken Sie auf Berechtigungen prüfen.
- Wählen Sie ein Konto aus.
- Klicken Sie auf Zulassen.
Das Ausführungsprotokoll des Skripts wird unten im Fenster angezeigt.