Method: spaces.patch

Aktualisiert einen Gruppenbereich. Ein Beispiel finden Sie unter Gruppenbereich 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 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.

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. Möglicherweise wird dieser Anzeigename bereits für einen vorhandenen 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. Wenn der vorhandene Gruppenbereich bereits den Typ SPACE hat, ist es optional, die spaceType-Maske und den SPACE-Typ beim Aktualisieren des Anzeigenamens in den angegebenen Gruppenbereich aufzunehmen. Versuche, den Gruppenbereichstyp auf andere Weise zu aktualisieren, führen zu einem Fehler wegen ungültigen Arguments. spaceType wird von useAdminAccess nicht unterstützt.

spaceHistoryState: Aktualisiert die Einstellungen für den Gruppenbereichsverlauf, indem der Verlauf für den Gruppenbereich aktiviert oder deaktiviert wird. Nur unterstützt, wenn die Verlaufseinstellungen für die Google Workspace-Organisation aktiviert sind. Wenn Sie den Verlaufsstatus des Gruppenbereichs aktualisieren möchten, müssen Sie alle anderen Feldmasken in Ihrer 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 für den vorhandenen Gruppenbereich eine Zielgruppe festgelegt ist, können Sie sie 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. Dieses Feld kann nicht aktualisiert werden, 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 der Berechtigungseinstellungen können Sie nur permissionSettings-Feldmasken angeben. Andere Feldmasken können nicht gleichzeitig aktualisiert werden. permissionSettings wird von useAdminAccess nicht unterstützt. Zu den unterstützten Feldmasken gehören:

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

boolean

Optional. Wenn true festgelegt ist, 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 ohne 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.