Gestire le licenze Gemini Code Assist Standard ed Enterprise

Prima di utilizzare Gemini Code Assist Standard ed Enterprise, ogni utente della tua organizzazione deve avere una licenza.

Per impostazione predefinita, per i nuovi abbonamenti è necessario assegnare le licenze manualmente. Dopo aver configurato alcuni prodotti Gemini per Google Cloud , puoi scegliere di assegnare le licenze manualmente o automaticamente.

Prima di iniziare

  • Assicurati di disporre dei ruoli IAM Amministratore account di fatturazione (roles/billing.admin) o Amministratore ordini di acquisto consumer (roles/consumerprocurement.orderAdmin) per poter concedere le autorizzazioni aggiuntive richieste nell'account di fatturazione per attività specifiche di gestione delle licenze descritte nelle sezioni seguenti.
  • Se vuoi gestire le licenze utilizzando un'API anziché la console Google Cloud, assicurati di quanto segue:

Modificare il numero di licenze Gemini Code Assist Standard ed Enterprise in un abbonamento

Puoi aggiungere o rimuovere il numero di licenze Gemini per Google Cloud direttamente tramite la console Google Cloud o tramite il rappresentante del tuo Account Google o un rivenditore autorizzato.

Per modificare il numero di licenze in un abbonamento:

  1. Assicurati di disporre delle seguenti autorizzazioni Identity and Access Management (IAM) nell'account di fatturazione proprietario dell'abbonamento:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.orders.modify
    • resourcemanager.projects.get

  2. Nella console Google Cloud, vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

  3. Scegli l'abbonamento che vuoi modificare e poi seleziona Modifica abbonamento.

  4. Inserisci il numero di licenze che vuoi acquistare. Vengono visualizzate le seguenti informazioni:

    • Numero di licenze totali dopo l'acquisto.
    • Numero di licenze disponibili per l'assegnazione dopo l'acquisto.
    • Nuovo prezzo dell'abbonamento per periodo. L'importo aggiuntivo per le licenze aggiunte viene ripartito proporzionalmente in base al tempo rimanente nel termine corrente.

  5. Seleziona Salva.

Visualizzare le assegnazioni delle licenze Gemini Code Assist Standard ed Enterprise

Seleziona una delle seguenti opzioni:

Console API

  1. Assicurati di disporre delle seguenti autorizzazioni IAM per l'account di fatturazione proprietario dell'abbonamento:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • resourcemanager.projects.get

  2. Vai alla pagina Amministrazione di Gemini e seleziona il progetto associato al tuo account di fatturazione con l'abbonamento a Gemini Code Assist Standard o Enterprise.

    Vai a Gemini per Google Cloud

  3. Scegli l'abbonamento che vuoi modificare e poi seleziona Modifica abbonamento.

    Per ogni utente a cui è stata assegnata una licenza sono disponibili le seguenti informazioni:

    • Nome.
    • Email.
    • Data di assegnazione della licenza.
    • Data e ora dell'ultimo utilizzo della licenza.

  4. Per trovare un insieme specifico di utenti, puoi filtrare e ordinare l'elenco come segue:

    • Per filtrare l'elenco, inserisci le proprietà e i valori nel campo Filtro.
    • Per ordinare l'elenco, seleziona l'intestazione della colonna in base alla quale vuoi eseguire l'ordinamento. Ad esempio, per ordinare in ordine alfabetico in base ai nomi utente, seleziona l'intestazione della colonna Nome.

Per visualizzare le assegnazioni delle licenze Gemini Code Assist Standard o Enterprise, utilizza il metodo billingAccounts.orders.licensePool.enumerateLicensedUsers.

Per eseguire questa operazione, devi disporre dell'autorizzazioneconsumerprocurement.licensePools.enumerateLicensedUsers sull'account pagamenti proprietario dell'abbonamento.

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

Sostituisci quanto segue:

Se il comando va a buon fine, restituisce l'output licensedUsers nel seguente formato:

{
  "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"
      }
  ]
}

Se non sono presenti assunzioni di licenze Gemini Code Assist Standard o Enterprise o se ORDER_ID non è valido, viene restituito l'output licensedUsers nel seguente formato:

{}

Assegnare manualmente le licenze Gemini Code Assist Standard ed Enterprise ai singoli utenti

Seleziona una delle seguenti opzioni:

Console API

  1. Assicurati di disporre delle seguenti autorizzazioni IAM per l'account di fatturazione proprietario dell'abbonamento:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.assign
    • resourcemanager.projects.get

  2. Vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

  3. Seleziona Gestisci Gemini Code Assist e poi Modifica abbonamento.

  4. Per questo abbonamento a Gemini Code Assist Standard o Enterprise, assicurati di impostare Assegnazione licenze su Assegna manualmente le licenze. Se l'abbonamento a Gemini Code Assist Standard o Enterprise è impostato su Assegna automaticamente le licenze, non puoi gestire le singole licenze. Se imposti questo account di fatturazione su Assegna licenze manualmente, l'assegnazione automatica delle licenze viene disattivata dopo la modifica, ma le assegnazioni delle licenze esistenti non vengono interessate.

  5. Seleziona Assegna licenze. Viene visualizzata una finestra di dialogo di selezione dell'utente. Per cercare utenti specifici, inserisci il loro indirizzo email e seleziona Avanti.

  6. Seleziona Assegna licenze.

  7. Assicurati di concedere agli utenti i ruoli IAM Gemini for Google Cloud User e Service Usage Consumer agli utenti con licenza.

Per assegnare le licenze Gemini Code Assist Standard ed Enterprise, utilizza il metodo billingAccounts.orders.licensePool.assign.

Per eseguire questa operazione, assicurati di disporre delle seguenti autorizzazioni sull'account di fatturazione proprietario dell'abbonamento:

  • 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"
  ]
}

Sostituisci quanto segue:

  • BILLING_ACCOUNT_ID: l'ID account di fatturazione
  • ORDER_ID: l'ID ordine. Se non conosci l'ID ordine, puoi recuperarlo elencando gli ordini associati al tuo account di fatturazione.

Se il comando va a buon fine, restituisce un corpo della risposta vuoto nel seguente formato:

{}

Per verificare l'assegnazione, visualizza l'elenco dei compiti.

Quindi, assicurati di concedere agli utenti i ruoli IAM Gemini for Google Cloud User e Service Usage Consumer agli utenti con licenza.

Assegnare automaticamente le licenze Gemini Code Assist Standard ed Enterprise

Puoi assegnare automaticamente una licenza a qualsiasi utente della tua organizzazione che richiede l'accesso a Gemini Code Assist Standard o Enterprise dalla pagina Assegnazione licenze. L'assegnazione automatica delle licenze viene impostata individualmente per ogni abbonamento.

L'assegnazione automatica delle licenze è supportata solo in VS Code, IntelliJ e altri IDE JetBrains supportati: .

Se scegli di assegnare automaticamente le licenze per Gemini Code Assist Standard o Enterprise, non puoi rimuovere o aggiungere licenze per singoli utenti in questo account. Per gli utenti con assegnazioni di licenze che non hanno utilizzato alcuna funzionalità di Gemini Code Assist Standard o Enterprise viene eseguito automaticamente il deprovisioning alla fine del periodo di fatturazione dopo un numero specificato di giorni di inattività, come impostato dall'amministratore.

  1. Nella console Google Cloud, vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

  2. Seleziona Gestisci Gemini Code Assist, quindi Gestisci abbonamento.

  3. Seleziona Gestione licenze e poi Abilita assegnazione automatica di licenza. Viene visualizzata la finestra di dialogo Abilita le licenze automatiche.

    Se imposti l'assegnazione automatica delle licenze per questo abbonamento, l'assegnazione manuale delle licenze viene disattivata dopo la modifica, ma le assegnazioni delle licenze preesistenti rimangono invariate.

  4. Imposta il periodo di tempo per l'annullamento dell'assegnazione di una licenza se l'assegnatario non è attivo, quindi seleziona Conferma modifica. Viene visualizzata la finestra di dialogo L'assegnazione automatica delle licenze è stata attivata.

  5. Seleziona Chiudi.

  6. Assicurati di concedere agli utenti i ruoli IAM Gemini for Google Cloud User e Service Usage Consumer agli utenti con licenza.

    Gli utenti con l'autorizzazione cloudaicompanion.licenses.selfAssign ricevono automaticamente una licenza al primo accesso a Gemini Code Assist Standard o Enterprise in un progetto pagato da un account di fatturazione con un abbonamento valido configurato per l'assegnazione automatica delle licenze e con licenze disponibili coperte dai tuoi abbonamenti nell'account di fatturazione.

Per disattivare l'assegnazione automatica delle licenze:

  1. Nella console Google Cloud, vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

  2. Seleziona Gestisci Gemini Code Assist, quindi Gestisci abbonamento.

  3. Seleziona Gestione licenze e poi Gestisci assegnazione automatica di licenze. Viene visualizzata la finestra di dialogo Gestisci l'assegnazione automatica delle licenze.

  4. Seleziona Disattiva la gestione automatica delle licenze.

  5. Seleziona Conferma modifica.

Annullare manualmente l'assegnazione delle licenze Gemini Code Assist Standard ed Enterprise

Seleziona una delle seguenti opzioni:

Console API

  1. Assicurati di disporre delle seguenti autorizzazioni IAM per l'account di fatturazione proprietario dell'abbonamento:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.unassign
    • resourcemanager.projects.get

  2. Vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

  3. Seleziona Gestisci Gemini Code Assist, quindi Gestisci abbonamento.

  4. Seleziona Gestione licenze e poi Gestisci assegnazione automatica di licenze. Viene visualizzata la finestra di dialogo Gestisci l'assegnazione automatica delle licenze.

  5. Seleziona gli utenti di cui vuoi annullare l'assegnazione delle licenze e poi Annulla assegnazione licenza.

  6. Seleziona Conferma.

Per annullare l'assegnazione delle licenze Gemini Code Assist Standard ed Enterprise, utilizza il metodo billingAccounts.orders.licensePool.unassign.

Per eseguire questa operazione, devi disporre dell'autorizzazione consumerprocurement.licensePools.unassign per l'account di fatturazione proprietario dell'abbonamento.

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

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

Sostituisci quanto segue:

Se il comando va a buon fine, restituisce un corpo di risposta vuoto nel seguente formato:

{}

Per verificare lo scollegamento, visualizza l'elenco dei compiti.

Trasferire le licenze Gemini Code Assist Standard ed Enterprise

Le licenze Gemini Code Assist Standard ed Enterprise non possono essere trasferite direttamente tra utenti. È invece necessario annullare l'assegnazione della licenza a un utente e poi assegnarla al nuovo utente.

Impedire l'utilizzo delle licenze tra organizzazioni

Le licenze Gemini Code Assist Standard ed Enterprise vengono assegnate ai singoli utenti, non alle organizzazioni o ai progetti, consentendo ai singoli utenti di utilizzare Gemini Code Assist Standard ed Enterprise in più organizzazioni.

Tutti i log generati dall'utilizzo di Gemini Code Assist vengono archiviati nel progetto in cui si è verificato l'utilizzo e non con il titolare della licenza. Inoltre, qualsiasi personalizzazione o configurazione di Gemini Code Assist (ad esempio la personalizzazione del codice) viene eseguita nel progetto, non a livello di licenza o abbonamento.

Per impedire ulteriormente l'utilizzo tra organizzazioni di Gemini Code Assist Standard ed Enterprise in un progetto, puoi eseguire una delle seguenti operazioni:

  • Disattiva l'API Gemini for Google Cloud nel progetto.
  • Utilizza le autorizzazioni per negare l'accesso degli utenti al progetto.

Limitazioni

Passaggi successivi