Acquistare abbonamenti e assegnare licenze per Gemini Enterprise

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

Per configurare l'accesso, in genere devi completare le seguenti fasi:

  1. Acquista: acquista un abbonamento a una versione 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. Puoi assegnare le licenze 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 di Gemini Notebook Enterprise.

Informazioni sugli abbonamenti

Per ottenere le licenze, devi prima avere un abbonamento a una versione di Gemini Enterprise. Gli abbonamenti sono specifici per un account di fatturazione. Per informazioni sulle versioni disponibili, consulta Confronta le versioni di Gemini Enterprise.

Per Gemini Enterprise, puoi acquistare un abbonamento mensile o annuale. Puoi impostare questi abbonamenti in modo che si rinnovino automaticamente.

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

Limiti di quantità di utenze per l'abbonamento

Quando acquisti o modifichi un abbonamento basato sulle utenze direttamente tramite la consoleGoogle Cloud , la console applica un limite automatico al numero di utenze. Il numero massimo di utenze dipende dal tuo account di fatturazione Cloud.

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

Informazioni sugli stati degli abbonamenti

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 se le assegni agli utenti, questi non potranno accedere a Gemini Enterprise finché l'abbonamento non diventerà attivo. Per saperne di più, consulta Distribuisci le 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 relative licenze stanno per scadere in anticipo. Gli utenti con licenze in questo abbonamento continuano ad accedere 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 Gestisci la terminazione 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 fine anticipata dell'abbonamento.

Prima di iniziare

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

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

    • Configurazione di un account di fatturazione per il tuo progetto.
    • Concedere almeno il ruolo Utente aziendale Gemini Enterprise a tutti gli utenti a cui concederai la licenza per l'utilizzo di Gemini Enterprise.

  • Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud . Per saperne di più, consulta la sezione Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .

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

    • Il ruolo Gemini Enterprise Admin.

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

      In alternativa, per controllare le autorizzazioni IAM in modo granulare, puoi utilizzare un ruolo personalizzato con le seguenti autorizzazioni anziché il ruolo Billing Account Administrator:

      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

Sottoscrivi 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 all'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 > Piani e fatturazione.

    Vai a Piani e fatturazione

  2. Dal menu a discesa Account di fatturazione selezionato, seleziona il tuo account di fatturazione.

  3. Fai clic su Crea sottoscrizione.

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

  5. Configura i Dettagli di fatturazione:

    1. Conferma o seleziona l'account di fatturazione dal menu a discesa.
    2. Inserisci un Nome sottoscrizione.
    3. Inserisci il numero di licenze di cui hai bisogno per la versione.

  6. Seleziona un periodo di abbonamento.

  7. Se vuoi che l'abbonamento si rinnovi automaticamente, seleziona la casella di controllo Rinnova automaticamente l'abbonamento.

  8. Configura i Dettagli distribuzione:

    1. Nel campo Progetto, inserisci un ID progetto, quindi seleziona un progetto dalle opzioni di corrispondenza. Se la console lo richiede, abilita le API necessarie.
    2. Scegli una località per la tua sottoscrizione. Se non hai motivi di conformità o normativi per posizionare i dati nelle località multiregionali degli Stati Uniti e dell'UE, Google consiglia di scegliere la località multiregionale globale per la massima disponibilità e una bassa latenza.

  9. Fai clic su Crea > Conferma.

Pagamento a consumo

Con un abbonamento con pagamento a consumo, paghi mensilmente per ciò che consumi. Per saperne di più, consulta Quote e prezzi per la versione a pagamento a consumo. Puoi utilizzare l'abbonamento con qualsiasi progetto collegato al tuo account di fatturazione.

Per abbonarti alla versione Gemini Enterprise con pagamento a consumo, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Piani e fatturazione.

    Vai a Piani e fatturazione

  2. Dal menu a discesa Account di fatturazione selezionato, seleziona il tuo account di fatturazione.

  3. Fai clic su Crea sottoscrizione.

  4. Per la versione Gemini Enterprise con pagamento a consumo, fai clic su Crea piano.

  5. Configura i Dettagli di fatturazione:

    1. Conferma o seleziona l'account di fatturazione dal menu a discesa.
    2. Inserisci un Nome sottoscrizione.
    3. Inserisci il numero di licenze con pagamento a consumo di cui hai bisogno per la versione.

  6. Configura i Dettagli distribuzione:

    1. Nel campo Progetto, inserisci un ID progetto, quindi seleziona un progetto dalle opzioni di corrispondenza. Se la console lo richiede, abilita le API necessarie.
    2. Scegli una località per la tua sottoscrizione. Se non hai motivi di conformità o normativi per posizionare i dati nelle località multiregionali degli Stati Uniti e dell'UE, Google consiglia di scegliere la località multiregionale globale per la massima disponibilità e una bassa latenza.

  7. Fai clic su Crea > Conferma.

  8. Se il tuo progetto è collegato a un account di fatturazione Cloud self-service (online), si apre la finestra Acquista crediti. Seleziona un importo e un metodo di pagamento, quindi completa l'acquisto. Facoltativamente, configura la ricarica automatica.

    Se non hai ancora configurato i crediti prepagati nell'account di fatturazione, devi acquistarli. Se annulli, non crei un abbonamento e Google non ti addebita alcun costo. Per saperne di più, consulta Gestisci i crediti prepagati.

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 > Piani e fatturazione.

    Vai a Piani e fatturazione

  2. Dal menu a discesa Account di fatturazione selezionato, seleziona il tuo account di fatturazione.

  3. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento per aprire la pagina Dettagli abbonamento.

REST

Per visualizzare i dettagli della sottoscrizione, 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 o l'ID progetto che utilizzi per attribuire la fatturazione e la quota per questa chiamata API. Devi disporre del ruolo Service Usage Consumer per questo progetto.

  • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud .

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

Aggiorna 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 dal modo in cui hai acquistato 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 aggiornare il modulo d'ordine con il nuovo numero di licenze. Contatta il tuo account manager Google per aggiornare il modulo d'ordine.

Per aggiornare il numero di licenze o le impostazioni di rinnovo se hai acquistato l'abbonamento tramite la console Google Cloud , segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Piani e fatturazione.

    Vai a Piani e fatturazione

  2. Dal menu a discesa Account di fatturazione selezionato, seleziona il tuo account di fatturazione.

  3. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento per aprire la pagina Dettagli abbonamento.

  4. Nella pagina Dettagli sottoscrizione, fai clic su Modifica.

  5. Nel riquadro Modifica abbonamento, inserisci un nuovo valore nel campo Numero di licenze oppure seleziona o deseleziona la casella di controllo 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 alla fine del periodo di abbonamento e Google potrebbe addebitarti dei costi fino a quella data. Per scoprire di più sul tuo abbonamento, vedi Visualizza dettagli abbonamento.

Per annullare l'abbonamento:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Piani e fatturazione.

    Vai a Piani e fatturazione

  2. Dal menu a discesa Account di fatturazione selezionato, seleziona il tuo account di fatturazione.

  3. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento per aprire la pagina Dettagli abbonamento.

  4. Nella pagina Dettagli sottoscrizione, fai clic su Modifica.

  5. Nel riquadro Modifica abbonamento, deseleziona la casella di controllo Rinnovo automatico.

  6. Fai clic su Invia.

Distribuisci licenze

Se non hai distribuito le licenze in abbonamento a un progetto, il che potrebbe accadere quando acquisti l'abbonamento offline o quando un tentativo precedente di distribuire le licenze non è andato a buon fine, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Piani e fatturazione.

    Vai a Piani e fatturazione

  2. Dal menu a discesa Account di fatturazione selezionato, seleziona il tuo account di fatturazione.

  3. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento per aprire la pagina Dettagli abbonamento.

  4. Nella pagina Dettagli abbonamento, fai clic su Distribuisci licenze.

    Si apre il riquadro Distribuisci licenze, che mostra le allocazioni delle licenze dei progetti esistenti insieme ai conteggi delle Licenze disponibili e delle Licenze totali.

  5. Per distribuire le licenze a un progetto:

    1. Nel campo Seleziona un progetto, inserisci un ID progetto, quindi seleziona un progetto dalle opzioni di corrispondenza.
    2. Se una finestra di dialogo ti chiede di abilitare l'API Discovery Engine per il progetto selezionato, fai clic per abilitarla.
    3. Dal menu a discesa Regione, seleziona una regione.
    4. Nel campo Numero di licenze, inserisci il numero di licenze da assegnare.
    5. (Facoltativo) Per assegnare licenze ad altri progetti o regioni, fai clic su Aggiungi distribuzione licenze e ripeti questi passaggi.

  6. Fai clic su Invia.

  7. Nella finestra di dialogo Conferma distribuzione licenze, fai clic su Invia.

REST

Per distribuire le licenze a uno o 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 o l'ID progetto che utilizzi per attribuire la fatturazione e la quota per questa chiamata API. Devi disporre del ruolo Service Usage Consumer per questo progetto. Puoi utilizzare TARGET_PROJECT_NUMBER se hai attivato Discovery Engine in quel progetto.

  • ENDPOINT_LOCATION: la località multiregionale per la richiesta API. Specifica uno dei seguenti valori:

    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.

  • LOCATION: la località multiregionale del datastore: global, us o eu.

  • TARGET_PROJECT_NUMBER: il numero del progetto a cui vuoi distribuire le licenze.

  • LICENSE_COUNT: il numero di licenze da distribuire.

  • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud .

  • BILLING_ACCOUNT_LICENSE_CONFIG_ID: individua l'ID configurazione licenza account di fatturazione nei dettagli dell'abbonamento.

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

Recupera 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 ridistribuirle ad altri progetti.

Console

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Piani e fatturazione.

    Vai a Piani e fatturazione

  2. Dal menu a discesa Account di fatturazione selezionato, seleziona il tuo account di fatturazione.

  3. Nella tabella Abbonamenti Gemini, fai clic sul nome del tuo abbonamento per aprire la pagina Dettagli abbonamento.

  4. Nella pagina Dettagli abbonamento, fai clic su Distribuisci licenze.

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

  6. Scegli una delle seguenti azioni:

    • Per ridurre il numero di licenze, diminuisci il numero nel campo Numero di licenze.
    • Per recuperare tutte le licenze dalla riga, sposta il puntatore sulla riga e poi fai clic su Elimina elemento.

  7. Fai clic su Invia.

  8. Nella finestra di dialogo Conferma distribuzione licenze, leggi l'avviso che indica che le revoche delle licenze sono limitate a una al giorno, quindi fai clic su Invia.

REST

Per trasferire le licenze dell'abbonamento all'account di fatturazione per ridistribuirle, 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 o l'ID progetto che utilizzi per attribuire la fatturazione e la quota per questa chiamata API. Devi disporre del ruolo Service Usage Consumer per questo progetto. Puoi utilizzare TARGET_PROJECT_NUMBER se hai attivato Discovery Engine in quel progetto.

  • ENDPOINT_LOCATION: la località multiregionale per la richiesta API. Specifica uno dei seguenti valori:

    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.

  • LOCATION: la località multiregionale del datastore: global, us o eu.

  • TARGET_PROJECT_NUMBER: il numero del progetto da cui vuoi recuperare le licenze. Questo è il progetto in cui hai allocato le licenze.

  • LICENSE_COUNT: il numero di licenze da recuperare.

  • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud .

  • BILLING_ACCOUNT_LICENSE_CONFIG_ID: individua l'ID configurazione licenza account di fatturazione nei dettagli dell'abbonamento.

  • LICENSE_CONFIG_ID: l'ID di configurazione della licenza di una configurazione della licenza a livello di progetto esistente.

Gestisci la terminazione anticipata

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

Per garantire una transizione più agevole ed evitare interruzioni del servizio, offriamo un periodo di tolleranza di una settimana (sette giorni) durante il quale le licenze interessate sono in stato di disattivazione prima della scadenza completa. Durante questo periodo di tolleranza, puoi continuare a utilizzare il servizio mentre esegui la transizione a un nuovo abbonamento.

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

La seguente immagine mostra un esempio di licenza in fase di disattivazione 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 le hai assegnate, segui questi passaggi:

  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.

Esporta i dati utente

La tabella degli utenti nella console Google Cloud non supporta l'ordinamento o l'applicazione di filtri. 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 completo della risorsa Google Cloud per l'abbonamento assegnato all'utente (ad esempio, projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). L'ID di configurazione della licenza corrisponde alla versione di Gemini Enterprise (ad esempio, Standard o Plus) assegnata all'utente da un amministratore.
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: all'utente è stata assegnata una licenza.
  • NO_LICENSE: l'utente non dispone di una licenza perché un amministratore non ne ha assegnata una o ha rimosso una licenza esistente.
  • BLOCKED: una policy o un amministratore impedisce all'utente di ricevere una licenza.

Per esportare i dati utente in un file CSV, segui questi passaggi:

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

    Gestisci gli utenti

  2. Seleziona la multiregione della licenza esistente.

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

    A seconda delle dimensioni della tabella degli utenti, l'esportazione dei dati potrebbe richiedere fino a 2,5 minuti. 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.

Risolvi i problemi di esportazione

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

Problema Risoluzione
Il pulsante Esporta tutti gli utenti è nascosto Assicurati di aver assegnato le licenze agli utenti nella multiregione selezionata. Se non sono presenti utenti con licenze assegnate, 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 di utenti supera il limite di esportazione di 1.000.000 di utenti, la console Google Cloud rifiuta la richiesta di esportazione e visualizza un messaggio di errore di superamento del limite.
La richiesta di esportazione non va a buon fine con un errore di autorizzazione negata Assicurati che il tuo account disponga del ruolo Gemini Enterprise Admin, 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, dopo l'assegnazione, l'utente può accedere immediatamente a Gemini Enterprise.

Aggiungi utenti e assegna loro le 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 automaticamente le licenze e poi l'abbonamento.

    Ogni volta che un utente senza una licenza assegnata manualmente accede, 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.

Aggiungi utenti e assegna loro le licenze manualmente

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

Console

Per assegnare manualmente le licenze agli utenti, segui questi passaggi:

  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/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 località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la località multiregionale 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.

Trasferisci le licenze dagli abbonamenti scaduti

Gli utenti non possono accedere a Gemini Enterprise se l'abbonamento è scaduto. Puoi ripristinare il livello accesso dell'account in due modi:

Trasferisci automaticamente gli utenti a un abbonamento attivo

Per trasferire automaticamente gli utenti a un abbonamento attivo, segui questi passaggi:

  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, acquista un abbonamento.

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

  5. Seleziona Aggiorna automaticamente la licenza scaduta.

    Al successivo accesso di un utente con una licenza scaduta, Gemini Enterprise concede automaticamente una licenza nell'abbonamento scelto.

Trasferire manualmente gli utenti a un abbonamento attivo

Per trasferire manualmente gli utenti a un abbonamento attivo, segui questi passaggi:

  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, acquista un abbonamento.

  4. Seleziona gli utenti e fai clic su Assegna una 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 le hai 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 località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la località multiregionale del datastore: global, us o eu

Rimuovi utenti da una licenza

Puoi rimuovere una licenza da un utente in qualsiasi momento. Quando rimuovi una licenza, l'utente perde immediatamente l'accesso a Gemini Enterprise. Per rimuovere gli utenti da una licenza, segui questi passaggi:

Console

Per rimuovere gli utenti da una licenza utilizzando la console Google Cloud , segui questi passaggi:

  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 l'assegnazione della 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 gli 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 località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la località multiregionale del datastore: global, us o eu
  • USER_EMAIL: l'indirizzo email dell'utente che vuoi rimuovere dalla licenza.

Passaggi successivi