Rendre un espace Google Chat visible par des utilisateurs spécifiques d'une organisation Google Workspace

Cette page explique comment utiliser l'API Google Chat pour partager un espace Google Chat avec des utilisateurs spécifiques d'une organisation Google Workspace, afin qu'ils puissent le découvrir et le rejoindre.

Pour spécifier les utilisateurs de votre organisation qui peuvent découvrir et rejoindre un espace, vous devez créer des audiences cibles. Une audience cible est un groupe de personnes (par exemple, des services spécifiques ou l'ensemble de l'organisation) avec lequel vous pouvez partager un espace de discussion Chat pour améliorer la visibilité et la capacité de partage de l'espace. Les cibles vous permettent également de gérer et de personnaliser les membres d'un espace sans avoir à inviter des utilisateurs individuels. Pour en savoir plus, consultez À propos des audiences cibles.

Vous ne pouvez rendre les espaces nommés visibles que pour des audiences cibles. Vous ne pouvez pas partager d'autres types d'espaces, tels que les messages privés ou les conversations de groupe, avec des audiences cibles.

Prérequis

Obtenir l'ID de l'audience cible

Pour obtenir l'ID d'une audience cible :

  1. Dans la console d'administration Google, accédez à Menu  > Annuaire > Audiences cibles.

    Accéder aux audiences cibles

  2. Dans le tableau Audiences cibles, cliquez sur le champ Nom de l'audience cible.

  3. Recherchez l'ID de l'audience cible dans l'URL de la page. Le format de l'URL est https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, où TARGET_AUDIENCE_ID correspond à l'ID alphanumérique de votre audience cible.

Dans la section suivante, vous allez utiliser l'ID de l'audience cible pour créer un espace visible ou mettre à jour un espace existant afin de le rendre visible par l'audience cible.

Spécifier l'audience cible dans votre requête Chat API

Pour créer un espace pour une audience cible spécifique, utilisez la méthode create() ou setup() sur la ressource Space. Pour rendre un espace existant détectable, utilisez la méthode update() sur la ressource Space. Étant donné que seuls les espaces nommés peuvent être partagés avec des audiences cibles, le type d'espace (représenté dans le champ spaceType) doit être SPACE.

Pour rendre un espace visible par votre audience cible, incluez l'objet AccessSettings dans la ressource Space dans le cadre de votre requête API Chat. Dans l'objet, spécifiez le champ audience :

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

Remplacez TARGET_AUDIENCE_ID par l'ID de l'audience cible que vous avez obtenu dans la section précédente. Pour utiliser les paramètres de partage d'espace Chat par défaut pour votre organisation Google Workspace, remplacez-le par default.

Pour savoir comment créer ou modifier des espaces à l'aide de l'API Chat, consultez les guides suivants :