Gestire le licenze Gemini Code Assist

Prima di utilizzare Gemini Code Assist, 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 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 per i consumatori (roles/consumerprocurement.orderAdmin) per poter concedere le autorizzazioni aggiuntive necessarie per attività di gestione delle licenze specifiche descritte nelle seguenti sezioni.

• Se vuoi gestire le licenze utilizzando un'API anziché la console Google Cloud, assicurati di quanto segue:
  • Configura un progetto quota per il tuo account di fatturazione.
  • Abilita l'API Cloud Commerce Consumer Procurement nel progetto quota.
  • Assicurati che le seguenti coppie chiave-valore dell'intestazione siano presenti in tutte le chiamate API:
    • Authorization: il tuo token di accesso Google Cloud da Google Cloud CLI
    • x-goog-user-project: l'ID del progetto quota

Modificare il numero di licenze Gemini Code Assist 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 ad Amministrazione per Gemini

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 di Gemini Code Assist

Seleziona una delle seguenti opzioni:

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

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

Assegnare manualmente le licenze di Gemini Code Assist a singoli utenti

Seleziona una delle seguenti opzioni:

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

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

{}

Assegnare automaticamente le licenze Gemini Code Assist

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

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

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

   Vai ad Amministrazione per Gemini

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.

Se sono disponibili licenze da assegnare, i nuovi utenti ricevono automaticamente una licenza al primo accesso a Gemini Code Assist coperto dai tuoi abbonamenti in questo account di fatturazione.

Per disattivare l'assegnazione automatica delle licenze:

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

   Vai ad Amministrazione per Gemini

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

Seleziona una delle seguenti opzioni:

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

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

{}

Trasferire le licenze Gemini Code Assist

Le licenze Gemini Code Assist non possono essere trasferite direttamente tra gli utenti. Annullare l'assegnazione della licenza a un utente e poi assegnarla al nuovo utente.

Impedire l'utilizzo delle licenze tra organizzazioni

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

Tutti i log generati dall'utilizzo di Gemini Code Assist rimangono 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 di Gemini Code Assist tra organizzazioni in un progetto, puoi procedere in uno dei seguenti modi:

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

Limitazioni

• La gestione delle licenze di Gemini per Google Cloud non supporta la federazione delle identità per la forza lavoro.