Method: spaces.patch

Aktualisiert einen Gruppenbereich Weitere Informationen

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 Gruppenbereich in der Google Workspace-Organisation verwendet.

Erfordert 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, durch Kommas getrennt.

Derzeit unterstützte Feldpfade:

  • displayName (Unterstützt nur das Ändern des Anzeigenamens eines Gruppenbereichs mit dem Typ SPACE oder auch wenn die spaceType-Maske verwendet wird, um einen GROUP_CHAT-Gruppentyp zu SPACE zu ändern. Der Versuch, den Anzeigenamen eines GROUP_CHAT- oder DIRECT_MESSAGE-Bereichs zu aktualisieren, führt zu einem ungültigen Argumentfehler. Wenn Sie beim Aktualisieren von displayName die Fehlermeldung ALREADY_EXISTS erhalten, versuchen Sie es mit einem anderen displayName. Dieser Anzeigename wird möglicherweise bereits für einen Gruppenbereich in der Google Workspace-Organisation verwendet.

  • spaceType (Unterstützt nur das Ändern des Typs GROUP_CHAT eines Gruppenbereichs in SPACE. Fügen Sie displayName und spaceType in die Aktualisierungsmaske ein und achten Sie darauf, dass der angegebene Gruppenbereich einen nicht leeren Anzeigenamen und einen SPACE-Typ hat. Das Hinzufügen der Maske spaceType und des Typs SPACE im angegebenen Gruppenbereich ist bei der Aktualisierung des Anzeigenamens optional, wenn der vorhandene Gruppenbereich bereits den Typ SPACE hat. Wenn Sie versuchen, den Gruppenbereichstyp auf andere Weise zu aktualisieren, wird ein Argumentfehler ungültig.

  • spaceDetails

  • spaceHistoryState (Unterstützt das Aktivieren oder Deaktivieren des Verlaufs für den Gruppenbereich, wenn die Organisation Nutzern erlaubt, ihre Protokolleinstellungen zu ändern. Warnung: schließen sich mit allen anderen Feldpfaden gegenseitig 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.