Administra las licencias de Gemini Code Assist

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

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

Antes de comenzar

  • Asegúrate de tener los roles de IAM de Administrador de cuentas de facturación (roles/billing.admin) o Administrador de pedidos de adquisición de consumidores (roles/consumerprocurement.orderAdmin) para que puedas otorgar los permisos adicionales necesarios para las tareas específicas de administración de licencias que se detallan en las siguientes secciones.
  • Si deseas administrar licencias con una API en lugar de la consola de Google Cloud, asegúrate de lo siguiente:

Cambia la cantidad de licencias de Gemini Code Assist en una suscripción

Puedes agregar o quitar la cantidad de licencias de Gemini para Google Cloud directamente a través de la consola de Google Cloud, a través de tu representante de la Cuenta de Google o un revendedor autorizado.

Para cambiar la cantidad de licencias de una suscripción, sigue estos pasos:

  1. Asegúrate de tener los siguientes permisos de Identity and Access Management (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 consola de Google Cloud, ve a la página Administrador de Gemini.

    Ir a Administrador de Gemini

  3. Elige la suscripción que deseas cambiar y, luego, selecciona Modificar suscripción.

  4. Ingresa la cantidad de licencias que deseas tener. Se muestra la siguiente información:

    • Es la cantidad total de licencias después de la compra.
    • Cantidad de licencias disponibles para asignar después de la compra.
    • Es el nuevo precio de la suscripción por período. El importe adicional de las licencias agregadas se prorratea en función del tiempo que queda en el período actual.

  5. Selecciona Guardar.

Cómo ver las asignaciones de licencias de Gemini Code Assist

Selecciona una de las siguientes opciones:

Console

  1. Asegúrate de tener los siguientes permisos de IAM en la cuenta de facturación a la que pertenece 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.

    Ve a Administrador de Gemini

  3. Elige la suscripción que deseas cambiar y, luego, selecciona Modificar suscripción.

    La siguiente información está disponible para cada usuario al que se le asignó una licencia:

    • Nombre
    • Correo electrónico
    • Tipo de cuenta
    • Se asignaron las licencias

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

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

API

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

Para realizar esta tarea, debes tener el permiso consumerprocurement.licensePools.enumerateLicensedUsers en la cuenta de facturación propietaria de la suscripción.

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

Reemplaza lo siguiente:

  • BILLING_ACCOUNT_ID: el ID de la cuenta de facturación
  • ORDER_ID: La política de IAM

Si el comando tiene éxito, se muestra el resultado licensedUsers en 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"
      }
  ]
}

Asignar licencias de Gemini Code Assist de forma manual a usuarios individuales

Selecciona una de las siguientes opciones:

Console

  1. Asegúrate de tener los siguientes permisos de IAM en la cuenta de facturación a la que pertenece 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 Administrador de Gemini.

    Ve a Administrador de Gemini

  3. Selecciona Administrar Gemini Code Assist y, luego, Modificar suscripción.

  4. Para esta suscripción a Gemini Code Assist, asegúrate de establecer Asignación de licencias en Asignar licencias de forma manual. Si la suscripción a Gemini Code Assist está configurada en Asignar licencias automáticamente, no podrás administrar licencias individuales. Si cambias esta cuenta de facturación a Asignar licencias de forma manual, se desactivará la asignación automática de licencias después del cambio, pero las asignaciones de licencias existentes no se verán afectadas.

  5. Selecciona Asignar licencias. Aparecerá un diálogo de selección del usuario. Para buscar usuarios específicos, ingresa su dirección de correo electrónico y, luego, selecciona Siguiente.

  6. Selecciona Asignar licencias.

API

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

Para realizar esta tarea, asegúrate de tener los siguientes permisos en la cuenta de facturación a la que pertenece la suscripción:

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

Reemplaza lo siguiente:

  • BILLING_ACCOUNT_ID: el ID de la cuenta de facturación
  • ORDER_ID: la política de IAM

Si el comando se ejecuta de forma correcta, muestra un cuerpo de respuesta vacío en el siguiente formato:

{}

Para verificar la tarea, consulta la lista de tareas.

Asigna licencias de Gemini Code Assist automáticamente

Puedes asignar automáticamente una licencia a cualquier usuario de tu organización que requiera acceso a Gemini Code Assist desde la página Asignación de licencias. La asignación automática de licencias se establece de forma individual para cada suscripción.

Si decides asignar licencias automáticamente para Gemini Code Assist, no podrás quitar ni agregar licencias de usuarios individuales en esa cuenta. Los usuarios con asignaciones de licencias que no hayan usado ninguna función de Gemini Code Assist se desaprovisionarán automáticamente al final del período de facturación después de una cantidad especificada de días de inactividad, según lo establezca el administrador.

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

    Ir a Administrador de Gemini

  2. Selecciona Administrar Gemini Code Assist y, luego, Administrar suscripción.

  3. Selecciona Administración de licencias y, luego, Habilitar asignación automática de licencias. Aparecerá el diálogo Habilitar licencias automáticas.

    Si cambias esta suscripción para asignar licencias automáticamente, se desactivará la asignación manual de licencias después del cambio, pero las asignaciones de licencias preexistentes no se verán afectadas.

  4. Establece el tiempo que se debe esperar para que una licencia deje de estar asignada si el usuario asignado está inactivo y, luego, selecciona Confirmar cambio. Aparecerá el diálogo Se habilitó la asignación automática de licencias.

  5. Selecciona Cerrar.

Siempre que haya licencias disponibles para asignar, los usuarios nuevos recibirán automáticamente una licencia cuando accedan por primera vez a Gemini Code Assist cubierto por tus suscripciones en esta cuenta de facturación.

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

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

    Ve a Administrador de Gemini

  2. Selecciona Administrar Gemini Code Assist y, luego, Administrar suscripción.

  3. Selecciona Administración de licencias y, luego, Administrar asignación automática de licencias. Aparecerá el diálogo Administrar asignación automática de licencias.

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

  5. Selecciona Confirmar cambio.

Cómo anular la asignación manual de licencias de Gemini Code Assist

Selecciona una de las siguientes opciones:

Console

  1. Asegúrate de tener los siguientes permisos de IAM en la cuenta de facturación a la que pertenece 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 Administrador de Gemini.

    Ve a Administrador de Gemini

  3. Selecciona Administrar Gemini Code Assist y, luego, Administrar suscripción.

  4. Selecciona Administración de licencias y, luego, Administrar asignación automática de licencias. Aparecerá el diálogo Administrar asignación automática de licencias.

  5. Selecciona los usuarios a los que quieres quitarles las licencias y, luego, elige Quitar la licencia.

  6. Selecciona Confirmar.

API

Para anular la asignación de licencias de Gemini Code Assist, usa el método billingAccounts.orders.licensePool.unassign.

Para realizar esta tarea, debes tener el permiso consumerprocurement.licensePools.unassign en la cuenta de facturación propietaria de la suscripción.

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

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

Reemplaza lo siguiente:

  • BILLING_ACCOUNT_ID: el ID de la cuenta de facturación
  • ORDER_ID: la política de IAM

Si el comando se ejecuta de forma correcta, muestra un cuerpo de respuesta vacío en el siguiente formato:

{}

Para verificar la anulación de la tarea, consulta la lista de tareas.

Cómo transferir licencias de Gemini Code Assist

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

Evita el uso de licencias entre organizaciones

Las licencias de Gemini Code Assist se asignan a usuarios individuales, no a organizaciones ni proyectos, lo que permite que los usuarios individuales usen Gemini Code Assist en varias organizaciones.

Cualquier registro generado a partir del uso de Gemini Code Assist se encuentra en el proyecto en el que se produjo el uso, y no con el 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 la licencia o la suscripción.

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

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

Limitaciones