- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- MessageReplyOption
- Testen!
Erstellt eine Nachricht in einem Google Chat-Bereich. Ein Beispiel finden Sie unter Nachricht erstellen.
Für den Aufruf dieser Methode ist eine Authentifizierung erforderlich. Folgende Authentifizierungstypen werden unterstützt:
- Für SMS wird die Nutzer- oder App-Authentifizierung unterstützt.
- Für Kartennachrichten wird nur die App-Authentifizierung unterstützt. Nur Chat-Apps können Kartennachrichten 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: Verwende 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, anstatt eine neue Nachricht zu erstellen. |
messageReplyOption |
Optional. Gibt an, ob eine Nachricht einen Thread startet oder darauf antwortet. Wird nur in benannten Gruppenbereichen unterstützt. |
messageId |
Optional. Ein benutzerdefinierter Name für eine Chatnachricht, der bei der Erstellung zugewiesen wurde. 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.
MessageReplyOption
Gibt an, wie auf eine Nachricht geantwortet wird. In Zukunft werden möglicherweise weitere Bundesstaaten 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. Wenn der Vorgang fehlschlägt, 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. Bei Verwendung eines neuen threadKey wird ein neuer Thread erstellt. Wenn die Nachricht nicht erstellt werden kann, wird stattdessen der Fehler NOT_FOUND zurückgegeben. |