Administra las licencias de Gemini Code Assist Standard y Enterprise

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

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

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:

{}

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

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

{}

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

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.

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 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 la asignación automática de licencias. Aparecerá el 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 Quitar asignación de licencia.

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 en la cuenta de facturación que contiene el grupo de licencias cuya licencia deseas anular la asignación.

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

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

{}

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