Method: spaces.messages.create

Eine Nachricht in einem Google Chat-Bereich erstellen. Ein Beispiel finden Sie im Hilfeartikel Nachrichten senden.

Für die Methode create() ist entweder eine Nutzer- oder Anwendungsauthentifizierung erforderlich. Chat ordnet den Absender der Nachricht je nach Authentifizierungstyp, den Sie in Ihrer Anfrage verwenden, unterschiedlich zu.

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.

Nachricht mit App-Authentifizierung gesendet

Die folgende Abbildung zeigt, wie Google 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).

Nachricht mit Nutzerauthentifizierung gesendet

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

string

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

Format: spaces/{space}

Suchparameter

Parameter
threadKey
(deprecated)

string

Optional. Eingestellt: Verwende stattdessen thread.thread_key. ID für den Thread. Unterstützt bis zu 4.000 Zeichen. Erstellen Sie eine Nachricht und geben Sie einen threadKey- oder thread.name-Wert an, um eine Konversation zu starten oder hinzuzufügen. Anwendungsbeispiele finden Sie im Hilfeartikel Konversationen 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, anstatt eine neue Nachricht zu erstellen.

messageReplyOption

enum (MessageReplyOption)

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

messageId

string

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 name der Nachricht angezeigt).

Der Wert für dieses Feld muss die folgenden Anforderungen erfüllen:

  • Beginnt mit client-. client-custom-name ist beispielsweise eine gültige benutzerdefinierte ID, custom-name jedoch nicht.
  • Sie kann bis zu 63 Zeichen enthalten und darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten.
  • Ist innerhalb eines Gruppenbereichs eindeutig. Eine Chat-App kann nicht dieselbe benutzerdefinierte ID für verschiedene Nachrichten verwenden.

Weitere Informationen finden Sie im Hilfeartikel Nachrichten benennen.

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. Eine neue Unterhaltung wird gestartet. Bei dieser Option werden alle enthaltenen thread ID oder threadKey ignoriert.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Erstellt die Nachricht als Antwort auf den in thread ID oder threadKey angegebenen Thread. Wenn der Vorgang fehlschlägt, wird stattdessen ein neuer Thread gestartet.
REPLY_MESSAGE_OR_FAIL Erstellt die Nachricht als Antwort auf den in thread ID oder threadKey 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.