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 Chat afin d'améliorer sa visibilité et sa capacité de partage. Les audiences cibles vous permettent également de gérer et de personnaliser les membres d'un espace sans avoir à inviter des utilisateurs individuellement. Pour en savoir plus, consultez À 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 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, procédez comme suit :

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

    Accédez à 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 d'API Chat

Pour créer un espace pour une audience cible spécifique, utilisez la create() ou setup() méthode sur la ressource Space. Pour rendre un espace existant visible, utilisez la update() méthode 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 pour votre audience cible, incluez l' AccessSettings objet dans la ressource Space dans le cadre de votre requête d'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 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 :