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 dans l'organisation Google Workspace utilise peut-être déjà ce nom à afficher.

Nécessite une 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 de champs actuellement acceptés:

  • displayName (permet uniquement de modifier le nom à afficher d'un espace avec le type SPACE, ou lorsque vous incluez également le masque spaceType pour remplacer un type d'espace GROUP_CHAT par SPACE). Toute tentative de mise à jour du nom à afficher d'un GROUP_CHAT ou d'un espace DIRECT_MESSAGE entraîne une erreur d'argument non valide. Si le message d'erreur ALREADY_EXISTS s'affiche lors de la mise à jour du displayName, essayez avec un autre displayName. Un espace existant dans l'organisation Google Workspace utilise peut-être déjà ce nom à afficher.)

  • spaceType (permet uniquement de remplacer un 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é a un nom à afficher et le type d'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 est déjà du type SPACE. Toute tentative de modification du type d'espace entraîne une erreur d'argument non valide. spaceType n'est pas compatible avec l'accès administrateur.

  • spaceDetails

  • spaceHistoryState (permet d'activer ou désactiver l'historique pour l'espace si l'organisation autorise les utilisateurs à modifier les paramètres de leur historique). Avertissement: Les chemins d'accès à tous les autres champs s'excluent mutuellement.) spaceHistoryState n'est pas compatible avec l'accès administrateur.

  • Preview développeur: accessSettings.audience (permet de modifier le paramètre d'accès d'un espace. Si aucune audience n'est spécifiée dans le paramètre d'accès, celui-ci est défini sur "Limité". Avertissement: Les chemins d'accès à tous les autres champs s'excluent mutuellement.) accessSettings.audience n'est pas compatible avec l'accès administrateur.
useAdminAccess

boolean

Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur.

L'utilisateur appelant doit être un administrateur Google Workspace disposant du droit de gérer les conversations Chat et Espaces.

Nécessite le champ d'application OAuth 2.0 chat.admin.spaces.

Certaines valeurs FieldMask ne sont pas compatibles avec l'accès administrateur. Pour en savoir plus, consultez la description de updateMask.

Corps de la requête

Le corps de la requête contient une instance de 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.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Pour en savoir plus, consultez le Guide relatif aux autorisations.