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. Il est possible qu'un espace existant de l'organisation Google Workspace utilise déjà ce nom à afficher.

Nécessite une authentification 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 d'accès des champs mis à jour, séparés par une virgule s'il y en a plusieurs.

Chemins d'accès des champs actuellement acceptés:

  • displayName (Ne permet de modifier le nom à afficher d'un espace de type SPACE ou lorsque le masque spaceType est également 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, vous obtiendrez une erreur d'argument non valide. Si le message d'erreur ALREADY_EXISTS s'affiche lors de la mise à jour de displayName, essayez un autre displayName. Il est possible qu'un espace existant de l'organisation Google Workspace utilise déjà ce nom à afficher.)

  • spaceType (Compatible uniquement avec le remplacement du type d'espace GROUP_CHAT par SPACE. Incluez displayName et spaceType dans le masque de mise à jour, et assurez-vous que le nom à afficher de l'espace spécifié et le type d'espace SPACE ne sont pas vides. L'ajout du masque spaceType et du type SPACE dans l'espace spécifié lors de la mise à jour du nom à afficher est facultatif si l'espace existant est déjà de type SPACE. Si vous essayez de mettre à jour le type d'espace d'une autre manière, vous obtiendrez une erreur d'argument non valide).

  • spaceDetails

  • spaceHistoryState (Permet d'activer ou de désactiver l'historique pour l'espace si l'organisation autorise les utilisateurs à modifier les paramètres de leur historique. Avertissement: S'exclut mutuellement avec tous les autres chemins d'accès de champ.)

  • Preview développeur: accessSettings.audience (permet de modifier le paramètre d'accès à un espace. Si aucune audience n'est spécifiée dans le paramètre d'accès, le paramètre d'accès de l'espace est défini sur "Limité". Avertissement: S'exclut mutuellement avec tous les autres chemins d'accès de champ.)

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 relatif aux autorisations.