Adquirir licenças do Gemini Enterprise

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

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 adquirir 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 mais 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.

Antes de começar

Antes de iniciar os procedimentos nesta 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.

• Para gerenciar assinaturas, você precisa ter a função de administrador da conta de faturamento. Para mais informações sobre como encontrar administradores, consulte Encontrar um administrador da conta de faturamento.

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.

Distribuir licenças

Se as licenças assinadas não forem distribuídas a um projeto, o que pode acontecer quando a assinatura é comprada off-line ou quando a distribuição de licenças falhou anteriormente, faça o seguinte:

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ças ao lado de Detalhes da assinatura.

6. Configure os detalhes de Distribuir licenças:

   1. No menu suspenso Selecionar um projeto, escolha seu projeto.

   2. Escolha um local para sua assinatura. Se você não tiver motivos regulamentares ou de compliance para localizar seus dados nas multirregiões dos EUA ou da UE, o Google recomenda escolher a multirregião global para ter disponibilidade máxima e baixa latência.

7. Clique em Enviar.

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.

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. 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 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 de login a elas:

• Transferir automaticamente os usuários atuais com licenças expiradas para a assinatura padrão.

• Transferir 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, 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, 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, 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:

REST

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

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

• Saiba mais sobre papéis e permissões do IAM.