Administra las 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, la asignación automática de licencias está habilitada para todas las suscripciones. A los usuarios de tu organización que tengan los permisos necesarios, se les asignará automáticamente una licencia cuando comiencen a usar Gemini Code Assist en un IDE compatible. Esos permisos se detallan más adelante en este documento. Después de configurar Gemini Code Assist, puedes elegir asignar licencias de forma manual o continuar con la asignación automática.

Puedes asignar licencias a cualquier usuario que tenga acceso a un proyecto vinculado a la cuenta de facturación correspondiente.

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 poder otorgar los permisos adicionales necesarios en la cuenta de facturación para las tareas específicas de administración de licencias que se detallan en las siguientes secciones.

  • Verifica que hayas configurado Gemini Code Assist.

  • Si quieres administrar licencias con una API en lugar de la consola de Google Cloud , verifica lo siguiente:

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

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

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

Selecciona una de las siguientes opciones:

Console

  1. Verifica que tengas los siguientes permisos de IAM 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 adjunto a tu cuenta de facturación con la suscripción a Gemini Code Assist Standard o Enterprise.

    Ir a Administrador para Gemini

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

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

    • Nombre.
    • el correo electrónico,
    • Es la fecha en 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, 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 usuario, 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. Verifica que tengas el permiso de IAM consumerprocurement.licensePools.enumerateLicensedUsers en la cuenta de facturación que contiene el grupo de licencias cuyas asignaciones de licencias 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/"
    

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de un proyecto. El uso de la cuota y los cargos asociados con la solicitud a la API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID: Es el ID de la cuenta de facturación asociada con el grupo de licencias.
    • ORDER_ID: Es el ID del pedido. Si no conoces el ID del pedido, puedes recuperarlo creando una lista de los pedidos asociados con tu cuenta de facturación.

Si el comando se ejecuta de forma correcta, 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"
      }
  ]
}

Si no hay asignaciones de licencias de Gemini Code Assist Standard o Enterprise, o si el ORDER_ID no es válido, se devuelve el resultado licensedUsers en el siguiente formato:

{}

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

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

Si decides asignar licencias automáticamente para Gemini Code Assist Standard o Enterprise, no puedes quitar ni agregar licencias de usuario individuales en esa cuenta. Los usuarios con asignaciones de licencias que no hayan usado ninguna función de Gemini Code Assist Standard o Enterprise se desaprovisionarán automáticamente al final del período de inactividad establecido por el administrador.

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

    Ir a Administrador para Gemini

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

  3. Selecciona Administración de licencias y, luego, Habilitar la 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 período para anular la asignación de una licencia si el destinatario está inactivo y, luego, selecciona Confirmar cambio. Aparecerá el cuadro de diálogo Se habilitó la asignación automática de licencias.

    Si configuraste T días de inactividad para la anulación de la asignación, las licencias se anulará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 anulación de la asignación, las licencias se anularán y estarán disponibles en el grupo de licencias el día 8.

  5. Selecciona Cerrar.

  6. Asegúrate de otorgar los roles de IAM de usuario de Gemini para Google Cloud y consumidor de Service Usage a los usuarios con 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 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 consola de Google Cloud , ve a la página Administrador de Gemini.

    Ir a Administrador para Gemini

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

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

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

  5. Selecciona Confirmar cambio.

Asigna manualmente licencias de Gemini Code Assist Standard y Enterprise a usuarios individuales

Con la asignación manual de licencias, puedes agregar y quitar licencias para usuarios individuales. Este método te brinda control directo sobre quién puede acceder a Gemini Code Assist, lo que es ideal para otorgar acceso a un conjunto específico de usuarios.

Selecciona una de las siguientes opciones:

Console

  1. Verifica que tengas los siguientes permisos de IAM 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 Administrador para Gemini.

    Ir a Administrador para Gemini

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

  4. Para esta suscripción a Gemini Code Assist Standard o Enterprise, verifica que hayas configurado la Asignación de licencias en Asignar licencias manualmente. Si la suscripción a Gemini Code Assist Standard o Enterprise está configurada en Asignar licencias automáticamente, no podrás administrar 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 preexistentes no se verán afectadas.

  5. Selecciona Agregar usuario con licencia. Aparecerá un cuadro de diálogo de selección del usuario. Solo se admiten direcciones de correo electrónico de Cuentas de Google individuales, como @gmail.com, @googlegroups.com y dominios de Google Workspace. No se admite la federación de identidades de personal (BYOID).

  6. Selecciona Agregar usuario con licencia.

  7. Verifica que otorgues los roles de IAM de usuario de Gemini para Google Cloud y consumidor de Service Usage a los usuarios con licencia.

API

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

  1. Verifica que tengas los siguientes permisos de IAM 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
      ]
    }
    

    Reemplaza USER_EMAILS por una lista separada por comas de las cuentas de usuario a las que se les asignará la licencia, por ejemplo, "dana@example.com", "lee@example.com". Solo se admiten direcciones de correo electrónico de Cuentas de Google individuales, como @gmail.com, @googlegroups.com y dominios de Google Workspace. No se admite la federación de identidades de personal (BYOID).

  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/"

    Reemplaza lo siguiente:

    • JSON_FILE_NAME: Es la ruta de acceso del archivo JSON que creaste en el paso 2.
    • PROJECT_ID: Es el ID de un proyecto. El uso de la cuota y los cargos asociados con la solicitud a la API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID: Es el ID de la cuenta de facturación asociada con el grupo de licencias.
    • ORDER_ID: Es el ID del pedido. Si no conoces el ID del pedido, puedes recuperarlo creando una lista de los pedidos asociados con tu cuenta de facturación.

Si se ejecuta de forma correcta, la respuesta será similar a la siguiente:

{}

Para verificar la asignación, consulta la lista de asignaciones.

Luego, verifica que otorgues los roles de IAM de usuario de Gemini para Google Cloud y consumidor de Service Usage a los usuarios con licencia.

Anula manualmente la asignación de licencias de Gemini Code Assist Standard y Enterprise

Selecciona una de las siguientes opciones:

Console

  1. Verifica que tengas los siguientes permisos de IAM 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 Administrador para Gemini.

    Ir a Administrador para Gemini

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

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

  5. Selecciona los usuarios a los que quieras quitar la asignación de licencias y, luego, selecciona Anular la asignación de licencias.

  6. Selecciona Confirmar.

API

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

  1. Para realizar esta tarea, debes tener el permiso consumerprocurement.licensePools.unassign de Identity and Access Management (IAM) en la cuenta de facturación que contiene el grupo de licencias cuya licencia quieres anular.

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

    {
      "usernames": [
        USER_EMAILS
      ]
    }
    

    Reemplaza USER_EMAILS por una lista separada por comas de las cuentas de usuario a las que se les asigna 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/"

    Reemplaza lo siguiente:

    • JSON_FILE_NAME: Es la ruta de acceso del archivo JSON que creaste en el paso 2.
    • PROJECT_ID: Es el ID de un proyecto. El uso de la cuota y los cargos asociados con la solicitud a la API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID: Es el ID de la cuenta de facturación asociada con el grupo de licencias.
    • ORDER_ID: Es el ID del pedido. Si no conoces el ID del pedido, puedes recuperarlo creando una lista de los pedidos asociados con tu cuenta de facturación.

Si se ejecuta de forma correcta, la respuesta será similar a la siguiente:

{}

Para verificar que se haya anulado la asignación, consulta la lista de asignaciones.

Transfiere 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, anula la asignación de la licencia de un usuario y, luego, asigna una licencia al usuario nuevo.

Evita el uso de licencias entre organizaciones

Las licencias de Gemini Code Assist Standard y Enterprise se asignan a usuarios individuales, no a organizaciones ni a proyectos, lo que permite que los usuarios individuales usen 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 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.

Es posible que algunas organizaciones grandes quieran evitar que los desarrolladores de su organización usen Gemini Code Assist Standard o Enterprise en ciertos proyectos de su organización, como cuando ciertos proyectos tienen cuentas de facturación diferentes o cuando diferentes proyectos están asociados con diferentes clientes con diferentes tenencias y herramientas.

En estos casos, para ayudar a evitar el uso entre organizaciones de Gemini Code Assist Standard y Enterprise en un proyecto, puedes realizar una de las siguientes acciones:

Limitaciones