REST Resource: spaces

{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string,
  "importModeExpireTime": string,
  "customer": string,

  // Union field space_permission_settings can be only one of the following:
  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
  // End of list of possible types for union field space_permission_settings.
}

string

Kennung. Ressourcenname des Gruppenbereichs.

Format: spaces/{space}

Dabei steht {space} für die vom System zugewiesene ID des Gruppenbereichs. Sie können die Gruppenbereichs-ID durch Aufrufen der Methode spaces.list() oder über die URL des Gruppenbereichs abrufen. Wenn die Gruppenbereichs-URL beispielsweise https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA lautet, ist die Gruppenbereichs-ID AAAAAAAAA.

enum (Type)

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen spaceType. Der Typ eines Gruppenbereichs.

enum (SpaceType)

Optional. Der Typ des Gruppenbereichs. Erforderlich beim Erstellen eines Gruppenbereichs oder Aktualisieren des Gruppenbereichstyps. Ausgabe nur für andere Zwecke.

boolean

Optional. Gibt an, ob es sich bei dem Gruppenbereich um eine Direktnachricht zwischen einer Chat-App und einer einzelnen Person handelt.

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen spaceThreadingState. Ob Nachrichten in diesem Gruppenbereich in Threads angezeigt werden.

string

Optional. Der Anzeigename des Gruppenbereichs. Erforderlich, wenn Sie einen Gruppenbereich mit einer spaceType von SPACE erstellen. Wenn Sie beim Erstellen eines Gruppenbereichs oder Aktualisieren des displayName die Fehlermeldung ALREADY_EXISTS erhalten, versuchen Sie es mit einem anderen displayName. Möglicherweise wird dieser Anzeigename bereits für einen vorhandenen Gruppenbereich in der Google Workspace-Organisation verwendet.

Bei Direktnachrichten ist dieses Feld möglicherweise leer.

Unterstützt bis zu 128 Zeichen.

boolean

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 in den folgenden Fällen weg, wenn Sie Gruppenbereiche erstellen:

• Der authentifizierte Nutzer verwendet ein Privatkonto (nicht verwaltetes Nutzerkonto). In einem Gruppenbereich, der von einem privaten Konto erstellt wurde, ist standardmäßig der Zugriff für alle Google Chat-Nutzer erlaubt.

Bei bestehenden Gruppenbereichen dient dieses Feld nur der Ausgabe.

enum (SpaceThreadingState)

Nur Ausgabe. Der Status der Unterhaltungsbereiche im Chatbereich.

object (SpaceDetails)

Optional. Details zum Gruppenbereich, einschließlich Beschreibung und Regeln.

enum (HistoryState)

Optional. Der Status des Nachrichtenverlaufs für Nachrichten und Threads in diesem Gruppenbereich.

boolean

Optional. Gibt an, ob dieser Gruppenbereich in Import Mode im Rahmen einer Datenmigration zu Google Workspace erstellt wird. Während Gruppenbereiche importiert werden, sind sie für Nutzer erst sichtbar, wenn der Import abgeschlossen ist.

Für das Erstellen eines Gruppenbereichs in Import Mode ist eine Nutzerauthentifizierung erforderlich.

string (Timestamp format)

Optional. Nicht veränderbar. Bei in Google Chat erstellten Gruppenbereichen ist es die Uhrzeit, zu der der Gruppenbereich erstellt wurde. Dieses Feld dient nur der Ausgabe, es sei denn, es wird in Gruppenbereichen im Importmodus verwendet.

Legen Sie für Gruppenbereiche im Importmodus in diesem Feld den Zeitstempel fest, zu dem der Gruppenbereich in der Quelle erstellt wurde, um den ursprünglichen Erstellungszeitpunkt beizubehalten.

Wird nur in die Ausgabe aufgenommen, wenn spaceType GROUP_CHAT oder SPACE ist.

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Nachricht im Gruppenbereich.

boolean

Nur Ausgabe. Ob ein Gruppenbereich für Direktnachrichten (DM) mit einer Chat-App von einem Google Workspace-Administrator erstellt wurde. Administratoren können im Namen von Nutzern in ihrer Organisation eine Chat-App installieren und eine Direktnachricht einrichten.

Damit die Installation durch Administratoren unterstützt werden kann, muss Ihre Chat-App Direktnachrichten unterstützen.

object (MembershipCount)

Nur Ausgabe. Die Anzahl der Mitgliedschaften, gruppiert nach Mitgliedstyp. Wird ausgefüllt, wenn spaceType SPACE, DIRECT_MESSAGE oder GROUP_CHAT ist.

object (AccessSettings)

Optional. Gibt die Zugriffseinstellung des Gruppenbereichs an. Wird nur ausgefüllt, wenn spaceType SPACE ist.

string

Nur Ausgabe. Der URI, über den ein Nutzer auf den Gruppenbereich zugreifen kann.

string (Timestamp format)

Nur Ausgabe. Das Datum, an dem der Gruppenbereich automatisch vom System gelöscht wird, wenn er sich noch im Importmodus befindet.

Jeder im Importmodus erstellte Gruppenbereich muss vor Ablauf dieser Frist mit spaces.completeImport aus diesem Modus herausgenommen werden.

Dieses Feld wird nur für Gruppenbereiche ausgefüllt, die im Importmodus erstellt wurden.

string

Optional. Nicht veränderbar. Die Kunden-ID der Domain des Gruppenbereichs. Nur erforderlich, wenn Sie einen Gruppenbereich mit App-Authentifizierung erstellen und SpaceType = SPACE ist. Andernfalls sollte dieser Parameter nicht festgelegt werden.

Im Format customers/{customer}, wobei customer die id aus der [Admin SDK-Kundenressource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers) ist. Bei privaten Apps kann der Alias customers/my_customer auch verwendet werden, um den Gruppenbereich in derselben Google Workspace-Organisation wie die App zu erstellen.

Bei DMs ist dieses Feld nicht ausgefüllt.

enum (PredefinedPermissionSettings)

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 PermissionSettings eingefügt.

object (PermissionSettings)

Optional. Einstellungen für Berechtigungen für Gruppenbereiche für vorhandene Gruppenbereiche Eingabe für die Aktualisierung der genauen Berechtigungseinstellungen für Gruppenbereiche, bei der vorhandene Berechtigungseinstellungen ersetzt werden. Die Ausgabe enthält die aktuellen Berechtigungseinstellungen.