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
- Un compte Google Workspace ayant accès à Google Chat. Votre compte doit disposer du rôle de super-administrateur de votre organisation Google Workspace.
- Audience cible disponible dans Chat. Pour créer une audience cible, consultez la section Créer une audience cible. Pour rendre une audience cible existante disponible dans les espaces Chat, consultez Configurer l'accès aux espaces pour Chat.
Obtenir l'ID de la cible
Pour obtenir l'ID d'une audience cible, procédez comme suit:
Dans la console d'administration Google, accédez à Menu > Annuaire > Audiences cibles.
Dans le tableau Audiences cibles, cliquez sur le champ Nom de l'audience cible.
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:
Articles associés
- Créer une audience cible
- Configurer le partage dans Chat
- Créer des espaces avec différents niveaux d'accès