- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- MessageAntwortOption
Erstellt eine Nachricht. Ein Beispiel finden Sie unter Nachricht erstellen.
Erfordert Authentifizierung.
Das Erstellen einer SMS unterstützt sowohl die Nutzerauthentifizierung als auch die App-Authentifizierung. Für die Nutzerauthentifizierung ist der Autorisierungsbereich chat.messages
oder chat.messages.create
erforderlich.
Für das Erstellen einer Kartennachricht ist eine App-Authentifizierung erforderlich
Da Google Chat eine Authentifizierung für Webhooks als Teil der URL bereitstellt, die generiert wird, wenn ein Webhook registriert wird, können Webhooks Nachrichten ohne Dienstkonto- oder Nutzerauthentifizierung erstellen.
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. Eingestellt: Verwenden Sie stattdessen |
requestId |
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, statt eine neue Nachricht zu erstellen. |
messageReplyOption |
Optional. Gibt an, ob eine Nachricht einen Thread startet oder auf eine antwortet. Wird nur in benannten Gruppenbereichen unterstützt. |
messageId |
Optional. Ein benutzerdefinierter Name für eine Chatnachricht, die beim Erstellen zugewiesen wird. Muss mit |
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.
Option für Nachrichtenantwort
Gibt an, wie auf eine Nachricht geantwortet wird. In Zukunft werden möglicherweise weitere Bundesstaaten hinzugefügt.
Enums | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Standard. Startet eine Unterhaltung. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Erstellt die Nachricht als Antwort auf den von thread ID oder angegebenen Thread. Wenn die Nachricht fehlschlägt, wird stattdessen ein neuer Thread gestartet. |
REPLY_MESSAGE_OR_FAIL |
Erstellt die Nachricht als Antwort auf den von thread ID oder angegebenen Thread. Andernfalls wird der Fehler NOT_FOUND zurückgegeben. |