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:
- 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 CLIx-goog-user-project: Es el ID del proyecto de tu 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 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
Verifica que tengas los siguientes permisos de IAM en la cuenta de facturación propietaria de la suscripción:
billing.accounts.getconsumerprocurement.orders.getconsumerprocurement.licensePools.getconsumerprocurement.licensePools.enumerateLicensedUsersresourcemanager.projects.get
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.
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.
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.
Verifica que tengas el permiso de IAM
consumerprocurement.licensePools.enumerateLicensedUsersen la cuenta de facturación que contiene el grupo de licencias cuyas asignaciones de licencias quieres ver.Usa
cURLpara 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.
En la consola de Google Cloud , ve a la página Administrador de Gemini.
Selecciona Administrar Gemini Code Assist y, luego, Administrar suscripción.
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.
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
Tdí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íaT+1. Por ejemplo, si configuras7dí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ía8.Selecciona Cerrar.
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.selfAssignreciben 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:
En la consola de Google Cloud , ve a la página Administrador de Gemini.
Selecciona Administrar Gemini Code Assist y, luego, Administrar suscripción.
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.
Selecciona Inhabilitar la administración automática de licencias.
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
Verifica que tengas los siguientes permisos de IAM en la cuenta de facturación propietaria de la suscripción:
billing.accounts.getconsumerprocurement.orders.getconsumerprocurement.licensePools.getconsumerprocurement.licensePools.enumerateLicensedUsersconsumerprocurement.licensePools.assignresourcemanager.projects.get
Ve a la página Administrador para Gemini.
Selecciona Administrar Gemini Code Assist y, luego, Modificar suscripción.
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.
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.comy dominios de Google Workspace. No se admite la federación de identidades de personal (BYOID).Selecciona Agregar usuario con licencia.
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.
- 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.getconsumerprocurement.licensePools.assignconsumerprocurement.licensePools.getconsumerprocurement.licensePools.unassignconsumerprocurement.orders.get
Crea un archivo JSON que contenga la siguiente información:
{ "usernames": [ USER_EMAILS ] }Reemplaza
USER_EMAILSpor 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.comy dominios de Google Workspace. No se admite la federación de identidades de personal (BYOID).Usa
cURLpara 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
Verifica que tengas los siguientes permisos de IAM en la cuenta de facturación propietaria de la suscripción:
billing.accounts.getconsumerprocurement.orders.getconsumerprocurement.licensePools.getconsumerprocurement.licensePools.enumerateLicensedUsersconsumerprocurement.licensePools.unassignresourcemanager.projects.get
Ve a la página Administrador para Gemini.
Selecciona Administrar Gemini Code Assist y, luego, Administrar suscripción.
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.
Selecciona los usuarios a los que quieras quitar la asignación de licencias y, luego, selecciona Anular la asignación de licencias.
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.
Para realizar esta tarea, debes tener el permiso
consumerprocurement.licensePools.unassignde Identity and Access Management (IAM) en la cuenta de facturación que contiene el grupo de licencias cuya licencia quieres anular.Crea un archivo JSON que contenga la siguiente información:
{ "usernames": [ USER_EMAILS ] }Reemplaza
USER_EMAILSpor 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".Usa
cURLpara 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:
- Inhabilitar la API de Gemini for Google Cloud en un proyecto
- Usar las políticas de denegación de Identity and Access Management (IAM) para denegar el acceso de usuarios específicos al proyecto
Limitaciones
- La administración de licencias de Gemini Code Assist no admite la federación de identidades de personal.