REST Resource: spaces.threads

Ressource: Thread

Ein Thread in einem Google Chat-Bereich. Beispiele für die Verwendung finden Sie unter Unterhaltung starten oder auf eine Nachricht antworten.

Wenn Sie beim Erstellen einer Nachricht einen Thread angeben, können Sie im Feld messageReplyOption festlegen, was passiert, wenn kein übereinstimmender Thread gefunden wird.

JSON-Darstellung
{
  "name": string,
  "threadKey": string,
  "threadMetadata": {
    object (ThreadMetadata)
  }
}
Felder
name

string

ID. Ressourcenname des Threads.

Beispiel: spaces/{space}/threads/{thread}

threadKey

string

Optional. Eingabe zum Erstellen oder Aktualisieren eines Threads. Andernfalls nur Ausgabe. ID für den Thread. Unterstützt bis zu 4.000 Zeichen.

Diese ID ist für die Chat-App, die sie festlegt, eindeutig. Wenn beispielsweise mehrere Chat-Apps eine Nachricht mit demselben Threadschlüssel erstellen, werden die Nachrichten in verschiedenen Threads gepostet. Wenn Sie in einem Thread antworten möchten, der von einer Person oder einer anderen Chat-App erstellt wurde, geben Sie stattdessen das Feld name des Threads an.

threadMetadata

object (ThreadMetadata)

Optional. Thread-Metadaten zum Rendern und Verwalten dieses Threads als Sitzung.

ThreadMetadata

Thread-Metadaten, die zum Rendern und Verwalten einer Sitzung in Google Chat verwendet werden. Gilt nur für Apps, in denen agentische Funktionen aktiviert sind.

JSON-Darstellung
{
  "title": string,
  "icon": {
    object (Icon)
  }
}
Felder
title

string

Optional. Titel des Threads. Ein Titel, der das Thema der Sitzung beschreibt.

Die maximale Länge beträgt 1.024 Zeichen.

Wenn nichts angegeben ist, wird standardmäßig die erste Nachricht in der Sitzung verwendet.

icon

object (Icon)

Optional. Symbol des Threads. Ein Symbol, das neben dem Titel der Sitzung angezeigt wird.

Es werden nur Material Design-Symbole unterstützt. Wenn nichts angegeben ist, wird standardmäßig das Material Design-Symbol Notizen verwendet.

Symbol

Ein Symbol, das in einem Prompt oder Thread angezeigt wird.

JSON-Darstellung
{
  "altText": string,

  "materialIcon": {
    object (MaterialIcon)
  }
}
Felder
altText

string

Optional. Der Alt-Text dieses Symbols, der für die Barrierefreiheit verwendet wird.

Ein Symbol, das in einer Aufforderung angezeigt wird. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
materialIcon

object (MaterialIcon)

Zeigt eines der Google Material Design-Symbole an.

Wenn Sie beispielsweise ein Kästchensymbol anzeigen möchten, verwenden Sie Folgendes:

"materialIcon": {
  "name": "check_box"
}
Ende der sich gegenseitig ausschließenden Felder.

Methoden

get

Ruft Details zu einem Thread in einem 1:1-App-DM-Bereich ab.

list

Listet Threads in einem 1:1-App-DM-Bereich auf.

patch

Aktualisiert einen Thread in einem 1:1-App-DM-Bereich.