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 pelo endereço de e-mail.

• Licenças atribuídas automaticamente:você pode escolher que as licenças de uma assinatura sejam atribuídas automaticamente a um usuário na primeira vez que ele acessar a interface do Gemini Enterprise ou do NotebookLM Enterprise.

Observação: as licenças são específicas de um Google Cloud projeto e um local. Por exemplo, se os usuários precisarem de acesso a um app do Gemini Enterprise localizado em um projeto Google Cloud que está nas multirregiões dos EUA e global, você precisará ter duas licenças separadas para esses dois locais diferentes no mesmo projeto Google Cloud .

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 para a 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.

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 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 período 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.

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

    • Administrador da conta de faturamento (roles/billing.admin)
    • Consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer)

    Como alternativa, para um controle granular do IAM, use uma função personalizada com as seguintes permissões em vez da função 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 adquirir licenças para seus usuários, primeiro compre uma assinatura de uma edição do Gemini Enterprise para sua conta de faturamento. A assinatura fornece o pool de licenças que você pode distribuir para projetos e atribuir a usuários.

Para assinar o 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 que você quer assinar, 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 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.

Gerenciar assinaturas

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

Ver detalhes das assinaturas

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 licença se você comprou pelo console Google 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.

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:

Observação:uma assinatura do Gemini Enterprise Standard ou Plus também dá acesso aos recursos do Gemini Code Assist Standard em ambientes de desenvolvimento integrado compatíveis. Você precisa atribuir essas licenças separadamente nas páginas de administrador do Gemini Code Assist. Siga as instruções em Configurar o Gemini Code Assist.

Esse recurso não está incluído nos níveis Business ou Frontline. Para mais informações sobre os recursos incluídos em cada nível, consulte Comparar edições do Gemini Enterprise.

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 a API Discovery Engine estiver desativada no 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 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 para 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 em que você quer distribuir as 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 conferir os detalhes da assinatura.

  Observação: se você omitir o LICENSE_CONFIG_ID desta solicitação de API, uma nova configuração de licença será criada para o número e o local especificados do projeto. Para atualizar uma configuração de licença, inclua o LICENSE_CONFIG_ID.

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

Observação: só é possível realizar essa ação uma vez por dia.

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 revogar totalmente as licenças, mova o ponteiro sobre a linha para mostrar 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 revogadas) e clique para confirmar.

REST

Observação: só é possível realizar essa ação uma vez por dia.

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 no nível do 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 no serviço, oferecemos um período de carência de uma semana (sete dias) em que as licenças afetadas ficam em 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 :

Gerenciar licenças de usuários

Esta seção descreve como visualizar, 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.

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:

Observação: verifique se sua assinatura tem licenças suficientes para o número máximo de usuários que vão usar o Gemini Enterprise.

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.

   Uma licença dessa assinatura é atribuída sempre que um usuário sem uma licença atribuída manualmente faz login. Se não houver mais licenças na assinatura, os usuários vão receber uma mensagem informando que 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. Digite 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:

Termo-chave:no Gemini Enterprise, o termo app pode ser usado de forma intercambiável com o termo mecanismo no contexto das APIs. Um mecanismo do Gemini Enterprise é um mecanismo de pesquisa genérico em que o campo app_type está definido como APP_TYPE_INTRANET.

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":{
         "paths":[
            "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 automaticamente os usuários atuais com licenças expiradas para a assinatura padrão.

• Transfira manualmente os usuários atuais para uma nova assinatura.

Observação: se um usuário foi bloqueado anteriormente para acessar uma licença, o acesso ao Gemini Enterprise será concedido em até 30 minutos após a atribuição da nova licença.

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, assine.

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, ele vai receber 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, assine.

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:

Termo-chave:no Gemini Enterprise, o termo app pode ser usado de forma intercambiável com o termo mecanismo no contexto das APIs. Um mecanismo do Gemini Enterprise é um mecanismo de pesquisa genérico em que o campo app_type está definido como APP_TYPE_INTRANET.

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 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 console Google Cloud , 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:

Termo-chave:no Gemini Enterprise, o termo app pode ser usado de forma intercambiável com o termo mecanismo no contexto das APIs. Um mecanismo do Gemini Enterprise é um mecanismo de pesquisa genérico em que o campo app_type está definido como APP_TYPE_INTRANET.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask":{
         "paths":[
            "userPrincipal",
            "licenseConfig"
         ]
      }
   },
   "deleteUnassignedUserLicenses":true
  }'

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.

Conferir o uso da cota agrupada (prévia pública)

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Visão geral das cotas agrupadas do Gemini Enterprise

No Gemini Enterprise, as cotas de recursos (como geração de respostas, ações e uso de agentes) são compartilhadas entre todos os usuários de um projeto do Google Cloud . Esse compartilhamento de cota também é chamado de agrupamento. Em vez de cada usuário ter um limite separado e individual para o consumo de recursos, os limites são combinados em um único pool em todo o projeto. As cotas são agrupadas por edição. Por exemplo, os usuários com licenças do Gemini Enterprise Plus compartilham um pool de cotas, enquanto os usuários com licenças do Gemini Enterprise Frontline compartilham um pool separado.

Por exemplo, a tabela a seguir mostra como a cota de geração de imagens é agrupada para a edição Gemini Enterprise Plus:

Tipo de cota	Limite por licença	Exemplo de total (para 100 licenças)
Geração de imagens	10 imagens por dia	1.000 imagens por dia

Essa cota agrupada pode ser usada por qualquer usuário no projeto.

Antes de começar

Só é possível acessar o painel de uso de cota se as seguintes condições forem verdadeiras:

• Você é administrador do Gemini Enterprise.
• Você tem pelo menos uma assinatura ativa do Gemini Enterprise Standard, Gemini Enterprise Plus ou Gemini Enterprise Frontline.

Se você tiver uma assinatura ativa do Agentspace, só poderá acessar o painel de uso da cota se também tiver uma assinatura ativa do Gemini Enterprise. Nesse caso, o painel mostra as cotas combinadas das suas assinaturas do Agentspace e do Gemini Enterprise da seguinte forma:

• As cotas do Gemini Enterprise Plus incluem as do Agentspace Enterprise Plus
• As cotas do Gemini Enterprise Standard incluem as do Agentspace Enterprise
• As cotas do Gemini Enterprise Frontline incluem as cotas do Agentspace Frontline Worker

Não é possível acessar o painel de uso de cota se você tiver apenas uma assinatura do Agentspace e nenhuma assinatura ativa do Gemini Enterprise.

Acessar o painel de uso da cota

Como administrador do Gemini Enterprise, para conferir o uso da cota agrupada no seu projeto, 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 das licenças.

3. Clique em Ver uso da cota.

4. No painel Uso da cota do Gemini Enterprise que é aberto, selecione a edição do produto na lista Nível de assinatura.

   O painel preenche as cotas e mostra o uso absoluto e percentual de cada uma delas.

A seguir

• Confira as perguntas frequentes sobre as licenças do Gemini Enterprise.
• Saiba mais sobre papéis e permissões do IAM.