Ressource: Gruppenbereich
Einen Gruppenbereich in Google Chat Gruppenbereiche sind Unterhaltungen zwischen zwei oder mehreren Nutzern oder Einzelunterhaltungen zwischen einem Nutzer und einer Chat-App.
JSON-Darstellung |
---|
{ "name": string, "type": enum ( |
Felder | |
---|---|
name |
Kennung. Ressourcenname des Gruppenbereichs. Format: Dabei steht |
type |
Nur Ausgabe. Verworfen. Verwenden Sie stattdessen |
space |
Optional. Die Art des Gruppenbereichs. Erforderlich, wenn Sie einen Gruppenbereich erstellen oder den Typ eines Gruppenbereichs aktualisieren. Ausgabe nur für andere Zwecke. |
single |
Optional. Gibt an, ob der Gruppenbereich eine DN zwischen einer Chat-App und einem einzelnen Nutzer ist. |
threaded |
Nur Ausgabe. Verworfen. Verwenden Sie stattdessen |
display |
Optional. Der Anzeigename des Gruppenbereichs. Erforderlich beim Erstellen eines Gruppenbereichs mit dem Bei Direktnachrichten ist dieses Feld möglicherweise leer. Unterstützt bis zu 128 Zeichen. |
external |
Optional. Nicht veränderbar. Gibt an, ob in diesem Gruppenbereich beliebige Google Chat-Nutzer als Mitglieder zugelassen sind. Wird beim Erstellen eines Gruppenbereichs in einer Google Workspace-Organisation eingegeben. Lassen Sie dieses Feld weg, wenn Sie unter den folgenden Bedingungen Gruppenbereiche erstellen:
Für vorhandene Gruppenbereiche wird dieses Feld nur für die Ausgabe verwendet. |
space |
Nur Ausgabe. Der Status der Unterhaltungsbereiche im Chatbereich. |
space |
Optional. Details zum Gruppenbereich, einschließlich einer Beschreibung und Regeln |
space |
Optional. Der Status des Nachrichtenverlaufs für Nachrichten und Threads in diesem Gruppenbereich. |
import |
Optional. Gibt an, ob dieser Gruppenbereich in Zum Erstellen eines Gruppenbereichs in |
create |
Optional. Nicht veränderbar. Bei in Google Chat erstellten Gruppenbereichen ist es die Uhrzeit, zu der der Gruppenbereich 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 für dieses Feld den historischen Zeitstempel fest, zu dem der Gruppenbereich in der Quelle erstellt wurde, um den ursprünglichen Erstellungszeitpunkt beizubehalten. Wird nur in die Ausgabe aufgenommen, wenn |
last |
Nur Ausgabe. Zeitstempel der letzten Nachricht im Gruppenbereich. |
admin |
Nur Ausgabe. Ob ein Gruppenbereich für Direktnachrichten (DM-Gruppenbereich) mit einer Chat-App von einem Google Workspace-Administrator erstellt wurde. Administratoren können im Namen von Nutzern in ihrer Organisation eine Direktnachricht mit einer Chat-App installieren und einrichten. Damit die Installation durch Administratoren unterstützt wird, muss Ihre Chat-App Direktnachrichten unterstützen. |
membership |
Nur Ausgabe. Die Anzahl der verbundenen Mitgliedschaften, gruppiert nach Mitgliedstyp. Wird ausgefüllt, wenn |
access |
Optional. Gibt die Zugriffseinstellung des Gruppenbereichs an. Wird nur ausgefüllt, wenn |
space |
Nur Ausgabe. Der URI für einen Nutzer, um auf den Gruppenbereich zuzugreifen. |
customer |
Optional. Nicht veränderbar. Die Kundennummer der Domain des Gruppenbereichs. Nur erforderlich, wenn Sie einen Gruppenbereich mit App-Authentifizierung erstellen und Im Format Bei DMs ist dieses Feld nicht ausgefüllt. |
Union-Feld Erfordert die Nutzerauthentifizierung. Für |
|
predefined |
Optional. Nur Eingabe. Vordefinierte Berechtigungseinstellungen für Gruppenbereiche, die nur beim Erstellen eines Gruppenbereichs eingegeben werden. Wenn das Feld nicht festgelegt ist, wird ein Gruppenbereich erstellt. Nachdem Sie den Gruppenbereich erstellt haben, werden die Einstellungen in das Feld |
permission |
Optional. Einstellungen für Berechtigungen für Gruppenbereiche für vorhandene Gruppenbereiche Eingabe zum Aktualisieren der genauen Berechtigungseinstellungen für den Gruppenbereich, wobei vorhandene Berechtigungseinstellungen ersetzt werden. Die Ausgabe enthält die aktuellen Berechtigungseinstellungen. |
Typ
Verworfen. Verwenden Sie stattdessen SpaceType
.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Reserviert. |
ROOM |
Unterhaltungen zwischen zwei oder mehr Personen. |
DM |
1:1-Direktnachricht zwischen einem Nutzer und einer Chat-App, bei der alle Nachrichten in einer flachen Form dargestellt werden. Direktnachrichten zwischen zwei Personen sind davon ausgenommen. |
SpaceType
Die Art des Gruppenbereichs. Erforderlich, wenn Sie einen Gruppenbereich erstellen oder aktualisieren. 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 mit mindestens drei Personen Ein GROUP_CHAT kann Chat-Apps enthalten. |
DIRECT_MESSAGE |
1:1-Nachrichten zwischen zwei Personen oder einer Person und einer Chat-App |
SpaceThreadingState
Gibt den Typ des Threading-Status im Chatbereich an.
Enums | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
Reserviert. |
THREADED_MESSAGES |
Benannte Gruppenbereiche, die Nachrichtenthreads unterstützen. Wenn Nutzer auf eine Nachricht antworten, können sie im Thread antworten. Dadurch bleibt ihre Antwort im Kontext der ursprünglichen Nachricht. |
GROUPED_MESSAGES |
Benannte Gruppenbereiche, in denen die Unterhaltung nach Themen geordnet ist. Themen und die dazugehörigen Antworten werden gruppiert. |
UNTHREADED_MESSAGES |
Direktnachrichten (DMs) zwischen zwei Personen und Gruppenunterhaltungen mit mindestens drei Personen |
SpaceDetails
Details zum Gruppenbereich, einschließlich Beschreibung und Regeln.
JSON-Darstellung |
---|
{ "description": string, "guidelines": string } |
Felder | |
---|---|
description |
Optional. Eine Beschreibung des Gruppenbereichs. Beschreiben Sie beispielsweise das Diskussionsthema, den funktionalen Zweck oder die Teilnehmenden des Gruppenbereichs. Unterstützt bis zu 150 Zeichen. |
guidelines |
Optional. Regeln, Erwartungen und Etikette im Raum. 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 aufbewahrt werden.
Enums | |
---|---|
HISTORY_STATE_UNSPECIFIED |
Standardwert. Nicht verwenden. |
HISTORY_OFF |
Verlauf deaktiviert. Nachrichten und Unterhaltungen werden 24 Stunden lang aufbewahrt. |
HISTORY_ON |
Verlauf aktiviert. In den Aufbewahrungsregeln für Google Vault der Organisation ist festgelegt, wie lange Nachrichten und Threads aufbewahrt werden. |
MembershipCount
Die Anzahl der Mitgliedschaften in einem Gruppenbereich, gruppiert nach Kategorien.
JSON-Darstellung |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
Felder | |
---|---|
joined |
Nur Ausgabe. Anzahl der menschlichen Nutzer, die dem Gruppenbereich direkt beigetreten sind. Nicht berücksichtigt werden Nutzer, die durch Mitgliedschaft in einer verbundenen Gruppe beigetreten sind. |
joined |
Nur Ausgabe. Die Anzahl aller Gruppen, die dem Gruppenbereich direkt beigetreten sind. |
AccessSettings
Die Zugriffseinstellung für den Gruppenbereich.
JSON-Darstellung |
---|
{
"accessState": enum ( |
Felder | |
---|---|
access |
Nur Ausgabe. Gibt den Zugriffsstatus des Gruppenbereichs an. |
audience |
Optional. Der Ressourcenname der Zielgruppe, die den Gruppenbereich finden, ihm beitreten und sich eine Vorschau der Nachrichten im Gruppenbereich ansehen kann. Wenn diese Option nicht festgelegt ist, können nur Nutzer oder Google-Gruppen, die einzeln eingeladen oder dem Gruppenbereich hinzugefügt wurden, darauf zugreifen. Weitere Informationen finden Sie im Hilfeartikel Einen Gruppenbereich für eine Zielgruppe sichtbar machen. Format: Wenn Sie die Standardzielgruppe für die Google Workspace-Organisation verwenden möchten, legen Sie Das Lesen der Zielgruppe unterstützt:
Dieses Feld wird nicht ausgefüllt, wenn der Umfang Für die Festlegung der Zielgruppe ist eine Nutzerauthentifizierung erforderlich. |
AccessState
Stellt den Zugriffsstatus des Gruppenbereichs dar.
Enums | |
---|---|
ACCESS_STATE_UNSPECIFIED |
Der Zugriffsstatus ist unbekannt oder wird in dieser API nicht unterstützt. |
PRIVATE |
Nur Nutzer oder Google-Gruppen, die von anderen Nutzern oder Google Workspace-Administratoren einzeln hinzugefügt oder eingeladen wurden, können den Gruppenbereich finden und darauf zugreifen. |
DISCOVERABLE |
Ein Administrator eines Gruppenbereichs hat einer Zielgruppe Zugriff auf den Gruppenbereich gewährt. Nutzer oder Google-Gruppen, die einzeln zum Gruppenbereich hinzugefügt oder dazu eingeladen wurden, können den Gruppenbereich ebenfalls finden und darauf zugreifen. Weitere Informationen finden Sie unter Gruppenbereich für bestimmte Nutzer sichtbar machen. Für das Erstellen von Gruppenbereichen mit offenem Zugang ist eine Nutzerauthentifizierung erforderlich. |
PredefinedPermissionSettings
Vordefinierte Berechtigungseinstellungen, die Sie nur beim Erstellen eines benannten Gruppenbereichs angeben können. In Zukunft werden möglicherweise weitere Einstellungen hinzugefügt. Weitere Informationen zu den Berechtigungseinstellungen für benannte Gruppenbereiche finden Sie unter Gruppenbereiche.
Enums | |
---|---|
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED |
Nicht angegeben Nicht verwenden. |
COLLABORATION_SPACE |
Einstellung, mit der der Gruppenbereich zu einem Gruppenbereich für die Zusammenarbeit wird, in dem alle Mitglieder Nachrichten posten können. |
ANNOUNCEMENT_SPACE |
Einstellung, um einen Gruppenbereich für Ankündigungen zu erstellen, in dem nur Administratoren des Gruppenbereichs Nachrichten posten können. |
PermissionSettings
Berechtigungseinstellungen, die Sie beim Aktualisieren eines vorhandenen benannten Bereichs festlegen können.
Wenn Sie Berechtigungseinstellungen beim Erstellen eines Gruppenbereichs festlegen möchten, geben Sie in Ihrer Anfrage das Feld PredefinedPermissionSettings
an.
JSON-Darstellung |
---|
{ "manageMembersAndGroups": { object ( |
Felder | |
---|---|
manage |
Optional. Einstellung zum Verwalten von Mitgliedern und Gruppen in einem Gruppenbereich. |
modify |
Optional. Einstellung zum Aktualisieren des Namens, des Avatars, der Beschreibung und der Richtlinien eines Gruppenbereichs |
toggle |
Optional. Einstellung zum Aktivieren und Deaktivieren des Gruppenbereichsverlaufs. |
use |
Optional. Einstellung für die Verwendung von @alle in einem Gruppenbereich. |
manage |
Optional. Einstellung zum Verwalten von Apps in einem Gruppenbereich. |
manage |
Optional. Einstellung zum Verwalten von Webhooks in einem Gruppenbereich. |
post |
Nur Ausgabe. Einstellung zum Posten von Nachrichten in einem Gruppenbereich. |
reply |
Optional. Einstellung für das Beantworten von Nachrichten in einem Gruppenbereich. |
PermissionSetting
Stellt eine Berechtigungseinstellung für einen Gruppenbereich dar.
JSON-Darstellung |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
Felder | |
---|---|
managers |
Optional. Ob Administratoren von Gruppenbereichen diese Berechtigung haben. |
members |
Optional. Ob Mitglieder ohne die Rolle „Administrator“ diese Berechtigung haben. |
Methoden |
|
---|---|
|
Schließt den Importvorgang für den angegebenen Bereich ab und macht ihn für Nutzer sichtbar. |
|
Erstellt einen Gruppenbereich ohne Mitglieder. |
|
Löscht einen benannten Gruppenbereich. |
|
Gibt die vorhandene Direktnachricht mit dem angegebenen Nutzer zurück. |
|
Gibt Details zu einem Gruppenbereich zurück. |
|
Listet Gruppenbereiche auf, in denen der Anrufer Mitglied ist. |
|
Aktualisiert einen Gruppenbereich. |
|
Eine Liste der Gruppenbereiche in einer Google Workspace-Organisation, die auf der Suche eines Administrators basiert. |
|
Erstellt einen Gruppenbereich und fügt ihm angegebene Nutzer hinzu. |