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 découvrir l'espace, le rejoindre et voir ses membres.

Pour spécifier les utilisateurs de votre organisation qui peuvent découvrir un espace, y participer et en afficher les membres, 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 Chat. Cela vous permet de contrôler plus précisément qui peut accéder à l'espace et à ses informations. 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 les 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 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 utiliserez 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 modifier 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 un espace, le rejoindre ou voir ses membres, 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.
  • Afficher les membres : utilisez viewSpaceMembershipSetting pour définir qui peut voir la liste des membres d'un espace. Lorsque vous mettez à jour les personnes autorisées à voir les membres d'un espace, accessSettings.accessPermissionSettings.viewSpaceMembershipSetting doit être spécifié avec permissionSettings.viewSpaceMembership dans le corps de la requête et dans updateMask. Lorsqu'une audience cible est configurée dans viewSpaceMembershipSetting, l'accès viewSpaceMembership doit être accordé à tous les membres (managersAllowed, assistantManagersAllowed et membersAllowed définis sur true).

L'exemple suivant montre comment rendre un espace visible par deux audiences cibles, permettre à l'une d'elles de le rejoindre et s'assurer que tous les membres et les audiences cibles spécifiées peuvent consulter la liste des membres :

{
  "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" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

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 par défaut des espaces Chat pour votre organisation Google Workspace, remplacez-les 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. Nous vous recommandons toutefois de spécifier des audiences cibles et des autorisations précises.

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

  "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 par défaut des espaces Chat pour votre organisation Google Workspace, remplacez-les par default.

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

Lorsque vous obtenez ou listez des espaces, l'objet AccessSettings dans 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 :