Method: spaces.messages.create

Erstellt eine Nachricht in einem Google Chat-Gruppenbereich. Ein Beispiel finden Sie unter Nachricht senden.

Für die Methode create() ist entweder eine Nutzerauthentifizierung oder eine App-Authentifizierung erforderlich. In Google Chat wird der Absender der Nachricht je nach Art der Authentifizierung, die Sie in Ihrer Anfrage verwenden, unterschiedlich zugeordnet.

Auf dem folgenden Bild ist zu sehen, wie eine Nachricht in Google Chat zugeordnet wird, 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

Das folgende Bild zeigt, wie Chat eine Nachricht zuordnet, wenn Sie die Nutzerauthentifizierung verwenden. In Google Chat wird der Nutzer als Absender der Nachricht angezeigt und die Chat-App wird der Nachricht durch Angabe ihres Namens zugeordnet. Der Inhalt der Nachricht darf nur Text (text) enthalten.

Nachricht mit Nutzerauthentifizierung gesendet

Die maximale Nachrichtengröße, einschließlich des Nachrichteninhalts, beträgt 32.000 Byte.

Bei webhook enthält die Antwort nicht die vollständige Nachricht. In der Antwort werden nur die Felder name und thread.name zusätzlich zu den Informationen aus der Anfrage ausgefüllt.

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. Verworfen. Verwenden Sie stattdessen thread.thread_key. ID für den Thread. Unterstützt bis zu 4.000 Zeichen. Wenn Sie einen Thread starten oder ihm eine Nachricht hinzufügen möchten, erstellen Sie eine Nachricht und geben Sie eine threadKey oder die thread.name an. Eine Beispielanwendung 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, anstatt eine neue Nachricht zu erstellen.
messageReplyOption

enum (MessageReplyOption)

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

Wenn Sie auf Nutzerinteraktionen reagieren, wird dieses Feld ignoriert. Bei Interaktionen innerhalb eines Threads wird die Antwort im selben Thread erstellt. Andernfalls wird die Antwort als neuer Thread erstellt.
messageId

string

Optional. Eine benutzerdefinierte ID für eine Nachricht. Ermöglicht es Chat-Apps, eine Nachricht abzurufen, zu aktualisieren oder zu löschen, ohne die vom System zugewiesene ID im Ressourcennamen der Nachricht (im Feld name der Nachricht) speichern zu müssen.

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

  • Beginnt mit client-. Beispiel: client-custom-name ist eine gültige benutzerdefinierte ID, custom-name jedoch nicht.
  • Enthält bis zu 63 Zeichen und nur Kleinbuchstaben, Ziffern und Bindestriche.
  • Darf innerhalb eines Gruppenbereichs nur einmal vorkommen. Eine Chat-App kann nicht dieselbe benutzerdefinierte ID für unterschiedliche Nachrichten verwenden.

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.

MessageReplyOption

Gibt an, wie auf eine Nachricht geantwortet werden soll. Weitere Bundesländer werden möglicherweise in Zukunft 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 Die Nachricht wird als Antwort auf den Thread erstellt, der durch thread ID oder threadKey angegeben wird. Andernfalls wird durch die Nachricht stattdessen ein neuer Thread gestartet.
REPLY_MESSAGE_OR_FAIL Die Nachricht wird als Antwort auf den Thread erstellt, der durch thread ID oder threadKey angegeben wird. Wenn ein neuer threadKey verwendet wird, wird ein neuer Thread erstellt. Wenn die Nachrichtenerstellung fehlschlägt, wird stattdessen ein NOT_FOUND-Fehler zurückgegeben.