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
- Une entreprise Un compte Google Workspace ayant accès à Google Chat : Votre le compte de service doit disposer du super-administrateur rôle pour votre organisation Google Workspace.
- Audience cible disponible dans Chat. À créer une audience cible, reportez-vous à la section Créer une audience cible audience cible. Pour créer cible disponible pour les espaces Chat, consultez Configurez l'accès à l'espace 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 la cible. 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
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:
Articles associés
- Créer une audience cible
- Configurer le partage dans Chat
- Créer des espaces avec différents niveaux d'accès