Auf dieser Seite wird beschrieben, wie Sie eine Google Chat-App mit einem Dienst verbinden. oder ein Tool außerhalb von Google Chat. Während Chat-Apps sie arbeiten oft mit anderen Systemen zusammen und benötigen Companion-Anwendungen zum Verbinden von Konten, Autorisieren des Datenzugriffs, Anzeigen oder Nutzereinstellungen konfigurieren.
Vorbereitung
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein Chat-App verwenden, führen Sie eine der folgenden Kurzanleitungen aus für die App-Architektur, die Sie verwenden möchten:- HTTP-Dienst mit Google Cloud Functions
- Google Apps-Skript
- Google Cloud Dialogflow CX
- Cloud Pub/Sub
Konfiguration der Chat-App von einem Nutzer anfordern
Wenn für das Ausführen einer Anfrage eine zusätzliche Konfiguration erforderlich ist, die nicht Chat-App ausgeführt haben, geben Sie eine Konfigurations-URL als Teil einer normalen Antwort an den Nutzer senden oder sie privat präsentieren, im folgenden Format:
{ "actionResponse": { "type": "REQUEST_CONFIG", "url": "CONFIGURATION_URL" } }
Dadurch wird dem Nutzer in Google Chat eine private Aufforderung angezeigt, in der
CONFIGURATION_URL
ist ein Link
auf die der Nutzer zur zusätzlichen Authentifizierung, Autorisierung oder
Konfiguration. Eine REQUEST_CONFIG
-Antwort schließt sich mit einem regulären
Antwortnachricht. Text, Karten und andere Attribute werden ignoriert.
Konfigurationsanfrage abschließen
Jeden
MESSAGE
Interaktionsereignis
die Ihre Chat-App erhält, enthält auch das Feld
configCompleteRedirectUrl
. Sie müssen diese URL in Ihrem
Konfigurations-URL, die nach Abschluss des Vorgangs verwendet werden soll. Du wirst weitergeleitet
URL signalisiert Google Chat, dass die Konfigurationsanfrage erfüllt wurde.
Wenn die Chat-App gestartet wird, hängt der Ablauf davon ab,
bestimmte Nachricht empfangen. Als Antwort auf eine Nachricht wie @app help
wurde ein
Die Chat-App sollte mit einer Nachricht antworten,
und erfordert eine zusätzliche Konfiguration.
Wenn ein Nutzer erfolgreich zu configCompleteRedirectUrl
weitergeleitet wird
in der ursprünglichen Nachricht enthalten, führt Google Chat die folgenden Schritte aus:
- Löschen Sie die Aufforderung, die dem initiierenden Nutzer angezeigt wurde.
- Die ursprüngliche Nachricht öffentlich machen, damit sie für andere Mitglieder von sichtbar ist den Gruppenbereich.
- Originalnachricht an dieselbe Chat-App senden ein zweites Mal.
Das Aufrufen einer configCompleteRedirectUrl
wirkt sich nur auf eine einzelne Nutzernachricht aus.
Wenn ein Nutzer mehrmals versucht hat, einer Chat-App eine Nachricht zu senden
und so mehrere Prompts erhielten,
Die Eingabeaufforderung und das Abschließen der Authentifizierung und Konfiguration wirkt sich nur auf
Nachricht senden. Andere Nachrichten werden nicht geändert.
Wenn ein MESSAGE
-Interaktionsereignis auf diese Weise noch einmal gesendet wird, muss es identisch sein.
mit dem ursprünglichen Ereignis verknüpft. Es gibt jedoch Situationen, in denen MESSAGE
Interaktionsereignisse variieren. Wenn in einer Nachricht beispielsweise sowohl
Chat-App A und Chat-App B,
Der Nutzer kann die Nachricht bearbeiten, wenn die Chat-App A
mit einer regulären Nachricht antwortet, bevor sie sich mit
Chat-App B. In diesem Fall
Chat-App B empfängt den bearbeiteten Nachrichtentext nach dem
Der Nutzer führt die Authentifizierung und Konfiguration durch.
Chat-Nutzer außerhalb von Google Chat authentifizieren
In einigen Fällen, etwa beim Anfordern der OAuth-Autorisierung für eine API, muss Ihre Anwendung um auf eine URL außerhalb von Chat zu verlinken, während der Nutzer Identität. Der beste Weg, Nutzer zu identifizieren, besteht darin, Ziel-App mit Google Log-in.
Verwenden Sie die Methode
Identitätstoken
die bei der Anmeldung ausgestellt wurden, um die Nutzer-ID zu erhalten. Die sub
-Anforderung enthält die
eindeutige ID und kann mit der Nutzer-ID aus Google Chat in Beziehung gesetzt werden.
Obwohl die beiden IDs nicht genau identisch sind, können sie erzwungen werden. Bis
Erzwingen Sie den Wert der sub
-Anforderung in eine Google Chat-users/{user}
.
den Wert mit users/
. Der Anforderungswert von 123
ist beispielsweise äquivalent.
an den Nutzernamen users/123
in Nachrichten an Ihre
Chat-App.
Weitere Informationen
- Nutzerinteraktionen empfangen und darauf reagieren
- Beispiel für die MyProfile App verwendet das Identitätstoken aus der Google Log-in-Antwort zur Identifizierung des Nutzer.