Ottenere licenze per Gemini Enterprise

Questa pagina descrive come ottenere abbonamenti a Gemini Enterprise e assegnare licenze agli 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 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.

Le licenze sono specifiche per più regioni. Ad esempio, se gli utenti vogliono accedere alle app sia nella multiregione us sia in global, assegna loro una licenza in ciascuna.

Informazioni sugli abbonamenti

Per ottenere le licenze, devi prima disporre di un abbonamento a una versione di Gemini Enterprise. Per informazioni sulle versioni disponibili, vedi Confronto tra le versioni di Gemini Enterprise.

Gli abbonamenti sono specifici per regione. Gli utenti che creano app nella regione globale hanno bisogno di licenze di un abbonamento global. Allo stesso modo, gli utenti che devono conservare le proprie app e i propri dati nell'Unione Europea hanno bisogno di licenze di un abbonamento eu.

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

Prima di iniziare

Prima di iniziare le procedure descritte in questa pagina, assicurati che:

  • Hai completato le attività in Configura Gemini Enterprise. Ciò include la configurazione di un account di fatturazione per il tuo progetto e la concessione almeno del ruolo Discovery Engine User a tutti gli utenti a cui concederai la licenza per utilizzare Gemini Enterprise.

  • Devi disporre del ruolo Amministratore Discovery Engine.

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 regione multiregionale globale per la massima disponibilità e la bassa latenza.

  8. Fai clic su Crea > Conferma.

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.

  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.

Aggiungere utenti e assegnare loro manualmente le licenze

Per concedere a utenti specifici l'accesso a Gemini Enterprise, puoi assegnare 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 la multiregione 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/global/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/global/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. Assegna uno dei seguenti valori:
    • us- per la multiregione Stati Uniti
    • eu- per la multiregione EU
    • global- per la località globale
    Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
  • LOCATION: la multiregione del tuo 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.

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 la multiregione 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.

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 la multiregione 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 la multiregione 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:

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. Assegna uno dei seguenti valori:
    • us- per la multiregione Stati Uniti
    • eu- per la multiregione EU
    • global- per la località globale
    Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
  • LOCATION: la multiregione del tuo datastore: global, us o eu

Rimuovere utenti da una licenza

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 la multiregione 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. Assegna uno dei seguenti valori:
    • us- per la multiregione Stati Uniti
    • eu- per la multiregione EU
    • global- per la località globale
    Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
  • LOCATION: la multiregione del tuo datastore: global, us o eu
  • USER_EMAIL: l'indirizzo email dell'utente che vuoi rimuovere dalla licenza.

Passaggi successivi