REST Resource: spaces.messages

Ressource: Nachricht

Eine Nachricht in einem Google Chat-Bereich.

JSON-Darstellung
{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}
Felder
name

string

Ressourcenname der Nachricht.

Format: spaces/{space}/messages/{message}

Dabei ist {space} die ID des Gruppenbereichs, in dem die Nachricht gepostet wird, und {message} eine vom System zugewiesene ID für die Nachricht. Beispiel: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

Wenn Sie beim Erstellen einer Nachricht eine benutzerdefinierte ID festlegen, können Sie diese ID verwenden, um die Nachricht in einer Anfrage anzugeben. Ersetzen Sie dazu {message} durch den Wert aus dem Feld clientAssignedMessageId. Beispiel: spaces/AAAAAAAAAAA/messages/client-custom-name Weitere Informationen finden Sie im Hilfeartikel Nachrichten benennen.

sender

object (User)

Nur Ausgabe. Der Nutzer, der die Nachricht erstellt hat. Wenn sich Ihre Chat-App als Nutzer authentifiziert, wird die Ausgabe in den Feldern Nutzer name und type ausgefüllt.

createTime

string (Timestamp format)

Optional. Nicht veränderbar. Bei Gruppenbereichen, die in Google Chat erstellt wurden, der Zeitpunkt, zu dem die Nachricht erstellt wurde. Dieses Feld wird nur für die Ausgabe verwendet, es sei denn, es wird in Bereichen im Importmodus verwendet.

Legen Sie für Gruppenbereiche im Importmodus dieses Feld auf den historischen Zeitstempel fest, zu dem die Nachricht in der Quelle erstellt wurde, um den ursprünglichen Erstellungszeitpunkt beizubehalten.

lastUpdateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Nachricht zuletzt von einem Nutzer bearbeitet wurde. Wenn die Nachricht noch nie bearbeitet wurde, ist dieses Feld leer.

deleteTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Nachricht in Google Chat gelöscht wurde. Wenn die Nachricht nie gelöscht wird, ist dieses Feld leer.

text

string

Nur-Text der Nachricht. Über den ersten Link zu einem Bild, einem Video oder einer Webseite wird ein Vorschau-Chip generiert. Sie können auch einen Google Chat-Nutzer oder alle Personen im Gruppenbereich@erwähnen.

Weitere Informationen zum Erstellen von SMS finden Sie unter Nachrichten senden.

formattedText

string

Nur Ausgabe. Enthält die Nachricht text mit Markups, die hinzugefügt wurden, um die Formatierung zu kommunizieren. Dieses Feld erfasst möglicherweise nicht alle Formatierungen, die in der Benutzeroberfläche sichtbar sind, enthält aber Folgendes:

  • Markup-Syntax für Fett- und Kursivformatierung, durchgestrichene Zeichen, Festbreiten- und Monospace-Blocks und Aufzählungslisten.

  • Nutzererwähnungen im Format <users/{user}>

  • Benutzerdefinierte Hyperlinks im Format <{url}|{rendered_text}>, wobei der erste String die URL und der zweite der gerenderte Text ist, z. B. <http://example.com|custom text>.

  • Benutzerdefinierte Emojis im Format :{emojiName}:, z. B. :smile:. Dies gilt nicht für Unicode-Emojis, z. B. U+1F600 für ein grinsendes Gesicht.

Weitere Informationen finden Sie im Hilfeartikel In Nachrichten gesendete Textformatierungen ansehen.

cards[]
(deprecated)

object (Card)

Eingestellt: Verwende stattdessen cardsV2.

Umfangreiche, formatierte und interaktive Karten, mit denen Sie UI-Elemente wie formatierte Texte, Schaltflächen und anklickbare Bilder darstellen können. Karten werden normalerweise unter dem Nur-Text der Nachricht angezeigt. cards und cardsV2 dürfen eine maximale Größe von 32 KB haben.

cardsV2[]

object (CardWithId)

Ein Array mit Karten.

Nur Chat-Apps können Karten erstellen. Wenn sich Ihre Chat-App als Nutzer authentifiziert, dürfen die Nachrichten keine Karten enthalten.

Informationen zum Erstellen einer Nachricht, die Karten enthält, finden Sie im Hilfeartikel Nachrichten senden.

Entwerfen Sie Karten mit dem Card Builder und zeigen Sie Vorschauen an.

Card Builder öffnen

annotations[]

object (Annotation)

Nur Ausgabe. Annotationen, die mit text in dieser Nachricht verknüpft sind.

thread

object (Thread)

Der Thread, zu dem die Nachricht gehört. Anwendungsbeispiele finden Sie im Hilfeartikel Unterhaltungen starten oder beantworten.

space

object (Space)

Wenn sich Ihre Chat-App als Nutzer authentifiziert, wird die Ausgabe im Bereich name dargestellt.

fallbackText

string

Eine Klartextbeschreibung der Karten der Nachricht, die verwendet wird, wenn die eigentlichen Karten nicht angezeigt werden können, z. B. mobile Benachrichtigungen.

actionResponse

object (ActionResponse)

Nur Eingabe. Parameter, mit denen in einer Chat-App konfiguriert werden kann, wie Antworten gepostet werden.

argumentText

string

Nur Ausgabe. Nur-Text der Nachricht, wobei alle Erwähnungen in der Google Chat App entfernt wurden.

slashCommand

object (SlashCommand)

Nur Ausgabe. Informationen zu Slash-Befehlen, falls vorhanden.

attachment[]

object (Attachment)

Vom Nutzer hochgeladener Anhang.

matchedUrl

object (MatchedUrl)

Nur Ausgabe. Eine URL in spaces.messages.text, die mit einem Muster für die Linkvorschau übereinstimmt. Weitere Informationen finden Sie unter Vorschaulinks.

threadReply

boolean

Nur Ausgabe. Wenn true, ist die Nachricht eine Antwort in einem Antwortthread. Wenn false, wird die Nachricht in der Unterhaltung der obersten Ebene des Gruppenbereichs entweder als erste Nachricht einer Unterhaltung oder als Nachricht ohne Unterhaltungsthreads angezeigt.

Wenn in einem Gruppenbereich keine Antworten in Threads unterstützt werden, lautet das Feld immer false.

clientAssignedMessageId

string

Optional. Eine benutzerdefinierte ID für die Nachricht. Sie können das Feld verwenden, um eine Nachricht zu identifizieren oder eine Nachricht abzurufen, zu löschen oder zu aktualisieren. Geben Sie beim Erstellen der Nachricht das Feld messageId an, um eine benutzerdefinierte ID festzulegen. Weitere Informationen finden Sie im Hilfeartikel Nachrichten benennen.

emojiReactionSummaries[]

object (EmojiReactionSummary)

Nur Ausgabe. Die Liste der Zusammenfassungen der Emoji-Reaktionen in der Nachricht.

privateMessageViewer

object (User)

Nicht veränderbar. Eingabe zum Erstellen einer Nachricht, andernfalls nur Ausgabe. Der Nutzer, der die Nachricht ansehen kann. Wenn dies festgelegt ist, ist die Nachricht privat und nur für den angegebenen Nutzer und die Chat-App sichtbar. Wenn Sie dieses Feld in Ihre Anfrage aufnehmen möchten, müssen Sie die Chat API mithilfe der App-Authentifizierung aufrufen und Folgendes weglassen:

Weitere Informationen finden Sie im Hilfeartikel Nachrichten privat senden.

deletionMetadata

object (DeletionMetadata)

Nur Ausgabe. Informationen zu einer gelöschten Nachricht. Eine Nachricht wird gelöscht, wenn deleteTime festgelegt ist.

quotedMessageMetadata

object (QuotedMessageMetadata)

Nur Ausgabe. Informationen zu einer Nachricht, die von einem Google Chat-Nutzer in einem Gruppenbereich zitiert wurde. Google Chat-Nutzer können eine Nachricht zitieren, um darauf zu antworten.

attachedGifs[]

object (AttachedGif)

Nur Ausgabe. GIF-Bilder, die an die Nachricht angehängt sind.

accessoryWidgets[]

object (AccessoryWidget)

Ein oder mehrere interaktive Widgets, die unten in einer Nachricht angezeigt werden. Sie können Zubehör-Widgets zu Nachrichten hinzufügen, die Text, Karten oder sowohl Text als auch Karten enthalten. Nicht unterstützt für Meldungen, die Dialogfelder enthalten. Weitere Informationen finden Sie im Hilfeartikel Interaktive Widgets am Ende einer Nachricht hinzufügen.

Zum Erstellen einer Mitteilung mit Zubehör-Widgets ist die App-Authentifizierung erforderlich.

CardWithId

Eine Karte in einer Google Chat-Nachricht.

Nur Chat-Apps können Karten erstellen. Wenn sich Ihre Chat-App als Nutzer authentifiziert, darf die Nachricht keine Karten enthalten.

Entwerfen Sie Karten mit dem Card Builder und zeigen Sie Vorschauen an.

Card Builder öffnen

JSON-Darstellung
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
Felder
cardId

string

Erforderlich, wenn die Nachricht mehrere Karten enthält. Eine eindeutige Kennung für eine Karte in einer Nachricht.

card

object (Card)

Eine Infokarte Die maximale Größe beträgt 32 KB.

Annotation

Nur Ausgabe. Mit dem Nur-Text-Text der Nachricht verknüpfte Annotationen. Informationen zum grundlegenden Formatieren von SMS finden Sie unter Textnachrichten formatieren.

Beispiel für einen Nachrichtentext:

Hello @FooBot how are you!"

Die entsprechenden Metadaten der Annotationen:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
JSON-Darstellung
{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  }
  // End of list of possible types for union field metadata.
}
Felder
type

enum (AnnotationType)

Der Typ dieser Anmerkung.

length

integer

Länge der Teilzeichenfolge im Nur-Text-Nachrichtentext, der diese Anmerkung entspricht.

startIndex

integer

Startindex (0-basiert, einschließlich) im Nur-Text-Nachrichtentext, dem diese Annotation entspricht.

Union-Feld metadata. Zusätzliche Metadaten zur Anmerkung. Für metadata ist nur einer der folgenden Werte zulässig:
userMention

object (UserMentionMetadata)

Die Metadaten der Nutzererwähnung.

slashCommand

object (SlashCommandMetadata)

Die Metadaten für einen Slash-Befehl.

AnnotationType

Typ der Anmerkung.

Enums
ANNOTATION_TYPE_UNSPECIFIED Standardwert für die Aufzählung. Nicht verwenden.
USER_MENTION Ein Nutzer wird erwähnt.
SLASH_COMMAND Ein Slash-Befehl wird aufgerufen.

UserMentionMetadata

Annotationsmetadaten für Nutzererwähnungen (@).

JSON-Darstellung
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
Felder
user

object (User)

Der Nutzer hat etwas erwähnt.

type

enum (Type)

Der Typ der Nutzererwähnung.

Typ

Enums
TYPE_UNSPECIFIED Standardwert für die Aufzählung. Nicht verwenden.
ADD Nutzer zu Gruppenbereich hinzufügen.
MENTION Nutzer im Gruppenbereich erwähnen.

SlashCommandMetadata

Annotationsmetadaten für Slash-Befehle (/).

JSON-Darstellung
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
Felder
bot

object (User)

Die Chat-App, deren Befehl aufgerufen wurde.

type

enum (Type)

Der Typ des Slash-Befehls.

commandName

string

Der Name des aufgerufenen Slash-Befehls.

commandId

string (int64 format)

Die Befehls-ID des aufgerufenen Slash-Befehls.

triggersDialog

boolean

Gibt an, ob der Slash-Befehl für ein Dialogfeld bestimmt ist.

Typ

Enums
TYPE_UNSPECIFIED Standardwert für die Aufzählung. Nicht verwenden.
ADD Chat-App zu Gruppenbereich hinzufügen.
INVOKE Rufen Sie den Slash-Befehl im Leerzeichen auf.

RichLinkMetadata

Ein Rich-Link zu einer Ressource.

JSON-Darstellung
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

  // Union field data can be only one of the following:
  "driveLinkData": {
    object (DriveLinkData)
  },
  "chatSpaceLinkData": {
    object (ChatSpaceLinkData)
  }
  // End of list of possible types for union field data.
}
Felder
uri

string

Der URI dieses Links.

Union-Feld data. Daten für die verknüpfte Ressource. Für data ist nur einer der folgenden Werte zulässig:

RichLinkType

Der Rich-Link-Typ. In Zukunft werden möglicherweise weitere Typen hinzugefügt.

Enums
DRIVE_FILE Ein Rich-Link-Typ für Google Drive.
CHAT_SPACE Ein Rich-Link-Typ für Chatbereiche. Beispiel: ein Smartchip für den Weltraum.

DriveLinkData

Daten für Google Drive-Links.

JSON-Darstellung
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
Felder
driveDataRef

object (DriveDataRef)

Eine DriveDataRef, die auf eine Google Drive-Datei verweist.

mimeType

string

Der MIME-Typ der verknüpften Google Drive-Ressource.

ChatSpaceLinkData

Daten für Links zu Chatbereichen.

JSON-Darstellung
{
  "space": string,
  "thread": string,
  "message": string
}
Felder
space

string

Der Bereich der verknüpften Chatbereich-Ressource.

Format: spaces/{space}

thread

string

Der Thread der verknüpften Chatbereich-Ressource.

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

message

string

Die Nachricht der verknüpften Chatbereichsressource.

Format: spaces/{space}/messages/{message}

Thread

Thread in einem Google Chat-Bereich. Anwendungsbeispiele finden Sie im Hilfeartikel Unterhaltungen starten oder beantworten.

Wenn Sie beim Erstellen einer Nachricht einen Thread angeben, können Sie über das Feld messageReplyOption festlegen, was passiert, wenn keine passende Unterhaltung gefunden wird.

JSON-Darstellung
{
  "name": string,
  "threadKey": string
}
Felder
name

string

Ressourcenname des Threads.

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

threadKey

string

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

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

ActionResponse

Parameter, mit denen in einer Chat-App konfiguriert werden kann, wie Antworten gepostet werden.

JSON-Darstellung
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
Felder
type

enum (ResponseType)

Nur Eingabe. Der Typ der Chat-App-Antwort.

url

string

Nur Eingabe. URL zum Authentifizieren oder Konfigurieren. (Nur für REQUEST_CONFIG-Antworttypen.)

dialogAction

object (DialogAction)

Nur Eingabe. Eine Antwort auf ein Interaktionsereignis, das mit einem Dialogfeld zusammenhängt. Muss von ResponseType.Dialog begleitet werden.

updatedWidget

object (UpdatedWidget)

Nur Eingabe. Die Antwort des aktualisierten Widgets.

ResponseType

Der Typ der Chat-App-Antwort.

Enums
TYPE_UNSPECIFIED Standardtyp, der als NEW_MESSAGE behandelt wird.
NEW_MESSAGE Als neue Nachricht im Thema posten.
UPDATE_MESSAGE Aktualisieren Sie die Nachricht der Chat-App. Dies ist nur bei einem CARD_CLICKED-Ereignis zulässig, bei dem der Absendertyp der Nachricht BOT ist.
UPDATE_USER_MESSAGE_CARDS Karten in der Nachricht eines Nutzers aktualisieren. Dies ist nur als Antwort auf ein MESSAGE-Ereignis mit einer übereinstimmenden URL oder auf ein CARD_CLICKED-Ereignis mit dem Absendertyp HUMAN zulässig. Text wird ignoriert.
REQUEST_CONFIG Nutzer privat um eine zusätzliche Authentifizierung oder Konfiguration bitten
DIALOG Zeigt ein Dialogfeld an.
UPDATE_WIDGET Abfrage der Optionen für die automatische Vervollständigung von Widget-Texten.

DialogAction

Enthält ein dialog-Fenster und einen Statuscode für die Anfrage.

JSON-Darstellung
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
Felder
actionStatus

object (ActionStatus)

Nur Eingabe. Status für eine Anfrage zum Aufrufen oder Senden eines Dialogfelds. Zeigt Nutzern bei Bedarf einen Status und eine Nachricht an. beispielsweise bei einem Fehler oder Erfolg.

Union-Feld action. Auszuführende Aktion Für action ist nur einer der folgenden Werte zulässig:
dialog

object (Dialog)

Nur Eingabe. Dialog (Dialogfeld) für die Anfrage.

Dialog

Wrapper um den Kartentext des Dialogfelds.

JSON-Darstellung
{
  "body": {
    object (Card)
  }
}
Felder
body

object (Card)

Nur Eingabe. Text des Dialogfelds, der in einem modalen Fenster gerendert wird. Die folgenden Kartenentitäten werden in Google Chat-Apps nicht unterstützt: DateTimePicker, OnChangeAction.

ActionStatus

Stellt den Status für eine Anfrage zum Aufrufen oder Senden eines Dialogfelds dar.

JSON-Darstellung
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
Felder
statusCode

enum (Code)

Der Statuscode.

userFacingMessage

string

Die Nachricht, die Nutzern über den Status ihrer Anfrage gesendet wird. Wenn die Richtlinie nicht konfiguriert ist, wird eine generische Nachricht basierend auf dem statusCode gesendet.

Code

Die kanonischen Fehlercodes für gRPC APIs.

Manchmal können mehrere Fehlercodes zutreffen. Dienste sollten den spezifischsten Fehlercode liefern, der zutrifft. Beispiel: OUT_OF_RANGE sollte gegenüber FAILED_PRECONDITION bevorzugt werden, wenn beide Codes zutreffen. Entsprechend ist NOT_FOUND oder ALREADY_EXISTS gegenüber FAILED_PRECONDITION vorzuziehen.

Enums
OK

Kein Fehler; wird bei Erfolg angezeigt

HTTP Mapping: 200 OK

CANCELLED

Der Vorgang wurde abgebrochen, üblicherweise vom Aufrufer.

HTTP Mapping: 499 Client Closed Request

UNKNOWN

Unbekannter Fehler. Dieser Fehler wird beispielsweise ausgegeben, wenn ein Status-Wert, der von einem anderen Adressbereich stammt, zu einem Fehlerbereich gehört, der in diesem Adressbereich nicht bekannt ist. Auch Fehler, die von APIs ausgelöst werden, die nicht genügend Fehlerinformationen liefern, können in diesen Fehler umgewandelt werden.

HTTP Mapping: 500 Internal Server Error

INVALID_ARGUMENT

Der Client hat ein ungültiges Argument angegeben. Dieser Wert ist nicht identisch mit FAILED_PRECONDITION. INVALID_ARGUMENT gibt Argumente an, die ungeachtet des Systemstatus problematisch sind (z. B. ein ungültiger Dateiname).

HTTP Mapping: 400 Bad Request

DEADLINE_EXCEEDED

Die Frist ist abgelaufen, bevor der Vorgang abgeschlossen werden konnte. Bei Vorgängen, die den Systemstatus verändern, kann dieser Fehler angezeigt werden, auch wenn der Vorgang erfolgreich abgeschlossen wurde. Zum Beispiel könnte eine erfolgreiche Antwort von einem Server so lange verzögert worden sein, dass die Frist abgelaufen ist.

HTTP Mapping: 504 Gateway Timeout

NOT_FOUND

Eine angeforderte Entität (z. B. Datei oder Verzeichnis) wurde nicht gefunden.

Hinweis für Serverentwickler: Wenn eine Anfrage, z. B. eine schrittweise Einführung von Funktionen oder eine undokumentierte Zulassungsliste, für eine gesamte Nutzerklasse abgelehnt wird, kann NOT_FOUND verwendet werden. Wenn eine Anfrage, z. B. nutzerbasierte Zugriffssteuerung, für einige Nutzer innerhalb einer Nutzerklasse abgelehnt wird, muss PERMISSION_DENIED verwendet werden.

HTTP Mapping: 404 Not Found

ALREADY_EXISTS

Die Entität, die ein Client erstellen wollte (z. B. eine Datei oder ein Verzeichnis), ist bereits vorhanden.

HTTP Mapping: 409 Conflict

PERMISSION_DENIED

Der Aufrufer hat keine Berechtigung zur Ausführung des angegebenen Vorgangs. PERMISSION_DENIED darf nicht für Ablehnungen verwendet werden, die dadurch verursacht werden, dass eine Ressource erschöpft ist (verwenden Sie stattdessen RESOURCE_EXHAUSTED für diese Fehler). PERMISSION_DENIED darf nicht verwendet werden, wenn der Aufrufer nicht ermittelt werden kann (verwenden Sie stattdessen UNAUTHENTICATED für diese Fehler). Dieser Fehlercode impliziert nicht, dass die Anfrage gültig ist oder die angefragte Entität existiert oder andere Vorbedingungen erfüllt.

HTTP Mapping: 403 Forbidden

UNAUTHENTICATED

Die Anfrage enthält keine gültigen Authentifizierungsanmeldedaten für diesen Vorgang.

HTTP Mapping: 401 Unauthorized

RESOURCE_EXHAUSTED

Eine Ressource, z. B. ein nutzerbezogenes Kontingent, ist erschöpft oder der Speicherplatz für das gesamte Dateisystem ist ausgegangen.

HTTP Mapping: 429 Too Many Requests

FAILED_PRECONDITION

Der Vorgang wurde abgelehnt, weil der Systemzustand nicht für die Ausführung des Vorgangs geeignet ist. Beispielsweise ist das zu löschende Verzeichnis nicht leer, ein rmdir-Vorgang wird auf eine Ressource angewendet, die kein Verzeichnis ist, usw.

Dienstimplementierungen können anhand der folgenden Richtlinien zwischen FAILED_PRECONDITION, ABORTED und UNAVAILABLE entscheiden: (a) Verwenden Sie UNAVAILABLE, wenn der Client nur den fehlgeschlagenen Aufruf wiederholen kann. (b) Verwende ABORTED, wenn der Client den Vorgang auf einer höheren Ebene wiederholen soll. Wenn beispielsweise ein vom Client angegebener Test-and-Set-Vorgang fehlschlägt, wird angezeigt, dass der Client eine Read-Modify-Write-Sequenz neu starten soll. (c) Sollte der Client den Fehler nicht wiederholen, bis der Systemstatus ausdrücklich festgelegt wurde, verwenden Sie FAILED_PRECONDITION. Wenn beispielsweise ein "rmdir" fehlschlägt, weil das Verzeichnis nicht leer ist, sollte FAILED_PRECONDITION angezeigt werden, da der Client den erneuten Versuch erst dann machen sollte, wenn die Dateien aus dem Verzeichnis gelöscht wurden.

HTTP Mapping: 400 Bad Request

ABORTED

Der Vorgang wurde abgebrochen, in der Regel aufgrund eines Parallelitätsproblems wie einer fehlgeschlagenen Sequencer-Überprüfung oder einer abgebrochenen Transaktion.

Siehe obige Richtlinien zum Abwägen zwischen FAILED_PRECONDITION, ABORTED und UNAVAILABLE.

HTTP Mapping: 409 Conflict

OUT_OF_RANGE

Beim Vorgang wurde versucht, den gültigen Bereich zu überschreiten. Beispiel: Such- oder Lesevorgang über das Dateiende hinaus.

Im Gegensatz zu INVALID_ARGUMENT zeigt dieser Fehler ein Problem an, das behoben werden kann, wenn sich der Systemstatus ändert. Zum Beispiel erzeugt ein 32-Bit-Dateisystem INVALID_ARGUMENT, wenn es in einem Bereich lesen soll, der nicht innerhalb des Bereichs [0,2^32-1] liegt. Dagegen generiert es OUT_OF_RANGE, wenn für einen Bereich gelesen werden soll, der die aktuelle Dateigröße übersteigt.

Es gibt einige Überschneidungen zwischen FAILED_PRECONDITION und OUT_OF_RANGE. Wir empfehlen die Verwendung von OUT_OF_RANGE (der spezifischere Fehler), wenn dies zutrifft, damit die Aufrufer, die über einen Bereich iterieren, einfach nach einem OUT_OF_RANGE-Fehler suchen können, wenn sie fertig sind.

HTTP Mapping: 400 Bad Request

UNIMPLEMENTED

Dieser Vorgang ist nicht implementiert oder wird bei diesem Dienst nicht unterstützt bzw. ist bei diesem Dienst nicht aktiviert.

HTTP Mapping: 501 Not Implemented

INTERNAL

Interne Fehler. Das bedeutet, dass einige Invarianten, die vom zugrunde liegenden System erwartet werden, nicht erfüllt wurden. Dieser Fehlercode ist für schwerwiegende Fehler reserviert.

HTTP Mapping: 500 Internal Server Error

UNAVAILABLE

Der Dienst ist derzeit nicht verfügbar. Dies ist höchstwahrscheinlich ein vorübergehender Zustand, der durch Wiederholen mit einem Backoff korrigiert werden kann. Es ist nicht immer sicher, nicht idempotente Vorgänge zu wiederholen.

Siehe obige Richtlinien zum Abwägen zwischen FAILED_PRECONDITION, ABORTED und UNAVAILABLE.

HTTP Mapping: 503 Service Unavailable

DATA_LOSS

Dauerhafter Datenverlust oder Datenkorruption.

HTTP Mapping: 500 Internal Server Error

UpdatedWidget

Die Antwort des aktualisierten Widgets. Wird verwendet, um Optionen zur automatischen Vervollständigung für ein Widget bereitzustellen.

JSON-Darstellung
{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}
Felder
widget

string

Die ID des aktualisierten Widgets. Die ID muss mit der ID des Widgets übereinstimmen, das die Aktualisierungsanfrage ausgelöst hat.

Union-Feld updated_widget. Das Widget wurde als Reaktion auf eine Nutzeraktion aktualisiert. Für updated_widget ist nur einer der folgenden Werte zulässig:
suggestions

object (SelectionItems)

Liste der Ergebnisse der automatischen Vervollständigung von Widgets

SelectionItems

Liste der Ergebnisse der automatischen Vervollständigung von Widgets.

JSON-Darstellung
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
Felder
items[]

object (SelectionItem)

Ein Array der SelectionItem-Objekte.

SlashCommand

Einen Slash-Befehl in Google Chat.

JSON-Darstellung
{
  "commandId": string
}
Felder
commandId

string (int64 format)

Die ID des aufgerufenen Slash-Befehls.

MatchedUrl

Eine übereinstimmende URL in einer Chatnachricht. Chat-Apps können sich übereinstimmende URLs in der Vorschau ansehen. Weitere Informationen finden Sie unter Vorschaulinks.

JSON-Darstellung
{
  "url": string
}
Felder
url

string

Nur Ausgabe. Die übereinstimmende URL.

EmojiReactionSummary

Die Anzahl der Personen, die auf eine Nachricht mit einem bestimmten Emoji reagiert haben.

JSON-Darstellung
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
Felder
emoji

object (Emoji)

Mit den Reaktionen verknüpftes Emoji.

reactionCount

integer

Die Gesamtzahl der Reaktionen mit dem zugehörigen Emoji.

DeletionMetadata

Informationen zu einer gelöschten Nachricht. Eine Nachricht wird gelöscht, wenn deleteTime festgelegt ist.

JSON-Darstellung
{
  "deletionType": enum (DeletionType)
}
Felder
deletionType

enum (DeletionType)

Gibt an, wer die Nachricht gelöscht hat.

DeletionType

Wer die Nachricht gelöscht hat und wie sie gelöscht wurde.

Enums
DELETION_TYPE_UNSPECIFIED Dieser Wert wird nicht verwendet.
CREATOR Ein Nutzer hat seine eigene Nachricht gelöscht.
SPACE_OWNER Der Eigentümer des Gruppenbereichs hat die Nachricht gelöscht.
ADMIN Ein Google Workspace-Administrator hat die Nachricht gelöscht.
APP_MESSAGE_EXPIRY Eine Chat-App hat ihre eigene Nachricht gelöscht, nachdem sie abgelaufen ist.
CREATOR_VIA_APP Eine Chat-App hat die Nachricht im Namen des Nutzers gelöscht.
SPACE_OWNER_VIA_APP Eine Chat-App hat die Nachricht im Namen des Inhabers des Gruppenbereichs gelöscht.

QuotedMessageMetadata

Informationen zu einer zitierten Nachricht.

JSON-Darstellung
{
  "name": string,
  "lastUpdateTime": string
}
Felder
name

string

Nur Ausgabe. Ressourcenname der in Anführungszeichen gesetzten Nachricht.

Format: spaces/{space}/messages/{message}

lastUpdateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die zitierte Nachricht erstellt oder die zitierte Nachricht zuletzt aktualisiert wurde.

AttachedGif

Ein GIF-Bild, das durch eine URL angegeben wird.

JSON-Darstellung
{
  "uri": string
}
Felder
uri

string

Nur Ausgabe. Die URL, auf der das GIF-Bild gehostet wird.

AccessoryWidget

Ein oder mehrere interaktive Widgets, die unten in einer Nachricht angezeigt werden. Weitere Informationen finden Sie im Hilfeartikel Interaktive Widgets am Ende einer Nachricht hinzufügen.

JSON-Darstellung
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
Felder
Union-Feld action. Die Art der Aktion. Für action ist nur einer der folgenden Werte zulässig:
buttonList

object (ButtonList)

Eine Liste mit Schaltflächen.

Methoden

create

Eine Nachricht in einem Google Chat-Bereich erstellen.

delete

Löscht eine Nachricht.

get

Gibt Details zu einer Nachricht zurück.

list

Listet Nachrichten in einem Gruppenbereich auf, in dem der Anrufer Mitglied ist, einschließlich Nachrichten von blockierten Mitgliedern und Gruppenbereichen.

patch

Aktualisiert eine Nachricht.

update

Aktualisiert eine Nachricht.