Receber assinaturas e atribuir licenças do Gemini Enterprise

Nesta página, descrevemos como adquirir assinaturas do Gemini Enterprise e gerenciar licenças de usuário.

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

  1. Procurar: compre uma assinatura de uma edição do produto para sua conta de faturamento.
  2. Distribuir: aloca 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 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:você pode adicionar usuários pelos endereços de e-mail deles.

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

No 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 consoleGoogle Cloud .

Limites de quantidade de licenças de assinatura

Ao comprar ou modificar uma assinatura baseada em licenças diretamente no console Google Cloud , os limites automáticos de quantidade de licenças são aplicados com base no tipo 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 Google Cloud .
  • Contas de faturamento faturadas (ou off-line):limitadas a um máximo de 1.000 licenças por conta.

Se a sua 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 seu Google Cloud representante de vendas ou gerente de contas para comprar mais licenças com um pedido off-line ou solicitar uma exceção da lista de permissões.

Sobre os estados das assinaturas

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 elas 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 que têm uma licença nela podem acessar o Gemini Enterprise.
Desativando A assinatura está em estado de desativação, com licenças programadas para rescisão antecipada. Os usuários com licenças nessa assinatura vão continuar tendo acesso ao Gemini Enterprise por um período de carência de uma semana. Após essa semana, as licenças vão passar para o estado "Expirado". Para mais informações, consulte Processar encerramento antecipado.
Expirado Os usuários com licenças nessa assinatura perdem o acesso ao Gemini Enterprise quando o prazo da assinatura termina ou quando as licenças passam do estado de desativação para o estado expirado 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 seu projeto.
    • Conceder pelo menos a função de usuário do Gemini Enterprise a todos os usuários que você vai licenciar para usar o Gemini Enterprise.

  • Verifique se o faturamento está ativado para o projeto Google Cloud . Para mais informações, consulte Verificar se o faturamento está ativado no seu projeto Google Cloud .

  • Confirme se você tem os papéis e as permissões necessárias do IAM:

    • A função de administrador do Gemini Enterprise.

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

      Como alternativa, para um controle granular do IAM, use um papel personalizado com as seguintes permissões em vez do papel Administrador 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

Assinar

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 as edições Standard ou Plus 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. 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 que você precisa para a edição.

  5. Selecione o Período de assinatura.

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

  7. Configure os Detalhes da distribuição:

    1. No menu suspenso Selecionar 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 escolher a multirregião global para ter disponibilidade máxima 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 nas taxas listadas em Excedentes. É possível usar a assinatura com qualquer projeto conectado à sua conta de faturamento.

Para assinar a edição do Gemini Enterprise com pagamento por uso, 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 que você precisa para a edição.

  5. Configure os Detalhes da distribuição:

    1. No menu suspenso Selecionar 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 escolher a multirregião global para ter disponibilidade máxima e baixa latência.

  6. Clique em Criar > Confirmar.

Gerenciar assinaturas

Nesta seção, descrevemos como ver, atualizar, distribuir e recuperar assinaturas do Gemini Enterprise.

Ver detalhes da assinatura

Para conferir 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 do projeto em que você tem a função de consumidor do Service Usage
  • BILLING_ACCOUNT_ID: ID da sua Google Cloud conta de faturamento.

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 originalmente:

  • Se você comprou sua assinatura pelo console Google Cloud , adicione mais licenças diretamente no console Google Cloud seguindo as etapas desta seção.
  • Se você fez a compra 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ê fez a compra pelo consoleGoogle 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 ou 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 prazo, e você poderá receber cobranças até essa data. Para saber mais sobre sua assinatura, consulte Ver 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 Renovar assinatura automaticamente.

  6. Clique em Enviar.

Distribuir licenças

Se você não distribuiu 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 falhou anteriormente, 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 aparece mostrando as distribuições de licenças e as estatísticas de assentos restantes e totais.

  6. Para distribuir licenças a um projeto:

    1. Clique no seletor de projetos para escolher um projeto. O seletor tem 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ê faça isso.
    3. Selecione um local.
    4. Insira o número de licenças a serem alocadas.
    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 a um ou vários 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 do projeto em que você tem a função de consumidor do Service Usage
  • 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 Google Cloud conta de faturamento.
  • 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. Você pode encontrar esse ID no campo licenseConfigDistributions ao ver 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 a 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 para todas as alocações.

  6. Na lista de alocações, localize a linha do projeto e do local de que 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 todas 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 do projeto em que você tem a função de consumidor do Service Usage
  • 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 as licenças.
  • LICENSE_COUNT: o número de licenças a serem recuperadas.
  • BILLING_ACCOUNT_ID: ID da sua Google Cloud conta de faturamento.
  • 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 previsto.

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 completamente. Durante esse período, 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 para uma assinatura nova e ativa automaticamente ou manualmente.

A imagem a seguir mostra um exemplo de uma licença sendo desativada no console doGoogle Cloud :

Exemplo de desativação de uma licença no console Google 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 conferir 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, exporte até 1 milhão de registros para um arquivo de valores separados por vírgula (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 da configuração de 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) em que um administrador atribuiu a licença.
last_login_time O carimbo de data/hora (em UTC) em que o usuário fez login pela última vez.
license_assignment_state O estado da atribuição de licença. Estes são os valores 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 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. 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 respectivas soluções.

Problema Resolução
O botão Exportar todos os usuários está 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 Google Cloud vai rejeitar a solicitação de exportação e mostrar 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 a novos usuários de forma automática ou manual. Você pode atribuir uma licença a um novo usuário a qualquer momento. Depois que uma licença é atribuída, o usuário pode acessar o Gemini Enterprise imediatamente.

Adicionar usuários e atribuir licenças automaticamente

Para atribuir licenças aos usuários automaticamente quando eles fazem login no app 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.

    Cada vez que um usuário sem uma licença atribuída manualmente faz login, o Gemini Enterprise atribui automaticamente uma licença da 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 licenças manualmente 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 Gemini Enterprise.

    2. Selecione a assinatura que você quer atribuir 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 seu projeto Google Cloud .
  • SUBSCRIPTION_ID: o ID da sua assinatura do Gemini Enterprise.

Transferir licenças de assinaturas expiradas

Os usuários não podem fazer login no Gemini Enterprise se a assinatura expirou. Há algumas abordagens para devolver o acesso por 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 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 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

É possível remover uma licença de um usuário a qualquer momento. Quando uma licença é removida, o usuário perde o acesso ao Gemini Enterprise imediatamente. Para remover usuários de uma licença, faça o seguinte:

Console

Para remover usuários de uma licença usando o Google Cloud console, faça o seguinte:

  1. No console 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 a atribuição da licença.
    • Para remover a licença e excluir os usuários selecionados do projeto, clique em Cancelar a atribuição e excluir a 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