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 con los permisos necesarios se les asigna automáticamente una licencia cuando comienzan a usar Gemini Code Assist en un IDE compatible. Esos permisos se detallan más adelante en este documento. Después de configurar productos específicos de Gemini para Google Cloud productos, puedes 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.

Nota: No puedes asignar una licencia de puesto de Gemini Code Assist Standard a un usuario que tenga una suscripción Premium al Programa para desarrolladores de Google, ya que ese usuario ya tiene una licencia de Gemini Code Assist Standard como parte de su propia suscripción.

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 Consumer Procurement (roles/consumerprocurement.orderAdmin) para poder otorgar permisos adicionales necesarios en la cuenta de facturación para 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 Google Cloud consola, verifica lo siguiente:

  • Configura un proyecto de cuota para tu cuenta de facturación.
  • Habilita la API de Cloud Commerce Consumer Procurement en tu proyecto de cuota.
  • Verifica que los siguientes pares clave-valor de encabezado estén presentes en todas las llamadas a la API:
    • Authorization: tu Google Cloud token de acceso de Google Cloud CLI
    • x-goog-user-project: el ID del proyecto de cuota

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 para Google Cloud directamente a través de la Google Cloud consola, o bien a través de tu representante de cuenta de Google o un revendedor autorizado.

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

1. Verifica que tengas los siguientes permisos de Identity and Access Management (IAM) en la cuenta de facturación que posee la suscripción:

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

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

   Ir a Gemini para Google Cloud

3. Elige la suscripción que deseas cambiar y, luego, selecciona Modificar suscripción. Ten en cuenta que, si estás en un período de prueba activo, este botón se muestra como Inhabilitar renovación automática.

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

   • Cantidad total de licencias después de la compra
   • Cantidad de licencias disponibles para la asignación después de la compra
   • Nuevo precio de suscripción por período El importe adicional de las licencias agregadas se prorratea en función del tiempo restante del período actual.

5. Selecciona Guardar.

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 que posee 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 Gemini para Google Cloud

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
   • el correo electrónico,
   • 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 por la 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 billingAccounts.orders.licensePool.enumerateLicensedUsers método.

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 deseas 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: 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: el ID de la cuenta de facturación asociada con el grupo de licencias
   • ORDER_ID: el ID del pedido Si no conoces el ID del pedido, puedes recuperarlo enumerando los pedidos asociados con tu cuenta de facturación.

Si el comando se ejecuta correctamente, muestra el resultado licensedUsers en el siguiente formato:

{
  "licensedUsers": [
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "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, muestra el resultado licensedUsers en el siguiente formato:

{}

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

Puedes habilitar la asignación automática de licencias para una suscripción.

La asignación automática de licencias solo es compatible con 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 usuarios 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 desaprovisionan automáticamente al final del período de inactividad establecido por el administrador.

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

   Ir a Gemini para Google Cloud

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

3. Selecciona Administración de licencias y, luego, 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 las asignaciones de licencias existentes no se verán afectadas.

4. Establece el período durante el cual una licencia dejará de asignarse 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, entonces 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 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 de, ve a la página Administrador de Gemini.

   Ir a Gemini para Google Cloud

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

3. Selecciona Administración de licencias y, luego, selecciona Administrar asignación automática de licencias. Aparecerá el cuadro de diálogo Administrar 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 que posee 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.

   Ir a Gemini para Google Cloud

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

4. Para esta suscripción a Gemini Code Assist Standard o Enterprise, verifica que hayas configurado 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, entonces 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 existentes 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 individuales de Cuentas de Google, 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 billingAccounts.orders.licensePool.assign método.

1. Verifica que tengas los siguientes permisos de IAM en la cuenta de facturación que contiene el grupo de licencias cuya licencia deseas 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 cuentas de usuario a las que se les asignará la licencia, por ejemplo, "[e-mail]", "[e-mail]". Solo se admiten direcciones de correo electrónico individuales de Cuentas de Google, 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: la ruta de acceso del archivo JSON que creaste en el paso 2
   • PROJECT_ID: 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: el ID de la cuenta de facturación asociada con el grupo de licencias
   • ORDER_ID: el ID del pedido Si no conoces el ID del pedido, puedes recuperarlo enumerando los pedidos asociados con tu cuenta de facturación.

Si se realiza de forma correcta, la respuesta se verá como 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 que posee 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.

   Ir a Gemini para Google Cloud

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

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

5. Selecciona los usuarios para los que deseas anular 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 billingAccounts.orders.licensePool.unassign método.

1. Para realizar esta tarea, debes tener el permiso de Identity and Access Management (IAM) consumerprocurement.licensePools.unassign en la cuenta de facturación que contiene el grupo de licencias cuya licencia deseas 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 cuentas de usuario a las que se les asignará la licencia, por ejemplo, "[e-mail]", "[e-mail]".

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: la ruta de acceso del archivo JSON que creaste en el paso 2
   • PROJECT_ID: 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: el ID de la cuenta de facturación asociada con el grupo de licencias
   • ORDER_ID: el ID del pedido Si no conoces el ID del pedido, puedes recuperarlo enumerando los pedidos asociados con tu cuenta de facturación.

Si se realiza de forma correcta, la respuesta se verá como la siguiente:

{}

Para verificar la anulación de 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.

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 entre organizaciones de Gemini Code Assist Standard y Enterprise en un proyecto, puedes realizar una de las siguientes acciones:

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

Limitaciones

• La administración de licencias de Gemini para Google Cloud no admite la federación de identidades de personal.

¿Qué sigue?

• Obtén más información para ayudar a evitar el uso de licencias entre organizaciones.