Cette page explique comment obtenir des abonnements pour Gemini Enterprise et comment gérer les licences utilisateur.
Pour configurer l'accès, vous devez généralement suivre les étapes suivantes :
- Acheter : souscrivez un abonnement à une édition de produit pour votre compte de facturation.
- Distribuer : allouez des licences de l'abonnement à des projets et des emplacements spécifiques.
- 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 en saisissant leur adresse e-mail.
Licences attribuées automatiquement : vous pouvez configurer un abonnement de sorte que Gemini Enterprise attribue automatiquement une licence à un utilisateur la première fois qu'il accède à l'interface Gemini Enterprise ou Gemini Notebook pour les entreprises.
À 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. Vous pouvez configurer le renouvellement automatique pour ces abonnements.
Vous pouvez souscrire des abonnements pour les éditions Gemini Enterprise Standard, Gemini Enterprise Plus et Gemini Enterprise avec paiement à l'usage à l'aide de la consoleGoogle Cloud .
Limites du nombre de licences d'abonnement
Lorsque vous achetez ou modifiez un abonnement basé sur le nombre de licences directement dans la consoleGoogle Cloud , celle-ci applique un plafond automatique au nombre de licences. Le nombre maximal de licences dépend de votre compte de facturation Cloud.
Si votre organisation a besoin de plus de licences ou si vous rencontrez l'erreur de limite maximale de licences lorsque vous essayez d'ajouter des licences à un abonnement existant, contactez votre représentant commercial ou votre responsable de compte Google Cloud pour acheter des licences supplémentaires via une commande hors connexion ou demander une exemption de liste d'autorisation.
À propos des états d'abonnement
Un abonnement peut présenter 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 les licences de cet abonnement à des projets, mais si vous les attribuez à des utilisateurs, ils ne pourront pas accéder à 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 ses licences se terminent plus tôt que prévu. Les utilisateurs disposant de licences dans cet abonnement continuent d'accéder à Gemini Enterprise pendant un délai de grâce d'une semaine. Passé ce délai, les licences passent à l'état "Expiré". Pour en savoir plus, consultez Gérer l'arrêt anticipé. |
| Expiré | Les utilisateurs disposant de licences dans cet abonnement perdent l'accès à Gemini Enterprise à la fin de la période d'abonnement ou lorsque les licences passent de l'état de désactivation à l'état d'expiration après la fin anticipée de l'abonnement. |
Avant de commencer
Avant de commencer les procédures décrites sur cette page, remplissez 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
- Attribuez au moins le rôle d'utilisateur Gemini Enterprise à tous les utilisateurs auxquels vous accorderez une licence 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 sur le projet.
Si vous gérez la facturation pour votre organisation, vous devez disposer des rôles suivants pour acheter et gérer les abonnements et les commandes d'approvisionnement Gemini Enterprise :
Sur le compte de facturation Cloud que vous utilisez pour l'abonnement, l'un des éléments suivants :
- Rôle Administrateur de compte de facturation (
roles/billing.admin). - Rôles Administrateur des commandes d'approvisionnement des consommateurs (
roles/consumerprocurement.orderAdmin) et Lecteur de compte de facturation (roles/billing.viewer).
- Rôle Administrateur de compte de facturation (
Sur le projet, le rôle Consommateur Service Usage (
roles/serviceusage.serviceUsageConsumer).
Pour contrôler les autorisations IAM de manière précise, vous pouvez également utiliser un rôle personnalisé avec les autorisations suivantes au lieu du rôle Administrateur de compte de facturation. Accordez les autorisations sur les ressources listées dans le tableau.
Ressource Service Autorisations Compte de facturation Cloud Cloud Billing billing.billingAccountPrices.listCompte de facturation Cloud Approvisionnement des consommateurs consumerprocurement.orders.get
consumerprocurement.orders.place
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.unassign
consumerprocurement.licensePools.enumerateLicensedUsersCompte de facturation Cloud Moteur de découverte discoveryengine.billingAccountLicenseConfigs.distribute
discoveryengine.billingAccountLicenseConfigs.get
discoveryengine.billingAccountLicenseConfigs.list
discoveryengine.billingAccountLicenseConfigs.retractProjet Moteur de découverte 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.listUserLicensesProjet Resource Manager resourcemanager.projects.get
resourcemanager.projects.listProjet 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 distribuez aux projets et attribuez aux utilisateurs. Vous pouvez distribuer des licences d'un abonnement basé sur des licences, comme Gemini Enterprise Standard ou Plus, à des projets associés à n'importe quel compte de facturation. Vous ne pouvez distribuer des licences d'un abonnement avec paiement à l'usage qu'aux projets associés au compte de facturation propriétaire de l'abonnement.
Standard et Plus
Pour vous abonner à l'édition Gemini Enterprise Standard ou Plus, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Forfaits et facturation.
Dans la liste déroulante Compte de facturation sélectionné, sélectionnez votre compte de facturation.
Cliquez sur Créer un abonnement.
Pour l'édition Gemini Enterprise Standard ou Gemini Enterprise Plus, cliquez sur S'abonner.
Configurez les informations de facturation :
- Confirmez ou sélectionnez le compte de facturation dans le menu déroulant.
- Saisissez un nom d'abonnement.
- Saisissez le nombre de licences dont vous avez besoin pour l'édition.
Sélectionnez une période d'abonnement.
Si vous souhaitez que l'abonnement soit renouvelé automatiquement, cochez la case Renouveler automatiquement l'abonnement.
Configurez les Détails de la distribution :
- Dans le champ Projet, saisissez un ID de projet, puis sélectionnez un projet parmi les options correspondantes. Si la console vous y invite, activez les API requises.
- Choisissez un 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.
Cliquez sur Créer > Confirmer.
Paiement à l'usage
Avec un abonnement avec paiement à l'usage, vous payez chaque mois ce que vous consommez. Pour en savoir plus, consultez Quotas et tarifs de l'édition avec paiement à l'usage. Vous pouvez utiliser l'abonnement avec n'importe quel projet connecté à votre compte de facturation.
Pour vous abonner à l'édition Gemini Enterprise avec paiement à l'usage, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Forfaits et facturation.
Dans la liste déroulante Compte de facturation sélectionné, sélectionnez votre compte de facturation.
Cliquez sur Créer un abonnement.
Pour l'édition Gemini Enterprise avec paiement à l'usage, cliquez sur Créer un forfait.
Configurez les informations de facturation :
- Confirmez ou sélectionnez le compte de facturation dans le menu déroulant.
- Saisissez un nom d'abonnement.
- Saisissez le nombre de licences de paiement à l'usage dont vous avez besoin pour l'édition.
Configurez les Détails de la distribution :
- Dans le champ Projet, saisissez un ID de projet, puis sélectionnez un projet parmi les options correspondantes. Si la console vous y invite, activez les API requises.
- Choisissez un 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.
Cliquez sur Créer > Confirmer.
Si votre projet est associé à un compte de facturation Cloud en libre-service (en ligne), la fenêtre Acheter des crédits s'ouvre. Sélectionnez un montant et un mode de paiement, puis finalisez l'achat. Vous pouvez également configurer la recharge automatique.
Si vous n'avez pas encore configuré de crédits prépayés sur le compte de facturation, vous devez en acheter. Si vous annulez, vous ne créez pas d'abonnement et Google ne vous facture pas. Pour en savoir plus, consultez Gérer les crédits prépayés.
Gérer les abonnements
Cette section explique comment afficher, mettre à jour, 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, procédez comme suit :
Console
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Forfaits et facturation.
Dans la liste déroulante Compte de facturation sélectionné, sélectionnez votre compte de facturation.
Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement pour ouvrir la page Détails de l'abonnement.
REST
Pour obtenir les détails de 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 ou ID du projet que vous utilisez pour attribuer la facturation et le quota pour cet appel d'API. Vous devez disposer du rôle Consommateur Service Usage pour ce projet.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
Après avoir créé un abonnement, vous pouvez modifier ses paramètres, comme le nombre de licences ou le paramètre de renouvellement automatique.
La méthode d'ajout de licences dépend de la manière dont vous avez initialement souscrit votre abonnement :
- Si vous avez acheté votre abonnement via la console Google Cloud , ajoutez des licences directement dans la console Google Cloud en suivant les étapes de cette section.
- Si vous avez effectué l'achat à l'aide d'un bon de commande hors connexion, vous devez mettre à jour le bon de commande avec le nouveau nombre de licences. Contactez votre responsable de compte Google pour mettre à jour le bon de commande.
Pour modifier le nombre de licences ou les paramètres de renouvellement si vous avez acheté votre abonnement via la console Google Cloud , procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Forfaits et facturation.
Dans la liste déroulante Compte de facturation sélectionné, sélectionnez votre compte de facturation.
Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement pour ouvrir la page Détails de l'abonnement.
Sur la page Détails de l'abonnement, cliquez sur Modifier.
Dans le volet Modifier l'abonnement, saisissez une nouvelle valeur dans le champ Nombre de licences, ou cochez ou décochez la case Renouvellement automatique.
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, et Google peut vous facturer jusqu'à cette date. Pour en savoir plus sur votre abonnement, consultez Voir les détails de l'abonnement.
Pour résilier votre abonnement, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Forfaits et facturation.
Dans la liste déroulante Compte de facturation sélectionné, sélectionnez votre compte de facturation.
Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement pour ouvrir la page Détails de l'abonnement.
Sur la page Détails de l'abonnement, cliquez sur Modifier.
Dans le volet Modifier l'abonnement, décochez la case Renouvellement automatique.
Cliquez sur Envoyer.
Distribuer des licences
Si vous n'avez pas distribué les licences d'abonnement à un projet, ce qui peut se produire lorsque vous achetez l'abonnement hors connexion ou lorsqu'une tentative précédente de distribution de licences a échoué, procédez comme suit :
Console
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Forfaits et facturation.
Dans la liste déroulante Compte de facturation sélectionné, sélectionnez votre compte de facturation.
Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement pour ouvrir la page Détails de l'abonnement.
Sur la page Détails de l'abonnement, cliquez sur Distribuer des licences.
Le volet Distribuer des licences s'ouvre et affiche les allocations de licences de projet existantes, ainsi que le nombre de licences disponibles et le nombre total de licences.
Pour distribuer des licences à un projet :
- Dans le champ Sélectionner un projet, saisissez un ID de projet, puis sélectionnez un projet parmi les options correspondantes.
- Si une boîte de dialogue vous invite à activer l'API Discovery Engine pour le projet sélectionné, cliquez pour l'activer.
- Dans le menu déroulant Région, sélectionnez une région.
- Dans le champ Nombre de licences, saisissez le nombre de licences à attribuer.
- Facultatif : Pour attribuer des licences à d'autres projets ou régions, cliquez sur Ajouter une distribution de licences, puis répétez ces étapes.
Cliquez sur Envoyer.
Dans la boîte de dialogue Confirmer la distribution des licences, cliquez sur Envoyer.
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 ou ID du projet que vous utilisez pour attribuer la facturation et le quota pour cet appel d'API. Vous devez disposer du rôle Consommateur Service Usage pour ce projet. Vous pouvez utiliserTARGET_PROJECT_NUMBERsi vous avez activé Discovery Engine sur ce projet.ENDPOINT_LOCATION: emplacement multirégional de votre requête API. Spécifiez une des valeurs suivantes :uspour l'emplacement multirégional USeupour l'emplacement multirégional EUglobalpour l'emplacement mondial
LOCATION: emplacement multirégional de votre data store :global,usoueu.TARGET_PROJECT_NUMBER: numéro du projet auquel vous souhaitez distribuer 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 informations détaillées sur l'abonnement.Facultatif
LICENSE_CONFIG_ID: ID d'une configuration de licence existante au niveau du projet. Vous trouverez cet ID dans le champlicenseConfigDistributionslorsque vous afficherez les détails de l'abonnement.
Récupérer les licences non attribuées d'un abonnement
Cette section explique comment récupérer les licences non attribuées d'un projet, afin de les rendre disponibles dans le compte de facturation pour les redistribuer à d'autres projets.
Console
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Forfaits et facturation.
Dans la liste déroulante Compte de facturation sélectionné, sélectionnez votre compte de facturation.
Dans le tableau Abonnements Gemini, cliquez sur le nom de votre abonnement pour ouvrir la page Détails de l'abonnement.
Sur la page Détails de l'abonnement, cliquez sur Distribuer des licences.
Dans la liste des allocations, recherchez la ligne correspondant au projet et à la région dont vous souhaitez récupérer les licences.
Choisissez l'une des actions suivantes :
- Pour réduire le nombre de licences, diminuez le nombre dans le champ Nombre de licences.
- Pour récupérer toutes les licences de la ligne, pointez sur la ligne, puis cliquez sur Supprimer l'élément.
Cliquez sur Envoyer.
Dans la boîte de dialogue Confirmer la distribution des licences, lisez l'avertissement indiquant que les retraits de licence sont limités à une fois par jour, puis cliquez sur Envoyer.
REST
Pour transférer des licences d'abonnement vers le compte de facturation afin de les redistribuer, 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 ou ID du projet que vous utilisez pour attribuer la facturation et le quota pour cet appel d'API. Vous devez disposer du rôle Consommateur Service Usage pour ce projet. Vous pouvez utiliserTARGET_PROJECT_NUMBERsi vous avez activé Discovery Engine sur ce projet.ENDPOINT_LOCATION: emplacement multirégional de votre requête API. Spécifiez une des valeurs suivantes :uspour l'emplacement multirégional USeupour l'emplacement multirégional EUglobalpour l'emplacement mondial
LOCATION: emplacement multirégional de votre data store :global,usoueu.TARGET_PROJECT_NUMBER: numéro du projet dont vous souhaitez récupérer les licences. Il s'agit du projet dans lequel vous avez alloué les 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 informations détaillées sur l'abonnement.LICENSE_CONFIG_ID: ID de configuration de licence d'une configuration de licence existante au niveau du projet.
Gérer les arrêts anticipés
Lorsque vous migrez entre différents types d'abonnement ou si votre compte de facturation rencontre un problème, un abonnement peut se terminer plus tôt que prévu.
Pour faciliter la transition et éviter les interruptions de service, nous accordons un délai de grâce d'une semaine (sept jours) pendant lequel les licences concernées sont en cours 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 leur accès, transférez leurs licences vers un nouvel abonnement actif, automatiquement ou manuellement.
L'image suivante montre un exemple de désactivation de licence dans la consoleGoogle 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 auxquels vous les avez attribuées, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise.
Cliquez sur Gérer les utilisateurs.
Sélectionnez l'emplacement multirégional de la licence existante.
Exporter des données utilisateur
La table des utilisateurs de la console Google Cloud ne permet pas de trier ni de filtrer les données. Si vous devez trier, filtrer ou analyser vos données utilisateur, vous pouvez exporter jusqu'à 1 000 000 enregistrements utilisateur dans un fichier CSV (valeurs séparées par une virgule).
Le fichier CSV exporté comprend 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) qu'un administrateur a attribuée à l'utilisateur.
|
assignment_time |
Code temporel (au format UTC) indiquant quand un administrateur a attribué la licence. |
last_login_time |
Horodatage (au format UTC) de la dernière connexion de l'utilisateur. |
license_assignment_state
|
État de l'attribution de la licence. Les valeurs suivantes sont disponibles :
|
Pour exporter les données utilisateur vers un fichier CSV, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Gérer les utilisateurs.
Sélectionnez l'emplacement multirégional de la licence existante.
Dans la section Utilisateurs, cliquez sur Exporter tous les utilisateurs.
Selon la taille de la table des utilisateurs, l'exportation des données peut prendre jusqu'à deux minutes et demie. Pendant ce temps, la console affiche un état de chargement. Une fois l'exportation terminée, votre navigateur télécharge le fichier CSV dans 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 liés à l'exportation de données utilisateur et leurs solutions.
| Problème | Solution |
|---|---|
| Le bouton Exporter tous les utilisateurs est masqué. | Assurez-vous d'avoir attribué des licences aux utilisateurs de l'emplacement multirégional sélectionné. Si aucun utilisateur ne dispose de licence, le bouton Exporter tous les utilisateurs ne s'affiche pas. |
| La requête d'exportation échoue avec 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 requête d'exportation échoue avec une erreur d'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 des licences automatiquement ou manuellement 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, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise.
Cliquez sur Gérer les utilisateurs.
Sélectionnez l'emplacement multirégional de la licence existante.
Sélectionnez Attribuer automatiquement des licences, puis l'abonnement.
Chaque fois qu'un utilisateur sans licence attribuée manuellement se connecte, Gemini Enterprise lui attribue automatiquement une licence de cet abonnement. S'il ne reste aucune licence dans l'abonnement, Gemini Enterprise affiche un message informant les 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, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise.
Cliquez sur Gérer les utilisateurs.
Sélectionnez l'emplacement multirégional de la licence existante.
Cliquez sur Add users (Ajouter des utilisateurs).
Sur la page Ajouter des utilisateurs :
Saisissez les adresses e-mail des utilisateurs. Veillez à utiliser l'adresse e-mail qu'ils utiliseront pour se connecter à l'application Gemini Enterprise.
Sélectionnez l'abonnement à attribuer à ces utilisateurs.
Cliquez sur Envoyer.
REST
Pour attribuer manuellement des licences à des 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: emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :uspour l'emplacement multirégional USeupour l'emplacement multirégional EUglobalpour l'emplacement mondial
LOCATION: emplacement multirégional de votre data store :global,usoueuUSER_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 d'abonnements arrivés à expiration
Les utilisateurs ne peuvent pas se connecter à Gemini Enterprise si l'abonnement a expiré. Vous pouvez restaurer leur accès de deux manières :
Transférer automatiquement les utilisateurs vers un abonnement actif
Pour transférer automatiquement les utilisateurs vers un abonnement actif, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Gérer les utilisateurs.
Sélectionnez l'emplacement multirégional de la licence existante.
Assurez-vous de disposer d'un abonnement actif. Si vous n'en avez pas, souscrivez un abonnement.
Sélectionnez Attribuer automatiquement des licences, puis choisissez l'abonnement actif.
Sélectionnez Mettre à jour automatiquement la licence expirée.
Lors de la prochaine connexion d'un utilisateur dont la licence a expiré, 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, procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Gérer les utilisateurs.
Sélectionnez l'emplacement multirégional de la licence existante.
Assurez-vous de disposer d'un abonnement actif. Si vous n'en avez pas, souscrivez un abonnement.
Sélectionnez les utilisateurs, puis cliquez sur Attribuer une autre licence.
Dans le volet Modifier les utilisateurs, sélectionnez l'abonnement, puis cliquez sur Envoyer.
Lister les licences
Pour lister les licences et les utilisateurs auxquels vous les avez attribuées, 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: emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :uspour l'emplacement multirégional USeupour l'emplacement multirégional EUglobalpour l'emplacement mondial
LOCATION: emplacement multirégional de votre data store :global,usoueu
Supprimer des utilisateurs d'une licence
Vous pouvez supprimer la licence d'un utilisateur à tout moment. Lorsque vous supprimez une licence, 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 :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Gérer les utilisateurs.
Sélectionnez l'emplacement multirégional de la licence existante.
Dans le tableau des utilisateurs, sélectionnez les utilisateurs.
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 retirer la licence et supprimer les utilisateurs sélectionnés du projet, cliquez sur Annuler l'attribution et supprimer la licence.
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: emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :uspour l'emplacement multirégional USeupour l'emplacement multirégional EUglobalpour l'emplacement mondial
LOCATION: emplacement multirégional de votre data store :global,usoueuUSER_EMAIL: adresse e-mail de l'utilisateur que vous souhaitez supprimer de la licence.
Étapes suivantes
- En savoir plus sur les questions fréquentes sur les licences Gemini Enterprise
- Découvrez les rôles et autorisations IAM.