Method: spaces.messages.create

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

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. Wenn Sie eine Unterhaltung beginnen oder einer Unterhaltung hinzufügen möchten, erstellen Sie eine Nachricht und geben Sie eine threadKey oder den thread.name an. Ein Beispiel dafür finden Sie unter E-Mail-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. Ein benutzerdefinierter Name für eine Chatnachricht, der bei der Erstellung zugewiesen wurde. Muss mit client- beginnen und darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten, die maximal 63 Zeichen lang sind. Geben Sie dieses Feld an, um die Nachricht mit dem angegebenen Wert abzurufen, zu aktualisieren oder zu löschen. Mit einem benutzerdefinierten Namen kann eine Chat-App die Nachricht abrufen, ohne dass die Nachricht name aus dem Antworttext gespeichert wird, der beim Erstellen der Nachricht zurückgegeben wurde. Das Zuweisen eines benutzerdefinierten Namens ersetzt nicht das generierte Feld name, also den Ressourcennamen der Nachricht. Stattdessen wird der benutzerdefinierte Name als clientAssignedMessageId-Feld festgelegt, auf das Sie bei der Verarbeitung späterer Vorgänge wie dem Aktualisieren oder Löschen der Nachricht verweisen können. Beispiele für die Verwendung finden Sie unter Erstellte Nachricht 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. Startet einen neuen Thread. Bei Verwendung 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 mit der Nachricht stattdessen ein neuer Thread gestartet.
REPLY_MESSAGE_OR_FAIL Erstellt die Nachricht als Antwort auf den in thread ID oder threadKey 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.