Gérer les licences Gemini Code Assist

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

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

Avant de commencer

  • Assurez-vous de disposer des rôles IAM "Administrateur de compte de facturation" (roles/billing.admin) ou "Administrateur des commandes d'approvisionnement pour les consommateurs" (roles/consumerprocurement.orderAdmin) afin de pouvoir accorder les autorisations supplémentaires requises pour les tâches de gestion des licences spécifiques décrites dans les sections suivantes.
  • Si vous souhaitez gérer les licences à l'aide d'une API plutôt que de la console Google Cloud, vérifiez les points suivants :

Modifier le nombre de licences Gemini Code Assist dans un abonnement

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

Pour modifier le nombre de licences d'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 de Gemini.

    Accéder à "Administration de Gemini"

  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 disponibles pour l'attribution 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 de la durée restante de la période actuelle.

  5. Sélectionnez Enregistrer.

Afficher les attributions de licences Gemini Code Assist

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 Administration pour Gemini.

    Accéder à "Administration de Gemini"

  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
    • E-mail
    • Type de compte
    • Licences attribuées

  4. Pour trouver un ensemble d'utilisateurs spécifique, 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 des utilisateurs, sélectionnez l'en-tête de colonne Nom.

API

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

Pour effectuer cette tâche, vous devez disposer de l'autorisation consumerprocurement.licensePools.enumerateLicensedUsers sur le compte de facturation propriétaire de l'abonnement.

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

Remplacez les éléments suivants :

  • BILLING_ACCOUNT_ID: ID du compte de facturation
  • ORDER_ID: la stratégie IAM

Si la commande réussit, 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"
      }
  ]
}

Attribuer manuellement des licences Gemini Code Assist à des utilisateurs spécifiques

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 Administration pour Gemini.

    Accéder à "Administration de Gemini"

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

  4. Pour cet abonnement Gemini Code Assist, assurez-vous de définir Attribution de licence sur Attribuer manuellement des licences. Si l'abonnement Gemini Code Assist est défini sur Attribution automatique des licences, vous ne pouvez pas gérer les licences individuelles. Si vous définissez ce compte de facturation sur Attribuer manuellement des licences, l'attribution automatique des licences sera désactivée après le changement, mais les attributions de licences 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.

API

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

Pour effectuer cette tâche, assurez-vous de disposer des autorisations suivantes sur le compte de facturation propriétaire de l'abonnement:

  • billing.accounts.get
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.unassign
  • consumerprocurement.orders.get
POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Remplacez les éléments suivants :

  • BILLING_ACCOUNT_ID: ID du compte de facturation
  • ORDER_ID: la stratégie IAM

Si la commande réussit, elle renvoie un corps de réponse vide au format suivant:

{}

Pour vérifier le devoir, consultez la liste des devoirs.

Attribuer automatiquement des licences Gemini Code Assist

Vous pouvez attribuer automatiquement une licence à tous les utilisateurs de votre organisation qui ont besoin d'accéder à Gemini Code Assist depuis la page Attribution de licence. L'attribution automatique de licences est définie individuellement pour chaque abonnement.

Si vous choisissez d'attribuer automatiquement des licences pour un Gemini Code Assist, vous ne pouvez pas supprimer ni ajouter de licences utilisateur individuelles sous ce compte. Les utilisateurs auxquels des licences ont été attribuées et qui n'ont pas utilisé de fonctionnalités Gemini Code Assist sont automatiquement désprovisionnés à la fin de la période de facturation après un nombre spécifié de jours d'inactivité, comme défini par l'administrateur.

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

    Accéder à "Administration de Gemini"

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

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

    Si vous activez l'attribution automatique des licences pour cet abonnement, 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 sera réattribuée si l'utilisateur auquel elle est attribuée est inactif, puis sélectionnez Confirmer la modification. La boîte de dialogue L'attribution automatique de licences a été activée s'affiche.

  5. Sélectionnez Fermer.

Tant que des licences sont disponibles, les nouveaux utilisateurs reçoivent automatiquement une licence lorsqu'ils accèdent pour la première fois à l'assistance par code Gemini couverte par vos abonnements dans ce compte de facturation.

Pour désactiver l'attribution automatique des licences, procédez comme suit:

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

    Accéder à "Administration de Gemini"

  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 des 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.

Désattribuer manuellement des licences Gemini Code Assist

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 Administration pour Gemini.

    Accéder à "Administration de Gemini"

  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 des licences. La boîte de dialogue Gérer l'attribution automatique de licences s'affiche.

  5. Sélectionnez les utilisateurs pour lesquels vous souhaitez annuler l'attribution de licence, puis sélectionnez Annuler l'attribution de licence.

  6. Sélectionnez Confirmer.

API

Pour désattribuer des licences Gemini Code Assist, utilisez la méthode billingAccounts.orders.licensePool.unassign.

Pour effectuer cette tâche, vous devez disposer de l'autorisation consumerprocurement.licensePools.unassign sur le compte de facturation propriétaire de l'abonnement.

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Remplacez les éléments suivants :

  • BILLING_ACCOUNT_ID: ID du compte de facturation
  • ORDER_ID: la stratégie IAM

Si la commande réussit, elle renvoie un corps de réponse vide au format suivant:

{}

Pour vérifier la suppression, affichez la liste des devoirs.

Transférer des licences Gemini Code Assist

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

Empêcher l'utilisation de licences entre organisations

Les licences Gemini Code Assist sont attribuées à des utilisateurs individuels, et non à des organisations ou à des projets. Cela permet aux utilisateurs individuels d'utiliser Gemini Code Assist dans plusieurs organisations.

Tous les journaux générés à partir de l'utilisation de Gemini Code Assist se trouvent dans le projet dans lequel l'utilisation a eu lieu, et non chez le licencié. 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-organisationnelle de Gemini Code Assist dans un projet, vous pouvez procéder comme suit:

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

Limites