Adquirir licenças do Gemini Enterprise

Esta página descreve como adquirir assinaturas do Gemini Enterprise e atribuir licenças aos usuários.

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.

As licenças são específicas para multirregiões. Por exemplo, se os usuários quiserem acesso a apps na multirregião us e em global, atribua uma licença em cada uma delas.

Sobre as assinaturas

Para receber licenças, primeiro você precisa ter uma assinatura de uma edição do Gemini Enterprise. Para informações sobre as edições disponíveis, consulte Comparar as edições do Gemini Enterprise.

As assinaturas são específicas de cada região. Os usuários que criam apps na região global precisam de licenças de uma assinatura do global. Da mesma forma, os usuários que precisam manter os apps e dados na União Europeia precisam de licenças de uma assinatura do eu.

No Gemini Enterprise, você pode comprar uma assinatura mensal ou anual. Essas assinaturas podem ser configuradas para renovação automática.

Antes de começar

Antes de iniciar os procedimentos desta página, verifique se:

  • Você concluiu as tarefas em Configurar o Gemini Enterprise. Isso inclui configurar uma conta de faturamento para seu projeto e conceder pelo menos a função Discovery Engine User a todos os usuários que você vai licenciar para usar o Gemini Enterprise.

  • Você tem o papel de administrador do Discovery Engine.

Assinar

Para assinar o Gemini Enterprise, faça o seguinte:

  1. No console Google Cloud , acesse a página do 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.

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.

  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.

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:

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/global/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/global/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. Atribua 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.

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.

    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.

Transferir licenças de assinaturas expiradas

Os usuários não podem fazer login no Gemini Enterprise se a assinatura expirar. Há algumas abordagens para devolver o acesso de login a elas:

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 manualmente usuários 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:

REST

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

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:

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