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 découvrir et rejoindre l'espace.

Pour spécifier les utilisateurs de votre organisation autorisés à découvrir et à rejoindre un espace : lorsque vous créez des audiences cibles. Une audience cible désigne un groupe de personnes, des services spécifiques ou l'ensemble de l'organisation, que vous pouvez partager Chat avec, pour améliorer la visibilité de l'espace et et le partage. Les audiences cibles vous permettent aussi de gérer et de personnaliser l'espace plutôt que d'avoir à inviter individuellement des utilisateurs à un espace. Pour plus informations, consultez la section À propos de la cible audiences.

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

  2. Dans le tableau Audiences cibles, cliquez sur le champ Nom de la cible. 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 est l'identifiant alphanumérique de votre public cible.

Dans la section suivante, vous allez utiliser l'ID d'audience cible pour créer ou modifier un espace existant pour le rendre visible votre 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 le create() ou setup() sur la ressource Space. Créer un espace existant utilisez la méthode update() sur la ressource Space. Parce que seuls 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 le 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 la cible. que vous avez obtenue dans la section précédente. Pour utiliser la valeur par défaut Paramètres de partage des espaces Chat pour votre compte Google Workspace organisation, remplacez par default.

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