Method: spaces.patch

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

Wenn du beim Aktualisieren des Felds displayName die Fehlermeldung ALREADY_EXISTS erhältst, versuche es mit einem anderen Anzeigenamen. Dieser Anzeigename wird möglicherweise bereits von einem vorhandenen 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, kommagetrennt, falls mehrere vorhanden sind.

Derzeit unterstützte Feldpfade:

  • displayName (Unterstützt nur das Ändern des Anzeigenamens eines Gruppenbereichs mit dem Typ SPACE oder wenn zusätzlich die Maske spaceType eingefügt wird, um den Gruppenbereichstyp GROUP_CHAT in SPACE zu ändern. Der Versuch, den Anzeigenamen eines GROUP_CHAT- oder DIRECT_MESSAGE-Leerbereichs 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. Möglicherweise wird dieser Anzeigename bereits von einem vorhandenen Gruppenbereich in der Google Workspace-Organisation verwendet.)

  • spaceType (Das Ändern des Gruppenbereichstyps des Typs „GROUP_CHAT“ zu „SPACE“ wird nur unterstützt. Fügen Sie displayName zusammen mit spaceType in die Aktualisierungsmaske ein und achten Sie darauf, dass für das angegebene Leerzeichen ein Anzeigename und der Bereichstyp SPACE angegeben werden. Das Einfügen der spaceType-Maske und des SPACE-Typs in das angegebene Leerzeichen beim Aktualisieren des Anzeigenamens ist optional, wenn das vorhandene Leerzeichen bereits den Typ SPACE hat. Der Versuch, den Gruppenbereichstyp auf andere Weise zu aktualisieren, führt zu einem Fehler aufgrund eines ungültigen Arguments.

  • spaceDetails

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

  • Entwicklervorschau: accessSettings.audience (unterstützt das Ändern der Zugriffseinstellung eines Gruppenbereichs. Wenn in der Zugriffseinstellung keine Zielgruppe angegeben wurde, wird die Zugriffseinstellung des Gruppenbereichs in „Eingeschränkt“ geändert. Warnung: schließen sich gegenseitig mit allen anderen Feldpfaden aus.)

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.