Gestionar licencias de Gemini Code Assist Standard y Enterprise

Antes de usar Gemini Code Assist Standard y Enterprise, cada usuario de tu organización necesita una licencia.

De forma predeterminada, las nuevas suscripciones requieren que asignes licencias manualmente. Después de configurar determinados productos de Gemini, puedes asignar licencias manualmente o automáticamente. Google Cloud

Puedes asignar licencias a cualquier usuario que tenga acceso a un proyecto vinculado a la cuenta de facturación correspondiente. Una vez que hayas asignado la licencia al usuario, podrá usar Gemini Code Assist en cualquier proyecto.

Antes de empezar

  • Asegúrate de que tienes los roles de gestión de identidades y accesos Administrador de cuenta de facturación (roles/billing.admin) o Administrador de pedidos de adquisición de consumidor (roles/consumerprocurement.orderAdmin) para poder conceder permisos adicionales necesarios en la cuenta de facturación para tareas específicas de gestión de licencias, que se detallan en las siguientes secciones.

  • Si quieres gestionar las licencias mediante una API en lugar de la consola, comprueba lo siguiente: Google Cloud

Cambiar el número de licencias de Gemini Code Assist Standard y Enterprise en una suscripción

Puedes añadir o quitar el número de licencias de Gemini para Google Cloud directamente en la consola de Google Cloud , o bien a través de tu representante de la cuenta de Google o de un distribuidor autorizado.

Para cambiar el número de licencias de una suscripción, sigue estos pasos:

  1. Verifica que tengas los siguientes permisos de Gestión de Identidades y Accesos (IAM) en la cuenta de facturación propietaria de la suscripción:

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

  2. En la Google Cloud consola, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

  3. Elige la suscripción que quieras cambiar y, a continuación, selecciona Modificar suscripción. Ten en cuenta que, si estás disfrutando de un periodo de prueba activo, este botón se mostrará como Inhabilitar renovación automática.

  4. Introduce el número de licencias que quieras tener. Se muestra la siguiente información:

    • Número total de licencias después de la compra.
    • Número de licencias disponibles para asignar después de la compra.
    • Nuevo precio de la suscripción por periodo. El importe adicional de las licencias añadidas se prorratea en función del tiempo que quede del plazo actual.

  5. Selecciona Guardar.

Ver las asignaciones de licencias de Gemini Code Assist Standard y Enterprise

Selecciona una de las opciones siguientes:

Consola

  1. Verifica que tienes los siguientes permisos de gestión de identidades y accesos en la cuenta de facturación propietaria de la suscripción:

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

  2. Ve a la página Administrador de Gemini y selecciona el proyecto asociado a tu cuenta de facturación con la suscripción a Gemini Code Assist Standard o Enterprise.

    Ir a Gemini para Google Cloud

  3. Elige la suscripción que quieras cambiar y, a continuación, selecciona Modificar suscripción.

    Se muestra la siguiente información de cada usuario al que se le ha asignado una licencia:

    • Nombre.
    • el correo electrónico,
    • Fecha en la que se asignó la licencia.
    • Fecha y hora en que se usó la licencia por última vez.

  4. Para encontrar un conjunto específico de usuarios, puedes filtrar y ordenar la lista de la siguiente manera:

    • Para filtrar la lista, en el campo Filtro, introduce las propiedades y los valores.
    • Para ordenar la lista, selecciona el encabezado de la columna por la que quieras ordenar los elementos. Por ejemplo, para ordenar alfabéticamente los nombres de los usuarios, selecciona el encabezado de la columna Nombre.

API

Para ver las asignaciones de licencias de Gemini Code Assist Standard o Enterprise, usa el método billingAccounts.orders.licensePool.enumerateLicensedUsers.

  1. Comprueba que tienes el permiso de gestión de identidades y accesos consumerprocurement.licensePools.enumerateLicensedUsers en la cuenta de facturación que contiene el grupo de licencias cuyas asignaciones quieres ver.

  2. Usa cURL para llamar al 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/"

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de un proyecto. El uso de la cuota y los cargos asociados a la solicitud de la API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID: ID de la cuenta de facturación asociada al grupo de licencias.
    • ORDER_ID: el ID del pedido. Si no sabes el ID del pedido, puedes obtenerlo consultando los pedidos asociados a tu cuenta de facturación.

Si el comando se ejecuta correctamente, devuelve un licensedUsers con el siguiente 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"
      }
  ]
}

Si no hay ninguna asignación de licencia de Gemini Code Assist Standard o Enterprise, o si el ORDER_ID no es válido, se devuelve el resultado licensedUsers con el siguiente formato:

{}

Asignar manualmente licencias de Gemini Code Assist Standard y Enterprise a usuarios concretos

Selecciona una de las opciones siguientes:

Consola

  1. Verifica que tienes los siguientes permisos de gestión de identidades y accesos en la cuenta de facturación propietaria de la suscripción:

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

  2. Ve a la página Administrar Gemini.

    Ir a Gemini para Google Cloud

  3. Selecciona Gestionar Gemini Code Assist y, a continuación, Modificar suscripción.

  4. Para esta suscripción a Gemini Code Assist Standard o Enterprise, comprueba que hayas definido Asignación de licencias como Asignar licencias manualmente. Si la suscripción a Gemini Code Assist Standard o Enterprise está configurada como Asignar licencias automáticamente, no podrás gestionar licencias individuales. Si cambias esta cuenta de facturación a Asignar licencias manualmente, se desactivará la asignación automática de licencias después del cambio, pero las asignaciones de licencias anteriores no se verán afectadas.

  5. Selecciona Añadir usuario con licencia. Aparecerá un cuadro de diálogo de selección de usuario. Solo se admiten direcciones de correo de cuentas de Google individuales, como @gmail.com, @googlegroups.com y dominios de Google Workspace. No se admite la federación de identidades de Workforce (BYOID).

  6. Selecciona Añadir usuario con licencia.

  7. Verifica que concedes los roles de gestión de identidades y accesos de usuario de Gemini para Google Cloud y de consumidor de uso de servicios a los usuarios que tienen licencia.

API

Para asignar licencias de Gemini Code Assist Standard y Enterprise, usa el método billingAccounts.orders.licensePool.assign.

  1. Verifica que tienes los siguientes permisos de gestión de identidades y accesos en la cuenta de facturación que contiene el grupo de licencias cuya licencia quieres asignar:
  • billing.accounts.get
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.unassign
  • consumerprocurement.orders.get

  1. Crea un archivo JSON que contenga la siguiente información:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Sustituye USER_EMAILS por una lista de cuentas de usuario separadas por comas a las que se les va a asignar la licencia. Por ejemplo, "dana@example.com", "lee@example.com". Solo se admiten direcciones de correo de cuentas de Google individuales, como @gmail.com, @googlegroups.com y dominios de Google Workspace. La federación de identidades para los trabajadores (BYOID) no es compatible.

  2. Usa cURL para llamar al 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/"

    Haz los cambios siguientes:

    • JSON_FILE_NAME: la ruta del archivo JSON que has creado en el paso 2.
    • PROJECT_ID: el ID de un proyecto. El uso de la cuota y los cargos asociados a la solicitud de la API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID: ID de la cuenta de facturación asociada al grupo de licencias.
    • ORDER_ID: el ID del pedido. Si no sabes el ID del pedido, puedes obtenerlo consultando los pedidos asociados a tu cuenta de facturación.

Si la solicitud se realiza correctamente, la respuesta será similar a la siguiente:

{}

Para verificar la tarea, consulta la lista de tareas.

A continuación, comprueba que has concedido los roles de gestión de identidades y accesos Usuario de Gemini para Google Cloud y Consumidor de uso de servicios a los usuarios que tienen licencia.

Asignar automáticamente licencias de Gemini Code Assist Standard y Enterprise

Puedes asignar automáticamente una licencia a cualquier usuario de tu organización que necesite acceder a Gemini Code Assist Standard o Enterprise desde la página Asignación de licencias. La asignación automática de licencias se configura de forma individual para cada suscripción.

La asignación automática de licencias solo se admite en VS Code, IntelliJ y otros IDEs de JetBrains compatibles.

Si decides asignar automáticamente licencias de Gemini Code Assist Standard o Enterprise, no podrás quitar ni añadir licencias de usuario concretas en esa cuenta. Los usuarios con asignaciones de licencias que no hayan usado ninguna función de Gemini Code Assist Standard o Enterprise se desaprovisionan automáticamente al final del periodo de inactividad definido por el administrador.

  1. En la Google Cloud consola, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

  2. Selecciona Gestionar Gemini Code Assist y, a continuación, Gestionar suscripción.

  3. Selecciona Gestión de licencias y, a continuación, Habilitar asignación automática de licencias. Aparecerá el cuadro de diálogo Habilitar licencias automáticas.

    Si cambias esta suscripción para que asigne licencias automáticamente, se desactivará la asignación manual de licencias después del cambio, pero no se verán afectadas las asignaciones de licencias que ya existían.

  4. Define el periodo de tiempo que debe transcurrir para que se anule la asignación de una licencia si el usuario asignado está inactivo y, a continuación, selecciona Confirm Change (Confirmar cambio). Aparecerá el cuadro de diálogo La asignación automática de licencias se ha habilitado.

    Si has configurado T días de inactividad para la cancelación de la asignación, las licencias se cancelarán automáticamente y estarán disponibles en el grupo de licencias el día T+1. Por ejemplo, si configuras 7 días de inactividad para la reasignación, las licencias se reasignarán y estarán disponibles en el grupo de licencias el día 8.

  5. Selecciona Cerrar.

  6. Asegúrate de conceder los roles de gestión de identidades y accesos de usuario de Gemini para Google Cloud y de consumidor de uso de servicios a los usuarios que tengan licencia.

    Los usuarios con el permiso cloudaicompanion.licenses.selfAssign reciben automáticamente una licencia cuando acceden por primera vez a Gemini Code Assist Standard o Enterprise en un proyecto pagado por una cuenta de facturación que tiene una suscripción válida configurada para la asignación automática de licencias y que tiene licencias disponibles cubiertas por tus suscripciones en la cuenta de facturación.

Para inhabilitar la asignación automática de licencias, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

  2. Selecciona Gestionar Gemini Code Assist y, a continuación, Gestionar suscripción.

  3. Selecciona Gestión de licencias y, a continuación, Gestionar asignación automática de licencias. Aparecerá el cuadro de diálogo Gestionar la asignación automática de licencias.

  4. Selecciona Inhabilitar la gestión automática de licencias.

  5. Selecciona Confirmar cambio.

Asignar licencias de Gemini Code Assist Standard y Enterprise manualmente

Selecciona una de las opciones siguientes:

Consola

  1. Verifica que tienes los siguientes permisos de gestión de identidades y accesos en la cuenta de facturación propietaria de la suscripción:

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

  2. Ve a la página Administrar Gemini.

    Ir a Gemini para Google Cloud

  3. Selecciona Gestionar Gemini Code Assist y, a continuación, Gestionar suscripción.

  4. Selecciona Gestión de licencias y, a continuación, Gestionar asignación automática de licencias. Aparecerá el cuadro de diálogo Gestionar la asignación automática de licencias.

  5. Selecciona los usuarios a los que quieras quitar las licencias y, a continuación, selecciona Quitar licencia.

  6. Selecciona Confirmar.

API

Para quitar las licencias de Gemini Code Assist Standard y Enterprise, usa el método billingAccounts.orders.licensePool.unassign.

  1. Para llevar a cabo esta tarea, debe tener el permiso de gestión de identidades y accesos (IAM) de consumerprocurement.licensePools.unassign en la cuenta de facturación que contenga el grupo de licencias cuya licencia quiera desasignar.

  2. Crea un archivo JSON que contenga la siguiente información:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Sustituye USER_EMAILS por una lista de cuentas de usuario separadas por comas a las que se les ha asignado la licencia. Por ejemplo, "dana@example.com", "lee@example.com".

  3. Usa cURL para llamar al 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/"

    Haz los cambios siguientes:

    • JSON_FILE_NAME: la ruta del archivo JSON que has creado en el paso 2.
    • PROJECT_ID: el ID de un proyecto. El uso de la cuota y los cargos asociados a la solicitud de la API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID: ID de la cuenta de facturación asociada al grupo de licencias.
    • ORDER_ID: el ID del pedido. Si no sabes el ID del pedido, puedes obtenerlo consultando los pedidos asociados a tu cuenta de facturación.

Si la solicitud se realiza correctamente, la respuesta será similar a la siguiente:

{}

Para verificar que se ha retirado la asignación, consulta la lista de asignaciones.

Transferir licencias de Gemini Code Assist Standard y Enterprise

Las licencias de Gemini Code Assist Standard y Enterprise no se pueden transferir directamente entre usuarios. En su lugar, retira la licencia a un usuario y, a continuación, asigna una licencia al nuevo usuario.

Impedir el uso de licencias entre organizaciones

Las licencias de Gemini Code Assist Standard y Enterprise se asignan a usuarios concretos, no a organizaciones ni proyectos, lo que permite a los usuarios usar Gemini Code Assist Standard y Enterprise en varias organizaciones.

Los registros generados a partir del uso de Gemini Code Assist se almacenan en el proyecto en el que se ha producido el uso, no en el del licenciatario. Además, cualquier personalización o configuración de Gemini Code Assist (como la personalización de código) se realiza en el proyecto, no a nivel de licencia o suscripción.

Para evitar aún más el uso de Gemini Code Assist Standard y Enterprise en un proyecto entre organizaciones, puedes hacer lo siguiente:

  • Inhabilita la API Gemini for Google Cloud en el proyecto.
  • Usa los permisos para denegar el acceso de los usuarios al proyecto.

Limitaciones

Siguientes pasos