Method: spaces.patch

Aktualisiert einen Gruppenbereich. Ein Beispiel finden Sie unter Gruppenbereiche aktualisieren.

Wenn Sie das Feld displayName aktualisieren und die Fehlermeldung ALREADY_EXISTS erhalten, versuchen Sie es mit einem anderen Anzeigenamen. Möglicherweise wird dieser Anzeigename bereits für einen vorhandenen Gruppenbereich in der Google Workspace-Organisation verwendet.

Unterstützt die folgenden Authentifizierungstypen:

HTTP-Anfrage

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
space.name

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 Gruppenbereichs-URL abrufen. Wenn die Gruppenbereichs-URL beispielsweise https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA lautet, ist die Gruppenbereichs-ID AAAAAAAAA.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Erforderlich. Die aktualisierten Feldpfade, bei mehreren durch Kommas getrennt.

Sie können die folgenden Felder für einen Gruppenbereich aktualisieren:

spaceDetails: Aktualisiert die Beschreibung des Gruppenbereichs Unterstützt bis zu 150 Zeichen.

displayName: Der Anzeigename kann nur für Gruppenbereiche aktualisiert werden, in denen das Feld spaceType den Wert SPACE hat. Wenn Sie die Fehlermeldung ALREADY_EXISTS erhalten, versuchen Sie es mit einem anderen Wert. Dieser Anzeigename wird möglicherweise bereits für einen bestehenden Gruppenbereich in der Google Workspace-Organisation verwendet.

spaceType: Unterstützt nur die Änderung des Typs eines GROUP_CHAT-Bereichs in SPACE. Fügen Sie displayName zusammen mit spaceType in die Updatemaske ein und achten Sie darauf, dass der angegebene Gruppenbereich einen nicht leeren Anzeigenamen und den Gruppenbereichstyp SPACE hat. Das Einfügen der Maske spaceType und des Typs SPACE im angegebenen Bereich beim Aktualisieren des Anzeigenamens ist optional, wenn der vorhandene Bereich bereits den Typ SPACE hat. Der Versuch, den Gruppenbereichstyp auf andere Weise zu aktualisieren, führt zu einem Fehler aufgrund eines ungültigen Arguments. spaceType wird von useAdminAccess nicht unterstützt.

spaceHistoryState: Aktualisiert die Einstellungen für den Verlauf des Gruppenbereichs, indem der Verlauf für den Gruppenbereich aktiviert oder deaktiviert wird. Wird nur unterstützt, wenn Verlaufseinstellungen für die Google Workspace-Organisation aktiviert sind. Wenn Sie den Status des Gruppenbereichsverlaufs aktualisieren möchten, müssen Sie alle anderen Feldmasken in der Anfrage weglassen. spaceHistoryState wird von useAdminAccess nicht unterstützt.

accessSettings.audience: Aktualisiert die Zugriffseinstellung für Nutzer, die den Gruppenbereich finden, ihm beitreten und sich eine Vorschau der Nachrichten im benannten Gruppenbereich ansehen können, in dem das Feld spaceType den Wert SPACE hat. Wenn der vorhandene Gruppenbereich eine Zielgruppe hat, können Sie die Zielgruppe entfernen und den Zugriff auf den Gruppenbereich einschränken, indem Sie einen Wert für diese Feldmaske weglassen. Wenn Sie die Zugriffseinstellungen für einen Gruppenbereich aktualisieren möchten, muss der authentifizierende Nutzer ein Administrator des Gruppenbereichs sein und alle anderen Feldmasken in der Anfrage weglassen. Sie können dieses Feld nicht aktualisieren, wenn sich der Gruppenbereich im Importmodus befindet. Weitere Informationen finden Sie unter Gruppenbereich für bestimmte Nutzer sichtbar machen. accessSettings.audience wird von useAdminAccess nicht unterstützt.

permissionSettings: Unterstützt das Ändern der Berechtigungseinstellungen eines Gruppenbereichs. Beim Aktualisieren von Berechtigungseinstellungen können Sie nur permissionSettings-Feldmasken angeben. Sie können nicht gleichzeitig andere Feldmasken aktualisieren. permissionSettings wird von useAdminAccess nicht unterstützt. Folgende Feldmasken werden unterstützt:

  • permissionSettings.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.replyMessages
useAdminAccess

boolean

Optional. Wenn true, wird die Methode mit den Google Workspace-Administratorberechtigungen des Nutzers ausgeführt.

Der anrufende Nutzer muss ein Google Workspace-Administrator mit der Berechtigung „Unterhaltungen in Chats und Gruppenbereichen verwalten“ sein.

Erfordert den chat.admin.spaces OAuth 2.0-Bereich.

Einige FieldMask-Werte werden mit Administratorzugriff nicht unterstützt. Weitere Informationen finden Sie in der Beschreibung von updateMask.

Anfragetext

Der Anfragetext enthält eine Instanz von Space.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Space.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.