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 autorisés à découvrir et à rejoindre un espace, vous devez créer des audiences cibles. Une audience cible est un groupe de personnes (des services spécifiques ou l'ensemble de l'organisation, par exemple) avec lesquels vous pouvez partager un espace Chat afin d'en améliorer la visibilité et le partage. Les audiences cibles vous permettent également de gérer et de personnaliser les membres d'un espace sans avoir à inviter individuellement des utilisateurs. Pour en savoir plus, consultez À propos des audiences cibles.

Vous ne pouvez rendre des espaces nommés visibles que par des 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.

Conditions préalables

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 à la page "Audiences cibles"

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

  3. Recherchez l'ID de la cible dans l'URL de la page. Le format d'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 d'audience cible pour créer un espace visible ou pour 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 destiné à une audience cible spécifique, utilisez la méthode create() ou setup() sur la ressource Space. Pour rendre visible un espace existant, utilisez la méthode update() sur la ressource Space. Étant donné que seuls les espaces nommés peuvent être partagés avec les 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 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 des espaces Chat par défaut de 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: