Acquistare abbonamenti e assegnare licenze per Gemini Enterprise

Questa pagina descrive come ottenere abbonamenti a Gemini Enterprise e come gestire le licenze utente.

La configurazione dell'accesso in genere prevede le seguenti fasi:

  1. Acquisto: acquista un abbonamento a un'edizione del prodotto per il tuo account di fatturazione.
  2. Distribuisci: assegna le licenze dell'abbonamento a progetti e località specifici.
  3. Assegna: assegna le licenze distribuite a singoli utenti.

Informazioni sulle licenze

Per accedere all'app Gemini Enterprise, un utente deve disporre di una licenza. Le licenze possono essere assegnate agli utenti manualmente o automaticamente.

  • Licenze assegnate manualmente:puoi aggiungere utenti in base ai loro indirizzi email.

  • Licenze assegnate automaticamente:puoi configurare un abbonamento in modo che Gemini Enterprise assegni automaticamente una licenza a un utente la prima volta che accede all'interfaccia di Gemini Enterprise o Gemini Notebook Enterprise.

Informazioni sugli abbonamenti

Per ottenere le licenze, devi prima disporre di un abbonamento a una versione di Gemini Enterprise. Gli abbonamenti sono specifici per un account di fatturazione. Per informazioni sulle versioni disponibili, vedi Confronto tra le versioni di Gemini Enterprise.

Per Gemini Enterprise, puoi acquistare un abbonamento mensile o un abbonamento di un anno. Questi abbonamenti possono essere impostati per il rinnovo automatico.

Puoi acquistare abbonamenti alle versioni Gemini Enterprise Standard, Gemini Enterprise Plus e Gemini Enterprise con pagamento a consumo utilizzando la consoleGoogle Cloud .

Limiti di quantità di posti per l'abbonamento

Quando acquisti o modifichi un abbonamento basato sulle utenze direttamente tramite la consoleGoogle Cloud , vengono applicati limiti automatici alla quantità di utenze in base al tuo tipo di account di fatturazione Cloud:

  • Account di fatturazione self-service (o online) e rivenduti:limitati a un massimo di 25 posti per account quando gestisci gli abbonamenti utilizzando la console Google Cloud .
  • Account di fatturazione con fatturazione mensile non automatica (o offline):limitati a un massimo di 1000 utenze per account.

Se la tua organizzazione richiede più posti o se si verifica l'errore relativo al limite massimo di posti quando provi ad aggiungere licenze a un abbonamento esistente, contatta il tuo Google Cloud rappresentante di vendita o account manager per acquistare licenze aggiuntive tramite un ordine offline o richiedere un'esenzione dalla lista consentita.

Informazioni sugli stati dell'abbonamento

Un abbonamento può avere uno dei seguenti stati:

Stato Descrizione
Non avviato Hai acquistato l'abbonamento, ma non è ancora attivo. Puoi distribuire le licenze di questo abbonamento ai progetti, ma gli utenti a cui sono state assegnate queste licenze non avranno accesso a Gemini Enterprise finché l'abbonamento non sarà attivo. Per ulteriori informazioni, vedi Distribuire licenze.
Attivo L'abbonamento è attivo e gli utenti che dispongono di una licenza in questo abbonamento possono accedere a Gemini Enterprise.
In fase di disattivazione L'abbonamento è in fase di disattivazione e le licenze sono pianificate per la risoluzione anticipata. Gli utenti con licenze in questo abbonamento continuano ad avere accesso a Gemini Enterprise per un periodo di tolleranza di una settimana. Dopo questa settimana, le licenze passano allo stato Scaduta. Per saperne di più, consulta Gestire la risoluzione anticipata.
Scaduto Gli utenti con licenze in questo abbonamento perdono l'accesso a Gemini Enterprise al termine del periodo di abbonamento o quando le licenze passano dallo stato di disattivazione allo stato di scadenza dopo la risoluzione anticipata.

Prima di iniziare

Prima di iniziare le procedure descritte in questa pagina, assicurati di soddisfare i seguenti prerequisiti:

  • Completa tutte le attività descritte in Configurare Gemini Enterprise. È incluso quanto segue:

    • Configurazione di un account di fatturazione per il tuo progetto.
    • Concedere almeno il ruolo Utente Gemini Enterprise a tutti gli utenti a cui assegnerai la licenza per utilizzare Gemini Enterprise.

  • Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud . Per ulteriori informazioni, consulta Verificare che la fatturazione sia attivata per il tuo progetto Google Cloud .

  • Verifica di disporre dei ruoli e delle autorizzazioni IAM richiesti:

    • Il ruolo di amministratore di Gemini Enterprise.

    • Se gestisci la fatturazione per la tua organizzazione, devi disporre dei seguenti ruoli per gestire gli abbonamenti a Gemini Enterprise e gli ordini di acquisto.

      In alternativa, per un controllo IAM granulare, puoi utilizzare un ruolo personalizzato con le seguenti autorizzazioni anziché il ruolo Amministratore account di fatturazione:

      Servizio Autorizzazioni
      Discovery Engine discoveryengine.billingAccountLicenseConfigs.distribute
      discoveryengine.billingAccountLicenseConfigs.get
      discoveryengine.billingAccountLicenseConfigs.list
      discoveryengine.billingAccountLicenseConfigs.retract
      discoveryengine.licenseConfigs.create
      discoveryengine.licenseConfigs.get
      discoveryengine.licenseConfigs.list
      discoveryengine.licenseConfigs.update
      discoveryengine.projects.get
      discoveryengine.projects.provision
      discoveryengine.projects.reportConsentChange
      discoveryengine.userStores.batchUpdateUserLicenses
      discoveryengine.userStores.listUserLicenses
      Consumer Procurement consumerprocurement.orders.get
      consumerprocurement.licensePools.assign
      consumerprocurement.licensePools.unassign
      consumerprocurement.licensePools.enumerateLicensedUsers
      Resource Manager resourcemanager.projects.get
      resourcemanager.projects.list
      Utilizzo dei servizi serviceusage.services.get
      serviceusage.services.list

Acquistare un abbonamento

Per ottenere le licenze, acquista un abbonamento a una versione di Gemini Enterprise per il tuo account di fatturazione. L'abbonamento fornisce un pool di licenze che puoi utilizzare con qualsiasi progetto collegato a quell'account di fatturazione, distribuire ai progetti e assegnare agli utenti.

Standard e Plus

Per abbonarti alla versione Gemini Enterprise Standard o Plus, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci abbonamenti > Crea abbonamento.

  3. Per la versione Gemini Enterprise Standard o Gemini Enterprise Plus, fai clic su Abbonati.

  4. Configura i dettagli di fatturazione:

    1. Seleziona l'account di fatturazione dal menu a discesa.
    2. Inserisci un nome dell'abbonamento.
    3. Inserisci il numero di licenze di cui hai bisogno per la versione.

  5. Seleziona il periodo di abbonamento.

  6. Se vuoi che l'abbonamento si rinnovi automaticamente, seleziona Rinnovo automatico abbonamento.

  7. Configura i Dettagli di distribuzione:

    1. Nel menu a discesa Seleziona un progetto, seleziona il tuo progetto.
    2. Scegli un Tipo di località per l'abbonamento. Se non hai motivi di conformità o normativi per posizionare i dati negli Stati Uniti o in più regioni dell'UE, Google consiglia di scegliere la multiregione globale per la massima disponibilità e la bassa latenza.

  8. Fai clic su Crea > Conferma.

Pagamento a consumo

Con un abbonamento con pagamento a consumo, paghi mensilmente ciò che consumi alle tariffe indicate in Eccedenze. Puoi utilizzare l'abbonamento con qualsiasi progetto collegato al tuo account di fatturazione.

Per abbonarti alla versione Gemini Enterprise con pagamento a consumo:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci abbonamenti > Crea abbonamento.

  3. Nella versione Gemini Enterprise con pagamento a consumo, fai clic su Abbonati.

  4. Configura i dettagli di fatturazione:

    1. Inserisci un nome dell'abbonamento.
    2. Inserisci il numero di licenze di cui hai bisogno per la versione.

  5. Configura i Dettagli di distribuzione:

    1. Nel menu a discesa Seleziona un progetto, seleziona il tuo progetto.
    2. Scegli un Tipo di località per l'abbonamento. Se non hai motivi di conformità o normativi per posizionare i dati negli Stati Uniti o in più regioni dell'UE, Google consiglia di scegliere la multiregione globale per la massima disponibilità e la bassa latenza.

  6. Fai clic su Crea > Conferma.

Gestisci abbonamenti

Questa sezione descrive come visualizzare, aggiornare, distribuire e recuperare gli abbonamenti a Gemini Enterprise.

Visualizza dettagli abbonamento

Per visualizzare i dettagli dei tuoi abbonamenti a Gemini Enterprise:

Console

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci abbonamenti.

  3. Seleziona l'account di fatturazione dal menu a discesa.

  4. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento.

REST

Per ottenere i dettagli dell'abbonamento, esegui questo comando:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

Sostituisci quanto segue:

  • PROJECT_NUMBER: il numero del progetto per il quale hai il ruolo Service Usage Consumer
  • BILLING_ACCOUNT_ID: l'ID del tuo Google Cloud account di fatturazione.

Esempio di output

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

Aggiornare le impostazioni dell'abbonamento

Dopo aver creato un abbonamento, puoi aggiornare le impostazioni, ad esempio il numero di licenze o l'impostazione di rinnovo automatico.

Il metodo per aggiungere altre licenze dipende da come hai acquistato originariamente l'abbonamento:

  • Se hai acquistato l'abbonamento tramite la console Google Cloud , aggiungi altre licenze direttamente nella console Google Cloud seguendo i passaggi descritti in questa sezione.
  • Se hai effettuato l'acquisto utilizzando un modulo d'ordine offline, devi aggiornarlo con il nuovo numero di licenze. Contatta il tuo account manager Google per aggiornare il modulo d'ordine.

Segui questi passaggi per aggiornare il numero di licenze se hai effettuato l'acquisto tramite la consoleGoogle Cloud :

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci abbonamenti.

  3. Fai clic sull'abbonamento che vuoi aggiornare nella tabella Abbonamenti Gemini.

  4. Fai clic su Modifica accanto a Dettagli abbonamento.

  5. Aggiorna il numero di licenze o attiva o disattiva il rinnovo automatico.

  6. Fai clic su Invia.

Annullare un abbonamento

Per annullare un abbonamento a Gemini Enterprise, devi disattivare il rinnovo automatico. L'abbonamento rimane attivo fino al termine del periodo di abbonamento e potresti incorrere in addebiti fino a quella data. Per saperne di più sul tuo abbonamento, consulta Visualizzare i dettagli dell'abbonamento.

Per annullare l'abbonamento, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci abbonamenti.

  3. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento per aprire la pagina dei dettagli dell'abbonamento.

  4. Fai clic su Modifica.

  5. Nel riquadro Modifica abbonamento, deseleziona la casella di controllo Rinnova automaticamente l'abbonamento.

  6. Fai clic su Invia.

Distribuire le licenze

Se non hai distribuito le licenze sottoscritte a un progetto, il che potrebbe accadere quando acquisti l'abbonamento offline o quando la distribuzione delle licenze non è riuscita in precedenza, procedi nel seguente modo:

Console

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci abbonamenti.

  3. Seleziona l'account di fatturazione dal menu a discesa.

  4. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento.

  5. Fai clic su Distribuisci licenza nella parte superiore della pagina. Viene visualizzato un elenco che mostra le distribuzioni delle licenze esistenti e le statistiche dei posti rimanenti e totali.

  6. Per distribuire le licenze a un progetto:

    1. Fai clic sul selettore dei progetti per selezionarne uno. Il selettore supporta il completamento automatico.
    2. Nota: se non hai abilitato l'API Discovery Engine per il progetto selezionato, viene visualizzata una finestra di dialogo che ti chiede di abilitarla.
    3. Seleziona una posizione.
    4. Inserisci il numero di licenze da assegnare.
    5. Ripeti questi passaggi se vuoi distribuire le licenze a più progetti o sedi.

  7. Fai clic su Invia.

  8. Nella finestra di dialogo di conferma, esamina il riepilogo delle modifiche e fai clic su Conferma.

REST

Per distribuire le licenze a un progetto o a più progetti, esegui questo comando:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

Sostituisci quanto segue:

  • PROJECT_NUMBER: il numero di progetto per cui hai il ruolo Service Usage Consumer
  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multiregione EU
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la multiregione del datastore: global, us o eu.
  • TARGET_PROJECT_NUMBER: il numero di progetto a cui vuoi distribuire le licenze.
  • LICENSE_COUNT: il numero di licenze da distribuire.
  • BILLING_ACCOUNT_ID: l'ID del tuo Google Cloud account di fatturazione.
  • BILLING_ACCOUNT_LICENSE_CONFIG_ID: individua l'ID configurazione licenza account di fatturazione all'interno dei dettagli dell'abbonamento.

  • (Facoltativo) LICENSE_CONFIG_ID: l'ID di una configurazione delle licenze a livello di progetto esistente. Puoi trovare questo ID nel campo licenseConfigDistributions quando visualizzi i dettagli dell'abbonamento.

Recuperare le licenze non assegnate in un abbonamento

Questa sezione descrive come recuperare le licenze non assegnate da un progetto, rendendole disponibili nell'account di fatturazione per la ridistribuzione ad altri progetti.

Console

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci abbonamenti.

  3. Seleziona l'account di fatturazione dal menu a discesa.

  4. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento.

  5. Fai clic su Distribuisci licenza nella parte superiore della pagina (questo pulsante apre il modulo di gestione per tutte le allocazioni).

  6. Nell'elenco delle allocazioni, individua la riga del progetto e della località da cui vuoi recuperare le licenze.

  7. Scegli una delle seguenti azioni:

    • Per ridurre il numero di licenze, diminuisci il conteggio nel campo di immissione della licenza.
    • Per recuperare completamente le licenze, sposta il puntatore del mouse sulla riga per visualizzare il pulsante Elimina e poi fai clic su Elimina.

  8. Fai clic su Invia.

  9. Nella finestra di dialogo di conferma, esamina il riepilogo delle modifiche (che elencherà le licenze recuperate) e fai clic su Conferma.

REST

Per trasferire nuovamente le licenze di abbonamento all'account di fatturazione per la ridistribuzione, esegui questo comando:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

Sostituisci quanto segue:

  • PROJECT_NUMBER: il numero di progetto per cui hai il ruolo Service Usage Consumer
  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multiregione EU
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la multiregione del datastore: global, us o eu.
  • TARGET_PROJECT_NUMBER: il numero di progetto da cui vuoi recuperare le licenze.
  • LICENSE_COUNT: il numero di licenze da recuperare.
  • BILLING_ACCOUNT_ID: l'ID del tuo Google Cloud account di fatturazione.
  • BILLING_ACCOUNT_LICENSE_CONFIG_ID: individua l'ID configurazione licenza account di fatturazione all'interno dei dettagli dell'abbonamento.
  • LICENSE_CONFIG_ID: l'ID configurazione licenza di una configurazione licenza esistente a livello di progetto.

Gestire la risoluzione anticipata

Quando esegui la migrazione tra diversi tipi di abbonamento o se si verifica un problema con il tuo account di fatturazione, un abbonamento potrebbe terminare prima del previsto.

Per garantire una transizione più fluida ed evitare interruzioni del servizio, forniamo un periodo di tolleranza di una settimana (sette giorni) in cui le licenze interessate si trovano in uno stato di disattivazione prima della scadenza completa. Durante questo periodo di tolleranza, puoi continuare a utilizzare il servizio mentre passi a un nuovo abbonamento.

Per garantire che gli utenti mantengano l'accesso, trasferisci le loro licenze a un nuovo abbonamento attivo automaticamente o manualmente.

La seguente immagine mostra un esempio di disattivazione della licenza nella consoleGoogle Cloud :

Esempio di disattivazione di una licenza nella console Google Cloud

Gestisci le licenze utente

Questa sezione descrive come visualizzare le licenze, esportare i dati utente e assegnare, trasferire e rimuovere le licenze per i singoli utenti.

Visualizzazione delle licenze

Per visualizzare le licenze e gli utenti a cui sono assegnate:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci utenti.

  3. Seleziona l'opzione Più regioni della licenza esistente.

Esportare i dati utente

La tabella degli utenti nella console Google Cloud non supporta l'ordinamento o il filtro. Se devi ordinare, filtrare o analizzare i dati utente, puoi esportare fino a 1.000.000 di record utente in un file con valori separati da virgole (CSV).

Il file CSV esportato include le seguenti colonne.

Nome colonna Descrizione
user_principal L'indirizzo email dell'utente.
license_config Il nome Google Cloud completo della risorsa per l'abbonamento assegnato all'utente (ad esempio, projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). L'ID configurazione della licenza corrisponde alla versione di Gemini Enterprise (ad esempio, Standard o Plus) assegnata all'utente.
assignment_time Il timestamp (in UTC) in cui un amministratore ha assegnato la licenza.
last_login_time Il timestamp (in UTC) dell'ultimo accesso dell'utente.
license_assignment_state Lo stato di assegnazione della licenza. Sono disponibili i seguenti valori:
  • ASSIGNED: l'utente ha una licenza assegnata.
  • NO_LICENSE: l'utente non ha una licenza perché un amministratore non ne ha assegnata una o ha rimosso una licenza esistente.
  • BLOCKED: un criterio o un amministratore impedisce all'utente di ricevere una licenza.

Per esportare i dati utente in un file CSV:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Gestisci utenti.

    Gestire gli utenti

  2. Seleziona l'opzione Più regioni della licenza esistente.

  3. Nella sezione Utenti, fai clic su Esporta tutti gli utenti.

    A seconda delle dimensioni della tabella degli utenti, il processo di esportazione potrebbe richiedere fino a 2,5 minuti per essere completato. Durante questo periodo, la console mostra uno stato di caricamento. Al termine dell'esportazione, il browser scarica il file CSV nella posizione di download predefinita.

Risolvere i problemi di esportazione

La seguente tabella elenca i problemi comuni durante l'esportazione dei dati utente e le relative soluzioni.

Problema Risoluzione
Il pulsante Esporta tutti gli utenti è nascosto Assicurati che siano stati assegnati utenti alle licenze nella multiregione selezionata. Se non ci sono utenti assegnati, il pulsante Esporta tutti gli utenti non viene visualizzato.
La richiesta di esportazione non va a buon fine e viene visualizzato un errore di superamento del limite Se l'elenco utenti supera il limite di esportazione di 1.000.000 di utenti, la console Google Cloud rifiuta la richiesta di esportazione e mostra un messaggio di errore di superamento del limite.
La richiesta di esportazione non va a buon fine e viene visualizzato un errore di autorizzazione negata Assicurati che il tuo account disponga del ruolo Amministratore Gemini Enterprise, che include l'autorizzazione discoveryengine.userStores.listUserLicenses richiesta.

Assegnazione di licenze agli utenti

Questa sezione spiega come assegnare automaticamente o manualmente le licenze ai nuovi utenti. Puoi assegnare una licenza a un nuovo utente in qualsiasi momento e, una volta assegnata, l'utente può accedere immediatamente a Gemini Enterprise.

Aggiungere utenti e assegnare loro automaticamente le licenze

Per assegnare automaticamente le licenze agli utenti quando accedono all'app Gemini Enterprise:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci utenti.

  3. Seleziona l'opzione Più regioni della licenza esistente.

  4. Seleziona Assegna licenze automaticamente e poi seleziona l'abbonamento.

    Ogni volta che un utente senza una licenza assegnata manualmente esegue l'accesso, Gemini Enterprise gli assegna automaticamente una licenza da questo abbonamento. Se non rimangono licenze nell'abbonamento, Gemini Enterprise mostra agli utenti un messaggio che li informa che non hanno accesso.

    Per saperne di più sugli abbonamenti, consulta la sezione Informazioni sugli abbonamenti.

Aggiungere utenti e assegnare loro manualmente le licenze

Per concedere a utenti specifici l'accesso a Gemini Enterprise, puoi assegnare loro manualmente le licenze da un abbonamento attivo.

Console

Per assegnare manualmente le licenze agli utenti:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic su Gestisci utenti.

  3. Seleziona l'opzione Più regioni della licenza esistente.

  4. Fai clic su Add users (Aggiungi utenti).

  5. Nella pagina Aggiungi utenti:

    1. Inserisci gli indirizzi email degli utenti. Assicurati di utilizzare lo stesso indirizzo email che utilizzeranno per accedere all'app Gemini Enterprise.

    2. Seleziona l'abbonamento da assegnare a questi utenti.

    3. Fai clic su Invia.

REST

Per assegnare manualmente le licenze agli utenti, esegui questo comando:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":false
  }'

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multiregione EU
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la multiregione del datastore: global, us o eu
  • USER_EMAIL: l'indirizzo email dell'utente che vuoi aggiungere alla licenza.
  • PROJECT_NUMBER: il numero del tuo progetto Google Cloud .
  • SUBSCRIPTION_ID: l'ID del tuo abbonamento a Gemini Enterprise.

Trasferire le licenze dagli abbonamenti scaduti

Gli utenti non possono accedere a Gemini Enterprise se l'abbonamento è scaduto. Esistono due approcci per restituire l'accesso all'account:

Trasferire automaticamente gli utenti a un abbonamento attivo

Per trasferire automaticamente gli utenti a un abbonamento attivo:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Gestisci utenti.

    Licenza Gemini Enterprise

  2. Seleziona l'opzione Più regioni della licenza esistente.

  3. Assicurati di avere un abbonamento attivo. Se non ne hai uno, abbonati.

  4. Seleziona Assegna licenze automaticamente e scegli l'abbonamento attivo.

  5. Seleziona Aggiorna automaticamente la licenza scaduta.

    Quando un utente con una licenza scaduta accede di nuovo, Gemini Enterprise gli concede automaticamente una licenza nell'abbonamento scelto.

Trasferire manualmente gli utenti a un abbonamento attivo

Per trasferire manualmente gli utenti a un abbonamento attivo:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Gestisci utenti.

    Licenza Gemini Enterprise

  2. Seleziona l'opzione Più regioni della licenza esistente.

  3. Assicurati di avere un abbonamento attivo. Se non ne hai uno, abbonati.

  4. Seleziona gli utenti e fai clic su Assegna licenza diversa.

  5. Nel riquadro Modifica utenti, seleziona l'abbonamento e fai clic su Invia.

Elenca le licenze

Per elencare le licenze e gli utenti a cui sono assegnate, esegui questo comando:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multiregione EU
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la multiregione del datastore: global, us o eu

Rimuovere utenti da una licenza

Puoi rimuovere una licenza da un utente in qualsiasi momento. Quando una licenza viene rimossa, l'utente perde immediatamente l'accesso a Gemini Enterprise. Per rimuovere utenti da una licenza:

Console

Per rimuovere utenti da una licenza utilizzando la console Google Cloud :

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Gestisci utenti.

    Licenza Gemini Enterprise

  2. Seleziona l'opzione Più regioni della licenza esistente.

  3. Nella tabella degli utenti, seleziona gli utenti.

  4. Per rimuovere utenti da una licenza, scegli una delle seguenti opzioni:

    • Per rimuovere la licenza solo dagli utenti selezionati, fai clic su Annulla assegnazione licenza.
    • Per rimuovere la licenza ed eliminare anche gli utenti selezionati dal progetto, fai clic su Annulla l'assegnazione ed elimina la licenza.

  5. Fai clic su Conferma.

REST

Per rimuovere utenti da una licenza, esegui questo comando:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multiregione EU
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la multiregione del datastore: global, us o eu
  • USER_EMAIL: l'indirizzo email dell'utente che vuoi rimuovere dalla licenza.

Passaggi successivi