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 lesquelles vous pouvez partager un espace Chat afin d'améliorer sa notoriété et sa partageabilité. Les audiences cibles vous permettent également de gérer et de personnaliser les adhésions à un espace au lieu d'inviter des utilisateurs individuels à un espace. Pour en savoir plus, consultez la section À propos des audiences cibles.

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

Prérequis

Obtenir l'ID de la cible

Pour obtenir l'ID d'une audience cible, procédez comme suit:

  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 utiliserez l'ID de l'audience cible pour créer un espace visible ou mettre à jour un espace existant afin de le rendre visible pour l'audience cible.

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

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 obtenue à la section précédente. Pour utiliser les paramètres de partage d'espace Chat par défaut de votre organisation Google Workspace, remplacez-les par default.

Pour en savoir plus sur la création ou la mise à jour d'espaces à l'aide de l'API Chat, consultez les guides suivants: