Receber assinaturas e atribuir licenças do Gemini Enterprise

Nesta página, descrevemos como assinar o Gemini Enterprise e como gerenciar licenças de usuário.

A configuração do acesso geralmente envolve as seguintes etapas:

  1. Adquirir: compre uma assinatura de uma edição do produto para sua conta de faturamento.
  2. Distribuir: aloque licenças da assinatura para projetos e locais específicos.
  3. 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 aos usuários 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 a interface do Gemini Enterprise ou do Gemini Notebook Enterprise.

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, você pode comprar uma assinatura mensal ou anual. Essas assinaturas podem ser configuradas para renovação automática.

É possível 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

Ao comprar ou modificar uma assinatura por usuário diretamente no console doGoogle Cloud , limites automáticos de quantidade de usuários são aplicados com base no tipo de conta do Cloud Billing:

  • Contas de faturamento de autoatendimento (ou on-line) e revendidas:limitadas a um máximo de 25 licenças por conta ao gerenciar assinaturas usando o console do Google Cloud .
  • Contas de faturamento faturadas (ou off-line):limitadas a um máximo de 1.000 licenças por conta.

Se a organização precisar de mais licenças ou se você encontrar o erro de limite máximo de licenças 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. Você pode distribuir licenças dessa assinatura para projetos, mas os usuários atribuídos a essas licenças não terão acesso ao 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 com uma licença nela podem acessar o Gemini Enterprise.
Desativando A assinatura está em um estado de desativação, com licenças programadas para rescisão antecipada. Os usuários com licenças nessa assinatura continuam tendo acesso ao Gemini Enterprise por um período de carência de uma semana. Após essa semana, as licenças passam para o estado "Expirado". 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 encerramento antecipado.

Antes de começar

Antes de iniciar os procedimentos nesta página, verifique se você atende aos 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 você licenciar 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.

    • Se você gerencia o faturamento da sua organização, precisa ter os seguintes papéis para gerenciar as assinaturas e os pedidos de compra do Gemini Enterprise.

      Como alternativa, para um controle granular do IAM, use um papel personalizado com as seguintes permissões em vez do papel de Admin da conta de faturamento:

      Serviço Permissões
      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
      Compras do consumidor consumerprocurement.orders.get
      consumerprocurement.licensePools.assign
      consumerprocurement.licensePools.unassign
      consumerprocurement.licensePools.enumerateLicensedUsers
      Resource Manager resourcemanager.projects.get
      resourcemanager.projects.list
      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ê pode usar com qualquer projeto conectado a essa conta de faturamento, distribuir para projetos e atribuir a usuários.

Standard e Plus

Para assinar a edição Gemini Enterprise Standard ou Plus, faça o seguinte:

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar assinaturas > Criar assinatura.

  3. Para a edição Gemini Enterprise Standard ou Gemini Enterprise Plus, clique em Assinar.

  4. Configure os Detalhes de faturamento:

    1. Selecione a Conta de faturamento no menu suspenso.
    2. Insira um Nome da assinatura.
    3. Digite o Número de licenças necessárias para a edição.

  5. Selecione o Período de assinatura.

  6. Se quiser que a assinatura seja renovada automaticamente, selecione Renovar automaticamente a assinatura.

  7. Configure os Detalhes da distribuição:

    1. No menu suspenso Selecione um projeto, escolha seu projeto.
    2. Escolha um Tipo de 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.

  8. 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:

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar assinaturas > Criar assinatura.

  3. Na edição Pagamento por uso do Gemini Enterprise, clique em Assinar.

  4. Configure os Detalhes de faturamento:

    1. Insira um Nome da assinatura.
    2. Digite o Número de licenças necessárias para a edição.

  5. Configure os Detalhes da distribuição:

    1. No menu suspenso Selecione um projeto, escolha seu projeto.
    2. Escolha um Tipo de 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.

  6. Clique em Criar > Confirmar.

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

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar assinaturas.

  3. Selecione a Conta de faturamento no menu suspenso.

  4. Na tabela Assinaturas do Gemini, clique no nome da sua 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 usado para faturamento e atribuição de cota para 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 a 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 com a nova contagem de licenças. Entre em contato com seu gerente de contas do Google para atualizar o formulário de pedido.

Siga estas etapas para atualizar a contagem de licenças se você tiver comprado pelo console doGoogle Cloud :

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar assinaturas.

  3. Clique na assinatura que você quer atualizar na tabela Assinaturas do Gemini.

  4. Clique em Editar ao lado de Detalhes da assinatura.

  5. Atualize a contagem de licenças ou ative/desative a renovação automática.

  6. 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 talvez haja cobranças até essa data. Para saber mais, confira os detalhes da assinatura.

Para cancelar sua assinatura, siga estas etapas:

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar assinaturas.

  3. Na tabela Assinaturas do Gemini, clique no nome da sua assinatura para abrir a página de detalhes.

  4. Clique em Editar.

  5. No painel Editar assinatura, desmarque a caixa de seleção Renovação automática da assinatura.

  6. Clique em Enviar.

Distribuir licenças

Se você não tiver distribuído as licenças assinadas para um projeto, o que pode acontecer quando você compra a assinatura off-line ou quando a distribuição de licenças falha, faça o seguinte:

Console

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar assinaturas.

  3. Selecione a Conta de faturamento no menu suspenso.

  4. Na tabela Assinaturas do Gemini, clique no nome da sua assinatura.

  5. Clique em Distribuir licença na parte de cima da página. Uma lista vai aparecer, mostrando as distribuições de licenças atuais e as estatísticas de vagas restantes e totais.

  6. Para distribuir licenças para um projeto:

    1. Clique no seletor de projetos para escolher um projeto. O seletor é compatível com o preenchimento automático.
    2. Observação: se você não tiver ativado a API Discovery Engine para o projeto selecionado, uma caixa de diálogo vai aparecer solicitando que você a ative.
    3. Selecione um Local.
    4. Insira o número de licenças que você quer alocar.
    5. Repita essas etapas se quiser distribuir licenças para vários projetos ou locais.

  7. Clique em Enviar.

  8. Na caixa de diálogo de confirmação, revise o resumo das mudanças e clique em Confirmar.

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 usado para faturamento e atribuição de cota para essa chamada de API. Você precisa ter o papel de Consumidor do Service Usage neste projeto. É possível usar TARGET_PROJECT_NUMBER se o Discovery Engine estiver ativado no projeto.

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:

    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.

  • LOCATION: a multirregião do seu repositório de dados: global, us ou eu.

  • 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 no nível do projeto. Esse ID está no campo licenseConfigDistributions ao 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

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar assinaturas.

  3. Selecione a Conta de faturamento no menu suspenso.

  4. Na tabela Assinaturas do Gemini, clique no nome da sua assinatura.

  5. Clique em Distribuir licença na parte de cima da página (esse botão abre o formulário de gerenciamento de todas as alocações).

  6. Na lista de alocações, localize a linha do projeto e do local de onde você quer recuperar as licenças.

  7. Escolha uma das seguintes ações:

    • Para reduzir o número de licenças: diminua a contagem no campo de entrada de licenças.
    • Para recuperar totalmente as licenças: mova o ponteiro sobre a linha para revelar o botão de exclusão e clique em Excluir.

  8. Clique em Enviar.

  9. Na caixa de diálogo de confirmação, revise o resumo das mudanças (que vai listar as licenças recuperadas) e clique em Confirmar.

REST

Para transferir as licenças de assinatura de volta para a conta de faturamento para redistribuição, 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 usado para faturamento e atribuição de cota para essa chamada de API. Você precisa ter o papel de Consumidor do Service Usage neste projeto. É possível usar TARGET_PROJECT_NUMBER se o Discovery Engine estiver ativado no projeto.

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:

    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.

  • LOCATION: a multirregião do seu repositório de dados: global, us ou eu.

  • TARGET_PROJECT_NUMBER: o número do projeto de que você quer recuperar licenças. Este é o projeto em que as licenças estão alocadas no momento.

  • 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 há um problema com sua conta de faturamento, uma assinatura pode terminar antes do planejado.

Para garantir uma transição mais tranquila e evitar interrupções de 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 :

Exemplo de desativação de licença no console do Google Cloud

Gerenciar licenças de usuários

Nesta seção, descrevemos como visualizar licenças, exportar dados de usuários 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:

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar usuários.

  3. 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 de recurso Google Cloud completo 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) atribuída ao usuário.
assignment_time O carimbo de data/hora (em UTC) de quando um administrador atribuiu a licença.
last_login_time O carimbo de data/hora (em UTC) do último login do usuário.
license_assignment_state O estado da atribuição de licença. Os seguintes valores estão disponíveis:
  • ASSIGNED: o usuário tem uma licença atribuída.
  • NO_LICENSE: o usuário não tem uma licença porque um administrador não atribuiu uma ou removeu uma licença existente.
  • BLOCKED: uma política ou um administrador impede que o usuário receba uma licença.

Para exportar dados do usuário para um arquivo CSV, faça o seguinte:

  1. No console do Google Cloud , acesse a página Gemini Enterprise > Gerenciar usuários.

    Gerenciar usuários

  2. Selecione a Multirregião da licença atual.

  3. Na seção Usuários, clique em Exportar todos os usuários.

    Dependendo do tamanho da tabela de usuários, o processo de exportação pode levar até 2,5 minutos para ser concluído. Durante esse período, o console exibe um estado de carregamento. Quando a exportação é concluída, o navegador faz o download do 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 há usuários atribuídos a licenças na multirregião selecionada. Se não houver usuários atribuídos, 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 de 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:

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar usuários.

  3. Selecione a Multirregião da licença atual.

  4. 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, você pode atribuir manualmente licenças de uma assinatura ativa.

Console

Para atribuir licenças manualmente aos usuários, faça o seguinte:

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Gerenciar usuários.

  3. Selecione a Multirregião da licença atual.

  4. Clique em Add users.

  5. Na página Adicionar usuários:

    1. 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 do Gemini Enterprise.

    2. Selecione a assinatura que será atribuída a esses usuários.

    3. 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:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • LOCATION: a multirregião do seu repositório de dados: global, us ou eu
  • USER_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. Há algumas abordagens para devolver o acesso de login a eles:

Transferir usuários automaticamente para uma assinatura ativa

Para transferir usuários automaticamente para uma assinatura ativa, faça o seguinte:

  1. No console do Google Cloud , acesse a página Gemini Enterprise > Gerenciar usuários.

    Licença do Gemini Enterprise

  2. Selecione a Multirregião da licença atual.

  3. Confira se você tem uma assinatura ativa. Se você não tiver uma, faça uma assinatura.

  4. Selecione Atribuir licenças automaticamente e escolha a assinatura ativa.

  5. 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:

  1. No console do Google Cloud , acesse a página Gemini Enterprise > Gerenciar usuários.

    Licença do Gemini Enterprise

  2. Selecione a Multirregião da licença atual.

  3. Confira se você tem uma assinatura ativa. Se você não tiver uma, faça uma assinatura.

  4. Selecione os usuários e clique em Atribuir outra licença.

  5. 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 atribuídos a elas, 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:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • LOCATION: a multirregião do seu repositório de dados: global, us ou eu

Remover usuários de uma licença

Você pode remover uma licença de um usuário a qualquer momento. Quando uma licença é removida, 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:

  1. No console do Google Cloud , acesse a página Gemini Enterprise > Gerenciar usuários.

    Licença do Gemini Enterprise

  2. Selecione a Multirregião da licença atual.

  3. Na tabela de usuários, selecione os usuários.

  4. 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.

  5. 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:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • LOCATION: a multirregião do seu repositório de dados: global, us ou eu
  • USER_EMAIL: o endereço de e-mail do usuário que você quer remover da licença.

A seguir