Richiedere abbonamenti e assegnare licenze per Gemini Enterprise

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

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 al loro indirizzo email.

  • Licenze assegnate automaticamente:puoi scegliere di assegnare automaticamente le licenze incluse in un abbonamento a un utente la prima volta che accede all'interfaccia di Gemini Enterprise o NotebookLM 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 l'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 annuale. Questi abbonamenti possono essere impostati per il rinnovo automatico.

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:

Sottoscrivere un abbonamento

Per ottenere un abbonamento a Gemini Enterprise:

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

    Gemini Enterprise

  2. Fai clic su Gestisci abbonamenti > Crea abbonamento.

  3. In corrispondenza della versione a cui vuoi abbonarti, 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 necessarie 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 località multiregionale globale per la massima disponibilità e una bassa latenza.

  8. Fai clic su Crea > Conferma.

Gestisci abbonamenti

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

Visualizza i dettagli degli abbonamenti

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 di progetto per cui hai il ruolo Consumer utilizzo servizi
  • 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 aggiornarne 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 la licenza se l'hai acquistata 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.

Distribuire le licenze

Se non hai distribuito le licenze 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 licenze accanto a Dettagli abbonamento.

  6. Configura i dettagli di Distribuisci licenze:

    1. Nel menu a discesa Seleziona un progetto, seleziona il tuo progetto.

    2. Scegli una posizione 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 località multiregionale globale per la massima disponibilità e una bassa latenza.

  7. Fai clic su Invia.

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 Consumer utilizzo servizi
  • 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 regione multipla 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 nei dettagli dell'abbonamento
  • (Facoltativo) LICENSE_CONFIG_ID: l'ID configurazione licenza di una configurazione licenza esistente a livello di progetto. Se è vuoto, verrà creata una nuova configurazione della licenza a livello di progetto con il numero e la località del progetto specificati

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.

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 Consumer utilizzo servizi
  • 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 regione multipla 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 nei dettagli dell'abbonamento
  • LICENSE_CONFIG_ID: l'ID configurazione licenza di una configurazione licenza a livello di progetto esistente

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, assegnare, trasferire e rimuovere le licenze per 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.

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 licenze automaticamente

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.

    Una licenza di questo abbonamento viene assegnata ogni volta che un utente che non dispone di una licenza assegnata manualmente esegue l'accesso. Se non rimangono licenze nell'abbonamento, agli utenti viene mostrato un messaggio che li informa che non hanno accesso.

    Per ulteriori informazioni sugli abbonamenti, consulta la sezione Informazioni sugli abbonamenti.

Aggiungere utenti e assegnare loro manualmente le licenze

Per concedere l'accesso a Gemini Enterprise a utenti specifici, 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 agli 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":{
       "paths":[
          "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 regione multipla 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 Google Cloud progetto.
  • 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, gli viene concessa 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 assegnati, esegui questo comando:

REST

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 regione multipla 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":{
       "paths":[
          "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 regione multipla per il datastore.
  • LOCATION: la multiregione del datastore: global, us o eu
  • USER_EMAIL: l'indirizzo email dell'utente che vuoi rimuovere dalla licenza.

Visualizzare l'utilizzo della quota in pool (anteprima pubblica)

Panoramica delle quote condivise di Gemini Enterprise

In Gemini Enterprise, le quote delle risorse (ad esempio per la generazione di risposte, azioni e utilizzo degli agenti) sono condivise tra tutti gli utenti di un progetto Google Cloud . Questa condivisione della quota è detta anche pooling. Anziché avere un limite individuale separato per il consumo di risorse, i limiti vengono combinati in un unico pool a livello di progetto. Le quote vengono raggruppate per edizione. Ad esempio, gli utenti con licenze Gemini Enterprise Plus condividono un pool di quote, mentre gli utenti con licenze Gemini Enterprise Frontline condividono un pool di quote separato.

Ad esempio, la versione Gemini Enterprise Plus include una quota di generazione di immagini di 10 immagini al giorno per licenza. Supponiamo che un'azienda abbia 100 licenze per la versione Gemini Enterprise Plus, quindi l'azienda ottiene una quota di 1000 immagini al giorno (100 licenze x 10 immagini al giorno per licenza). Questa quota può essere utilizzata da chiunque nel progetto.

Prima di iniziare

Puoi visualizzare la dashboard di utilizzo delle quote solo se si verificano le seguenti condizioni:

  • Hai il ruolo di amministratore Discovery Engine.
  • Hai almeno un abbonamento Gemini Enterprise attivo tra Gemini Enterprise Standard, Gemini Enterprise Plus o Gemini Enterprise Frontline.

Se hai un abbonamento Agentspace attivo, puoi visualizzare la dashboard di utilizzo della quota solo se hai anche un abbonamento Gemini Enterprise attivo. In questo caso, la dashboard mostra le quote combinate degli abbonamenti Agentspace e Gemini Enterprise come segue:

  • Le quote di Gemini Enterprise Plus includono le quote di Agentspace Enterprise Plus
  • Le quote di Gemini Enterprise Standard includono le quote di Agentspace Enterprise
  • Le quote di Gemini Enterprise Frontline includono le quote di Agentspace Frontline Worker

Non puoi visualizzare la dashboard di utilizzo della quota se hai solo un abbonamento ad Agenspace e nessun abbonamento a Gemini Enterprise attivo.

Visualizzare la dashboard di utilizzo della quota

In qualità di amministratore di Discovery Engine, per visualizzare l'utilizzo della quota condivisa nel tuo progetto:

Console

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

    Licenza Gemini Enterprise

  2. Seleziona la multiregione delle licenze.

  3. Fai clic su Visualizza utilizzo quota.

  4. Nel riquadro Utilizzo della quota di Gemini Enterprise che si apre, seleziona la tua versione del prodotto dall'elenco Livello di abbonamento.

    La dashboard compila le quote e mostra l'utilizzo assoluto e in percentuale di ciascuna quota.

Passaggi successivi