In diesem Leitfaden wird erläutert, wie Sie die
messages.create()
um eine der folgenden Aktionen auszuführen:
- Senden Sie Nachrichten, die Text, Karten und interaktive Widgets enthalten.
- Nachrichten privat an einen bestimmten Chat-Nutzer senden.
- Sie können eine Unterhaltung starten oder darauf antworten.
- Benennen Sie eine Nachricht, damit Sie sie in einer anderen Chat API angeben können -Anfragen.
<ph type="x-smartling-placeholder">
Die maximale Nachrichtengröße (inklusive Text oder Karten) beträgt 32.000 Byte. Wenn Sie eine Nachricht senden möchten, die diese Größe überschreitet, muss stattdessen mehrere Nachrichten senden.
Neben der Methode messages.create()
können Chat-Apps
Nachrichten erstellen und senden, um auf Interaktionen von Nutzern zu antworten, z. B.
Willkommensnachricht, nachdem ein Nutzer die Chat-App einer
Leerzeichen. Beim Reagieren auf Interaktionen können Chat-Apps andere
Arten von Messaging-Funktionen wie interaktive Dialogfelder und Linkvorschau
Schnittstellen. Um einem Nutzer zu antworten, gibt die Chat App
die Nachricht synchron, ohne die Chat API aufzurufen. Weitere Informationen
wie Sie Nachrichten senden, um auf Interaktionen zu reagieren,
Interaktionen mit der Google Chat App empfangen und beantworten
So werden in Google Chat mit der Chat API erstellte Nachrichten angezeigt und zugeordnet
Sie können die Methode messages.create()
mit
App-Authentifizierung
und Nutzerauthentifizierung.
In Google Chat wird der Absender der Nachricht unterschiedlich zugeordnet
je nach verwendetem Authentifizierungstyp.
Wenn Sie sich als Chat-App authentifizieren, die Chat-App die Nachricht sendet.
<ph type="x-smartling-placeholder">Wenn Sie sich als Nutzer authentifizieren, sendet die Chat-App die im Namen des Nutzers senden. In Chat wird auch die Chat-App an die Nachricht, indem der Name angezeigt wird.
<ph type="x-smartling-placeholder">Der Authentifizierungstyp bestimmt auch, welche Messaging-Funktionen und -Oberflächen die Sie in die Nachricht aufnehmen können. Bei der App-Authentifizierung Chat-Apps können Nachrichten senden, die RTF, kartenbasierten Oberflächen und interaktiven Widgets. Da Google Chat-Nutzer nur Text in ihren Nachrichten senden können, haben Sie folgende Möglichkeiten: nur Text enthalten, wenn Nachrichten mithilfe der Nutzerauthentifizierung erstellt werden. Weitere Informationen zur Nachrichtenfunktion die für die Chat API zur Verfügung stehen, finden Sie in der Nachrichten in Google Chat
In diesem Leitfaden wird erläutert, wie Sie beide Authentifizierungstypen zum Senden einer Nachricht verwenden. mit der Chat-API.
Vorbereitung
Node.js
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- Installieren Sie die Node.js Cloud-Clientbibliothek
- Anmeldedaten für den Zugriff basierend auf der Authentifizierung in der Google Chat API erstellen
Anfrage:
<ph type="x-smartling-placeholder">
- </ph>
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihr lokales Verzeichnis. - So authentifizieren Sie sich als Chat-App:
Dienstkonto erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.json
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- <ph type="x-smartling-placeholder"></ph> Wählen Sie einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder Mitglied der Chat-App ist. So authentifizieren Sie sich als der Chat-App fügen Sie die Chat-App mit dem Gruppenbereich
Python
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- Installieren Sie die Python Cloud-Clientbibliothek
- Anmeldedaten für den Zugriff basierend auf der Authentifizierung in der Google Chat API erstellen
Anfrage:
<ph type="x-smartling-placeholder">
- </ph>
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihr lokales Verzeichnis. - So authentifizieren Sie sich als Chat-App:
Dienstkonto erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.json
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- <ph type="x-smartling-placeholder"></ph> Wählen Sie einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder Mitglied der Chat-App ist. So authentifizieren Sie sich als der Chat-App fügen Sie die Chat-App mit dem Gruppenbereich
Java
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- Installieren Sie die Java Cloud-Clientbibliothek
- Anmeldedaten für den Zugriff basierend auf der Authentifizierung in der Google Chat API erstellen
Anfrage:
<ph type="x-smartling-placeholder">
- </ph>
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihr lokales Verzeichnis. - So authentifizieren Sie sich als Chat-App:
Dienstkonto erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.json
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- <ph type="x-smartling-placeholder"></ph> Wählen Sie einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder Mitglied der Chat-App ist. So authentifizieren Sie sich als der Chat-App fügen Sie die Chat-App mit dem Gruppenbereich
Apps Script
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- Eigenständiges Apps Script-Projekt erstellen und aktivieren Sie den erweiterten Chatdienst.
- In diesem Leitfaden müssen Sie entweder Nutzer oder die App-Authentifizierung. Für die Authentifizierung als Chat-App erstellen Sie Dienstkonto-Anmeldedaten Eine Anleitung dazu finden Sie unter Authentifizierung und Autorisierung als Google Chat App
- <ph type="x-smartling-placeholder"></ph> Wählen Sie einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder Mitglied der Chat-App ist. So authentifizieren Sie sich als der Chat-App fügen Sie die Chat-App mit dem Gruppenbereich
Nachricht als Chat-App senden
In diesem Abschnitt wird erläutert, wie Sie Nachrichten senden, die Text, Karten und interaktive Zubehör-Widgets App-Authentifizierung.
Zum Aufrufen von messages.create()
mithilfe der App-Authentifizierung müssen Sie die Methode
folgende Felder in der Anfrage:
- Der Autorisierungsbereich
chat.bot
. - Die Ressource
Space
, in der die Sie posten möchten. Die Chat-App muss Mitglied des Gruppenbereichs. - Die
Message
zu erstellende Ressource. Um den Inhalt der Nachricht zu definieren, können Sie RTF (text
) eine oder mehrere Kartenschnittstellen (cardsV2
), oder beides.
Optional können Sie Folgendes angeben:
- Das einzuschließende Feld
accessoryWidgets
interaktiven Schaltflächen unten in der Nachricht. - Das Feld
privateMessageViewer
für Sendet die Nachricht privat an einen bestimmten Nutzer. - Das Feld
messageId
, mit dem Sie Geben Sie der Nachricht einen Namen, der in anderen API-Anfragen verwendet werden soll. - Die Felder
thread.threadKey
undmessageReplyOption
für Threads starten oder darauf antworten Wenn im Gruppenbereich Threading verwenden, wird dieses Feld ignoriert.
Der folgende Code zeigt ein Beispiel für eine Chat-App kann eine in der Chat-App gepostete Nachricht senden, die Folgendes enthält: Text, eine Karte und eine anklickbare Schaltfläche unten in der Nachricht:
Node.js
Python
Java
Apps Script
Ersetzen Sie zum Ausführen dieses Beispiels SPACE_NAME
durch die ID von
des Gruppenbereichs
name
.
Sie erhalten die ID durch Aufrufen der
spaces.list()
-Methode
oder aus der URL des Gruppenbereichs.
Interaktive Widgets am Ende einer Nachricht hinzufügen
Im ersten Codebeispiel dieses Leitfadens Bei der Chat-App-Nachricht wird im Bereich in der Meldung angezeigt wird – das sogenannte Zubehör-Widget. Zubehör-Widgets werden nach Text oder Karten in einer Nachricht angezeigt. Mit diesen Widgets können Sie die Nutzer auf verschiedene Arten mit Ihrer Botschaft interagieren können, z. B.:
- Bewerten Sie die Genauigkeit oder Zufriedenheit einer Nachricht.
- Problem mit der Messages App oder der Chat App melden
- Öffnen Sie einen Link zu ähnlichen Inhalten, z. B. zur Dokumentation.
- Ähnliche Nachrichten aus der Chat App schließen oder zurückstellen für einen bestimmten Zeitraum.
Fügen Sie zum Hinzufügen von Zubehör-Widgets den
accessoryWidgets[]
im Text Ihrer Anfrage und geben Sie ein oder mehrere Widgets an, die Sie
enthalten sein sollen.
In der folgenden Abbildung sehen Sie eine Chat-App, eine Textnachricht mit Zubehör-Widgets, damit Nutzer ihre Erfahrung bewerten können mit der Chat-App.
<ph type="x-smartling-placeholder">Hier sehen Sie den Text der Anfrage, mit der eine Textnachricht mit
zwei Zubehörtasten. Wenn Nutzende auf eine Schaltfläche klicken, wird die entsprechende
(z. B. doUpvote
) die Interaktion verarbeitet:
{
text: "Rate your experience with this Chat app.",
accessoryWidgets: [{ buttonList: { buttons: [{
icon: { material_icon: {
name: "thumb_up"
}},
color: { red: 0, blue: 255, green: 0 },
onClick: { action: {
function: "doUpvote"
}}
}, {
icon: { material_icon: {
name: "thumb_down"
}},
color: { red: 0, blue: 255, green: 0 },
onClick: { action: {
function: "doDownvote"
}}
}]}}]
}
Nachricht privat senden
Chat-Apps können private Nachrichten senden, damit die Die Nachricht ist nur für einen bestimmten Nutzer im Gruppenbereich sichtbar. Wenn ein die Chat-App eine private Nachricht sendet, zeigt ein Label, das den Nutzer darüber informiert, dass die Nachricht nur für ihn sichtbar ist.
Wenn Sie eine Nachricht privat über die Chat API senden möchten, geben Sie Folgendes an:
privateMessageViewer
im Text Ihrer Anfrage. Um den Nutzer anzugeben, setzen Sie den Wert auf
User
-Ressource, die
stellt den Chat-Nutzer dar. Sie können auch die
name
des
User
, wie im folgenden Beispiel gezeigt:
{
text: "Hello private world!",
privateMessageViewer: {
name: "users/USER_ID"
}
}
Ersetzen Sie USER_ID
, um dieses Beispiel zu verwenden
mit einer eindeutigen ID für den Nutzer, z. B. 12345678987654321
oder
hao@cymbalgroup.com
Weitere Informationen zum Angeben von Nutzern finden Sie unter
Google Chat-Nutzer identifizieren und angeben
Um eine Nachricht privat zu senden, müssen Sie in Ihrer Anfrage Folgendes weglassen:
SMS im Namen eines Nutzers senden
In diesem Abschnitt wird erläutert, wie Sie Nachrichten im Namen eines Nutzers mit Nutzerauthentifizierung Bei der Nutzerauthentifizierung darf der Inhalt der Nachricht nur Text enthalten und darf Nachrichtenfunktionen auslassen, die nur für Chat-Apps wie Kartenoberflächen und interaktive Widgets
Um die messages.create()
mithilfe der Nutzerauthentifizierung aufzurufen, müssen Sie die
folgende Felder in der Anfrage:
- Einen Autorisierungsbereich
die die Nutzerauthentifizierung für diese Methode unterstützt. Im folgenden Beispiel werden
den Bereich
chat.messages.create
. - Die Ressource
Space
, in der die Sie posten möchten. Der authentifizierte Nutzer muss Mitglied des Leerzeichen. - Die
Message
zu erstellende Ressource. Um den Inhalt der Nachricht zu definieren, müssen Sie den Parametertext
ein.
Optional können Sie Folgendes angeben:
- Das Feld
messageId
, mit dem Sie Geben Sie der Nachricht einen Namen, der in anderen API-Anfragen verwendet werden soll. - Die Felder
thread.threadKey
undmessageReplyOption
für Threads starten oder darauf antworten Wenn im Gruppenbereich Threading verwenden, wird dieses Feld ignoriert.
Der folgende Code zeigt ein Beispiel für eine Chat-App kann im Namen eines authentifizierten Nutzers eine Textnachricht in einem bestimmten Bereich senden:
Node.js
Python
Java
Apps Script
Ersetzen Sie zum Ausführen dieses Beispiels SPACE_NAME
durch die ID von
des Gruppenbereichs
name
ein. Sie erhalten die ID durch Aufrufen der
spaces.list()
-Methode
oder aus der URL des Gruppenbereichs.
Threads starten oder antworten
Für Gruppenbereiche mit Threads: können Sie festlegen, ob mit einer neuen Nachricht ein Thread gestartet oder auf einen vorhandenen Thread.
Standardmäßig wird bei Nachrichten, die Sie mit der Chat API erstellen, ein neuer Diskussions-Thread. Damit Sie die Konversation leichter identifizieren und später darauf antworten können, können Sie ein Thread-Schlüssel in Ihrer Anfrage:
- Geben Sie im Text Ihrer Anfrage
thread.threadKey
ein. - Abfrageparameter angeben
messageReplyOption
um festzustellen, was passiert, falls der Schlüssel bereits vorhanden ist.
So erstellen Sie eine Antwort auf eine vorhandene Unterhaltung:
- Fügen Sie in den Anfragetext das Feld
thread
ein. Wenn festgelegt, können Sie geben Sie diethreadKey
die Sie erstellt haben. Andernfalls müssen Sie die Methodename
des Threads. - Geben Sie den Abfrageparameter
messageReplyOption
an.
Der folgende Code zeigt ein Beispiel für eine Chat-App kann eine Textnachricht senden, die einen bestimmten Thread startet oder darauf antwortet, der durch Schlüssel eines bestimmten Bereichs im Namen eines authentifizierten Nutzers:
Node.js
Python
Java
Apps Script
Ersetzen Sie Folgendes, um dieses Beispiel auszuführen:
THREAD_KEY
: ein vorhandener Threadschlüssel im Gruppenbereich oder zum Erstellen eines neuen Threads, einen eindeutigen Namen für den Thread.SPACE_NAME
: die ID aus demname
ein. Sie erhalten die ID durch Aufrufen derspaces.list()
-Methode oder aus der URL des Gruppenbereichs.
Nachrichten benennen
Sie können eine Nachricht benennen, um eine Nachricht in zukünftigen API-Aufrufen abzurufen oder anzugeben.
indem Sie das Feld messageId
in Ihrer messages.create()
-Anfrage festlegen.
Durch einen Namen können Sie die Nachricht angeben, ohne den
vom System zugewiesene ID aus dem Ressourcennamen der Nachricht (dargestellt in der
name
Feld.
Wenn Sie beispielsweise eine Nachricht mit der Methode get()
abrufen möchten, verwenden Sie die Methode
Ressourcenname, um anzugeben, welche Nachricht abgerufen werden soll. Der Ressourcenname lautet
formatiert als spaces/{space}/messages/{message}
, wobei {message}
für
die vom System zugewiesene ID oder den benutzerdefinierten Namen, den Sie beim Erstellen des
.
Um eine Nachricht zu benennen, geben Sie eine benutzerdefinierte ID in der
messageId
wenn Sie die Mitteilung erstellen. Das Feld messageId
legt den Wert für die
clientAssignedMessageId
der Ressource Message
.
Sie können eine Nachricht nur benennen, wenn Sie sie erstellen. Sie können weder einen Namen eine benutzerdefinierte ID für vorhandene Nachrichten ändern. Die benutzerdefinierte ID muss folgende Anforderungen erfüllen Anforderungen:
- Beginnt mit
client-
.client-custom-name
ist beispielsweise ein gültiger benutzerdefinierter ID,custom-name
jedoch nicht. - Enthält bis zu 63 Zeichen und darf nur Kleinbuchstaben, Ziffern und Bindestriche verwenden.
- Ist innerhalb eines Gruppenbereichs eindeutig. Eine Chat-App kann die dieselbe benutzerdefinierte ID für unterschiedliche Nachrichten verwenden.
Der folgende Code zeigt ein Beispiel für eine Chat-App kann eine Textnachricht mit einer ID im Namen eines authentifizierter Nutzer:
Node.js
Python
Java
Apps Script
Ersetzen Sie Folgendes, um dieses Beispiel auszuführen:
SPACE_NAME
: die ID aus demname
ein. Sie erhalten die ID durch Aufrufen derspaces.list()
-Methode oder aus der URL des Gruppenbereichs.MESSAGE-ID
: ein Name für die Nachricht, die mit dem mitcustom-
. Muss unter allen anderen Nachrichtennamen, die vom Chat-App im angegebenen Gruppenbereich.
Fehlerbehebung
Wenn eine Google Chat App oder card gibt einen Fehler zurück. Der Parameter In der Chatoberfläche wird die Meldung „Ein Fehler ist aufgetreten“ angezeigt. oder „Ihre Anfrage kann nicht verarbeitet werden.“ Manchmal kann die Chat-UI Es wird zwar keine Fehlermeldung angezeigt, aber die Chat-App oder die Karte zu einem unerwarteten Ergebnis führt. z. B. wird eine Kartennachricht angezeigt werden.
Auch wenn in der Chat-Benutzeroberfläche möglicherweise keine Fehlermeldung angezeigt wird, beschreibende Fehlermeldungen und Protokolldaten stehen zur Fehlerbehebung zur Verfügung. wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist. Hilfe bei der Anzeige: Debugging und Beheben von Fehlern finden Sie unter Google Chat-Fehler beheben
Weitere Informationen
- Verwenden Sie den Card Builder, um JSON-Kartennachrichten für Chat-Apps entwerfen und als Vorschau ansehen
- Nachrichten formatieren
- Details zu einer Nachricht abrufen
- Nachrichten in einem Gruppenbereich auflisten
- Nachricht aktualisieren
- Nachricht löschen
- Nutzer in Google Chat-Nachrichten identifizieren
- Nachrichten mit eingehenden Webhooks an Google Chat senden