Aktualisiert einen Gruppenbereich. Ein Beispiel finden Sie unter Bereich 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.
https://www.googleapis.com/auth/chat.import (nur Gruppenbereiche im Importmodus)
Bei der Nutzerauthentifizierung werden Administratorberechtigungen erteilt, wenn ein Administratorkonto authentifiziert wird, useAdminAccess gleich true ist und die folgenden Autorisierungsbereiche verwendet werden:
https://www.googleapis.com/auth/chat.admin.spaces
Für die App-Authentifizierung gelten die folgenden Einschränkungen:
Um space.predefined_permission_settings oder space.permission_settings zu aktualisieren, muss die App der Ersteller des Gruppenbereichs sein.
Das Aktualisieren der space.access_settings.audience wird für die App-Authentifizierung nicht unterstützt.
Dabei steht {space} für die vom System zugewiesene ID für den Bereich. Sie können die Gruppenbereichs-ID abrufen, indem Sie die Methode spaces.list() aufrufen oder die Gruppenbereichs-URL verwenden. Wenn die URL des Bereichs beispielsweise https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA lautet, ist die Bereichs-ID AAAAAAAAA.
Erforderlich. Die aktualisierten Feldpfade, durch Kommas getrennt, falls es mehrere gibt.
Sie können die folgenden Felder für einen Bereich aktualisieren:
spaceDetails: Aktualisiert die Beschreibung des Gruppenbereichs. Unterstützt bis zu 150 Zeichen.
displayName: Nur das Aktualisieren des Anzeigenamens für Bereiche wird unterstützt, in denen das Feld spaceTypeSPACE ist. 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: Es wird nur das Ändern eines GROUP_CHAT-Bereichstyps in SPACE unterstützt. Nehmen Sie displayName zusammen mit spaceType in die Aktualisierungsmaske auf und achten Sie darauf, dass der angegebene Space einen nicht leeren Anzeigenamen und den Space-Typ SPACE hat. Das Einbeziehen der spaceType-Maske und des SPACE-Typs im angegebenen Bereich beim Aktualisieren des Anzeigenamens ist optional, wenn der vorhandene Bereich bereits den SPACE-Typ hat. Wenn Sie versuchen, den Bereichstyp auf andere Weise zu aktualisieren, wird ein Fehler wegen eines ungültigen Arguments ausgegeben. spaceType wird mit useAdminAccess nicht unterstützt.
spaceHistoryState: Aktualisiert die Einstellungen für den Gruppenbereichsverlauf, indem der Verlauf für den Gruppenbereich aktiviert oder deaktiviert wird. Wird nur unterstützt, wenn die Verlaufseinstellungen für die Google Workspace-Organisation aktiviert sind. Wenn Sie den Status des Gruppenbereichs aktualisieren möchten, müssen Sie alle anderen Feldmasken in Ihrer Anfrage weglassen. spaceHistoryState wird mit useAdminAccess nicht unterstützt.
accessSettings.audience: Aktualisiert die Zugriffseinstellung für die Nutzer, die den benannten Gruppenbereich finden, ihm beitreten und die Nachrichten darin ansehen können, wenn das Feld spaceType den Wert SPACE hat. Wenn der vorhandene Gruppenbereich eine Zielgruppe hat, können Sie sie entfernen und den Zugriff auf den Gruppenbereich einschränken, indem Sie keinen Wert für diese Feldmaske angeben. Wenn Sie die Zugriffseinstellungen für einen Bereich aktualisieren möchten, muss der authentifizierende Nutzer ein Bereichsmanager sein und alle anderen Feldmasken in Ihrer Anfrage weglassen. Sie können dieses Feld nicht aktualisieren, wenn sich der Bereich im Importmodus befindet. Weitere Informationen finden Sie unter Projektbereich für bestimmte Nutzer auffindbar machen. accessSettings.audience wird mit useAdminAccess nicht unterstützt.
permissionSettings: Unterstützt das Ändern der Berechtigungseinstellungen eines Bereichs. Beim Aktualisieren von Berechtigungseinstellungen können Sie nur permissionSettings-Feldmasken angeben. Andere Feldmasken können nicht gleichzeitig aktualisiert werden. permissionSettings wird mit useAdminAccess nicht unterstützt. Die unterstützten Feldmasken sind:
permissionSettings.manageMembersAndGroups
permissionSettings.modifySpaceDetails
permissionSettings.toggleHistory
permissionSettings.useAtMentionAll
permissionSettings.manageApps
permissionSettings.manageWebhooks
permissionSettings.replyMessages
useAdminAccess
boolean
Optional. Wenn true, wird die Methode mit den Administratorberechtigungen des Google Workspace-Nutzers ausgeführt.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-29 (UTC)."],[[["\u003cp\u003eUpdates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges.\u003c/p\u003e\n"],["\u003cp\u003eSupports partial updates using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter to specify the fields to be modified.\u003c/p\u003e\n"],["\u003cp\u003eProvides options for using administrator privileges with the \u003ccode\u003euseAdminAccess\u003c/code\u003e query parameter, but some fields and functionalities are not supported in this mode.\u003c/p\u003e\n"],["\u003cp\u003eUses the PATCH HTTP method and gRPC Transcoding syntax for the request URL.\u003c/p\u003e\n"]]],["This content describes how to update a space within Google Workspace Chat via the API. Key actions include sending a `PATCH` request to `https://chat.googleapis.com/v1/{space.name=spaces/*}`, specifying the space's name in the path. The `updateMask` query parameter defines which fields to update, including space details, display name, type, history state, access and permissions. `useAdminAccess` allow to update the space with administrator permissions. Authentication requires specific OAuth scopes. The request and response body use the `Space` object.\n"],null,[]]
