Gerenciar licenças do Gemini Code Assist Standard e Enterprise

Antes de usar o Gemini Code Assist Standard e Enterprise, cada usuário na organização precisa de uma licença.

Por padrão, as novas assinaturas exigem que você atribua licenças manualmente. Após configurar determinados produtos do Gemini para Google Cloud , você poderá atribuir licenças de forma manual ou automática.

É possível atribuir licenças a qualquer usuário que tenha um projeto associado à conta de faturamento. Depois disso, o usuário poderá usar o Gemini Code Assist em qualquer projeto.

O plano Google Developer Program Premium inclui uma licença do Gemini Code Assist Standard para os usuários. Não é possível atribuir uma licença do Gemini Code Assist Standard para um usuário que tenha assinatura do Google Developer Program Premium, porque esse programa já disponibiliza uma licença.

Antes de começar

  • Você precisa ter os papéis "Administrador da conta de faturamento" (roles/billing.admin) ou "Administrador de pedidos de compra do consumidor" (roles/consumerprocurement.orderAdmin) do IAM. Eles são necessários para conceder outras permissões na conta de faturamento, exigidas para algumas tarefas de gerenciamento de licenças descritas nas seções abaixo.
  • Se quiser gerenciar licenças usando uma API em vez do console do Google Cloud :

Mudar o número de licenças do Gemini Code Assist Standard e Enterprise em uma assinatura

Você pode adicionar ou remover o número de licenças do Gemini para Google Cloud diretamente no console do Google Cloud . Outra opção é pedir para o representante da sua Conta do Google ou um revendedor autorizado.

Para mudar o número de licenças em uma assinatura:

  1. Você precisa ter as seguintes permissões do Identity and Access Management (IAM) na conta de faturamento proprietária da assinatura:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.orders.modify
    • resourcemanager.projects.get

  2. No console do Google Cloud , acesse a página Admin do Gemini.

    Acesse o Gemini para Google Cloud

  3. Escolha a assinatura que você quer alterar e selecione Modificar assinatura.

  4. Informe o número desejado de licenças. Vão aparecer as seguintes informações:

    • Número total de licenças após a compra.
    • Número de licenças disponíveis para atribuição após a compra.
    • Novo preço da assinatura por período. O valor extra das licenças incluídas é proporcional ao tempo restante do período atual.

  5. Escolha Salvar.

Ver as atribuições de licenças do Gemini Code Assist Standard e Enterprise

Selecione uma destas opções:

Console

  1. Você precisa ter as seguintes permissões do IAM na conta de faturamento proprietária da assinatura:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • resourcemanager.projects.get

  2. Acesse a página Admin do Gemini e selecione o projeto anexado à conta de faturamento com a assinatura do Gemini Code Assist Standard ou Enterprise.

    Acesse o Gemini para Google Cloud

  3. Escolha a assinatura que você quer alterar e selecione Modificar assinatura.

    As seguintes informações estão disponíveis para cada usuário que recebeu uma licença:

    • Nome
    • E-mail
    • Data em que a licença foi atribuída
    • Data e hora em que a licença foi usada pela última vez

  4. Se quiser encontrar um conjunto específico de usuários, filtre e ordene a lista da seguinte maneira:

    • Para filtrar a lista, insira as propriedades e os valores no campo Filtro.
    • Para ordenar a lista, selecione o cabeçalho da coluna que você quer usar como base. Por exemplo, para classificar em ordem alfabética pelos nomes de usuário, escolha o cabeçalho da coluna Nome.

API

Para ver as atribuições de licenças do Gemini Code Assist Standard ou Enterprise, use o método billingAccounts.orders.licensePool.enumerateLicensedUsers.

  1. É necessário ter a permissão consumerprocurement.licensePools.enumerateLicensedUsers do IAM na conta de faturamento que contém o pool de licenças com as atribuições você quer ver.

  2. Use cURL (link em inglês) para chamar o método:

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/"

    Substitua o seguinte:

    • PROJECT_ID: o ID de um projeto. O uso da cota e as cobranças associadas à solicitação de API são aplicados ao projeto.
    • BILLING_ACCOUNT_ID: o ID da conta de faturamento associada ao pool de licenças.
    • ORDER_ID: o código do pedido. Caso você não saiba o código, recupere-o listando os pedidos associados à conta de faturamento.

Se o comando for bem-sucedido, ele vai retornar a saída licensedUsers no seguinte formato:

{
  "licensedUsers": [
      {
          "username": "dana@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "lee@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "taylor@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "bola@example.com",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

Se não houver atribuições de licenças do Gemini Code Assist Standard ou Enterprise ou se o ORDER_ID for inválido, ele vai retornar a saída licensedUsers neste formato:

{}

Atribuir manualmente licenças do Gemini Code Assist Standard e Enterprise a usuários individuais

Selecione uma destas opções:

Console

  1. Você precisa ter as seguintes permissões do IAM na conta de faturamento proprietária da assinatura:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.assign
    • resourcemanager.projects.get

  2. Acesse a página Admin do Gemini.

    Acesse o Gemini para Google Cloud

  3. Selecione Gerenciar o Gemini Code Assist > Modificar assinatura.

  4. Para essa assinatura do Gemini Code Assist Standard ou Enterprise, defina Atribuição de licença como Atribuir licenças manualmente. Se a assinatura do Gemini Code Assist Standard ou Enterprise estiver definida como Atribuir licenças automaticamente, não será possível gerenciar licenças individuais. Caso você mude essa conta de faturamento para Atribuir licenças manualmente, a atribuição automática será desativada após a mudança, mas as atribuições anteriores não serão afetadas.

  5. Escolha Atribuir licenças. Uma caixa de diálogo para seleção de usuário vai aparecer. Se quiser pesquisar usuários específicos, digite o respectivo endereço de e-mail e selecione Avançar.

  6. Escolha Atribuir licenças.

  7. Conceda aos usuários licenciados os papéis "Usuário do Gemini para Google Cloud" e "Consumidor do Service Usage" do IAM.

API

Para atribuir licenças do Gemini Code Assist Standard e Enterprise, use o método billingAccounts.orders.licensePool.assign.

  1. É necessário ter as seguintes permissões do IAM na conta de faturamento que contém o pool de licenças que você quer atribuir:

    • billing.accounts.get
    • consumerprocurement.licensePools.assign
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.unassign
    • consumerprocurement.orders.get

  2. Crie um arquivo JSON com as informações a seguir:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Substitua USER_EMAILS por uma lista separada por vírgulas com as contas de usuário que estão recebendo a licença (por exemplo, "dana@example.com", "lee@example.com").

  3. Use cURL (link em inglês) para chamar o método:

    curl -X POST --data-binary @JSON_FILE_NAME \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

    Substitua o seguinte:

    • JSON_FILE_NAME: o caminho para o arquivo JSON criado na Etapa 2.
    • PROJECT_ID: o ID de um projeto. O uso da cota e as cobranças associadas à solicitação de API são aplicados ao projeto.
    • BILLING_ACCOUNT_ID: o ID da conta de faturamento associada ao pool de licenças.
    • ORDER_ID: o código do pedido. Caso você não saiba o código, recupere-o listando os pedidos associados à conta de faturamento.

Se a operação for bem-sucedida, a resposta será semelhante a esta:

{}

Para confirmar a atribuição, veja a lista de atribuições.

Em seguida, conceda aos usuários licenciados os papéis "Usuário do Gemini para Google Cloud" e "Consumidor do Service Usage" do IAM.

Atribuir automaticamente licenças do Gemini Code Assist Standard e Enterprise

Acesse a página Atribuição de licença para atribuir automaticamente uma licença a qualquer usuário da organização que precise de acesso ao Gemini Code Assist Standard ou Enterprise. A atribuição automática é definida individualmente para cada assinatura.

Essa função automática só é compatível com o VS Code, o IntelliJ e outros ambientes de desenvolvimento integrado aceitos pela JetBrains.

Se você atribuir licenças automaticamente para o Gemini Code Assist Standard ou Enterprise, não será possível remover nem adicionar licenças de usuários individuais nessa conta. Os usuários com atribuições de licenças que não usaram recursos do Gemini Code Assist Standard ou Enterprise têm o provisionamento cancelado automaticamente no fim do período de inatividade definido pelo administrador.

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

    Acesse o Gemini para Google Cloud

  2. Escolha Gerenciar o Gemini Code Assist > Gerenciar assinatura.

  3. Selecione Gerenciamento de licença > Ativar atribuição automática de licenças. A caixa de diálogo Ativar licenças automáticas vai aparecer.

    Após modificar a assinatura para atribuir licenças automaticamente, a função manual será desativada, mas as atribuições anteriores não serão afetadas.

  4. Defina o período para remoção da licença se o usuário atribuído estiver inativo e selecione Confirmar alteração. A caixa de diálogo A atribuição automática de licenças foi ativada vai aparecer.

    Se você configurou T dias de inatividade para remoção da atribuição, as licenças serão excluídas automaticamente e ficarão disponíveis no pool de licenças no dia T+1. Por exemplo, se você configurar 7 dias de inatividade para remoção da atribuição, as licenças serão excluídas e ficarão disponíveis no pool de licenças no dia 8.

  5. Selecione Fechar.

  6. Conceda aos usuários licenciados os papéis "Usuário do Gemini para Google Cloud" e "Consumidor do Service Usage" do IAM.

    Os usuários com a permissão cloudaicompanion.licenses.selfAssign recebem automaticamente uma licença quando acessam pela primeira vez o Gemini Code Assist Standard ou Enterprise em um projeto pago por uma conta de faturamento que inclua uma assinatura válida, esteja configurada para atribuição automática e tenha licenças disponíveis cobertas pelas assinaturas dessa conta.

Para desativar a atribuição automática de licenças:

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

    Acesse o Gemini para Google Cloud

  2. Escolha Gerenciar o Gemini Code Assist > Gerenciar assinatura.

  3. Selecione Gerenciamento de licença > Gerenciar atribuição automática de licenças. A caixa de diálogo Gerenciar atribuição automática de licenças vai aparecer.

  4. Escolha Desativar o gerenciamento automático de licenças.

  5. Selecione Confirmar alteração.

Remover manualmente a atribuição de licenças do Gemini Code Assist Standard e Enterprise

Selecione uma destas opções:

Console

  1. Você precisa ter as seguintes permissões do IAM na conta de faturamento proprietária da assinatura:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.unassign
    • resourcemanager.projects.get

  2. Acesse a página Admin do Gemini.

    Acesse o Gemini para Google Cloud

  3. Escolha Gerenciar o Gemini Code Assist > Gerenciar assinatura.

  4. Selecione Gerenciamento de licença > Gerenciar atribuição automática de licenças. A caixa de diálogo Gerenciar atribuição automática de licenças vai aparecer.

  5. Escolha os usuários para quem você quer cancelar a atribuição e selecione Cancelar a atribuição da licença.

  6. Escolha Confirmar.

API

Para remover a atribuição de licenças do Gemini Code Assist Standard e Enterprise, use o método billingAccounts.orders.licensePool.unassign.

  1. Para realizar essa tarefa, você precisa ter a permissão consumerprocurement.licensePools.unassign do Identity and Access Management (IAM) na conta de faturamento com o pool de licenças que você quer remover.

  2. Crie um arquivo JSON com as informações a seguir:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Substitua USER_EMAILS por uma lista separada por vírgulas com as contas de usuário que receberam a licença (por exemplo, "dana@example.com", "lee@example.com").

  3. Use cURL (link em inglês) para chamar o método:

    curl -X POST --data-binary @JSON_FILE_NAME \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/"

    Substitua o seguinte:

    • JSON_FILE_NAME: o caminho para o arquivo JSON criado na Etapa 2.
    • PROJECT_ID: o ID de um projeto. O uso da cota e as cobranças associadas à solicitação de API são aplicados ao projeto.
    • BILLING_ACCOUNT_ID: o ID da conta de faturamento associada ao pool de licenças.
    • ORDER_ID: o código do pedido. Caso você não saiba o código, recupere-o listando os pedidos associados à conta de faturamento.

Se a operação for bem-sucedida, a resposta será semelhante a esta:

{}

Para confirmar a remoção da atribuição, veja a lista de atribuições.

Transferir licenças do Gemini Code Assist Standard e Enterprise

Não é possível transferir licenças do Gemini Code Assist Standard e Enterprise diretamente entre usuários. Em vez disso, cancele a atribuição da licença de um usuário e atribua uma licença ao novo usuário.

Evitar o uso de licenças entre organizações

As licenças do Gemini Code Assist Standard e Enterprise são atribuídas a usuários individuais, não a organizações ou projetos. Assim, os usuários podem utilizar o Gemini Code Assist Standard e Enterprise em várias organizações.

Todos os registros gerados pelo uso do Gemini Code Assist ficam associados ao projeto em que a utilização ocorreu, e não ao licenciado. Além disso, as personalizações ou configurações do Gemini Code Assist (como personalização de código) são feitas no projeto, não no nível da licença ou da assinatura.

Para evitar ainda mais que pessoas de outras organizações usem o Gemini Code Assist Standard e Enterprise em um projeto:

  • Desative a API Gemini para Google Cloud no projeto.
  • Use permissões para negar o acesso do usuário ao projeto.

Limitações

A seguir