Gerenciar licenças do Gemini Code Assist

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

Por padrão, as novas assinaturas exigem que você atribua licenças manualmente. Depois de configurar alguns produtos do Gemini para o Google Cloud, você pode escolher atribuir licenças manualmente ou automaticamente.

Antes de começar

  • Verifique se você tem as funções de IAM de Administrador da conta de faturamento (roles/billing.admin) ou de Administrador de pedidos de compra do consumidor (roles/consumerprocurement.orderAdmin) para conceder as permissões adicionais necessárias para tarefas específicas de gerenciamento de licenças detalhadas nas seções a seguir.
  • Se você quiser gerenciar licenças usando uma API em vez do console do Google Cloud, confira o seguinte:

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

É possível adicionar ou remover o número de licenças do Gemini para o Google Cloud diretamente no console do Google Cloud, pelo representante da sua conta do Google ou por um revendedor autorizado.

Para mudar o número de licenças em uma assinatura, siga estas etapas:

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

    Acessar a página "Administrador do Gemini"

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

  4. Insira o número de licenças que você quer ter. As seguintes informações são exibidas:

    • 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 adicional das licenças adicionadas é proporcional ao tempo restante do período atual.

  5. Selecione Salvar.

Conferir as atribuições de licença do Gemini Code Assist

Selecione uma das seguintes opções:

Console

  1. Verifique se você tem as seguintes permissões de 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 Administrador do Gemini.

    Acessar a página "Administrador do Gemini"

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

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

    • Nome
    • E-mail
    • Tipo de conta
    • Licenças atribuídas

  4. Para encontrar um conjunto específico de usuários, é possível filtrar e classificar a lista da seguinte maneira:

    • Para filtrar a lista, insira as propriedades e os valores no campo Filtro.
    • Para classificar a lista, selecione o título da coluna que você quer usar como base da classificação. Por exemplo, para classificar alfabeticamente pelos nomes dos usuários, selecione o cabeçalho da coluna Nome.

API

Para conferir as atribuições de licença do Gemini Code Assist, use o método billingAccounts.orders.licensePool.enumerateLicensedUsers.

Para realizar essa tarefa, é necessário ter a permissão consumerprocurement.licensePools.enumerateLicensedUsers na conta de faturamento proprietária da assinatura.

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

Substitua:

  • BILLING_ACCOUNT_ID: o ID da conta de faturamento
  • ORDER_ID: a política do IAM

Se o comando for bem-sucedido, ele 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"
      }
  ]
}

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

Selecione uma das seguintes opções:

Console

  1. Verifique se você tem as seguintes permissões de 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 Administrador do Gemini.

    Acessar a página "Administrador do Gemini"

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

  4. Para esta assinatura do Gemini Code Assist, defina Atribuição de licença como Atribuir licenças manualmente. Se a assinatura do Gemini Code Assist estiver definida como Atribuir licenças automaticamente, não será possível gerenciar licenças individuais. Mudar essa conta de faturamento para Atribuir licenças manualmente desativa a atribuição automática de licenças após a mudança, mas as atribuições de licenças preexistentes não são afetadas.

  5. Selecione Atribuir licenças. Uma caixa de diálogo de seleção do usuário aparece. Para pesquisar usuários específicos, digite o endereço de e-mail deles e selecione Próxima.

  6. Selecione Atribuir licenças.

API

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

Para realizar essa tarefa, verifique se você tem as seguintes permissões na conta de faturamento proprietária da assinatura:

  • billing.accounts.get
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.unassign
  • consumerprocurement.orders.get
POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Substitua:

  • BILLING_ACCOUNT_ID: o ID da conta de faturamento
  • ORDER_ID: a política do IAM

Se o comando for bem-sucedido, ele retornará um corpo de resposta vazio no seguinte formato:

{}

Para verificar a tarefa, acesse a lista de tarefas.

Atribuir licenças do Gemini Code Assist automaticamente

É possível atribuir automaticamente uma licença a qualquer usuário da sua organização que precisa de acesso ao Gemini Code Assist na página Atribuição de licença. A atribuição automática de licenças é definida individualmente para cada assinatura.

Se você optar por atribuir automaticamente licenças para um Gemini Code Assist, não será possível remover ou adicionar licenças de usuário individual nessa conta. Os usuários com atribuições de licença que não usaram nenhum recurso do Gemini Code Assist são automaticamente desprovisionados no final do período de faturamento após um número especificado de dias de inatividade, conforme definido pelo administrador.

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

    Acessar a página "Administrador do Gemini"

  2. Selecione Gerenciar o Gemini Code Assist e Gerenciar assinatura.

  3. Selecione Gerenciamento de licenças e, em seguida, Ativar atribuição automática de licenças. A caixa de diálogo Ativar licenças automáticas é exibida.

    Mudar essa assinatura para atribuir licenças automaticamente desativa a atribuição manual de licenças após a mudança, mas as atribuições de licença preexistentes não são afetadas.

  4. Defina o período de tempo para que uma licença seja revertida se o usuário atribuído estiver inativo e selecione Confirmar mudança. A caixa de diálogo A atribuição automática de licenças foi ativada é exibida.

  5. Selecione Fechar.

Enquanto as licenças estiverem disponíveis para atribuição, os novos usuários vão receber uma licença automaticamente quando acessarem o Gemini Code Assist coberto pelas suas assinaturas nesta conta de faturamento.

Para desativar a atribuição automática de licenças, siga estas etapas:

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

    Acessar a página "Administrador do Gemini"

  2. Selecione Gerenciar o Gemini Code Assist e Gerenciar assinatura.

  3. Selecione Gerenciamento de licença e Gerenciar atribuição de licença automática. A caixa de diálogo Gerenciar atribuição automática de licenças é exibida.

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

  5. Selecione Confirmar mudança.

Cancelar a atribuição manual de licenças do Gemini Code Assist

Selecione uma das seguintes opções:

Console

  1. Verifique se você tem as seguintes permissões de 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 Administrador do Gemini.

    Acessar a página "Administrador do Gemini"

  3. Selecione Gerenciar o Gemini Code Assist e Gerenciar assinatura.

  4. Selecione Gerenciamento de licença e Gerenciar atribuição de licença automática. A caixa de diálogo Gerenciar atribuição automática de licenças é exibida.

  5. Selecione os usuários de quem você quer remover as licenças e selecione Remover licença.

  6. Selecione Confirmar.

API

Para desatribuir licenças do Gemini Code Assist, use o método billingAccounts.orders.licensePool.unassign.

Para realizar essa tarefa, é necessário ter a permissão consumerprocurement.licensePools.unassign na conta de faturamento que é proprietária da assinatura.

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Substitua:

  • BILLING_ACCOUNT_ID: o ID da conta de faturamento
  • ORDER_ID: a política do IAM

Se o comando for bem-sucedido, ele retornará um corpo de resposta vazio no seguinte formato:

{}

Para verificar a revogação, confira a lista de tarefas.

Transferir licenças do Gemini Code Assist

As licenças do Gemini Code Assist não podem ser transferidas 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.

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

As licenças do Gemini Code Assist são atribuídas a usuários individuais, não a organizações ou projetos, permitindo que usuários individuais usem o Gemini Code Assist em várias organizações.

Todos os registros gerados pelo Gemini Code Assist ficam no projeto em que o uso ocorreu, e não no licença. Além disso, qualquer personalização ou configuração do Gemini Code Assist (como a personalização de código) é feita no projeto, não no nível da licença ou da assinatura.

Para evitar o uso do Gemini Code Assist entre organizações em um projeto, faça o seguinte:

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

Limitações