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. Dieser Anzeigename wird möglicherweise bereits für einen bestehenden Gruppenbereich in der Google Workspace-Organisation verwendet.

Erfordert eine Nutzerauthentifizierung.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
space.name

string

Ressourcenname des Gruppenbereichs.

Format: spaces/{space}

Suchparameter

Parameter
updateMask

string (FieldMask format)

Erforderlich. Die aktualisierten Feldpfade, durch Kommas getrennt, wenn es mehrere gibt.

Derzeit unterstützte Feldpfade:

  • displayName (Unterstützt nur das Ändern des Anzeigenamens eines Gruppenbereichs mit dem Typ SPACE oder das Einbeziehen der spaceType-Maske zur Änderung des Gruppenbereichstyps „GROUP_CHAT“ in „SPACE“. Der Versuch, den Anzeigenamen eines GROUP_CHAT- oder DIRECT_MESSAGE-Bereichs zu aktualisieren, führt zu einem Fehler aufgrund eines ungültigen Arguments. Wenn du beim Aktualisieren von displayName die Fehlermeldung ALREADY_EXISTS erhältst, versuche es mit einem anderen displayName. Dieser Anzeigename wird möglicherweise bereits für einen bestehenden Gruppenbereich in der Google Workspace-Organisation verwendet.

  • spaceType (Unterstützt nur das Ändern des Gruppenbereichstyps „GROUP_CHAT“ zu „SPACE“. Fügen Sie displayName zusammen mit spaceType in die Aktualisierungsmaske ein und achten Sie darauf, dass das angegebene Leerzeichen einen Anzeigenamen und den Gruppenbereichstyp SPACE enthält. 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 für Administratorzugriff nicht unterstützt.

  • spaceDetails

  • spaceHistoryState (Unterstützt das Aktivieren oder Deaktivieren des Verlaufs für den Gruppenbereich, wenn die Organisation Nutzern erlaubt, ihre Einstellungen für das Chatprotokoll zu ändern. Achtung: Sie schließen sich mit allen anderen Feldpfaden gegenseitig aus.) spaceHistoryState wird für Administratorzugriff nicht unterstützt.

  • Entwicklervorschau: accessSettings.audience (unterstützt das Ändern der Zugriffseinstellung für einen Gruppenbereich. Wenn in der Zugriffseinstellung keine Zielgruppe angegeben ist, wird die Zugriffseinstellung des Gruppenbereichs zu „Eingeschränkt“ geändert. Achtung: Sie schließen sich mit allen anderen Feldpfaden gegenseitig aus.) accessSettings.audience wird für Administratorzugriff nicht unterstützt.

  • Entwicklervorschau: Unterstützt das Ändern der Berechtigungseinstellungen eines Gruppenbereichs. Unterstützte Feldpfade: permissionSettings.manage_members_and_groups, permissionSettings.modify_space_details, permissionSettings.toggle_history, permissionSettings.use_at_mention_all, permissionSettings.manage_apps, permissionSettings.manage_webhooks, permissionSettings.reply_messages (Warnung: Sie schließen sich gegenseitig aus und schließen alle anderen Feldpfade ohne Berechtigung aus). permissionSettings wird für Administratorzugriff nicht unterstützt.
useAdminAccess

boolean

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 bei Verwendung des Administratorzugriffs 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.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.