- Ressource: Platz
- JSON-Darstellung
- Typ
- SpaceType
- SpaceThreadingState
- SpaceDetails
- HistoryState
- AccessSettings (Zugriffseinstellungen)
- AccessState
- Methoden
Ressource: Raum
Ein Gruppenbereich in Google Chat. Gruppenbereiche sind Unterhaltungen zwischen zwei oder mehr Nutzern oder 1:1-Nachrichten zwischen einem Nutzer und einer Chat-App.
JSON-Darstellung |
---|
{ "name": string, "type": enum ( |
Felder | |
---|---|
name |
Ressourcenname des Gruppenbereichs. Format: |
type |
Nur Ausgabe Eingestellt: Verwenden Sie stattdessen |
spaceType |
Die Art des Gruppenbereichs. Erforderlich, wenn ein Gruppenbereich erstellt oder dessen Typ aktualisiert wird. Ausgabe nur für andere Zwecke. |
singleUserBotDm |
Optional. Gibt an, ob der Gruppenbereich eine DN zwischen einer Chat-App und einer einzelnen Person ist. |
threaded |
Nur Ausgabe Eingestellt: Verwenden Sie stattdessen |
displayName |
Anzeigename des Gruppenbereichs Erforderlich beim Erstellen eines Gruppenbereichs. Wenn Sie beim Erstellen eines Gruppenbereichs oder beim Aktualisieren der Bei Direktnachrichten ist dieses Feld möglicherweise leer. Unterstützt bis zu 128 Zeichen. |
externalUserAllowed |
Nicht veränderbar. Gibt an, ob Google Chat-Nutzer in diesem Gruppenbereich als Mitglied zulässig sind. Eingabe beim Erstellen eines Gruppenbereichs in einer Google Workspace-Organisation. Lassen Sie dieses Feld aus, wenn Sie unter den folgenden Bedingungen Gruppenbereiche erstellen:
Bei vorhandenen Gruppenbereichen wird dieses Feld nur ausgegeben. |
spaceThreadingState |
Nur Ausgabe Der Threading-Status im Chatbereich. |
spaceDetails |
Details zum Gruppenbereich, einschließlich einer Beschreibung und Regeln |
spaceHistoryState |
Der Status des Nachrichtenverlaufs für Nachrichten und Threads in diesem Gruppenbereich. |
importMode |
Optional. Gibt an, ob dieser Gruppenbereich im Rahmen einer Datenmigration in Google Workspace in |
createTime |
Optional. Nicht veränderbar. Der Zeitpunkt, zu dem der Gruppenbereich in Google Chat erstellt wurde. Dieses Feld wird nur ausgegeben, es sei denn, es wird in Gruppenbereichen im Importmodus verwendet. Legen Sie bei Gruppenbereichen im Importmodus in diesem Feld den bisherigen Zeitstempel fest, zu dem der Gruppenbereich in der Quelle erstellt wurde, damit der ursprüngliche Erstellungszeitpunkt beibehalten wird. Wird in der Ausgabe nur dann eingefügt, wenn |
adminInstalled |
Nur Ausgabe Gibt an, ob die Chat-App von einem Google Workspace-Administrator installiert wurde. Administratoren können Chat-Apps für ihre Domain, Organisationseinheit oder eine Gruppe von Nutzern installieren. Administratoren dürfen Chat-Apps nur für Direktnachrichten zwischen Nutzern und der App installieren. Damit die Installation durch Administratoren unterstützt wird, muss sie Direktnachrichten enthalten. |
accessSettings |
Optional. Gibt die Zugriffseinstellung des Gruppenbereichs an. Wird nur gefüllt, wenn |
spaceUri |
Nur Ausgabe Der URI des Gruppenbereichs. |
Typ
Eingestellt: Verwenden Sie stattdessen SpaceType
.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Reserviert. |
ROOM |
Gespräche zwischen zwei oder mehr Menschen |
DM |
1:1-Direktnachricht zwischen einem Nutzer und einer Chat-App, bei der alle Nachrichten flach dargestellt werden. Hinweis: Dies gilt nicht für Direktnachrichten zwischen zwei Nutzern. |
SpaceType
Die Art des Gruppenbereichs. Erforderlich beim Erstellen oder Aktualisieren eines Gruppenbereichs. Ausgabe nur für andere Zwecke.
Enums | |
---|---|
SPACE_TYPE_UNSPECIFIED |
Reserviert. |
SPACE |
Ein Ort, an dem Nutzer Nachrichten senden, Dateien teilen und zusammenarbeiten können. Eine SPACE kann Chat-Apps enthalten. |
GROUP_CHAT |
Gruppenunterhaltungen zwischen drei oder mehr Personen Eine GROUP_CHAT kann Chat-Apps enthalten. |
DIRECT_MESSAGE |
1:1-Nachrichten zwischen zwei Personen oder einem Nutzer und einer Chat-App. |
SpaceThreadingState
Gibt den Typ des Threading-Status im Chatbereich an.
Enums | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
Reserviert. |
THREADED_MESSAGES |
Benannte Gruppenbereiche, in denen E-Mail-Konversationen unterstützt werden Wenn ein Nutzer auf eine Nachricht antwortet, kann er im Thread antworten, wodurch seine Antwort im Kontext der ursprünglichen Nachricht beibehalten wird. |
GROUPED_MESSAGES |
Benannte Gruppenbereiche, in denen die Unterhaltung nach Themen geordnet ist. Themen und die zugehörigen Antworten werden gruppiert. |
UNTHREADED_MESSAGES |
Direktnachrichten (DN) zwischen zwei Personen und Gruppenunterhaltungen zwischen drei oder mehr Personen |
SpaceDetails
Details zum Gruppenbereich, einschließlich einer Beschreibung und Regeln
JSON-Darstellung |
---|
{ "description": string, "guidelines": string } |
Felder | |
---|---|
description |
Optional. Eine Beschreibung des Gruppenbereichs. Beschreiben Sie beispielsweise das Diskussionsthema, den Zweck oder die Teilnehmer des Gruppenbereichs. Unterstützt bis zu 150 Zeichen. |
guidelines |
Optional. Regeln, Erwartungen und Etikette im Gruppenbereich Unterstützt bis zu 5.000 Zeichen. |
HistoryState
Der Verlaufsstatus für Nachrichten und Gruppenbereiche. Gibt an, wie lange Nachrichten und Unterhaltungsthreads nach dem Erstellen gespeichert werden.
Enums | |
---|---|
HISTORY_STATE_UNSPECIFIED |
Standardwert. Nicht verwenden. |
HISTORY_OFF |
Verlauf deaktiviert. Nachrichten und Threads werden 24 Stunden lang gespeichert. |
HISTORY_ON |
Verlauf aktiviert. In den Aufbewahrungsregeln in Vault der Organisation ist festgelegt, wie lange Nachrichten und Threads aufbewahrt werden. |
AccessSettings
Stellt die Zugriffseinstellung des Gruppenbereichs dar.
JSON-Darstellung |
---|
{
"accessState": enum ( |
Felder | |
---|---|
accessState |
Nur Ausgabe Gibt den Zugriffsstatus des Gruppenbereichs an. |
audience |
Optional. Der Ressourcenname der Zielgruppe, die auf den Gruppenbereich zugreifen kann. Geben Sie in diesem Feld eine gültige Zielgruppen-ID an, um den Gruppenbereich sichtbar zu machen, oder verwenden Sie den Alias |
AccessState
Stellt den Zugriffsstatus des Gruppenbereichs dar.
Enums | |
---|---|
ACCESS_STATE_UNSPECIFIED |
Der Zugriffsstatus ist unbekannt oder wird in dieser API nicht unterstützt. |
PRIVATE |
Der Gruppenbereich ist für hinzugefügte oder eingeladene Mitglieder oder Gruppen sichtbar. |
DISCOVERABLE |
Der Gruppenbereich ist für die ausgewählte Zielgruppe sowie für hinzugefügte oder eingeladene Mitglieder oder Gruppen sichtbar. |
Methoden |
|
---|---|
|
Damit wird der Importvorgang für den angegebenen Gruppenbereich abgeschlossen und für Nutzer sichtbar. |
|
Erstellt einen benannten Gruppenbereich. |
|
Löscht einen benannten Gruppenbereich. |
|
Gibt die vorhandene Direktnachricht an den angegebenen Nutzer zurück |
|
Gibt Details zu einem Gruppenbereich zurück |
|
Listet Gruppenbereiche auf, in denen der Anrufer Mitglied ist. |
|
Aktualisiert einen Gruppenbereich. |
|
Erstellt einen Gruppenbereich und fügt ihm bestimmte Nutzer hinzu. |