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 determinati prodotti Gemini for Google Cloud , puoi scegliere di assegnare le licenze manualmente o automaticamente.
Puoi assegnare licenze a tutti gli utenti che hanno il progetto associato all'account di fatturazione. Dopo aver assegnato la licenza all'utente, quest'ultimo può utilizzare Gemini Code Assist in qualsiasi progetto.
Il piano Google Developer Program Premium fornisce agli utenti una licenza Gemini Code Assist Standard. Non puoi assegnare una licenza di posto Gemini Code Assist Standard a un utente che ha un abbonamento Google Developer Program Premium, in quanto dispone già di una licenza tramite Google Developer Program Premium.
Prima di iniziare
- Assicurati di disporre dei ruoli IAM Amministratore account di fatturazione
(
roles/billing.admin
) o Amministratore ordine di acquisto per i consumatori (roles/consumerprocurement.orderAdmin
) per poter concedere le autorizzazioni aggiuntive richieste per l'account di fatturazione per attività specifiche di gestione delle licenze descritte in dettaglio nelle sezioni seguenti.
- Se vuoi gestire le licenze utilizzando un'API anziché la console Google Cloud , assicurati che:
- Configura un progetto di quota per il tuo account di fatturazione.
- Abilita l'API Cloud Commerce Consumer Procurement nel tuo progetto di quota.
- Assicurati che tutte le chiamate API contengano le seguenti coppie chiave-valore di intestazione:
Authorization
: il tuo Google Cloud token di accesso da Google Cloud CLIx-goog-user-project
: l'ID progetto del tuo 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 per Google Cloud direttamente tramite la console Google Cloud o tramite il tuo rappresentante dell'Account Google o un rivenditore autorizzato.
Per modificare il numero di licenze in un abbonamento:
Assicurati di disporre delle seguenti autorizzazioni Identity and Access Management (IAM) per l'account di fatturazione proprietario dell'abbonamento:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.orders.modify
resourcemanager.projects.get
Nella console Google Cloud , vai alla pagina Amministrazione di Gemini.
Scegli l'abbonamento da modificare, poi seleziona Modifica abbonamento.
Inserisci il numero di licenze che vuoi avere. Vengono visualizzate le seguenti informazioni:
- Numero totale di licenze 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 aggiuntive viene calcolato in proporzione al tempo rimanente del periodo corrente.
Seleziona Salva.
Visualizzare le assegnazioni delle licenze Gemini Code Assist Standard ed Enterprise
Seleziona una delle seguenti opzioni:
Console
Assicurati di disporre delle seguenti autorizzazioni IAM sull'account di fatturazione proprietario dell'abbonamento:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
resourcemanager.projects.get
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.
Scegli l'abbonamento da modificare, 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.
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 delle licenze Gemini Code Assist Standard o Enterprise, utilizza il metodo billingAccounts.orders.licensePool.enumerateLicensedUsers
.
Assicurati 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.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 ha esito positivo, 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 assegnazioni 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 a singoli utenti
Seleziona una delle seguenti opzioni:
Console
Assicurati di disporre delle seguenti autorizzazioni IAM sull'account di fatturazione proprietario dell'abbonamento:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
resourcemanager.projects.get
Vai alla pagina Amministrazione di Gemini.
Seleziona Gestisci Gemini Code Assist, poi seleziona Modifica abbonamento.
Per questo abbonamento a Gemini Code Assist Standard o Enterprise, assicurati di impostare Assegnazione licenze su Assegna licenze manualmente. Se l'abbonamento a Gemini Code Assist Standard o Enterprise è impostato su Assegna automaticamente le licenze, non puoi gestire le singole licenze. Se passi a questo account di fatturazione Assegna licenze manualmente, l'assegnazione automatica delle licenze viene disattivata dopo la modifica, ma le assegnazioni di licenze preesistenti non vengono modificate.
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.
Seleziona Assegna licenze.
Assicurati di concedere agli utenti 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
metodo billingAccounts.orders.licensePool.assign
.
Assicurati di disporre delle seguenti autorizzazioni IAM sull'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
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"dana@example.com", "lee@example.com"
.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 ha esito positivo, la risposta è simile alla seguente:
{}
Per verificare l'assegnazione, visualizza l'elenco dei compiti.
Poi, assicurati di concedere i ruoli IAM Gemini for Google Cloud User e Service Usage Consumer agli utenti 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 singolarmente 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 utente individuali nell'account. Gli utenti con assegnazioni di licenze che non hanno utilizzato funzionalità di Gemini Code Assist Standard o Enterprise vengono deprovisionati automaticamente al termine del periodo di inattività impostato dall'amministratore.
Nella console Google Cloud , vai alla pagina Amministrazione per Gemini.
Seleziona Gestisci Gemini Code Assist, quindi Gestisci abbonamento.
Seleziona Gestione licenze e poi seleziona Abilita assegnazione automatica di licenza. Viene visualizzata la finestra di dialogo Abilita licenze automatiche.
Se passi a questo abbonamento per assegnare automaticamente le licenze, l'assegnazione manuale delle licenze verrà disattivata dopo la modifica, ma le assegnazioni delle licenze preesistenti non verranno interessate.
Imposta il periodo di tempo dopo il quale una licenza viene annullata se l'assegnatario è inattivo, poi 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 giornoT+1
. Ad esempio, se configuri7
giorni di inattività per l'annullamento dell'assegnazione, le licenze vengono annullate e rese disponibili nel pool di licenze il giorno8
.Seleziona Chiudi.
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 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 dai tuoi abbonamenti nell'account di fatturazione.
Per disattivare l'assegnazione automatica delle licenze:
Nella console Google Cloud , vai alla pagina Amministrazione per Gemini.
Seleziona Gestisci Gemini Code Assist, quindi Gestisci abbonamento.
Seleziona Gestione licenze, quindi Gestisci assegnazione automatica di licenze. Viene visualizzata la finestra di dialogo Gestisci l'assegnazione automatica delle licenze.
Seleziona Disattiva la gestione automatica delle licenze.
Seleziona Conferma modifica.
Annullare manualmente l'assegnazione delle licenze Gemini Code Assist Standard ed Enterprise
Seleziona una delle seguenti opzioni:
Console
Assicurati di disporre delle seguenti autorizzazioni IAM sull'account di fatturazione proprietario dell'abbonamento:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.unassign
resourcemanager.projects.get
Vai alla pagina Amministrazione di Gemini.
Seleziona Gestisci Gemini Code Assist, quindi Gestisci abbonamento.
Seleziona Gestione licenze, quindi Gestisci assegnazione automatica di licenze. Viene visualizzata la finestra di dialogo Gestisci l'assegnazione automatica delle licenze.
Seleziona gli utenti per i quali vuoi annullare l'assegnazione delle licenze, quindi seleziona Annulla assegnazione licenza.
Seleziona Conferma.
API
Per annullare l'assegnazione delle licenze Gemini Code Assist Standard ed Enterprise, utilizza il metodo billingAccounts.orders.licensePool.unassign
.
Per eseguire questa attività, devi disporre dell'autorizzazione
consumerprocurement.licensePools.unassign
Identity and Access Management (IAM) per l'account di fatturazione che contiene il pool di licenze di cui intendi annullare l'assegnazione.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"dana@example.com", "lee@example.com"
.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 ha esito positivo, 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. Anziché eliminare l'utente, annulla l'assegnazione della licenza a 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 da 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 la personalizzazione del codice) viene eseguita a livello di progetto, non a livello di licenza o abbonamento.
Per impedire ulteriormente l'utilizzo interorganizzativo di Gemini Code Assist Standard ed Enterprise in un progetto, puoi procedere in uno dei seguenti modi:
- Disattiva l'API Gemini in Google Cloud nel progetto.
- Utilizza le autorizzazioni per negare l'accesso utente al progetto.
Limitazioni
- La gestione delle licenze di Gemini per Google Cloud non supporta la federazione delle identità per la forza lavoro.