- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- MessageReplyOption
- Testen!
Erstellt eine Nachricht in einem Google Chat-Gruppenbereich. Ein Beispiel finden Sie unter Nachricht senden.
Für die Methode create()
ist entweder eine Nutzerauthentifizierung oder eine App-Authentifizierung erforderlich. In Google Chat wird der Absender der Nachricht je nach Art der Authentifizierung, die Sie in Ihrer Anfrage verwenden, unterschiedlich zugeordnet.
Die folgende Abbildung zeigt, wie Google Chat eine Nachricht zuordnet, wenn Sie die App-Authentifizierung verwenden. In Google Chat wird die Chat-App als Absender der Nachricht angezeigt. Der Inhalt der Nachricht kann Text (text
), Karten (cardsV2
) und Zubehör-Widgets (accessoryWidgets
) enthalten.
Das folgende Bild zeigt, wie Chat eine Nachricht zuordnet, wenn Sie die Nutzerauthentifizierung verwenden. In Google Chat wird der Nutzer als Absender der Nachricht angezeigt. Die Chat-App wird der Nachricht durch Anzeigen des Namens zugeordnet. Der Inhalt der Nachricht darf nur Text enthalten (text
).
Die maximale Nachrichtengröße, einschließlich des Nachrichteninhalts, beträgt 32.000 Byte.
HTTP-Anfrage
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Der Ressourcenname des Gruppenbereichs, in dem eine Nachricht erstellt werden soll. Format: |
Suchparameter
Parameter | |
---|---|
threadKey |
Optional. Verworfen. Verwenden Sie stattdessen |
request |
Optional. Eine eindeutige Anfrage-ID für diese Nachricht. Wenn Sie eine vorhandene Anfrage-ID angeben, wird die mit dieser ID erstellte Nachricht zurückgegeben, anstatt eine neue Nachricht zu erstellen. |
message |
Optional. Gibt an, ob eine Nachricht einen Thread startet oder darauf antwortet. Nur in benannten Gruppenbereichen unterstützt. |
message |
Optional. Eine benutzerdefinierte ID für eine Nachricht. Hiermit können Chat-Apps Nachrichten abrufen, aktualisieren oder löschen, ohne die vom System zugewiesene ID im Ressourcennamen der Nachricht speichern zu müssen (wird im Feld Der Wert für dieses Feld muss die folgenden Anforderungen erfüllen:
|
Anfragetext
Der Anfragetext enthält eine Instanz von Message
.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Message
.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.create
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
MessageReplyOption
Gibt an, wie auf eine Nachricht geantwortet werden soll. Weitere Bundesländer werden möglicherweise in Zukunft hinzugefügt.
Enums | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Standard. Startet einen neuen Thread. Bei Verwendung dieser Option werden alle enthaltenen thread ID oder ignoriert. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Erstellt die Nachricht als Antwort auf den in thread ID oder angegebenen Thread. Andernfalls wird mit der Nachricht stattdessen ein neuer Thread gestartet. |
REPLY_MESSAGE_OR_FAIL |
Erstellt die Nachricht als Antwort auf den in thread ID oder angegebenen Thread. Wenn eine neue threadKey verwendet wird, wird ein neuer Thread erstellt. Wenn die Nachricht nicht erstellt werden kann, wird stattdessen der Fehler NOT_FOUND zurückgegeben. |