Gérer les licences Gemini Code Assist Standard et Enterprise

Pour pouvoir utiliser Gemini Code Assist Standard et Enterprise, chaque utilisateur de votre organisation doit disposer d'une licence.

Par défaut, les nouveaux abonnements nécessitent que vous attribuiez manuellement les licences. Après avoir configuré certains produits Gemini pour Google Cloud , vous pouvez choisir d'attribuer des licences manuellement ou automatiquement.

Vous pouvez attribuer des licences à tous les utilisateurs associés au projet du compte de facturation. Une fois la licence attribuée à l'utilisateur, il peut utiliser Gemini Code Assist dans n'importe quel projet.

Le forfait Google Developer Program Premium fournit une licence Gemini Code Assist Standard aux utilisateurs. Vous ne pouvez pas attribuer de licence Gemini Code Assist Standard à un utilisateur disposant d'un abonnement premium au Google Developer Program, car il en possède déjà une.

Avant de commencer

  • Assurez-vous de disposer des rôles IAM d'administrateur de compte de facturation (roles/billing.admin) ou d'administrateur des bons de commande pour les achats des consommateurs (roles/consumerprocurement.orderAdmin). Vous pourrez ainsi accorder les autorisations supplémentaires requises sur le compte de facturation pour des tâches spécifiques de gestion des licences, détaillées dans les sections suivantes.
  • Si vous souhaitez gérer les licences à l'aide d'une API plutôt que de la console Google Cloud , assurez-vous des points suivants :
    • Configurez un projet de quota pour votre compte de facturation.
    • Activez l'API Cloud Commerce Consumer Procurement dans votre projet de quota.
    • Assurez-vous que les paires clé/valeur d'en-tête suivantes sont présentes dans tous les appels d'API :
      • Authorization : votre jeton d'accèsGoogle Cloud depuis la Google Cloud CLI
      • x-goog-user-project : ID de votre projet de quota

Modifier le nombre de licences Gemini Code Assist Standard et Enterprise dans un abonnement

Vous pouvez ajouter ou supprimer le nombre de licences Gemini pour Google Cloud directement dans la console Google Cloud , ou en contactant votre représentant de compte Google ou un revendeur agréé.

Pour modifier le nombre de licences dans un abonnement, procédez comme suit :

  1. Assurez-vous de disposer des autorisations IAM (Identity and Access Management) suivantes sur le compte de facturation propriétaire de l'abonnement :

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.orders.modify
    • resourcemanager.projects.get
  2. Dans la console Google Cloud , accédez à la page Administration pour Gemini.

    Accéder à Gemini pour Google Cloud

  3. Sélectionnez l'abonnement que vous souhaitez modifier, puis Modifier l'abonnement.

  4. Saisissez le nombre de licences que vous souhaitez obtenir. Les informations suivantes s'affichent :

    • Nombre total de licences après l'achat.
    • Nombre de licences pouvant être attribuées après l'achat.
    • Nouveau prix de l'abonnement par période. Le montant supplémentaire pour les licences ajoutées est calculé au prorata en fonction du temps restant dans la période en cours.
  5. Sélectionnez Enregistrer.

Afficher les attributions de licences Gemini Code Assist Standard et Enterprise

Sélectionnez l'une des options suivantes :

Console

  1. Assurez-vous de disposer des autorisations IAM suivantes sur le compte de facturation propriétaire de l'abonnement :

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • resourcemanager.projects.get
  2. Accédez à la page Admin pour Gemini et sélectionnez le projet associé à votre compte de facturation avec l'abonnement Gemini Code Assist Standard ou Enterprise.

    Accéder à Gemini pour Google Cloud

  3. Sélectionnez l'abonnement que vous souhaitez modifier, puis Modifier l'abonnement.

    Les informations suivantes sont disponibles pour chaque utilisateur auquel une licence a été attribuée :

    • Nom
    • par e-mail,
    • Date à laquelle la licence a été attribuée.
    • Date et heure de la dernière utilisation de la licence.
  4. Pour trouver un ensemble spécifique d'utilisateurs, vous pouvez filtrer et trier la liste comme suit :

    • Pour filtrer la liste, saisissez les propriétés et les valeurs dans le champ Filtre.
    • Pour trier la liste, sélectionnez l'en-tête de la colonne que vous souhaitez réorganiser. Par exemple, pour trier par ordre alphabétique en fonction des noms d'utilisateur, sélectionnez l'en-tête de colonne Nom.

API

Pour afficher les attributions de licences Gemini Code Assist Standard ou Enterprise, utilisez la méthode billingAccounts.orders.licensePool.enumerateLicensedUsers.

  1. Assurez-vous de disposer de l'autorisation IAM consumerprocurement.licensePools.enumerateLicensedUsers sur le compte de facturation contenant le pool de licences dont vous souhaitez afficher les attributions.

  2. Utilisez cURL pour appeler la méthode :

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/"
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID d'un projet. L'utilisation du quota et les frais associés à la requête API sont appliqués à ce projet.
    • BILLING_ACCOUNT_ID : ID du compte de facturation associé au pool de licences.
    • ORDER_ID : ID de la commande. Si vous ne connaissez pas l'ID de la commande, vous pouvez le récupérer en listant les commandes associées à votre compte de facturation.

Si la commande aboutit, elle renvoie le résultat licensedUsers au format suivant :

{
  "licensedUsers": [
      {
          "username": "dana@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "lee@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "taylor@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "bola@example.com",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

S'il n'y a pas d'attribution de licence Gemini Code Assist Standard ou Enterprise, ou si le ORDER_ID n'est pas valide, la sortie licensedUsers est renvoyée au format suivant :

{}

Attribuer manuellement des licences Gemini Code Assist Standard et Enterprise à des utilisateurs individuels

Sélectionnez l'une des options suivantes :

Console

  1. Assurez-vous de disposer des autorisations IAM suivantes sur le compte de facturation propriétaire de l'abonnement :

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.assign
    • resourcemanager.projects.get
  2. Accédez à la page Admin pour Gemini.

    Accéder à Gemini pour Google Cloud

  3. Sélectionnez Gérer Gemini Code Assist, puis Modifier l'abonnement.

  4. Pour cet abonnement Gemini Code Assist Standard ou Enterprise, assurez-vous de définir Attribution de licence sur Attribuer manuellement des licences. Si l'abonnement Gemini Code Assist Standard ou Enterprise est défini sur Attribuer automatiquement des licences, vous ne pouvez pas gérer les licences individuelles. Si vous passez ce compte de facturation à l'option Attribuer manuellement des licences, l'attribution automatique des licences sera désactivée après le changement, mais les attributions de licences préexistantes ne seront pas affectées.

  5. Sélectionnez Attribuer des licences. Une boîte de dialogue de sélection de l'utilisateur s'affiche. Pour rechercher des utilisateurs spécifiques, saisissez leur adresse e-mail, puis sélectionnez Suivant.

  6. Sélectionnez Attribuer des licences.

  7. Assurez-vous d'attribuer les rôles IAM "Utilisateur de Gemini pour Google Cloud" et "Consommateur de Service Usage" aux utilisateurs sous licence.

API

Pour attribuer des licences Gemini Code Assist Standard et Enterprise, utilisez la méthode billingAccounts.orders.licensePool.assign.

  1. Assurez-vous de disposer des autorisations IAM suivantes sur le compte de facturation qui contient le pool de licences dont vous souhaitez attribuer une licence :

    • billing.accounts.get
    • consumerprocurement.licensePools.assign
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.unassign
    • consumerprocurement.orders.get
  2. Créez un fichier JSON contenant les informations suivantes :

    {
      "usernames": [
        USER_EMAILS
      ]
    }
    

    Remplacez USER_EMAILS par une liste d'utilisateurs séparés par une virgule auxquels la licence est attribuée (par exemple, "dana@example.com", "lee@example.com").

  3. Utilisez cURL pour appeler la méthode :

    curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

    Remplacez les éléments suivants :

    • JSON_FILE_NAME : chemin d'accès au fichier JSON que vous avez créé à l'étape 2.
    • PROJECT_ID : ID d'un projet. L'utilisation du quota et les frais associés à la requête API sont appliqués à ce projet.
    • BILLING_ACCOUNT_ID : ID du compte de facturation associé au pool de licences.
    • ORDER_ID : ID de la commande. Si vous ne connaissez pas l'ID de la commande, vous pouvez le récupérer en listant les commandes associées à votre compte de facturation.

Si l'opération réussit, la réponse se présente comme suit :

{}

Pour vérifier l'attribution, affichez la liste des attributions.

Ensuite, assurez-vous d'attribuer les rôles IAM "Utilisateur de Gemini pour Google Cloud" et "Consommateur de Service Usage" aux utilisateurs disposant d'une licence.

Attribuer automatiquement des licences Gemini Code Assist Standard et Enterprise

Vous pouvez attribuer automatiquement une licence à tout utilisateur de votre organisation qui a besoin d'accéder à Gemini Code Assist Standard ou Enterprise depuis la page Attribution de licences. L'attribution automatique des licences est définie individuellement pour chaque abonnement.

L'attribution automatique de licences n'est compatible qu'avec VS Code, IntelliJ et d'autres IDE JetBrains compatibles.

Si vous choisissez d'attribuer automatiquement des licences pour Gemini Code Assist Standard ou Enterprise, vous ne pouvez pas retirer ni ajouter de licences d'utilisateur individuel sous ce compte. Les utilisateurs auxquels des licences ont été attribuées et qui n'ont utilisé aucune fonctionnalité Gemini Code Assist Standard ou Enterprise sont automatiquement désactivés à la fin de la période d'inactivité définie par l'administrateur.

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

    Accéder à Gemini pour Google Cloud

  2. Sélectionnez Gérer Gemini Code Assist, puis Gérer l'abonnement.

  3. Sélectionnez Gestion des licences, puis Activer l'attribution automatique de licences. La boîte de dialogue Activer les licences automatiques s'affiche.

    Si vous configurez cet abonnement pour qu'il attribue automatiquement des licences, l'attribution manuelle des licences sera désactivée après le changement, mais les attributions de licences préexistantes ne seront pas affectées.

  4. Définissez la durée pendant laquelle une licence doit être désattribuée si le bénéficiaire est inactif, puis sélectionnez Confirmer la modification. La boîte de dialogue L'attribution automatique de licences a été activée s'affiche.

    Si vous avez configuré T jours d'inactivité pour la suppression de l'attribution, la ou les licences sont automatiquement supprimées et disponibles dans le pool de licences le jour T+1. Par exemple, si vous configurez 7 jours d'inactivité pour la suppression de l'attribution, la ou les licences sont supprimées et disponibles dans le pool de licences le jour 8.

  5. Sélectionnez Fermer.

  6. Assurez-vous d'attribuer les rôles IAM "Utilisateur de Gemini pour Google Cloud" et "Consommateur de Service Usage" aux utilisateurs disposant d'une licence.

    Les utilisateurs disposant de l'autorisation cloudaicompanion.licenses.selfAssign reçoivent automatiquement une licence lorsqu'ils accèdent pour la première fois à Gemini Code Assist Standard ou Enterprise dans un projet payé par un compte de facturation disposant d'un abonnement valide configuré pour l'attribution automatique de licences et disposant de licences disponibles couvertes par vos abonnements dans le compte de facturation.

Pour désactiver l'attribution automatique de licences :

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

    Accéder à Gemini pour Google Cloud

  2. Sélectionnez Gérer Gemini Code Assist, puis Gérer l'abonnement.

  3. Sélectionnez Gestion des licences, puis Gérer l'attribution automatique de licences. La boîte de dialogue Gérer l'attribution automatique de licences s'affiche.

  4. Sélectionnez Désactiver la gestion automatique des licences.

  5. Sélectionnez Confirmer la modification.

Dissocier manuellement les licences Gemini Code Assist Standard et Enterprise

Sélectionnez l'une des options suivantes :

Console

  1. Assurez-vous de disposer des autorisations IAM suivantes sur le compte de facturation propriétaire de l'abonnement :

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.unassign
    • resourcemanager.projects.get
  2. Accédez à la page Admin pour Gemini.

    Accéder à Gemini pour Google Cloud

  3. Sélectionnez Gérer Gemini Code Assist, puis Gérer l'abonnement.

  4. Sélectionnez Gestion des licences, puis Gérer l'attribution automatique de licences. La boîte de dialogue Gérer l'attribution automatique de licences s'affiche.

  5. Sélectionnez les utilisateurs auxquels vous souhaitez retirer des licences, puis sélectionnez Retirer la licence.

  6. Sélectionnez Confirmer.

API

Pour supprimer l'attribution des licences Gemini Code Assist Standard et Enterprise, utilisez la méthode billingAccounts.orders.licensePool.unassign.

  1. Pour effectuer cette tâche, vous devez disposer de l'autorisation Identity and Access Management (IAM) consumerprocurement.licensePools.unassign pour le compte de facturation contenant le pool de licences dont vous souhaitez dissocier une licence.

  2. Créez un fichier JSON contenant les informations suivantes :

    {
      "usernames": [
        USER_EMAILS
      ]
    }
    

    Remplacez USER_EMAILS par une liste d'utilisateurs séparés par une virgule auxquels la licence est attribuée (par exemple, "dana@example.com", "lee@example.com").

  3. Utilisez cURL pour appeler la méthode :

    curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Content-Type: application/json" \
    "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/"

    Remplacez les éléments suivants :

    • JSON_FILE_NAME : chemin d'accès au fichier JSON que vous avez créé à l'étape 2.
    • PROJECT_ID : ID d'un projet. L'utilisation du quota et les frais associés à la requête API sont appliqués à ce projet.
    • BILLING_ACCOUNT_ID : ID du compte de facturation associé au pool de licences.
    • ORDER_ID : ID de la commande. Si vous ne connaissez pas l'ID de la commande, vous pouvez le récupérer en listant les commandes associées à votre compte de facturation.

Si l'opération réussit, la réponse se présente comme suit :

{}

Pour vérifier que l'utilisateur a bien été supprimé, affichez la liste des devoirs.

Transférer les licences Gemini Code Assist Standard et Enterprise

Les licences Gemini Code Assist Standard et Enterprise ne peuvent pas être transférées directement d'un utilisateur à un autre. À la place, retirez la licence à un utilisateur, puis attribuez-la au nouvel utilisateur.

Empêcher l'utilisation de licences entre organisations

Les licences Gemini Code Assist Standard et Enterprise sont attribuées à des utilisateurs individuels, et non à des organisations ni à des projets. Les utilisateurs individuels peuvent ainsi utiliser Gemini Code Assist Standard et Enterprise dans plusieurs organisations.

Tous les journaux générés par l'utilisation de Gemini Code Assist sont associés au projet dans lequel l'utilisation a eu lieu, et non au titulaire de la licence. De plus, toute personnalisation ou configuration de Gemini Code Assist (comme la personnalisation du code) est effectuée au niveau du projet, et non au niveau de la licence ou de l'abonnement.

Pour éviter davantage l'utilisation inter-organisations de Gemini Code Assist Standard et Enterprise dans un projet, vous pouvez effectuer l'une des opérations suivantes :

  • Désactivez l'API Gemini pour Google Cloud dans le projet.
  • Utilisez les autorisations pour refuser l'accès de l'utilisateur au projet.

Limites

Étapes suivantes