Obtenir des abonnements et attribuer des licences pour Gemini Enterprise

Cette page explique comment souscrire un abonnement à Gemini Enterprise et comment gérer les licences utilisateur.

La configuration de l'accès comprend généralement les étapes suivantes :

  1. S'abonner : souscrivez un abonnement à une édition de produit pour votre compte de facturation.
  2. Distribuer : attribuez des licences de l'abonnement à des projets et des établissements spécifiques.
  3. Attribuer : attribuez les licences distribuées à des utilisateurs individuels.

À propos des licences

Pour se connecter à l'application Gemini Enterprise, un utilisateur doit disposer d'une licence. Vous pouvez attribuer des licences aux utilisateurs manuellement ou automatiquement.

  • Licences attribuées manuellement : vous pouvez ajouter des utilisateurs à l'aide de leur adresse e-mail.

  • Licences attribuées automatiquement : vous pouvez configurer un abonnement pour que Gemini Enterprise attribue automatiquement une licence à un utilisateur la première fois qu'il accède à l'interface Gemini Enterprise ou Gemini Notebook Enterprise.

À propos des abonnements

Pour obtenir des licences, vous devez d'abord disposer d'un abonnement à une édition Gemini Enterprise. Les abonnements sont spécifiques à un compte de facturation. Pour en savoir plus sur les éditions disponibles, consultez Comparer les éditions de Gemini Enterprise.

Pour Gemini Enterprise, vous pouvez souscrire un abonnement mensuel ou annuel. Ces abonnements peuvent être configurés pour être renouvelés automatiquement.

Vous pouvez souscrire des abonnements aux éditions Gemini Enterprise Standard, Gemini Enterprise Plus et Gemini Enterprise avec paiement à l'usage à l'aide de la consoleGoogle Cloud .

Limites du nombre de sièges pour les abonnements

Lorsque vous souscrivez ou modifiez un abonnement basé sur le nombre de licences directement dans la consoleGoogle Cloud , des limites automatiques s'appliquent au nombre de licences en fonction du type de compte de facturation Cloud :

  • Comptes de facturation en libre-service (ou en ligne) et revendus : limités à 25 places maximum par compte lorsque vous gérez les abonnements à l'aide de la console Google Cloud .
  • Comptes de facturation avec paiement sur facture (ou hors connexion) : le nombre de licences est limité à 1 000 par compte.

Si votre organisation a besoin de plus de licences ou si vous rencontrez l'erreur de limite maximale de licences lorsque vous essayez d'en ajouter à un abonnement existant, contactez Google Cloud votre conseiller commercial ou votre responsable de compte pour acheter des licences supplémentaires via une commande hors connexion ou demandez une exemption de la liste d'autorisation.

À propos des états d'abonnement

Un abonnement peut avoir l'un des états suivants :

État Description
Non démarrée Vous avez souscrit l'abonnement, mais il n'est pas encore actif. Vous pouvez distribuer des licences de cet abonnement à des projets, mais les utilisateurs auxquels ces licences sont attribuées n'auront pas accès à Gemini Enterprise tant que l'abonnement ne sera pas actif. Pour en savoir plus, consultez Distribuer des licences.
Actif L'abonnement est actif et les utilisateurs disposant d'une licence dans cet abonnement peuvent accéder à Gemini Enterprise.
Désactivation… L'abonnement est en cours de désactivation, et les licences sont prévues pour une résiliation anticipée. Les utilisateurs disposant de licences dans cet abonnement continueront d'avoir accès à Gemini Enterprise pendant un délai de grâce d'une semaine. Au-delà de cette semaine, les licences passent à l'état "Expirée". Pour en savoir plus, consultez Gérer la résiliation anticipée.
Expiré Les utilisateurs disposant de licences dans cet abonnement perdent l'accès à Gemini Enterprise lorsque la période d'abonnement se termine ou lorsque les licences passent de l'état "Désactivé" à l'état "Expiré" après une résiliation anticipée.

Avant de commencer

Avant de commencer les procédures décrites sur cette page, assurez-vous de remplir les conditions préalables suivantes :

  • Effectuez toutes les tâches décrites dans Configurer Gemini Enterprise. Par exemple :

    • Configurer un compte de facturation pour votre projet
    • Attribuer au moins le rôle "Utilisateur Gemini Enterprise" à tous les utilisateurs auxquels vous accorderez une licence pour utiliser Gemini Enterprise.

  • Vérifiez que la facturation est activée pour votre projet Google Cloud . Pour en savoir plus, consultez Vérifier que la facturation est activée pour votre projet Google Cloud .

  • Vérifiez que vous disposez des rôles et autorisations IAM requis :

    • Le rôle Administrateur Gemini Enterprise.

    • Si vous gérez la facturation de votre organisation, vous devez disposer des rôles suivants pour gérer les abonnements Gemini Enterprise et les bons de commande.

      Vous pouvez également utiliser un rôle personnalisé avec les autorisations suivantes au lieu du rôle Administrateur du compte de facturation pour un contrôle IAM précis :

      Service Autorisations
      Moteur de découverte discoveryengine.billingAccountLicenseConfigs.distribute
      discoveryengine.billingAccountLicenseConfigs.get
      discoveryengine.billingAccountLicenseConfigs.list
      discoveryengine.billingAccountLicenseConfigs.retract
      discoveryengine.licenseConfigs.create
      discoveryengine.licenseConfigs.get
      discoveryengine.licenseConfigs.list
      discoveryengine.licenseConfigs.update
      discoveryengine.projects.get
      discoveryengine.projects.provision
      discoveryengine.projects.reportConsentChange
      discoveryengine.userStores.batchUpdateUserLicenses
      discoveryengine.userStores.listUserLicenses
      Approvisionnement des consommateurs consumerprocurement.orders.get
      consumerprocurement.licensePools.assign
      consumerprocurement.licensePools.unassign
      consumerprocurement.licensePools.enumerateLicensedUsers
      Resource Manager resourcemanager.projects.get
      resourcemanager.projects.list
      Service Usage serviceusage.services.get
      serviceusage.services.list

Souscrire un abonnement

Pour obtenir des licences, souscrivez un abonnement à une édition Gemini Enterprise pour votre compte de facturation. L'abonnement fournit un pool de licences que vous pouvez utiliser avec n'importe quel projet associé à ce compte de facturation, distribuer aux projets et attribuer aux utilisateurs.

Standard et Plus

Pour vous abonner à l'édition Standard ou Plus de Gemini Enterprise, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les abonnements > Créer un abonnement.

  3. Pour l'édition Gemini Enterprise Standard ou Gemini Enterprise Plus, cliquez sur S'abonner.

  4. Configurez les informations de facturation :

    1. Sélectionnez le compte de facturation dans le menu déroulant.
    2. Saisissez un nom d'abonnement.
    3. Saisissez le nombre de licences dont vous avez besoin pour l'édition.

  5. Sélectionnez la période d'abonnement.

  6. Si vous souhaitez que l'abonnement soit renouvelé automatiquement, sélectionnez Renouveler l'abonnement automatiquement.

  7. Configurez les détails de la distribution :

    1. Dans la liste déroulante Sélectionner un projet, sélectionnez votre projet.
    2. Sélectionnez un type d'emplacement pour votre abonnement. Si vous n'avez pas besoin de localiser vos données dans un emplacement multirégional aux États-Unis ou dans l'UE pour des raisons de conformité ou de réglementation, Google vous recommande de choisir l'emplacement multirégional mondial pour une disponibilité maximale et une faible latence.

  8. Cliquez sur Créer > Confirmer.

Paiement à l'usage

Avec un abonnement au paiement à l'usage, vous payez mensuellement ce que vous consommez aux tarifs indiqués dans Dépassements. Vous pouvez utiliser l'abonnement avec n'importe quel projet associé à votre compte de facturation.

Pour vous abonner à l'édition Gemini Enterprise avec paiement à l'usage, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les abonnements > Créer un abonnement.

  3. Dans l'édition Gemini Enterprise avec paiement à l'usage, cliquez sur S'abonner.

  4. Configurez les informations de facturation :

    1. Saisissez un nom d'abonnement.
    2. Saisissez le nombre de licences dont vous avez besoin pour l'édition.

  5. Configurez les détails de la distribution :

    1. Dans la liste déroulante Sélectionner un projet, sélectionnez votre projet.
    2. Sélectionnez un type d'emplacement pour votre abonnement. Si vous n'avez pas besoin de localiser vos données dans un emplacement multirégional aux États-Unis ou dans l'UE pour des raisons de conformité ou de réglementation, Google vous recommande de choisir l'emplacement multirégional mondial pour une disponibilité maximale et une faible latence.

  6. Cliquez sur Créer > Confirmer.

Gérer les abonnements

Cette section explique comment afficher, modifier, distribuer et récupérer des abonnements Gemini Enterprise.

Voir les détails de l'abonnement

Pour afficher les détails de vos abonnements Gemini Enterprise :

Console

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les abonnements.

  3. Sélectionnez le compte de facturation dans le menu déroulant.

  4. Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement.

REST

Pour obtenir des informations sur l'abonnement, exécutez la commande suivante :

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

Remplacez les éléments suivants :

  • PROJECT_NUMBER : numéro du projet pour lequel vous disposez du rôle "Consommateur Service Usage".
  • BILLING_ACCOUNT_ID : ID de votre compte de facturation Google Cloud .

Exemple de sortie

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

Modifier les paramètres d'abonnement

Une fois l'abonnement créé, vous pouvez modifier ses paramètres, comme le nombre de licences ou le paramètre de renouvellement automatique.

La méthode à suivre pour ajouter des licences dépend de la façon dont vous avez souscrit votre abonnement :

  • Si vous avez souscrit votre abonnement via la console Google Cloud , ajoutez des licences directement dans la console Google Cloud en suivant les étapes décrites dans cette section.
  • Si vous avez effectué votre achat à l'aide d'un formulaire de commande hors connexion, vous devez mettre à jour le bon de commande pour indiquer le nouveau nombre de licences. Contactez votre responsable de compte Google pour modifier le bon de commande.

Pour modifier le nombre de licences si vous avez effectué votre achat depuis la consoleGoogle Cloud  :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les abonnements.

  3. Dans le tableau Abonnements Gemini, cliquez sur l'abonnement que vous souhaitez modifier.

  4. Cliquez sur Modifier à côté de Détails de l'abonnement.

  5. Modifiez le nombre de licences ou activez ou désactivez le renouvellement automatique.

  6. Cliquez sur Envoyer.

Résilier un abonnement

Pour résilier un abonnement Gemini Enterprise, vous devez désactiver le renouvellement automatique. Votre abonnement reste actif jusqu'à la fin de la période d'abonnement. Des frais peuvent vous être facturés jusqu'à cette date. Pour en savoir plus sur votre abonnement, consultez Afficher les détails de l'abonnement.

Pour résilier votre abonnement, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les abonnements.

  3. Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement pour ouvrir la page d'informations.

  4. Cliquez sur Modifier.

  5. Dans le panneau Modifier l'abonnement, décochez la case Renouvellement automatique de l'abonnement.

  6. Cliquez sur Envoyer.

Distribuer des licences

Si vous n'avez pas distribué les licences souscrites à un projet (ce qui peut se produire lorsque vous souscrivez l'abonnement hors connexion ou lorsque la distribution des licences a échoué précédemment), procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les abonnements.

  3. Sélectionnez le compte de facturation dans le menu déroulant.

  4. Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement.

  5. Cliquez sur Distribuer la licence en haut de la page. Une liste s'affiche, indiquant les distributions de licences existantes et les statistiques sur le nombre de sièges restants et total.

  6. Pour distribuer des licences à un projet :

    1. Cliquez sur le sélecteur de projet pour sélectionner un projet. Le sélecteur est compatible avec la saisie semi-automatique.
    2. Remarque : Si vous n'avez pas activé l'API Discovery Engine pour le projet sélectionné, une boîte de dialogue s'affiche pour vous inviter à l'activer.
    3. Sélectionnez un lieu.
    4. Saisissez le nombre de licences à attribuer.
    5. Répétez ces étapes si vous souhaitez distribuer des licences à plusieurs projets ou sites.

  7. Cliquez sur Envoyer.

  8. Dans la boîte de dialogue de confirmation, vérifiez le récapitulatif des modifications, puis cliquez sur Confirmer.

REST

Pour distribuer des licences à un ou plusieurs projets, exécutez la commande suivante :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

Remplacez les éléments suivants :

  • PROJECT_NUMBER : numéro du projet pour lequel vous disposez du rôle "Consommateur Service Usage".
  • ENDPOINT_LOCATION : région multirégionale pour votre requête API. Spécifiez l'une des valeurs suivantes :
    • us pour l'emplacement multirégional US
    • eu pour l'emplacement multirégional EU
    • global pour l'emplacement mondial
    Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
  • LOCATION : emplacement multirégional de votre data store : global, us ou eu.
  • TARGET_PROJECT_NUMBER : numéro du projet auquel vous souhaitez attribuer des licences.
  • LICENSE_COUNT : nombre de licences à distribuer.
  • BILLING_ACCOUNT_ID : ID de votre compte de facturation Google Cloud .
  • BILLING_ACCOUNT_LICENSE_CONFIG_ID : recherchez l'ID de configuration de licence du compte de facturation dans les détails de l'abonnement.

  • Facultatif LICENSE_CONFIG_ID : ID d'une configuration de licence existante au niveau du projet. Vous trouverez cet ID dans le champ licenseConfigDistributions lorsque vous affichez les détails de l'abonnement.

Récupérer des licences non attribuées dans un abonnement

Cette section explique comment récupérer les licences non attribuées d'un projet pour les rendre disponibles dans le compte de facturation et les redistribuer à d'autres projets.

Console

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les abonnements.

  3. Sélectionnez le compte de facturation dans le menu déroulant.

  4. Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement.

  5. Cliquez sur Distribuer la licence en haut de la page (ce bouton ouvre le formulaire de gestion pour toutes les allocations).

  6. Dans la liste des allocations, recherchez la ligne correspondant au projet et à l'emplacement à partir desquels vous souhaitez récupérer des licences.

  7. Choisissez l'une des actions suivantes :

    • Pour réduire le nombre de licences, diminuez le nombre dans le champ de saisie des licences.
    • Pour récupérer complètement des licences : pointez sur la ligne pour afficher le bouton de suppression, puis cliquez sur Supprimer.

  8. Cliquez sur Envoyer.

  9. Dans la boîte de dialogue de confirmation, vérifiez le récapitulatif des modifications (qui liste les licences récupérées), puis cliquez sur Confirmer.

REST

Pour transférer les licences d'abonnement vers le compte de facturation pour redistribution, exécutez la commande suivante :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

Remplacez les éléments suivants :

  • PROJECT_NUMBER : numéro du projet pour lequel vous disposez du rôle "Consommateur Service Usage".
  • ENDPOINT_LOCATION : région multirégionale pour votre requête API. Spécifiez l'une des valeurs suivantes :
    • us pour l'emplacement multirégional US
    • eu pour l'emplacement multirégional EU
    • global pour l'emplacement mondial
    Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
  • LOCATION : emplacement multirégional de votre data store : global, us ou eu.
  • TARGET_PROJECT_NUMBER : numéro du projet à partir duquel vous souhaitez récupérer des licences.
  • LICENSE_COUNT : nombre de licences à récupérer.
  • BILLING_ACCOUNT_ID : ID de votre compte de facturation Google Cloud .
  • BILLING_ACCOUNT_LICENSE_CONFIG_ID : recherchez l'ID de configuration de licence du compte de facturation dans les détails de l'abonnement.
  • LICENSE_CONFIG_ID : ID de configuration de licence d'une configuration de licence existante au niveau du projet.

Gérer la résiliation anticipée

Lors de la migration entre différents types d'abonnements ou en cas de problème avec votre compte de facturation, un abonnement peut se terminer plus tôt que prévu.

Pour faciliter la transition et éviter toute interruption de service, nous accordons un délai de grâce d'une semaine (sept jours) pendant lequel les licences concernées sont en état de désactivation avant d'expirer complètement. Pendant ce délai de grâce, vous pouvez continuer à utiliser le service pendant que vous passez à un nouvel abonnement.

Pour que vos utilisateurs conservent l'accès, transférez leurs licences vers un nouvel abonnement actif, soit automatiquement, soit manuellement.

L'image suivante montre un exemple de licence désactivée dans la consoleGoogle Cloud  :

Exemple de désactivation d'une licence dans la console Google Cloud

Gérer les licences utilisateur

Cette section explique comment afficher les licences, exporter les données utilisateur, et attribuer, transférer et supprimer des licences pour des utilisateurs individuels.

Afficher les licences

Pour afficher les licences et les utilisateurs qui leur sont attribués :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les utilisateurs.

  3. Sélectionnez la multirégion de la licence existante.

Exporter les données utilisateur

Le tableau des utilisateurs de la console Google Cloud ne permet pas de trier ni de filtrer les données. Si vous avez besoin de trier, de filtrer ou d'analyser vos données utilisateur, vous pouvez exporter jusqu'à 1 000 000 d'enregistrements utilisateur dans un fichier CSV (valeurs séparées par une virgule).

Le fichier CSV exporté inclut les colonnes suivantes.

Nom de la colonne Description
user_principal L'adresse e-mail de l'utilisateur.
license_config Nom complet de la ressource Google Cloud pour l'abonnement attribué à l'utilisateur (par exemple, projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). L'ID de configuration de la licence correspond à l'édition Gemini Enterprise (par exemple, Standard ou Plus) attribuée à l'utilisateur.
assignment_time Code temporel (en UTC) indiquant le moment où un administrateur a attribué la licence.
last_login_time Code temporel (en UTC) de la dernière connexion de l'utilisateur.
license_assignment_state État de l'attribution de la licence. Les valeurs suivantes sont disponibles :
  • ASSIGNED : l'utilisateur dispose d'une licence attribuée.
  • NO_LICENSE : l'utilisateur ne dispose pas de licence, car un administrateur ne lui en a pas attribué ou lui en a retiré une.
  • BLOCKED : une règle ou un administrateur empêchent l'utilisateur de recevoir une licence.

Pour exporter les données utilisateur dans un fichier CSV :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise > Gérer les utilisateurs.

    Gérer les utilisateurs

  2. Sélectionnez la multirégion de la licence existante.

  3. Dans la section Utilisateurs, cliquez sur Exporter tous les utilisateurs.

    Selon la taille du tableau des utilisateurs, le processus d'exportation peut prendre jusqu'à 2,5 minutes. Pendant ce temps, la console affiche un état de chargement. Une fois l'exportation terminée, votre navigateur télécharge le fichier CSV à son emplacement de téléchargement par défaut.

Résoudre les problèmes d'exportation

Le tableau suivant répertorie les problèmes courants lors de l'exportation des données utilisateur et leurs solutions.

Problème Solution
Le bouton Exporter tous les utilisateurs est masqué Assurez-vous que des utilisateurs sont attribués aux licences dans la région multirégionale sélectionnée. Si aucun utilisateur n'est attribué, le bouton Exporter tous les utilisateurs n'apparaît pas.
La demande d'exportation échoue et renvoie une erreur de dépassement de limite Si votre liste d'utilisateurs dépasse la limite d'exportation de 1 000 000 d'utilisateurs, la console Google Cloud rejette la demande d'exportation et affiche un message d'erreur de dépassement de limite.
La demande d'exportation échoue et renvoie une erreur "Autorisation refusée". Assurez-vous que votre compte dispose du rôle Administrateur Gemini Enterprise, qui inclut l'autorisation discoveryengine.userStores.listUserLicenses requise.

Attribuer des licences aux utilisateurs

Cette section explique comment attribuer automatiquement ou manuellement des licences aux nouveaux utilisateurs. Vous pouvez attribuer une licence à un nouvel utilisateur à tout moment. Une fois la licence attribuée, l'utilisateur peut accéder immédiatement à Gemini Enterprise.

Ajouter des utilisateurs et leur attribuer automatiquement des licences

Pour attribuer automatiquement des licences aux utilisateurs lorsqu'ils se connectent à l'application Gemini Enterprise :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les utilisateurs.

  3. Sélectionnez la multirégion de la licence existante.

  4. Sélectionnez Attribuer automatiquement des licences, puis sélectionnez l'abonnement.

    Chaque fois qu'un utilisateur sans licence attribuée manuellement se connecte, Gemini Enterprise lui attribue automatiquement une licence à partir de cet abonnement. Si aucune licence n'est disponible dans l'abonnement, Gemini Enterprise affiche un message indiquant aux utilisateurs qu'ils n'y ont pas accès.

    Pour en savoir plus sur les abonnements, consultez la section À propos des abonnements.

Ajouter des utilisateurs et leur attribuer manuellement des licences

Pour donner accès à Gemini Enterprise à des utilisateurs spécifiques, vous pouvez leur attribuer manuellement des licences à partir d'un abonnement actif.

Console

Pour attribuer manuellement des licences à des utilisateurs :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur Gérer les utilisateurs.

  3. Sélectionnez la multirégion de la licence existante.

  4. Cliquez sur Add users (Ajouter des utilisateurs).

  5. Sur la page Ajouter des utilisateurs :

    1. Saisissez les adresses e-mail des utilisateurs. Veillez à utiliser la même adresse e-mail que celle qu'ils utiliseront pour se connecter à l'application Gemini Enterprise.

    2. Sélectionnez l'abonnement à attribuer à ces utilisateurs.

    3. Cliquez sur Envoyer.

REST

Pour attribuer manuellement des licences aux utilisateurs, exécutez la commande suivante :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":false
  }'

Remplacez les éléments suivants :

  • PROJECT_ID : l'ID du projet.
  • ENDPOINT_LOCATION : région multirégionale pour votre requête API. Spécifiez l'une des valeurs suivantes :
    • us pour l'emplacement multirégional US
    • eu pour l'emplacement multirégional EU
    • global pour l'emplacement mondial
    Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
  • LOCATION : emplacement multirégional de votre data store : global, us ou eu
  • USER_EMAIL : adresse e-mail de l'utilisateur que vous souhaitez ajouter à la licence.
  • PROJECT_NUMBER : numéro de votre projet Google Cloud .
  • SUBSCRIPTION_ID : ID de votre abonnement Gemini Enterprise.

Transférer des licences depuis des abonnements expirés

Les utilisateurs ne peuvent pas se connecter à Gemini Enterprise si l'abonnement a expiré. Il existe plusieurs façons de leur redonner accès à la connexion :

Transférer automatiquement les utilisateurs vers un abonnement actif

Pour transférer automatiquement les utilisateurs vers un abonnement actif, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise > Gérer les utilisateurs.

    Licence Gemini Enterprise

  2. Sélectionnez la multirégion de la licence existante.

  3. Assurez-vous que vous disposez d'un abonnement actif. Si vous n'en avez pas, souscrivez un abonnement.

  4. Sélectionnez Attribuer automatiquement des licences, puis choisissez l'abonnement actif.

  5. Sélectionnez Mettre à jour automatiquement la licence expirée.

    Lorsqu'un utilisateur disposant d'une licence expirée se connecte, Gemini Enterprise lui attribue automatiquement une licence dans l'abonnement choisi.

Transférer manuellement des utilisateurs vers un abonnement actif

Pour transférer manuellement des utilisateurs vers un abonnement actif :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise > Gérer les utilisateurs.

    Licence Gemini Enterprise

  2. Sélectionnez la multirégion de la licence existante.

  3. Assurez-vous que vous disposez d'un abonnement actif. Si vous n'en avez pas, souscrivez un abonnement.

  4. Sélectionnez les utilisateurs, puis cliquez sur Attribuer une autre licence.

  5. Dans le volet Modifier les utilisateurs, sélectionnez l'abonnement, puis cliquez sur Envoyer.

Lister les licences

Pour lister les licences et les utilisateurs qui leur sont attribués, exécutez la commande suivante :

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

Remplacez les éléments suivants :

  • PROJECT_ID : l'ID du projet.
  • ENDPOINT_LOCATION : région multirégionale pour votre requête API. Spécifiez l'une des valeurs suivantes :
    • us pour l'emplacement multirégional US
    • eu pour l'emplacement multirégional EU
    • global pour l'emplacement mondial
    Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
  • LOCATION : emplacement multirégional de votre data store : global, us ou eu

Supprimer des utilisateurs d'une licence

Vous pouvez supprimer la licence d'un utilisateur à tout moment. Lorsqu'une licence est supprimée, l'utilisateur perd immédiatement l'accès à Gemini Enterprise. Pour supprimer des utilisateurs d'une licence, procédez comme suit :

Console

Pour supprimer des utilisateurs d'une licence à l'aide de la console Google Cloud , procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise > Gérer les utilisateurs.

    Licence Gemini Enterprise

  2. Sélectionnez la multirégion de la licence existante.

  3. Dans le tableau des utilisateurs, sélectionnez les utilisateurs.

  4. Pour supprimer des utilisateurs d'une licence, choisissez l'une des options suivantes :

    • Pour ne supprimer la licence que pour les utilisateurs sélectionnés, cliquez sur Annuler l'attribution de la licence.
    • Pour supprimer la licence et les utilisateurs sélectionnés du projet, cliquez sur Annuler l'attribution et supprimer la licence.

  5. Cliquez sur Confirmer.

REST

Pour supprimer des utilisateurs d'une licence, exécutez la commande suivante :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

Remplacez les éléments suivants :

  • PROJECT_ID : l'ID du projet.
  • ENDPOINT_LOCATION : région multirégionale pour votre requête API. Spécifiez l'une des valeurs suivantes :
    • us pour l'emplacement multirégional US
    • eu pour l'emplacement multirégional EU
    • global pour l'emplacement mondial
    Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
  • LOCATION : emplacement multirégional de votre data store : global, us ou eu
  • USER_EMAIL : adresse e-mail de l'utilisateur que vous souhaitez supprimer de la licence.

Étapes suivantes