Gerenciar licenças do Gemini Code Assist Standard e Enterprise

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

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

Antes de começar

  • Certifique-se de ter as funções IAM de Administrador da conta de cobrança ( roles/billing.admin ) ou Administrador de pedidos de aquisição do consumidor ( roles/consumerprocurement.orderAdmin ) para que você possa conceder permissões adicionais necessárias na conta de cobrança para tarefas específicas de gerenciamento de licenças detalhadas nas seções a seguir.
  • Se você deseja gerenciar licenças usando uma API em vez de Google Cloud console, então certifique-se do seguinte:

Alterar 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 Gêmeos para Google Cloud licenças diretamente através do Google Cloud console ou por meio do seu representante de conta do Google ou de um revendedor autorizado.

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

  1. Certifique-se de ter as seguintes permissões de Gerenciamento de Identidade e Acesso (IAM) na conta de cobrança que possui a assinatura:

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

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

    Vá para Gemini para Google Cloud

  3. Selecione a assinatura que você deseja alterar e selecione Modificar assinatura .

  4. Insira o número de licenças que você deseja ter. As seguintes informações serã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 de assinatura por período. O valor adicional pelas licenças adicionadas é calculado proporcionalmente ao tempo restante do período atual.

  5. Selecione Salvar .

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

Selecione uma das seguintes opções:

Console

  1. Certifique-se de ter as seguintes permissões do IAM na conta de cobrança que possui a 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 à sua conta de cobrança com a assinatura Gemini Code Assist Standard ou Enterprise.

    Vá para Gemini para Google Cloud

  3. Selecione a assinatura que você deseja 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. Para encontrar um conjunto específico de usuários, você pode filtrar e classificar a lista da seguinte maneira:

    • Para filtrar a lista, no campo Filtro , insira as propriedades e valores.
    • Para classificar a lista, selecione o título da coluna pela qual deseja classificar. Por exemplo, para classificar em ordem alfabética pelos nomes de usuários, selecione o título da coluna "Nome" .

API

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

  1. Verifique se você tem a permissão do IAM consumerprocurement.licensePools.enumerateLicensedUsers na conta de cobrança que contém o pool de licenças cujas atribuições de licença você deseja visualizar.

  2. Use cURL 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 da API são aplicadas a este projeto.
    • BILLING_ACCOUNT_ID : a ID da conta de cobrança associada ao pool de licenças.
    • ORDER_ID : o ID do pedido. Caso não saiba o ID do pedido, você pode recuperá-lo listando os pedidos associados à sua conta de cobrança .

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"
      }
  ]
}

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

{}

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

Selecione uma das seguintes opções:

Console

  1. Certifique-se de ter as seguintes permissões do IAM na conta de cobrança que possui a 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 .

    Vá para Gemini para Google Cloud

  3. Selecione Gerenciar Gemini Code Assist e, em seguida, selecione Modificar assinatura .

  4. Para esta assinatura do Gemini Code Assist Standard ou Enterprise, certifique-se de definir a Atribuição de Licenças como Atribuir Licenças Manualmente . Se a assinatura do Gemini Code Assist Standard ou Enterprise estiver definida como Atribuir Licenças Automaticamente , você não poderá gerenciar licenças individuais. Alternar esta conta de cobrança para Atribuir Licenças Manualmente desativa a atribuição automática de licenças após a alteração, mas as atribuições de licenças preexistentes não serão afetadas.

  5. Selecione Atribuir Licenças . Uma caixa de diálogo para seleção de usuários será exibida. Para pesquisar usuários específicos, insira o endereço de e-mail deles e selecione Avançar .

  6. Selecione Atribuir licenças .

  7. Certifique-se de conceder as funções Gemini para Usuário do Google Cloud e Consumidor de Uso de Serviço do IAM aos usuários licenciados.

API

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

  1. Certifique-se de ter as seguintes permissões do IAM na conta de cobrança que contém o pool de licenças cuja licença você pretende atribuir:

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

  2. Crie um arquivo JSON que contenha as seguintes informações:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Substitua USER_EMAILS por uma lista separada por vírgulas de contas de usuários às quais a licença está sendo atribuída — por exemplo, "dana@example.com", "lee@example.com" .

  3. Use cURL 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 que você criou na Etapa 2.
    • PROJECT_ID : o ID de um projeto. O uso da cota e as cobranças associadas à solicitação da API são aplicadas a este projeto.
    • BILLING_ACCOUNT_ID : a ID da conta de cobrança associada ao pool de licenças.
    • ORDER_ID : o ID do pedido. Caso não saiba o ID do pedido, você pode recuperá-lo listando os pedidos associados à sua conta de cobrança .

Se for bem-sucedido, a resposta será semelhante à seguinte:

{}

Para verificar a tarefa, veja a lista de tarefas .

Em seguida, certifique-se de conceder as funções Gemini para Usuário do Google Cloud e Consumidor de Uso de Serviço do IAM aos usuários licenciados.

Atribuir automaticamente licenças Gemini Code Assist Standard e Enterprise

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

A atribuição automática de licenças só é suportada no VS Code, IntelliJ e outros IDEs JetBrains suportados .

Se você optar por atribuir licenças automaticamente para o Gemini Code Assist Standard ou Enterprise, não poderá remover ou adicionar licenças de usuário individuais nessa conta. Usuários com atribuições de licença que não utilizaram nenhum recurso do Gemini Code Assist Standard ou Enterprise serão automaticamente desprovisionados ao final do período de inatividade definido pelo administrador.

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

    Vá para Gemini para Google Cloud

  2. Selecione Gerenciar Gemini Code Assist e, em seguida, selecione Gerenciar assinatura .

  3. Selecione Gerenciamento de Licenças e, em seguida, Habilitar Atribuição Automática de Licenças . A caixa de diálogo Habilitar licenças automáticas será exibida.

    Alternar esta assinatura para atribuir licenças automaticamente desativa a atribuição manual de licenças após a alteração, mas as atribuições de licenças pré-existentes não são afetadas.

  4. Defina o período de tempo para cancelar a atribuição de uma licença caso o cessionário esteja inativo e selecione Confirmar Alteração . A caixa de diálogo "Atribuição automática de licença foi habilitada" será exibida.

    Se você configurou T dias de inatividade para a desatribuição, a(s) licença(s) será(ão) automaticamente desatribuída(s) e disponibilizada(s) no pool de licenças no dia T+1 . Por exemplo, se você configurar 7 dias de inatividade para a desatribuição, a(s) licença(s) será(ão) desatribuída(s) e disponibilizada(s) no pool de licenças no dia 8 .

  5. Selecione Fechar .

  6. Certifique-se de conceder as funções Gemini para Usuário do Google Cloud e Consumidor de Uso de Serviço do IAM aos usuários licenciados.

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

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

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

    Vá para Gemini para Google Cloud

  2. Selecione Gerenciar Gemini Code Assist e, em seguida, selecione Gerenciar assinatura .

  3. Selecione Gerenciamento de Licenças e, em seguida , Gerenciar Atribuição Automática de Licenças . A caixa de diálogo Gerenciar Atribuição Automática de Licenças será exibida.

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

  5. Selecione Confirmar alteração .

Desatribuir manualmente as licenças Gemini Code Assist Standard e Enterprise

Selecione uma das seguintes opções:

Console

  1. Certifique-se de ter as seguintes permissões do IAM na conta de cobrança que possui a 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 .

    Vá para Gemini para Google Cloud

  3. Selecione Gerenciar Gemini Code Assist e, em seguida, selecione Gerenciar assinatura .

  4. Selecione Gerenciamento de Licenças e, em seguida , Gerenciar Atribuição Automática de Licenças . A caixa de diálogo Gerenciar Atribuição Automática de Licenças será exibida.

  5. Selecione os usuários para os quais você deseja cancelar a atribuição de licenças e selecione Cancelar atribuição de licença .

  6. Selecione Confirmar .

API

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

  1. Para executar esta tarefa, você deve ter a permissão consumerprocurement.licensePools.unassign do Identity and Access Management (IAM) na conta de cobrança que contém o pool de licenças cuja licença você pretende cancelar a atribuição.

  2. Crie um arquivo JSON que contenha as seguintes informações:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Substitua USER_EMAILS por uma lista separada por vírgulas de contas de usuários às quais a licença foi atribuída — por exemplo, "dana@example.com", "lee@example.com" .

  3. Use cURL 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 que você criou na Etapa 2.
    • PROJECT_ID : o ID de um projeto. O uso da cota e as cobranças associadas à solicitação da API são aplicadas a este projeto.
    • BILLING_ACCOUNT_ID : a ID da conta de cobrança associada ao pool de licenças.
    • ORDER_ID : o ID do pedido. Caso não saiba o ID do pedido, você pode recuperá-lo listando os pedidos associados à sua conta de cobrança .

Se for bem-sucedido, a resposta será semelhante à seguinte:

{}

Para verificar a não atribuição, visualize a lista de atribuições .

Transferir licenças Gemini Code Assist Standard e Enterprise

As licenças do Gemini Code Assist Standard e Enterprise 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 Gemini Code Assist Standard e Enterprise 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 Standard e Enterprise em várias organizações.

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

Para evitar ainda mais o uso entre organizações do Gemini Code Assist Standard e Enterprise em um projeto, você pode fazer o seguinte:

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

Limitações

O que vem a seguir