Faça a gestão das licenças do Gemini Code Assist Standard e Enterprise

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

Por predefinição, as novas subscrições requerem que atribua manualmente licenças. Depois de configurar determinados produtos do Gemini para Google Cloud , pode optar por atribuir licenças manualmente ou automaticamente.

Pode atribuir licenças a todos os utilizadores que tenham acesso a um projeto associado à conta de faturação relevante. Depois de atribuir a licença ao utilizador, este pode usar o Gemini Code Assist em qualquer projeto.

Antes de começar

  • Certifique-se de que tem as funções do IAM Administrador da conta de faturação (roles/billing.admin) ou Administrador de encomendas de aprovisionamento do consumidor (roles/consumerprocurement.orderAdmin) para poder conceder autorizações adicionais necessárias na conta de faturação para tarefas específicas de gestão de licenças detalhadas nas secções seguintes.

  • Se quiser gerir licenças através de uma API em vez da Google Cloud consola, verifique o seguinte:

Altere o número de licenças do Gemini Code Assist Standard e Enterprise numa subscrição

Pode adicionar ou remover o número de licenças do Gemini for Google Cloud diretamente através da Google Cloud consola ou através do seu representante da Conta Google ou de um revendedor autorizado.

Para alterar o número de licenças numa subscrição, siga estes passos:

  1. Verifique se tem as seguintes autorizações de gestão de identidade e acesso (IAM) na conta de faturação proprietária da subscrição:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.orders.modify
    • resourcemanager.projects.get
  2. Na Google Cloud consola, aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

  3. Escolha a subscrição que quer alterar e, de seguida, selecione Modificar subscrição. Tenha em atenção que, se estiver num período de avaliação ativo, este botão é apresentado como Desativar renovação automática.

  4. Introduza o número de licenças que quer ter. São apresentadas 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 subscrição por período. O valor adicional das licenças adicionadas é calculado proporcionalmente com base no tempo restante no prazo atual.
  5. Selecione Guardar.

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

Selecione uma das seguintes opções:

Consola

  1. Verifique se tem as seguintes autorizações do IAM na conta de faturação proprietária da subscrição:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • resourcemanager.projects.get
  2. Aceda à página Administração do Gemini e selecione o projeto associado à sua conta de faturação com a subscrição do Gemini Code Assist Standard ou Enterprise.

    Aceder ao Gemini para Google Cloud

  3. Escolha a subscrição que quer alterar e, de seguida, selecione Modificar subscrição.

    As seguintes informações estão disponíveis para cada utilizador ao qual foi atribuída uma licença:

    • Nome.
    • Enviar.
    • 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 utilizadores, pode filtrar e ordenar a lista da seguinte forma:

    • Para filtrar a lista, no campo Filtro, introduza as propriedades e os valores.
    • Para ordenar a lista, selecione o cabeçalho da coluna pela qual quer ordenar. Por exemplo, para ordenar alfabeticamente pelos nomes de utilizadores, selecione 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 tem a consumerprocurement.licensePools.enumerateLicensedUsers autorização de IAM na conta de faturação que contém o conjunto de licenças cujas atribuições de licenças quer ver.

  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. A utilização de quotas e os encargos associados ao pedido de API são aplicados a este projeto.
    • BILLING_ACCOUNT_ID: o ID da conta de faturação associada ao conjunto de licenças.
    • ORDER_ID: o ID da encomenda. Se não souber o ID da encomenda, pode obtê-lo listando as encomendas associadas à sua conta de faturação.

Se o comando for executado com êxito, devolve o resultado 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 existirem atribuições de licenças do Gemini Code Assist Standard ou Enterprise, ou se o ORDER_ID for inválido, é devolvida uma saída licensedUsers no seguinte formato:

{}

Atribua manualmente licenças do Gemini Code Assist Standard e Enterprise a utilizadores individuais

Selecione uma das seguintes opções:

Consola

  1. Verifique se tem as seguintes autorizações do IAM na conta de faturação proprietária da subscrição:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.assign
    • resourcemanager.projects.get
  2. Aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

  3. Selecione Gerir o Gemini Code Assist e, de seguida, selecione Modificar subscrição.

  4. Para esta subscrição do Gemini Code Assist Standard ou Enterprise, verifique se definiu a Atribuição de licenças como Atribuir licenças manualmente. Se a subscrição do Gemini Code Assist Standard ou Enterprise estiver definida como Atribuir licenças automaticamente, não pode gerir licenças individuais. A mudança desta conta de faturação para a opção 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 existentes não são afetadas.

  5. Selecione Adicionar utilizador com licença. É apresentada uma caixa de diálogo de seleção de utilizadores. Apenas são suportados endereços de email de Contas Google individuais, como @gmail.com, @googlegroups.com e domínios do Google Workspace. A federação de identidades da força de trabalho (BYOID) não é suportada.

  6. Selecione Adicionar utilizador com licença.

  7. Verifique se concede as funções IAM de utilizador do Gemini para o Google Cloud e consumidor de utilização de serviços aos utilizadores licenciados.

API

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

  1. Verifique se tem as seguintes autorizações do IAM na conta de faturação que contém o conjunto de licenças cuja licença pretende atribuir:
  • billing.accounts.get
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.unassign
  • consumerprocurement.orders.get
  1. Crie um ficheiro JSON que contenha as seguintes informações:

    {
      "usernames": [
        USER_EMAILS
      ]
    }
    

    Substitua USER_EMAILS por uma lista de contas de utilizador separadas por vírgulas às quais está a atribuir a licença. Por exemplo, "dana@example.com", "lee@example.com". Apenas são suportados endereços de email de Contas Google individuais, como @gmail.com, @googlegroups.com e domínios do Google Workspace. A federação de identidade da força de trabalho (BYOID) não é suportada.

  2. 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 ficheiro JSON que criou no passo 2.
    • PROJECT_ID: o ID de um projeto. A utilização de quotas e os encargos associados ao pedido de API são aplicados a este projeto.
    • BILLING_ACCOUNT_ID: o ID da conta de faturação associada ao conjunto de licenças.
    • ORDER_ID: o ID da encomenda. Se não souber o ID da encomenda, pode obtê-lo listando as encomendas associadas à sua conta de faturação.

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

{}

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

Em seguida, verifique se concede as funções IAM de utilizador do Gemini para o Google Cloud e consumidor de utilização de serviços aos utilizadores licenciados.

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

Pode atribuir automaticamente uma licença a qualquer utilizador na sua organização que precise de acesso ao Gemini Code Assist Standard ou Enterprise a partir da página Atribuição de licenças. A atribuição automática de licenças é definida individualmente para cada subscrição.

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

Se optar por atribuir automaticamente licenças para o Gemini Code Assist Standard ou Enterprise, não pode remover nem adicionar licenças de utilizadores individuais nessa conta. Os utilizadores com atribuições de licenças que não usaram nenhuma funcionalidade do Gemini Code Assist Standard ou Enterprise têm o aprovisionamento automaticamente cancelado no final do período de inatividade definido pelo administrador.

  1. Na Google Cloud consola, aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

  2. Selecione Gerir Gemini Code Assist e, de seguida, selecione Gerir subscrição.

  3. Selecione Gestão de licenças e, de seguida, selecione Ativar atribuição automática de licenças. É apresentada a caixa de diálogo Ativar licenças automáticas.

    A mudança desta subscrição para a atribuição automática de licenças desativa a atribuição manual de licenças após a alteração, mas as atribuições de licenças preexistentes não são afetadas.

  4. Defina o período durante o qual uma licença deve ser anulada se o destinatário estiver inativo e, em seguida, selecione Confirmar alteração. É apresentada a caixa de diálogo A atribuição automática de licenças foi ativada.

    Se configurou T dias de inatividade para a anulação da atribuição, as licenças são automaticamente anuladas e ficam disponíveis no conjunto de licenças no dia T+1. Por exemplo, se configurar 7 dias de inatividade para a anulação da atribuição, as licenças são anuladas e ficam disponíveis no conjunto de licenças no dia 8.

  5. Selecione Fechar.

  6. Certifique-se de que concede as funções IAM de utilizador do Gemini para o Google Cloud e consumidor de utilização de serviços aos utilizadores licenciados.

    Os utilizadores com a autorização cloudaicompanion.licenses.selfAssign recebem automaticamente uma licença quando acedem pela primeira vez ao Gemini Code Assist Standard ou Enterprise num projeto pago por uma conta de faturação que tenha uma subscrição válida configurada para atribuição automática de licenças e que tenha licenças disponíveis abrangidas pelas suas subscrições na conta de faturação.

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

  1. Na Google Cloud consola, aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

  2. Selecione Gerir Gemini Code Assist e, de seguida, Gerir subscrição.

  3. Selecione Gestão de licenças e, de seguida, Gerir atribuição automática de licenças. É apresentada a caixa de diálogo Faça a gestão da atribuição automática de licenças.

  4. Selecione Desativar gestão automática de licenças.

  5. Selecione Confirmar alteração.

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

Selecione uma das seguintes opções:

Consola

  1. Verifique se tem as seguintes autorizações do IAM na conta de faturação proprietária da subscrição:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.unassign
    • resourcemanager.projects.get
  2. Aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

  3. Selecione Gerir Gemini Code Assist e, de seguida, Gerir subscrição.

  4. Selecione Gestão de licenças e, de seguida, Gerir atribuição automática de licenças. É apresentada a caixa de diálogo Faça a gestão da atribuição automática de licenças.

  5. Selecione os utilizadores para os quais quer remover a atribuição de licenças e, de seguida, selecione Remover atribuição de licença.

  6. Selecione Confirmar.

API

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

  1. Para realizar esta tarefa, tem de ter a autorização de consumerprocurement.licensePools.unassign gestão de identidade e acesso (IAM) na conta de faturação que contém o conjunto de licenças cuja licença pretende anular a atribuição.

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

    {
      "usernames": [
        USER_EMAILS
      ]
    }
    

    Substitua USER_EMAILS por uma lista de contas de utilizador separadas por vírgulas às quais a licença está 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 ficheiro JSON que criou no passo 2.
    • PROJECT_ID: o ID de um projeto. A utilização de quotas e os encargos associados ao pedido de API são aplicados a este projeto.
    • BILLING_ACCOUNT_ID: o ID da conta de faturação associada ao conjunto de licenças.
    • ORDER_ID: o ID da encomenda. Se não souber o ID da encomenda, pode obtê-lo listando as encomendas associadas à sua conta de faturação.

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

{}

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

Transfira licenças do Gemini Code Assist Standard e Enterprise

Não é possível transferir diretamente as licenças Standard e Enterprise do Gemini Code Assist entre utilizadores. Em alternativa, desatribua a licença a um utilizador e, em seguida, atribua uma licença ao novo utilizador.

Impeça a utilização de licenças entre organizações

As licenças do Gemini Code Assist Standard e Enterprise são atribuídas a utilizadores individuais, não a organizações nem projetos, o que permite que os utilizadores individuais usem o Gemini Code Assist Standard e Enterprise em várias organizações.

Todos os registos gerados a partir da utilização do Gemini Code Assist residem no projeto em que a utilização ocorreu e não no licenciado. Além disso, qualquer personalização ou configuração do Gemini Code Assist (como a personalização de código) é feita no projeto e não ao nível da licença ou da subscrição.

Para impedir ainda mais a utilização do Gemini Code Assist Standard e Enterprise entre organizações num projeto, pode fazer uma das seguintes ações:

  • Desative a API Gemini para o Google Cloud no projeto.
  • Use autorizações para negar o acesso do utilizador ao projeto.

Limitações

O que se segue?