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 de discussion Chat pour améliorer la visibilité et la capacité de partage de l'espace. Les audiences cibles vous permettent également de gérer et de personnaliser les membres d'un espace sans avoir à inviter des utilisateurs individuels. Pour en savoir plus, consultez À propos des audiences cibles.

Vous ne pouvez rendre les espaces nommés visibles que pour des 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 :

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

    Accéder aux 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 le suivant : 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 de l'audience cible pour créer un espace visible ou mettre à jour un espace existant afin de le rendre visible par l'audience cible.

Spécifier des audiences cibles et des autorisations précises

Pour créer un espace avec des autorisations d'accès spécifiques, utilisez la méthode create ou setup sur la ressource Space. Pour mettre à jour les autorisations d'un espace existant, utilisez la méthode update. É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 spécifier qui peut découvrir ou rejoindre un espace, incluez l'objet AccessSettings dans la ressource Space. Dans l'objet, utilisez le champ accessPermissionSettings pour spécifier une ou plusieurs des autorisations suivantes :

  • Visible : utilisez discoverSpaceSetting pour définir qui peut trouver le nom et la description d'un espace, et le parcourir dans Google Chat. Vous pouvez spécifier plusieurs audiences cibles pour la découverte.
  • Rejoignable : utilisez joinSpaceSetting pour définir qui peut rejoindre un espace sans invitation explicite et prévisualiser le message de l'espace. Les utilisateurs qui peuvent rejoindre un espace doivent également pouvoir le découvrir. Google Chat n'accepte qu'une seule audience cible pour cette autorisation.

L'exemple suivant montre comment rendre un espace visible par deux audiences cibles et permettre à l'une d'elles de le rejoindre :

  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      }
    }
  }

Remplacez TARGET_AUDIENCE_ID_1 et TARGET_AUDIENCE_ID_2 par l'ID de l'audience cible que vous avez obtenu dans Obtenir l'ID de l'audience cible. Pour utiliser les paramètres de partage d'espace Chat par défaut pour votre organisation Google Workspace, remplacez-le par default.

Pour la rétrocompatibilité, utilisez le champ audience.

Pour assurer la rétrocompatibilité, vous pouvez continuer à utiliser le champ audience pour spécifier une seule audience cible pouvant rejoindre un espace. Toutefois, nous vous recommandons de spécifier des audiences cibles et des autorisations précises.

Configurer le champ audience revient à spécifier l'audience cible dans joinSpaceSetting et discoverSpaceSetting :

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

Remplacez TARGET_AUDIENCE_ID par l'ID de l'audience cible que vous avez obtenu dans Obtenir l'ID de l'audience cible. Pour utiliser les paramètres de partage d'espace Chat par défaut pour votre organisation Google Workspace, remplacez-le par default.

Comprendre les paramètres d'accès dans les réponses de l'API

Lorsque vous récupérez des espaces, l'objet AccessSettings de la réponse reflète les autorisations précises définies pour l'espace.

Les champs suivants de AccessSettings indiquent si un espace peut être trouvé dans la recherche et les autorisations pour le rejoindre :

  • accessState : dérivé des autorisations de découverte (discoverSpaceSetting). Si la découverte est accordée à une ou plusieurs audiences cibles, ce champ est défini sur DISCOVERABLE. Sinon, la valeur est PRIVATE.
  • audience : mappé spécifiquement aux autorisations de participation (joinSpaceSetting). Si une seule audience cible dispose de l'autorisation de participation, ce champ contient le nom de ressource de cette audience cible.

Espace visible sans audience à rejoindre

Un espace peut être visible par une audience cible, mais ne peut pas être rejoint directement (par exemple, si les utilisateurs doivent être explicitement invités à le rejoindre).

Dans ce cas, l'objet AccessSettings présente les valeurs suivantes :

  • accessState : DISCOVERABLE
  • audience : omis ou null

Si accessState est défini sur DISCOVERABLE, mais que audience n'est pas présent, cela signifie que l'espace peut être découvert par les audiences cibles spécifiées dans discoverSpaceSetting, mais qu'il ne peut être rejoint que sur invitation. Pour savoir quelles audiences cibles peuvent découvrir l'espace, consultez le champ accessPermissionSettings.discoverSpaceSetting.

Pour en savoir plus sur les audiences cibles, consultez les guides suivants :

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