Method: spaces.patch

Met à jour un espace. Pour obtenir un exemple, consultez Mettre à jour un espace.

Si vous mettez à jour le champ displayName et que le message d'erreur ALREADY_EXISTS s'affiche, essayez un autre nom à afficher. Un espace existant de l'organisation Google Workspace peut déjà utiliser ce nom à afficher.

Nécessite l'authentification de l'utilisateur.

Requête HTTP :

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
space.name

string

Nom de ressource de l'espace.

Format : spaces/{space}

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Chemins des champs mis à jour, séparés par une virgule s'il y en a plusieurs.

Chemins d'accès des champs actuellement compatibles:

  • displayName (Seul le nom à afficher d'un espace avec le type SPACE peut être modifié, ou lorsque le masque spaceType est inclus pour remplacer le type d'espace GROUP_CHAT par SPACE. Si vous essayez de mettre à jour le nom à afficher d'un espace GROUP_CHAT ou DIRECT_MESSAGE, une erreur d'argument non valide se produit. Si vous recevez le message d'erreur ALREADY_EXISTS lorsque vous mettez à jour displayName, essayez une autre displayName. un espace existant de l'organisation Google Workspace peut déjà utiliser ce nom à afficher)

  • spaceType (uniquement compatible avec le remplacement du type d'espace GROUP_CHAT par SPACE). Incluez displayName avec spaceType dans le masque de mise à jour, et assurez-vous que l'espace spécifié est associé à un nom à afficher et à l'espace SPACE. L'inclusion du masque spaceType et du type SPACE dans l'espace spécifié lors de la mise à jour du nom à afficher est facultative si l'espace existant possède déjà le type SPACE. Si vous essayez de mettre à jour le type d'espace d'une autre manière, une erreur d'argument non valide sera renvoyée.

  • spaceDetails

  • spaceHistoryState (permet d'activer ou désactiver l'historique de l'espace si l'organisation autorise les utilisateurs à modifier les paramètres de leur historique) Avertissement: mutuellement exclusif avec tous les autres chemins d'accès des champs.)

Corps de la requête

Le corps de la requête contient une instance Space.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Space.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Pour en savoir plus, consultez le guide sur les autorisations.