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. Depois de 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 acesso a um projeto vinculado à conta de faturamento relevante. Depois disso, o usuário poderá usar o Gemini Code Assist em qualquer projeto.

Antes de começar

  • Confira se você tem as funções do IAM de Administrador da conta de faturamento (roles/billing.admin) ou Administrador do pedido de compra do consumidor (roles/consumerprocurement.orderAdmin) para conceder as permissões adicionais necessárias na conta de faturamento para tarefas específicas de gerenciamento de licenças detalhadas nas seções a seguir.

  • Se quiser gerenciar licenças usando uma API em vez do console de APIs do Google, verifique o seguinte:

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 da API ou com o representante da sua Conta do Google ou um revendedor autorizado.

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

  1. Verifique se você tem as seguintes permissões do Identity and Access Management na conta de faturamento proprietária da assinatura:

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

  2. No console de APIs, acesse a página Admin do Gemini.

    Acessar o Gemini para Google Cloud

  3. Escolha a assinatura que você quer alterar e selecione Modificar assinatura. Se você estiver em um período de teste ativo, o botão vai aparecer como Desativar a renovação automática.

  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 das seguintes opções:

Console

  1. Verifique se você tem 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.

    Acessar 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. Verifique se você tem a permissão consumerprocurement.licensePools.enumerateLicensedUsers do IAM na conta de faturamento que contém o pool de licenças com as atribuições que 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:

    • 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. Verifique se você tem 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.

    Acessar 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, verifique se você definiu 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. Selecione Adicionar usuário licenciado. Uma caixa de diálogo de seleção do usuário vai aparecer. Somente endereços de e-mail individuais da Conta do Google são aceitos, como @gmail.com, @googlegroups.com e domínios do Google Workspace. A federação de identidade da força de trabalho (BYOID) não é compatível.

  6. Selecione Adicionar usuário licenciado.

  7. Verifique se você concedeu 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. Verifique se você tem 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

  1. 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"). Apenas endereços de e-mail individuais da Conta do Google são aceitos, como @gmail.com, @googlegroups.com e domínios do Google Workspace. A federação de identidade de colaboradores (BYOID) não é compatível.

  2. 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, verifique se você concedeu 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 de APIs, acesse a página Admin do Gemini.

    Acessar 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 de APIs, acesse a página Admin do Gemini.

    Acessar 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. Verifique se você tem 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.

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