Method: spaces.messages.create

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

string

Erforderlich. Der Ressourcenname des Gruppenbereichs, in dem eine Nachricht erstellt werden soll.

Format: spaces/{space}

Suchparameter

Parameter
threadKey
(deprecated)

string

Optional. Eingestellt: Verwenden Sie stattdessen thread.thread_key. Undurchsichtige Thread-ID. Wenn Sie eine Unterhaltung starten oder ihr hinzufügen möchten, erstellen Sie eine Nachricht und geben Sie einen threadKey oder thread.name an. Weitere Informationen finden Sie unter Nachrichtenthreads starten oder beantworten.
requestId

string

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

enum (MessageReplyOption)

Optional. Gibt an, ob eine Nachricht einen Thread startet oder auf eine antwortet. Wird nur in benannten Gruppenbereichen unterstützt.
messageId

string

Optional. Ein benutzerdefinierter Name für eine Chatnachricht, die beim Erstellen zugewiesen wird. Muss mit client- beginnen und darf nur Kleinbuchstaben, Ziffern und Bindestriche bis zu 63 Zeichen enthalten. Geben Sie dieses Feld an, um die Nachricht mit dem angegebenen Wert abzurufen, zu aktualisieren oder zu löschen. Wenn Sie einen benutzerdefinierten Namen zuweisen, kann die Chat-App die Nachricht abrufen, ohne die Nachricht name aus dem Antworttext zu speichern, der beim Erstellen der Nachricht zurückgegeben wurde. Durch das Zuweisen eines benutzerdefinierten Namens wird das generierte name-Feld, der Ressourcenname der Nachricht, nicht ersetzt. Stattdessen wird der benutzerdefinierte Name als Feld clientAssignedMessageId festgelegt, auf das Sie bei der Verarbeitung späterer Vorgänge verweisen können, z. B. wenn Sie die Nachricht aktualisieren oder löschen. Weitere Informationen

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 threadKey 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 threadKey angegebenen Thread. Andernfalls wird der Fehler NOT_FOUND zurückgegeben.