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.

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

  • spaceDetails

  • displayName: Unterstützt nur die Aktualisierung des Anzeigenamens für Leerzeichen, 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 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.

  • spaceHistoryState: Aktualisiert die Einstellungen für den Gruppenbereichsverlauf, 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 für Administratorzugriff nicht unterstützt.

  • accessSettings.audience: Aktualisiert die Zugriffseinstellung, wer den Gruppenbereich entdecken, ihm beitreten und die Nachrichten im benannten Gruppenbereich als Vorschau ansehen kann. Das Feld spaceType hat den Wert SPACE. 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 im Hilfeartikel Gruppenbereiche für bestimmte Nutzer sichtbar machen. 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.