Gestisci le licenze di Gemini Code Assist Standard ed Enterprise

Importante: questa pagina descrive l'accesso a Gemini Code Assist utilizzando una licenza Gemini Code Assist Standard ed Enterprise. L'accesso all'account consumer alle funzionalità di Gemini Code Assist, ad esempio tramite Gemini Code Assist per privati, è stato ritirato.

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

Per impostazione predefinita, l'assegnazione automatica delle licenze è abilitata per tutti gli abbonamenti. Agli utenti della tua organizzazione con le autorizzazioni richieste viene assegnata automaticamente una licenza quando iniziano a utilizzare Gemini Code Assist in un IDE supportato. Queste autorizzazioni sono descritte in dettaglio più avanti in questo documento. Dopo aver configurato Gemini Code Assist, puoi scegliere di assegnare le licenze manualmente o continuare con l'assegnazione automatica.

Puoi assegnare le licenze a tutti gli utenti che hanno accesso a un progetto collegato all' account di fatturazione pertinente.

Prima di iniziare

• Assicurati di disporre dei ruoli IAM Amministratore account di fatturazione (roles/billing.admin) o Amministratore ordine di acquisto consumer (roles/consumerprocurement.orderAdmin) in modo da poter concedere le autorizzazioni aggiuntive richieste per l'account di fatturazione per attività di gestione delle licenze specifiche descritte nelle sezioni seguenti.

• Verifica di aver configurato Gemini Code Assist.

• Se vuoi gestire le licenze utilizzando un'API anziché la Google Cloud console, verifica quanto segue:

  • Configura un progetto di quota per il tuo account di fatturazione.
  • Abilita l' API Cloud Commerce Consumer Procurement nel progetto di quota.
  • Verifica che le seguenti coppie chiave-valore di intestazione siano presenti in tutte le chiamate API:
    • Authorization: il Google Cloud token di accesso da Google Cloud CLI
    • x-goog-user-project: l'ID progetto del progetto di quota

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

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

Per modificare il numero di licenze in un abbonamento:

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

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

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

   Vai ad Amministrazione per Gemini

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

4. Inserisci il numero di licenze che vuoi avere. 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 calcolato in base al tempo rimanente nel periodo corrente.

5. Seleziona Salva.

Visualizzare le assegnazioni di licenze Gemini Code Assist Standard ed Enterprise

Seleziona una delle seguenti opzioni:

Console

1. Verifica 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 per Gemini e seleziona il progetto collegato al tuo account di fatturazione con l'abbonamento a Gemini Code Assist Standard o Enterprise.

   Vai ad Amministrazione per Gemini

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.
   • le 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 farlo. Ad esempio, per ordinare in ordine alfabetico in base ai nomi utente, seleziona l'intestazione della colonna Nome.

API

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

1. Verifica di disporre dell'autorizzazione IAM consumerprocurement.licensePools.enumerateLicensedUsers per l'account di fatturazione che contiene il pool di licenze di cui vuoi visualizzare le assegnazioni.

2. Utilizza cURL per chiamare il metodo:

   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/"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID di un progetto. L'utilizzo della quota e gli addebiti associati alla richiesta API vengono applicati a questo progetto.
   • BILLING_ACCOUNT_ID: l'ID dell'account di fatturazione associato al pool di licenze.
   • 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 riesce, restituisce l'output licensedUsers nel seguente formato:

{
  "licensedUsers": [
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

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

{}

Assegnare automaticamente le licenze Gemini Code Assist Standard ed Enterprise

Puoi abilitare l'assegnazione automatica delle licenze per un 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. Agli utenti con assegnazioni di licenze che non hanno utilizzato le funzionalità di Gemini Code Assist Standard o Enterprise viene automaticamente annullata la fornitura alla fine del periodo di inattività impostato dall'amministratore.

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

   Vai ad Amministrazione per Gemini

2. Seleziona Gestisci Gemini Code Assist e poi seleziona Gestisci abbonamento.

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

   Se passi all'assegnazione automatica delle licenze per questo abbonamento, l'assegnazione manuale delle licenze viene disattivata dopo la modifica, ma le assegnazioni di licenze preesistenti non vengono interessate.

4. Imposta la durata di tempo per annullare l'assegnazione di una licenza se l'assegnatario è inattivo, quindi seleziona Conferma modifica. Viene visualizzata la finestra di dialogo L'assegnazione automatica delle licenze è stata abilitata.

   Se hai configurato T giorni di inattività per l'annullamento dell'assegnazione, le licenze vengono annullate automaticamente e sono disponibili nel pool di licenze il giorno T+1. Ad esempio, se configuri 7 giorni di inattività per l'annullamento dell'assegnazione, le licenze vengono annullate e sono disponibili nel pool di licenze il giorno 8.

5. Seleziona Chiudi.

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

   Gli utenti con l'autorizzazione cloudaicompanion.licenses.selfAssign ricevono automaticamente una licenza quando accedono per la prima volta 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 dagli abbonamenti nell'account di fatturazione.

Per disattivare l'assegnazione automatica delle licenze:

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

   Vai ad Amministrazione per Gemini

2. Seleziona Gestisci Gemini Code Assist e poi seleziona Gestisci abbonamento.

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

4. Seleziona Disattiva la gestione automatica delle licenze.

5. Seleziona Conferma modifica.

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

Con l'assegnazione manuale delle licenze, puoi aggiungere e rimuovere licenze per singoli utenti. Questo metodo ti consente di controllare direttamente chi può accedere a Gemini Code Assist, ideale per concedere l'accesso a un insieme specifico di utenti.

Seleziona una delle seguenti opzioni:

Console

1. Verifica 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 per Gemini.

   Vai ad Amministrazione per Gemini

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

4. Per questo abbonamento a Gemini Code Assist Standard o Enterprise, verifica che Assegnazione licenze sia impostato su Assegna licenze manualmente. Se l'abbonamento a Gemini Code Assist Standard o Enterprise è impostato su Assegna licenze automaticamente, allora non puoi gestire le singole licenze. Se passi all'assegnazione manuale delle licenze per questo account di fatturazione, l'assegnazione automatica delle licenze viene disattivata dopo la modifica, ma le assegnazioni di licenze preesistenti non vengono interessate.

5. Seleziona Aggiungi utente con licenza. Viene visualizzata una finestra di dialogo per la selezione degli utenti. Sono supportati solo gli indirizzi email di singoli Account Google, come @gmail.com, @googlegroups.com e i domini Google Workspace. La federazione delle identità della forza lavoro (BYOID) non è supportata.

6. Seleziona Aggiungi utente con licenza.

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

API

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

1. Verifica di disporre delle seguenti autorizzazioni IAM per l'account di fatturazione che contiene il pool di licenze di cui intendi assegnare la licenza:

• billing.accounts.get
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.unassign
• consumerprocurement.orders.get

1. Crea un file JSON contenente le seguenti informazioni:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Sostituisci USER_EMAILS con un elenco separato da virgole di account utente a cui viene assegnata la licenza, ad esempio, "[e-mail]", "[e-mail]". Sono supportati solo gli indirizzi email di singoli Account Google, come @gmail.com, @googlegroups.com e i domini Google Workspace. La federazione delle identità della forza lavoro (BYOID) non è supportata.

2. Utilizza cURL per chiamare il metodo:

   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/"

   Sostituisci quanto segue:

   • JSON_FILE_NAME: il percorso del file JSON che hai creato nel passaggio 2.
   • PROJECT_ID: l'ID di un progetto. L'utilizzo della quota e gli addebiti associati alla richiesta API vengono applicati a questo progetto.
   • BILLING_ACCOUNT_ID: l'ID dell'account di fatturazione associato al pool di licenze.
   • ORDER_ID: l'ID ordine. Se non conosci l'ID ordine, puoi recuperarlo elencando gli ordini associati al tuo account di fatturazione.

Se l'operazione va a buon fine, la risposta è simile alla seguente:

{}

Per verificare l'assegnazione, visualizza l'elenco delle assegnazioni.

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

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

Seleziona una delle seguenti opzioni:

Console

1. Verifica 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 per Gemini.

   Vai ad Amministrazione per Gemini

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

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

5. Seleziona gli utenti per i quali vuoi annullare l'assegnazione delle licenze e poi seleziona Annulla assegnazione licenza.

6. Seleziona Conferma.

API

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

1. Per eseguire questa attività, devi disporre dell'autorizzazione IAM (Identity and Access Management) consumerprocurement.licensePools.unassign per l'account di fatturazione che contiene il pool di licenze di cui intendi annullare l'assegnazione della licenza.

2. Crea un file JSON contenente le seguenti informazioni:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Sostituisci USER_EMAILS con un elenco separato da virgole di account utente a cui è assegnata la licenza, ad esempio, "[e-mail]", "[e-mail]".

3. Utilizza cURL per chiamare il metodo:

   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/"

   Sostituisci quanto segue:

   • JSON_FILE_NAME: il percorso del file JSON che hai creato nel passaggio 2.
   • PROJECT_ID: l'ID di un progetto. L'utilizzo della quota e gli addebiti associati alla richiesta API vengono applicati a questo progetto.
   • BILLING_ACCOUNT_ID: l'ID dell'account di fatturazione associato al pool di licenze.
   • ORDER_ID: l'ID ordine. Se non conosci l'ID ordine, puoi recuperarlo elencando gli ordini associati al tuo account di fatturazione.

Se l'operazione va a buon fine, la risposta è simile alla seguente:

{}

Per verificare l'annullamento dell'assegnazione, visualizza l'elenco delle assegnazioni.

Trasferire le licenze Gemini Code Assist Standard ed Enterprise

Le licenze Gemini Code Assist Standard ed Enterprise non possono essere trasferite direttamente tra gli utenti. Annulla l'assegnazione della licenza per un utente e poi assegna una licenza al nuovo utente.

Impedire l'utilizzo delle licenze tra organizzazioni

Le licenze Gemini Code Assist Standard ed Enterprise vengono assegnate a singoli utenti, non a organizzazioni o 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 si trovano nel progetto in cui si è verificato l'utilizzo e non con il licenziatario. Inoltre, qualsiasi personalizzazione o configurazione di Gemini Code Assist (ad esempio personalizzazione di codice) viene eseguita nel progetto, non a livello di licenza o abbonamento.

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

• Disabilita l'API Gemini for Google Cloud nel progetto.
• Utilizza le autorizzazioni per negare l'accesso utente al progetto.

Limitazioni

• La gestione delle licenze Gemini Code Assist non supporta la federazione delle identità della forza lavoro.

Passaggi successivi

• Scopri come contribuire a impedire l'utilizzo delle licenze tra organizzazioni.