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, 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 en la cuenta de facturación 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 APIs de Google, asegúrate de 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.
  • Asegúrate de que los siguientes pares clave-valor del encabezado estén presentes en todas las llamadas a la API:
    • Authorization: Tu token de acceso a Google Cloud de Google Cloud CLI
    • x-goog-user-project: El ID de tu 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 consola de la API, 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 administración de identidades y accesos 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 la API, 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.

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.

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

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 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
   • Correo electrónico.
   • Es la fecha en que se asignó la licencia.
   • Es la 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, ingresa las propiedades y los valores.
   • 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 Standard o Enterprise, usa el método billingAccounts.orders.licensePool.enumerateLicensedUsers.

1. Asegúrate de tener el permiso de IAM consumerprocurement.licensePools.enumerateLicensedUsers en la cuenta de facturación que contiene el grupo de licencias cuyas asignaciones de licencias 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: 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: el ID del pedido. Si no conoces el ID del pedido, puedes enumerar los pedidos asociados con tu cuenta de facturación para recuperarlo.

Si el comando tiene éxito, se 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 ORDER_ID no es válido, se muestra el resultado licensedUsers en el siguiente formato:

{}

Asignar manualmente licencias de Gemini Code Assist Standard y Enterprise 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.

   Ir a Gemini para Google Cloud

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

4. Para esta suscripción a Gemini Code Assist Standard o Enterprise, asegúrate de establecer Asignación de licencias en Asignar licencias de forma manual. 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 de forma manual, 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 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.

7. Asegúrate de otorgar a los usuarios 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. Asegúrate de tener 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

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 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: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: el ID del pedido. Si no conoces el ID del pedido, puedes enumerar los pedidos asociados con tu cuenta de facturación para recuperarlo.

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

{}

Para verificar la tarea, consulta la lista de tareas.

Luego, asegúrate de otorgar los roles de IAM Usuario de Gemini para Google Cloud y Consumidor de Service Usage a los usuarios con licencia.

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

Puedes asignar automáticamente una licencia a cualquier usuario de tu organización que requiera acceso a Gemini Code Assist Standard o Enterprise desde la página Asignación de licencias. La asignación automática de licencias se establece individualmente para cada 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 podrás 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 facturación después de una cantidad especificada de días de inactividad, según lo establezca el administrador.

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

   Ir a Gemini para Google Cloud

2. Selecciona Administrar Gemini Code Assist y, luego, Administrar suscripciones.

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

   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 debe transcurrir para que se anule la asignación de una licencia 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.

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 la API, 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, Administrar asignación automática de licencias. Aparecerá el diálogo Manage automatic license assignment.

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

5. Selecciona Confirmar cambio.

Cómo anular manualmente la asignación de licencias de Gemini Code Assist Standard y Enterprise

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.

   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, Administrar asignación automática de licencias. Aparecerá el diálogo Manage automatic license assignment.

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 las 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 de Identity and Access Management 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 las cuentas de usuario a las que se les asignó 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: 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: el ID del pedido. Si no conoces el ID del pedido, puedes enumerar los pedidos asociados con tu cuenta de facturación para recuperarlo.

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

{}

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

Cómo 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, 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 Standard y Enterprise se asignan a usuarios individuales, no a organizaciones ni 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 encuentran 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 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

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