Nesta página, descrevemos como assinar o Gemini Enterprise e como gerenciar licenças de usuário.
Para configurar o acesso, geralmente é preciso concluir as seguintes etapas:
- Adquirir: compre uma assinatura de uma edição do produto para sua conta de faturamento.
- Distribuir: aloque licenças da assinatura para projetos e locais específicos.
- Atribuir: atribua as licenças distribuídas a usuários específicos.
Sobre as licenças
Para fazer login no app do Gemini Enterprise, o usuário precisa ter uma licença. As licenças podem ser atribuídas de forma manual ou automática.
Licenças atribuídas manualmente: é possível adicionar usuários pelos endereços de e-mail.
Licenças atribuídas automaticamente: é possível configurar uma assinatura para que o Gemini Enterprise atribua automaticamente uma licença a um usuário na primeira vez que ele acessar o Gemini Enterprise ou a interface do Gemini Notebook para empresas.
Sobre as assinaturas
Para receber licenças, primeiro você precisa ter uma assinatura de uma edição do Gemini Enterprise. As assinaturas são específicas de uma conta de faturamento. Para informações sobre as edições disponíveis, consulte Comparar as edições do Gemini Enterprise.
Para o Gemini Enterprise, é possível comprar uma assinatura mensal ou anual. É possível configurar essas assinaturas para renovação automática.
Você pode comprar assinaturas das edições Gemini Enterprise Standard, Gemini Enterprise Plus e Gemini Enterprise pagamento por uso usando o console doGoogle Cloud .
Limites de quantidade de licenças de assinatura
Quando você compra ou modifica uma assinatura baseada em licenças diretamente pelo console doGoogle Cloud , o console aplica um limite automático de quantidade de licenças. O número máximo de licenças depende da sua conta do Cloud Billing.
Se a organização precisar de mais vagas ou se você encontrar o erro de limite máximo de vagas ao tentar adicionar licenças a uma assinatura, entre em contato com o representante de vendas ou gerente de contas do Google Cloud para comprar mais licenças por um pedido off-line ou solicitar uma isenção de lista de permissões.
Sobre os estados de assinatura
Uma assinatura pode estar em um dos seguintes estados:
| Estado | Descrição |
|---|---|
| Não iniciado | Você comprou a assinatura, mas ela ainda não está ativa. É possível distribuir licenças dessa assinatura para projetos, mas, se você atribuir essas licenças aos usuários, eles não poderão acessar o Gemini Enterprise até que a assinatura seja ativada. Para mais informações, consulte Distribuir licenças. |
| Ativo | A assinatura está ativa, e os usuários que têm uma licença nela podem acessar o Gemini Enterprise. |
| Desativando | A assinatura está sendo desativada, e as licenças estão sendo encerradas antes do prazo. Os usuários com licenças nessa assinatura continuam acessando o Gemini Enterprise por um período de carência de uma semana. Depois dessa semana, as licenças passam para o estado "Expirada". Para mais informações, consulte Processar o encerramento antecipado. |
| Expirado | Os usuários com licenças nessa assinatura perdem o acesso ao Gemini Enterprise quando o período da assinatura termina ou quando as licenças passam do estado de desativação para o estado de expiração após o término antecipado da assinatura. |
Antes de começar
Antes de iniciar os procedimentos nesta página, conclua os seguintes pré-requisitos:
Conclua todas as tarefas descritas em Configurar o Gemini Enterprise. Isso inclui:
- Configurar uma conta de faturamento para o projeto.
- Conceder pelo menos a função de usuário corporativo do Gemini Enterprise a todos os usuários que vão receber uma licença para usar o Gemini Enterprise.
Verifique se o faturamento foi ativado para o projeto do Google Cloud . Para mais informações, consulte Verificar se o faturamento está ativado para o projeto do Google Cloud .
Confirme se você tem os papéis e as permissões do IAM necessários:
O papel de administrador do Gemini Enterprise no projeto.
Se você gerencia o faturamento da sua organização, precisa ter os seguintes papéis para comprar e gerenciar assinaturas e pedidos de compra do Gemini Enterprise:
Na conta do Cloud Billing usada para a assinatura, uma das seguintes opções:
- O papel de Admin da conta de faturamento (
roles/billing.admin). - Os papéis de Administrador de pedidos de compras do consumidor
(
roles/consumerprocurement.orderAdmin) e de Leitor da conta de faturamento (roles/billing.viewer).
- O papel de Admin da conta de faturamento (
No projeto, o papel de Consumidor do Service Usage (
roles/serviceusage.serviceUsageConsumer).
Como alternativa, para controlar as permissões do IAM de maneira granular, use uma função personalizada com as permissões a seguir em vez do papel de Admin da conta de faturamento. Conceda as permissões nos recursos listados na tabela.
Recurso Serviço Permissões Conta do Cloud Billing Cloud Billing billing.billingAccountPrices.listConta do Cloud Billing Compras do consumidor consumerprocurement.orders.get
consumerprocurement.orders.place
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.unassign
consumerprocurement.licensePools.enumerateLicensedUsersConta do Cloud Billing Discovery Engine discoveryengine.billingAccountLicenseConfigs.distribute
discoveryengine.billingAccountLicenseConfigs.get
discoveryengine.billingAccountLicenseConfigs.list
discoveryengine.billingAccountLicenseConfigs.retractProjeto Discovery Engine 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.listUserLicensesProjeto Resource Manager resourcemanager.projects.get
resourcemanager.projects.listProjeto Service Usage serviceusage.services.get
serviceusage.services.list
Comprar uma assinatura
Para receber licenças, compre uma assinatura de uma edição do Gemini Enterprise para sua conta de faturamento. A assinatura oferece um pool de licenças que você distribui para projetos e atribui a usuários. É possível distribuir licenças de uma assinatura baseada em licença, como o Gemini Enterprise Standard ou Plus, para projetos vinculados a qualquer conta de faturamento. Só é possível distribuir licenças de uma assinatura de pagamento por uso para projetos vinculados à conta de faturamento que é proprietária da assinatura.
Standard e Plus
Para assinar a edição Gemini Enterprise Standard ou Plus, faça o seguinte:
No console do Google Cloud , acesse a página Gemini Enterprise > Planos e faturamento.
No menu suspenso Conta de faturamento selecionada, selecione sua conta de faturamento.
Clique em Criar assinatura.
Para a edição Gemini Enterprise Standard ou Gemini Enterprise Plus, clique em Assinar.
Configure os Detalhes de faturamento:
- Confirme ou selecione a Conta de faturamento no menu suspenso.
- Insira um Nome da assinatura.
- Digite o Número de licenças necessárias para a edição.
Selecione um Período de assinatura.
Se você quiser que a assinatura seja renovada automaticamente, marque a caixa de seleção Renovar assinatura automaticamente.
Configure os Detalhes da distribuição:
- No campo Projeto, insira um ID do projeto e selecione um projeto nas opções de correspondência. Se o console solicitar, ative as APIs necessárias.
- Escolha um Local para sua assinatura. Se você não tiver motivos regulamentares ou de compliance para localizar seus dados nas multirregiões dos EUA ou da UE, o Google recomenda que você escolha a multirregião global para máxima disponibilidade e baixa latência.
Clique em Criar > Confirmar.
Pagamento por uso
Com uma assinatura de pagamento por uso, você paga mensalmente pelo que consome. Para mais informações, consulte Cotas e preços da edição de pagamento por uso. É possível usar a assinatura com qualquer projeto conectado à sua conta de faturamento.
Para assinar a edição de pagamento por uso do Gemini Enterprise, faça o seguinte:
No console do Google Cloud , acesse a página Gemini Enterprise > Planos e faturamento.
No menu suspenso Conta de faturamento selecionada, selecione sua conta de faturamento.
Clique em Criar assinatura.
Na edição Pagamento por uso do Gemini Enterprise, clique em Criar plano.
Configure os Detalhes de faturamento:
- Confirme ou selecione a Conta de faturamento no menu suspenso.
- Insira um Nome da assinatura.
- Insira o Número de licenças de pagamento por uso necessárias para a edição.
Configure os Detalhes da distribuição:
- No campo Projeto, insira um ID do projeto e selecione um projeto nas opções de correspondência. Se o console solicitar, ative as APIs necessárias.
- Escolha um Local para sua assinatura. Se você não tiver motivos regulamentares ou de compliance para localizar seus dados nas multirregiões dos EUA ou da UE, o Google recomenda que você escolha a multirregião global para máxima disponibilidade e baixa latência.
Clique em Criar > Confirmar.
Se o projeto estiver vinculado a uma conta de autoatendimento (on-line) do Cloud Billing, a janela Comprar créditos será aberta. Selecione um valor e uma forma de pagamento e conclua a compra. Se quiser, configure a recarga automática.
Se você ainda não tiver configurado créditos pré-pagos na conta de faturamento, compre créditos. Se você cancelar, não vai criar uma assinatura e o Google não vai cobrar você. Para mais informações, consulte Gerenciar créditos pré-pagos.
Gerenciar assinaturas
Nesta seção, descrevemos como visualizar, atualizar, distribuir e recuperar assinaturas do Gemini Enterprise.
Ver detalhes da assinatura
Para ver os detalhes das suas assinaturas do Gemini Enterprise, faça o seguinte:
Console
No console do Google Cloud , acesse a página Gemini Enterprise > Planos e faturamento.
No menu suspenso Conta de faturamento selecionada, selecione sua conta de faturamento.
Na tabela Assinaturas do Gemini, clique no nome da sua assinatura para abrir a página Detalhes da assinatura.
REST
Para ver os detalhes da assinatura, execute o seguinte 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"
Substitua:
PROJECT_NUMBER: o número ou ID do projeto que você usa para atribuir faturamento e cota a essa chamada de API. Você precisa ter o papel de consumidor do Service Usage neste projeto.BILLING_ACCOUNT_ID: ID da sua conta de faturamento do Google Cloud .
Exemplo de saída
{
"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
}]
}
Atualizar as configurações de assinatura
Depois de criar uma assinatura, é possível atualizar as configurações, como a contagem de licenças ou a configuração de renovação automática.
O método para adicionar mais licenças depende de como você comprou sua assinatura:
- Se você comprou sua assinatura pelo console do Google Cloud , adicione mais licenças diretamente no console do Google Cloud seguindo as etapas desta seção.
- Se você comprou usando um formulário de pedido off-line, atualize o formulário de pedido com a nova contagem de licenças. Entre em contato com seu gerente de contas do Google para atualizar o formulário de pedido.
Para atualizar a contagem de licenças ou as configurações de renovação se você comprou sua assinatura pelo console do Google Cloud , faça o seguinte:
No console do Google Cloud , acesse a página Gemini Enterprise > Planos e faturamento.
No menu suspenso Conta de faturamento selecionada, selecione sua conta de faturamento.
Na tabela Assinaturas do Gemini, clique no nome da sua assinatura para abrir a página Detalhes da assinatura.
Na página Detalhes da assinatura, clique em Editar.
No painel Editar assinatura, insira um novo valor no campo Número de licenças ou marque ou desmarque a caixa de seleção Renovação automática.
Clique em Enviar.
Cancelar uma assinatura
Para cancelar uma assinatura do Gemini Enterprise, desative a renovação automática. Sua assinatura vai continuar ativa até o fim do período, e o Google poderá fazer cobranças até essa data. Para saber mais, confira os detalhes da assinatura.
Para cancelar sua assinatura, faça o seguinte:
No console do Google Cloud , acesse a página Gemini Enterprise > Planos e faturamento.
No menu suspenso Conta de faturamento selecionada, selecione sua conta de faturamento.
Na tabela Assinaturas do Gemini, clique no nome da sua assinatura para abrir a página Detalhes da assinatura.
Na página Detalhes da assinatura, clique em Editar.
No painel Editar assinatura, desmarque a caixa de seleção Renovação automática.
Clique em Enviar.
Distribuir licenças
Se você não tiver distribuído as licenças de assinatura para um projeto, o que pode acontecer quando você compra a assinatura off-line ou quando uma tentativa anterior de distribuir licenças falha, faça o seguinte:
Console
No console do Google Cloud , acesse a página Gemini Enterprise > Planos e faturamento.
No menu suspenso Conta de faturamento selecionada, selecione sua conta de faturamento.
Na tabela Assinaturas do Gemini, clique no nome da sua assinatura para abrir a página Detalhes da assinatura.
Na página Detalhes da assinatura, clique em Distribuir licenças.
O painel Distribuir licenças é aberto, mostrando as alocações de licenças de projeto atuais, além das contagens de Licenças disponíveis e Total de licenças.
Para distribuir licenças para um projeto:
- No campo Selecionar um projeto, insira um ID do projeto e selecione um projeto nas opções de correspondência.
- Se uma caixa de diálogo solicitar a ativação da API Discovery Engine para o projeto selecionado, clique para ativá-la.
- No menu suspenso Região, selecione uma região.
- No campo Contagem de licenças, insira o número de licenças a serem alocadas.
- Opcional: para alocar licenças para outros projetos ou regiões, clique em Adicionar distribuição de licenças e repita as etapas.
Clique em Enviar.
Na caixa de diálogo Confirmar distribuição de licenças, clique em Enviar.
REST
Para distribuir licenças para um ou mais projetos, execute o seguinte 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"
Substitua:
PROJECT_NUMBER: o número ou ID do projeto que você usa para atribuir faturamento e cota a essa chamada de API. Você precisa ter o papel de consumidor do Service Usage neste projeto. É possível usarTARGET_PROJECT_NUMBERse você tiver ativado o Discovery Engine nesse projeto.ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:uspara a multirregião dos EUAeupara a multirregião da UEglobalpara o local global
LOCATION: a multirregião do seu repositório de dados:global,usoueu.TARGET_PROJECT_NUMBER: o número do projeto para o qual você quer distribuir licenças.LICENSE_COUNT: o número de licenças a serem distribuídas.BILLING_ACCOUNT_ID: ID da sua conta de faturamento do Google Cloud .BILLING_ACCOUNT_LICENSE_CONFIG_ID: localize o ID da configuração de licença da conta de faturamento nos detalhes da assinatura.Opcional
LICENSE_CONFIG_ID: o ID de uma configuração de licença para envolvidos no projeto. É possível encontrar esse ID no campolicenseConfigDistributionsao visualizar os detalhes da assinatura.
Recuperar licenças não atribuídas em uma assinatura
Nesta seção, descrevemos como recuperar licenças não atribuídas de um projeto, disponibilizando-as na conta de faturamento para redistribuição para outros projetos.
Console
No console do Google Cloud , acesse a página Gemini Enterprise > Planos e faturamento.
No menu suspenso Conta de faturamento selecionada, selecione sua conta de faturamento.
Na tabela Assinaturas do Gemini, clique no nome da sua assinatura para abrir a página Detalhes da assinatura.
Na página Detalhes da assinatura, clique em Distribuir licenças.
Na lista de alocações, localize a linha do projeto e da região de onde você quer recuperar as licenças.
Escolha uma das seguintes ações:
- Para reduzir o número de licenças, diminua a contagem no campo Contagem de licenças.
- Para recuperar todas as licenças da linha, mova o ponteiro sobre a linha e clique em Excluir item.
Clique em Enviar.
Na caixa de diálogo Confirmar distribuição de licenças, leia o aviso de que as revogações de licença são limitadas a uma vez ao dia e clique em Enviar.
REST
Para transferir as licenças de assinatura de volta para a conta de faturamento e redistribuí-las, execute o seguinte 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"
Substitua:
PROJECT_NUMBER: o número ou ID do projeto que você usa para atribuir faturamento e cota a essa chamada de API. Você precisa ter o papel de consumidor do Service Usage neste projeto. É possível usarTARGET_PROJECT_NUMBERse você tiver ativado o Discovery Engine nesse projeto.ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:uspara a multirregião dos EUAeupara a multirregião da UEglobalpara o local global
LOCATION: a multirregião do seu repositório de dados:global,usoueu.TARGET_PROJECT_NUMBER: o número do projeto de que você quer recuperar licenças. Este é o projeto em que você alocou as licenças.LICENSE_COUNT: o número de licenças a serem recuperadas.BILLING_ACCOUNT_ID: ID da sua conta de faturamento do Google Cloud .BILLING_ACCOUNT_LICENSE_CONFIG_ID: localize o ID da configuração de licença da conta de faturamento nos detalhes da assinatura.LICENSE_CONFIG_ID: o ID da configuração de licença de uma configuração de licença para envolvidos no projeto.
Processar rescisão antecipada
Quando você migra entre diferentes tipos de assinatura ou se sua conta de faturamento tem um problema, uma assinatura pode terminar antes do planejado.
Para garantir uma transição mais tranquila e evitar interrupções no serviço, oferecemos um período de carência de uma semana (sete dias) em que as licenças afetadas ficam em um estado de desativação antes de expirarem totalmente. Durante esse período de carência, você pode continuar usando o serviço enquanto faz a transição para uma nova assinatura.
Para garantir que os usuários mantenham o acesso, transfira as licenças deles para uma nova assinatura ativa, de forma automática ou manual.
A imagem a seguir mostra um exemplo de licença de desativação no console doGoogle Cloud :

Gerenciar licenças de usuários
Esta seção descreve como visualizar licenças, exportar dados do usuário e atribuir, transferir e remover licenças de usuários individuais.
Ver as licenças
Para ver as licenças e os usuários atribuídos a elas, faça o seguinte:
No console Google Cloud , acesse a página Gemini Enterprise.
Clique em Gerenciar usuários.
Selecione a Multirregião da licença atual.
Exportar dados do usuário
A tabela de usuários no console do Google Cloud não é compatível com classificação ou filtragem. Se você precisar classificar, filtrar ou analisar os dados dos usuários, poderá exportar até 1.000.000 de registros de usuários para um arquivo de valores separados por vírgulas (CSV).
O arquivo CSV exportado inclui as seguintes colunas.
| Nome da coluna | Descrição |
|---|---|
user_principal |
O endereço de e-mail do usuário. |
license_config |
O nome completo do recurso Google Cloud da assinatura atribuída ao usuário (por exemplo, projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). O ID de configuração da licença corresponde à edição do Gemini Enterprise (por exemplo, Standard ou Plus) que um administrador atribuiu ao usuário.
|
assignment_time |
O carimbo de data/hora (em UTC) de quando um administrador atribuiu a licença. |
last_login_time |
A marcação de tempo (em UTC) do último acesso em do usuário. |
license_assignment_state
|
O estado da atribuição de licença. Os seguintes valores estão disponíveis:
|
Para exportar dados do usuário para um arquivo CSV, faça o seguinte:
No console do Google Cloud , acesse a página Gemini Enterprise > Gerenciar usuários.
Selecione a Multirregião da licença atual.
Na seção Usuários, clique em Exportar todos os usuários.
Dependendo do tamanho da tabela de usuários, a exportação dos dados pode levar até 2,5 minutos. Durante esse período, o console mostra um estado de carregamento. Quando a exportação terminar, o navegador vai baixar o arquivo CSV para o local de download padrão.
Resolver problemas de exportação
A tabela a seguir lista problemas comuns ao exportar dados do usuário e as resoluções deles.
| Problema | Resolução |
|---|---|
| O botão Exportar todos os usuários fica oculto. | Verifique se você atribuiu licenças aos usuários na multirregião selecionada. Se nenhum usuário tiver licenças atribuídas, o botão Exportar todos os usuários não vai aparecer. |
| A solicitação de exportação falha com um erro de limite excedido | Se a lista de usuários exceder o limite de exportação de 1.000.000 de usuários, o console do Google Cloud vai rejeitar a solicitação de exportação e exibir uma mensagem de erro de limite excedido. |
| A solicitação de exportação falha com um erro de permissão negada. |
Verifique se sua conta tem o papel
Administrador do Gemini Enterprise,
que inclui a permissão
discoveryengine.userStores.listUserLicenses necessária.
|
Atribuir licenças aos usuários
Nesta seção, explicamos como atribuir licenças de forma automática ou manual a novos usuários. Você pode atribuir uma licença a um novo usuário a qualquer momento. Depois disso, o usuário poderá acessar o Gemini Enterprise imediatamente.
Adicionar usuários e atribuir licenças automaticamente
Para atribuir licenças aos usuários automaticamente quando eles fizerem login no app do Gemini Enterprise, faça o seguinte:
No console Google Cloud , acesse a página Gemini Enterprise.
Clique em Gerenciar usuários.
Selecione a Multirregião da licença atual.
Selecione Atribuir licenças automaticamente e escolha a assinatura.
Sempre que um usuário sem uma licença atribuída manualmente fizer login, o Gemini Enterprise vai atribuir automaticamente uma licença dessa assinatura. Se não houver mais licenças na assinatura, o Gemini Enterprise vai mostrar aos usuários uma mensagem informando que eles não têm acesso.
Para mais informações sobre assinaturas, consulte a seção Sobre assinaturas.
Adicionar usuários e atribuir licenças manualmente
Para dar acesso ao Gemini Enterprise a usuários específicos, atribua manualmente licenças de uma assinatura ativa.
Console
Para atribuir licenças manualmente aos usuários, faça o seguinte:
No console Google Cloud , acesse a página Gemini Enterprise.
Clique em Gerenciar usuários.
Selecione a Multirregião da licença atual.
Clique em Add users.
Na página Adicionar usuários:
Insira os endereços de e-mail dos usuários. Use o mesmo endereço de e-mail que eles vão usar para fazer login no app Gemini Enterprise.
Selecione a assinatura que será atribuída a esses usuários.
Clique em Enviar.
REST
Para atribuir licenças manualmente aos usuários, execute o seguinte 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
}'
Substitua:
PROJECT_ID: ID do projeto.ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:uspara a multirregião dos EUAeupara a multirregião da UEglobalpara o local global
LOCATION: a multirregião do seu repositório de dados:global,usoueuUSER_EMAIL: o endereço de e-mail do usuário que você quer adicionar à licença.PROJECT_NUMBER: o número do projeto do Google Cloud .SUBSCRIPTION_ID: o ID da sua assinatura do Gemini Enterprise.
Transferir licenças de assinaturas expiradas
Os usuários não poderão fazer login no Gemini Enterprise se a assinatura tiver expirado. É possível restaurar o acesso por login de duas maneiras:
Transferir automaticamente os usuários com licenças expiradas para a assinatura padrão.
Transferir manualmente os usuários atuais para uma nova assinatura.
Transferir usuários automaticamente para uma assinatura ativa
Para transferir usuários automaticamente para uma assinatura ativa, faça o seguinte:
No console do Google Cloud , acesse a página Gemini Enterprise > Gerenciar usuários.
Selecione a Multirregião da licença atual.
Confira se você tem uma assinatura ativa. Se você não tiver uma, faça uma assinatura.
Selecione Atribuir licenças automaticamente e escolha a assinatura ativa.
Selecione Atualizar automaticamente a licença expirada.
Quando um usuário com uma licença expirada fizer login, o Gemini Enterprise vai conceder automaticamente uma licença na assinatura escolhida.
Transferir usuários manualmente para uma assinatura ativa
Para transferir usuários manualmente para uma assinatura ativa, faça o seguinte:
No console do Google Cloud , acesse a página Gemini Enterprise > Gerenciar usuários.
Selecione a Multirregião da licença atual.
Confira se você tem uma assinatura ativa. Se você não tiver uma, faça uma assinatura.
Selecione os usuários e clique em Atribuir outra licença.
No painel Editar usuários, selecione a assinatura e clique em Enviar.
Listar as licenças
Para listar as licenças e os usuários a quem você as atribuiu, execute o seguinte 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"
Substitua:
PROJECT_ID: ID do projeto.ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:uspara a multirregião dos EUAeupara a multirregião da UEglobalpara o local global
LOCATION: a multirregião do seu repositório de dados:global,usoueu
Remover usuários de uma licença
Você pode remover a licença de um usuário a qualquer momento. Quando você remove uma licença, o usuário perde imediatamente o acesso ao Gemini Enterprise. Para remover usuários de uma licença, faça o seguinte:
Console
Para remover usuários de uma licença usando o console do Google Cloud , faça o seguinte:
No console do Google Cloud , acesse a página Gemini Enterprise > Gerenciar usuários.
Selecione a Multirregião da licença atual.
Na tabela de usuários, selecione os usuários.
Para remover usuários de uma licença, escolha uma das seguintes opções:
- Para remover apenas a licença dos usuários selecionados, clique em Cancelar atribuição da licença.
- Para remover a licença e também excluir os usuários selecionados do projeto, clique em Cancelar atribuição e excluir licença.
Clique em Confirmar.
REST
Para remover usuários de uma licença, execute o seguinte 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
}'
Substitua:
PROJECT_ID: ID do projeto.ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:uspara a multirregião dos EUAeupara a multirregião da UEglobalpara o local global
LOCATION: a multirregião do seu repositório de dados:global,usoueuUSER_EMAIL: o endereço de e-mail do usuário que você quer remover da licença.
A seguir
- Saiba mais nas perguntas frequentes sobre as licenças do Gemini Enterprise.
- Saiba mais sobre papéis e permissões do IAM.