Obtén suscripciones y asigna licencias para Gemini Enterprise

En esta página, se describe cómo obtener suscripciones a Gemini Enterprise y cómo administrar las licencias de usuario.

Por lo general, la configuración del acceso implica las siguientes etapas:

1. Procure: Compra una suscripción a una edición de producto para tu cuenta de facturación.
2. Distribuir: Asigna licencias de la suscripción a proyectos y ubicaciones específicos.
3. Asignar: Asigna las licencias distribuidas a usuarios individuales.

Acerca de las licencias

Para acceder a la app de Gemini Enterprise, el usuario debe tener una licencia. Las licencias se pueden asignar a los usuarios de forma manual o automática.

• Licencias asignadas manualmente: Puedes agregar usuarios con sus direcciones de correo electrónico.

• Licencias asignadas automáticamente: Puedes configurar una suscripción para que Gemini Enterprise asigne automáticamente una licencia a un usuario la primera vez que acceda a Gemini Enterprise o a la interfaz de Gemini Notebook Enterprise.

Nota: Las licencias son específicas de un Google Cloud proyecto y una ubicación. Por ejemplo, si los usuarios necesitan acceder a una app de Gemini Enterprise ubicada en un proyecto Google Cloud que se encuentra en las multirregiones de EE.UU. y globales, debes tener dos licencias separadas para estas dos ubicaciones separadas dentro del mismo proyecto Google Cloud .

Información sobre las suscripciones

Para obtener licencias, primero debes tener una suscripción a una edición de Gemini Enterprise. Las suscripciones son específicas de una cuenta de facturación. Para obtener información sobre las ediciones disponibles, consulta Compara las ediciones de Gemini Enterprise.

En el caso de Gemini Enterprise, puedes comprar una suscripción mensual o anual. Estas suscripciones se pueden configurar para que se renueven automáticamente.

Puedes comprar suscripciones para las ediciones Gemini Enterprise Standard, Gemini Enterprise Plus y Gemini Enterprise con pago por uso a través de la consola deGoogle Cloud .

Límites de cantidad de licencias de suscripción

Cuando compras o modificas una suscripción basada en asientos directamente a través de la consola deGoogle Cloud , se aplican límites automáticos en la cantidad de asientos según el tipo de tu cuenta de Facturación de Cloud:

• Cuentas de facturación de autoservicio (o en línea) y revendidas: Se limitan a un máximo de 25 puestos por cuenta cuando se administran suscripciones con la consola de Google Cloud .
• Cuentas de facturación facturadas (o sin conexión): Se limitan a un máximo de 1,000 puestos por cuenta.

Si tu organización requiere más licencias o si recibes el error de límite máximo de licencias cuando intentas agregar licencias a una suscripción existente, comunícate con tu Google Cloud representante de ventas o administrador de cuentas para comprar licencias adicionales a través de un pedido sin conexión o solicitar una excepción de la lista de entidades permitidas.

Información sobre los estados de suscripción

Una suscripción puede tener uno de los siguientes estados:

Estado	Descripción
Sin iniciar	Compraste la suscripción, pero aún no está activa. Puedes distribuir licencias de esta suscripción a los proyectos, pero los usuarios a los que se les asignen estas licencias no tendrán acceso a Gemini Enterprise hasta que la suscripción se active. Para obtener más información, consulta Cómo distribuir licencias.
Activo	La suscripción está activa y los usuarios que tienen una licencia en esta suscripción pueden acceder a Gemini Enterprise.
Desactivando	La suscripción está en estado de desactivación, con licencias programadas para la rescisión anticipada. Los usuarios con licencias en esta suscripción seguirán teniendo acceso a Gemini Enterprise durante un período de gracia de una semana. Después de esta semana, las licencias pasan al estado Vencida. Para obtener más información, consulta Cómo controlar la finalización anticipada.
Vencido	Los usuarios con licencias en esta suscripción pierden el acceso a Gemini Enterprise cuando finaliza el plazo de la suscripción o cuando las licencias pasan del estado de desactivación al estado de vencimiento después de la cancelación anticipada.

Antes de comenzar

Antes de comenzar con los procedimientos de esta página, asegúrate de cumplir con los siguientes requisitos previos:

• Completa todas las tareas que se describen en Configura Gemini Enterprise. Esto incluye lo siguiente:

  • Configurar una cuenta de facturación para tu proyecto
  • Otorga al menos el rol de Usuario de Gemini Enterprise a los usuarios a los que les otorgarás licencias para usar Gemini Enterprise.

• Verifica que la facturación esté habilitada para tu proyecto de Google Cloud . Para obtener más información, consulta Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

  Nota: La suscripción a Gemini Enterprise con pago por uso solo está disponible para las cuentas facturadas. Para obtener más información, consulta Tipos de cuentas de Facturación de Cloud.

• Confirma que tienes los roles y permisos de IAM necesarios:

  • El rol de administrador de Gemini Enterprise

  • Si administras la facturación de tu organización, debes tener los siguientes roles para administrar las suscripciones a Gemini Enterprise y los pedidos de compra.

    • Administrador de cuentas de facturación (roles/billing.admin)
    • Consumidor de Service Usage (roles/serviceusage.serviceUsageConsumer)

    Como alternativa, para un control de IAM detallado, puedes usar un rol personalizado con los siguientes permisos en lugar del rol de Administrador de cuentas de facturación:

    Servicio	Permisos
    Discovery Engine	discoveryengine.billingAccountLicenseConfigs.distribute discoveryengine.billingAccountLicenseConfigs.get discoveryengine.billingAccountLicenseConfigs.list discoveryengine.billingAccountLicenseConfigs.retract discoveryengine.licenseConfigs.create discoveryengine.licenseConfigs.get discoveryengine.licenseConfigs.list discoveryengine.licenseConfigs.update discoveryengine.projects.get discoveryengine.projects.provision discoveryengine.projects.reportConsentChange discoveryengine.userStores.batchUpdateUserLicenses discoveryengine.userStores.listUserLicenses
    Adquisición de consumidores	consumerprocurement.orders.get consumerprocurement.licensePools.assign consumerprocurement.licensePools.unassign consumerprocurement.licensePools.enumerateLicensedUsers
    Resource Manager	resourcemanager.projects.get resourcemanager.projects.list
    Service Usage	serviceusage.services.get serviceusage.services.list

Obtén una suscripción

Para obtener licencias, compra una suscripción a una edición de Gemini Enterprise para tu cuenta de facturación. La suscripción proporciona un grupo de licencias que puedes usar con cualquier proyecto conectado a esa cuenta de facturación, distribuir a los proyectos y asignar a los usuarios.

Standard y Plus

Para suscribirte a la edición Gemini Enterprise Standard o Plus, haz lo siguiente:

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

   Gemini Enterprise

2. Haz clic en Administrar suscripciones > Crear suscripción.

3. En el caso de las ediciones Gemini Enterprise Standard o Gemini Enterprise Plus, haz clic en Suscribirse.

4. Configura los detalles de facturación:

   1. Selecciona la Cuenta de facturación en el menú desplegable.
   2. Ingresa un nombre de suscripción.
   3. Ingresa la cantidad de licencias que necesitas para la edición.

5. Selecciona el Período de suscripción.

6. Si deseas que la suscripción se renueve automáticamente, selecciona Suscripción con renovación automática.

7. Configura los detalles de distribución:

   1. En el menú desplegable Seleccionar un proyecto, selecciona tu proyecto.
   2. Elige un tipo de ubicación para tu suscripción. Si no tienes motivos regulatorios o de cumplimiento para ubicar tus datos en las multirregiones de EE.UU. o la UE, Google recomienda que elijas la multirregión global para obtener la máxima disponibilidad y una latencia baja.

8. Haz clic en Crear > Confirmar.

Pago por uso

Con una suscripción de pago por uso, pagas mensualmente por lo que consumes a las tarifas que se indican en Excedentes. Puedes usar la suscripción con cualquier proyecto conectado a tu cuenta de facturación.

Nota: La suscripción de pago por uso solo está disponible para las cuentas de Facturación de Cloud facturadas. Para obtener más información, consulta Tipos de cuentas de Facturación de Cloud.

Para suscribirte a la edición de Gemini Enterprise con pago por uso, haz lo siguiente:

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

   Gemini Enterprise

2. Haz clic en Administrar suscripciones > Crear suscripción.

3. En la edición Gemini Enterprise con pago por uso, haz clic en Suscribirse.

4. Configura los detalles de facturación:

   1. Ingresa un nombre de suscripción.
   2. Ingresa la cantidad de licencias que necesitas para la edición.

5. Configura los detalles de distribución:

   1. En el menú desplegable Seleccionar un proyecto, selecciona tu proyecto.
   2. Elige un tipo de ubicación para tu suscripción. Si no tienes motivos regulatorios o de cumplimiento para ubicar tus datos en las multirregiones de EE.UU. o la UE, Google recomienda que elijas la multirregión global para obtener la máxima disponibilidad y una latencia baja.

6. Haz clic en Crear > Confirmar.

Administrar las suscripciones

En esta sección, se describe cómo ver, actualizar, distribuir y recuperar suscripciones a Gemini Enterprise.

Ver detalles de la suscripción

Para ver los detalles de tus suscripciones a Gemini Enterprise, haz lo siguiente:

Console

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

   Gemini Enterprise

2. Haz clic en Administrar suscripciones.

3. Selecciona la Cuenta de facturación en el menú desplegable.

4. En la tabla Suscripciones a Gemini, haz clic en el nombre de tu suscripción.

REST

Para obtener detalles de la suscripción, ejecuta el siguiente comando:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

Reemplaza lo siguiente:

• PROJECT_NUMBER: Es el número del proyecto en el que tienes el rol de consumidor de Service Usage.
• BILLING_ACCOUNT_ID: ID de tu Google Cloud cuenta de facturación.

Ejemplo de resultado

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

Actualiza la configuración de la suscripción

Después de crear una suscripción, puedes actualizar la configuración, como la cantidad de licencias o el parámetro de configuración de renovación automática.

El método para agregar más licencias depende de cómo compraste originalmente tu suscripción:

• Si compraste tu suscripción a través de la consola de Google Cloud , agrega más licencias directamente en la consola de Google Cloud siguiendo los pasos que se indican en esta sección.
• Si realizaste la compra con un formulario de pedido sin conexión, debes actualizarlo con la nueva cantidad de licencias. Comunícate con tu administrador de cuentas de Google para actualizar el formulario de pedido.

Nota: Cuando actualices la cantidad de puestos de tu suscripción en la consola de Google Cloud , se aplicarán límites máximos de puestos según el tipo de cuenta de facturación (hasta 25 puestos para las cuentas de facturación de autoservicio [o en línea] y revendidas, y hasta 1,000 puestos para las cuentas de facturación con facturas [o sin conexión]). Para obtener más información, consulta Límites de cantidad de puestos de suscripción.

Si tu suscripción existente supera estos umbrales (por ejemplo, si se aprovisionó inicialmente a través de un pedido sin conexión dirigido por el equipo de ventas), intentar agregar más licencias directamente a través de la consola Google Cloud podría generar un error de límite de licencias. Comunícate con tu Google Cloud representante de ventas o administrador de cuentas para ajustar la cantidad de licencias o solicitar una excepción de la lista de entidades permitidas.

Sigue estos pasos para actualizar el recuento de licencias si realizaste la compra a través de laGoogle Cloud consola:

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

   Gemini Enterprise

2. Haz clic en Administrar suscripciones.

3. Haz clic en la suscripción que quieras actualizar en la tabla Suscripciones a Gemini.

4. Haz clic en Editar junto a Detalles de la suscripción.

5. Actualiza la cantidad de licencias o activa o desactiva la renovación automática.

6. Haz clic en Enviar.

Cancela una suscripción

Para cancelar una suscripción a Gemini Enterprise, debes desactivar la renovación automática. Tu suscripción permanecerá activa hasta que finalice el plazo de suscripción, y es posible que se te cobren cargos hasta esa fecha. Para obtener más información sobre tu suscripción, consulta Cómo ver los detalles de la suscripción.

Sigue estos pasos para cancelar tu suscripción:

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

   Gemini Enterprise

2. Haz clic en Administrar suscripciones.

3. En la tabla Suscripciones a Gemini, haz clic en el nombre de tu suscripción para abrir la página de detalles.

4. Haz clic en Editar.

5. En el panel Editar suscripción, desmarca la casilla de verificación Renovar suscripción automáticamente.

6. Haz clic en Enviar.

Distribuye licencias

Si no distribuiste las licencias suscritas a un proyecto, lo que puede ocurrir cuando compras la suscripción sin conexión o cuando falló la distribución de licencias anteriormente, haz lo siguiente:

Nota: Una suscripción a Gemini Enterprise Standard o Plus también otorga acceso a las funciones de Gemini Code Assist Standard en los IDE admitidos. Debes asignar estas licencias por separado en las páginas del administrador de Gemini Code Assist. Para obtener más información, consulta Configura Gemini Code Assist.

Esta capacidad no se incluye en los niveles Business ni Frontline. Para obtener más información sobre las funciones incluidas en cada nivel, consulta Compara las ediciones de Gemini Enterprise.

Console

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

   Gemini Enterprise

2. Haz clic en Administrar suscripciones.

3. Selecciona la Cuenta de facturación en el menú desplegable.

4. En la tabla Suscripciones a Gemini, haz clic en el nombre de tu suscripción.

5. Haz clic en Distribute License en la parte superior de la página. Aparecerá una lista en la que se mostrarán las distribuciones de licencias existentes y las estadísticas de los asientos restantes y totales.

6. Para distribuir licencias a un proyecto, sigue estos pasos:

   1. Haz clic en el selector de proyectos para seleccionar uno. El selector admite el autocompletado.
   2. Nota: Si no habilitaste la API de Discovery Engine para el proyecto seleccionado, aparecerá un diálogo en el que se te solicitará que lo hagas.
   3. Selecciona una ubicación.
   4. Ingresa la cantidad de licencias que se asignarán.
   5. Repite estos pasos si deseas distribuir licencias a varios proyectos o ubicaciones.

7. Haz clic en Enviar.

8. En el cuadro de diálogo de confirmación, revisa el resumen de los cambios y haz clic en Confirmar.

REST

Para distribuir licencias a un proyecto o a varios proyectos, ejecuta el siguiente comando:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

Reemplaza lo siguiente:

• PROJECT_NUMBER: Es el número del proyecto para el que tienes el rol de consumidor de Service Usage.
• ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
  • us para la multirregión de EE.UU.
  • eu para la multirregión de la UE
  • global para la ubicación global
  Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
• LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
• TARGET_PROJECT_NUMBER: Es el número del proyecto al que deseas distribuir licencias.
• LICENSE_COUNT: Es la cantidad de licencias que se distribuirán.
• BILLING_ACCOUNT_ID: ID de tu Google Cloud cuenta de facturación.
• BILLING_ACCOUNT_LICENSE_CONFIG_ID: Busca el ID de configuración de licencia de la cuenta de facturación en los detalles de la suscripción.

• Opcional LICENSE_CONFIG_ID: Es el ID de una configuración de licencia existente a nivel del proyecto. Puedes encontrar este ID en el campo licenseConfigDistributions cuando consultas los detalles de la suscripción.

  Nota: Si omites LICENSE_CONFIG_ID en esta solicitud a la API, se creará una nueva configuración de licencia para el número de proyecto y la ubicación especificados. Para actualizar una configuración de licencia existente, debes incluir el LICENSE_CONFIG_ID.

Cómo recuperar licencias no asignadas en una suscripción

En esta sección, se describe cómo recuperar licencias no asignadas de un proyecto para que estén disponibles en la cuenta de facturación y se puedan redistribuir a otros proyectos.

Console

Nota: Solo puedes realizar esta acción una vez por día calendario.

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

   Gemini Enterprise

2. Haz clic en Administrar suscripciones.

3. Selecciona la Cuenta de facturación en el menú desplegable.

4. En la tabla Suscripciones a Gemini, haz clic en el nombre de tu suscripción.

5. Haz clic en Distribute License en la parte superior de la página (este botón abre el formulario de administración para todas las asignaciones).

6. En la lista de asignaciones, busca la fila del proyecto y la ubicación de los que deseas recuperar licencias.

7. Elige una de las siguientes acciones:

   • Para reducir la cantidad de licencias, disminuye el recuento en el campo de entrada de licencias.
   • Para recuperar licencias por completo, mueve el puntero sobre la fila para que aparezca el botón de borrado y, luego, haz clic en Borrar.

8. Haz clic en Enviar.

9. En el cuadro de diálogo de confirmación, revisa el resumen de los cambios (en el que se enumerarán las licencias recuperadas) y haz clic en Confirmar.

REST

Nota: Solo puedes realizar esta acción una vez al día.

Para transferir las licencias de suscripción a la cuenta de facturación para su redistribución, ejecuta el siguiente comando:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

Reemplaza lo siguiente:

• PROJECT_NUMBER: Es el número del proyecto para el que tienes el rol de consumidor de Service Usage.
• ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
  • us para la multirregión de EE.UU.
  • eu para la multirregión de la UE
  • global para la ubicación global
  Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
• LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
• TARGET_PROJECT_NUMBER: Es el número del proyecto del que deseas recuperar licencias.
• LICENSE_COUNT: Es la cantidad de licencias que se recuperarán.
• BILLING_ACCOUNT_ID: ID de tu Google Cloud cuenta de facturación.
• BILLING_ACCOUNT_LICENSE_CONFIG_ID: Busca el ID de configuración de licencia de la cuenta de facturación en los detalles de la suscripción.
• LICENSE_CONFIG_ID: Es el ID de configuración de la licencia de una configuración de licencia existente a nivel del proyecto.

Cómo controlar la finalización anticipada

Cuando migras entre diferentes tipos de suscripciones o si hay un problema con tu cuenta de facturación, es posible que una suscripción finalice antes de lo previsto.

Para garantizar una transición más fluida y evitar interrupciones del servicio, proporcionamos un período de gracia de una semana (siete días) en el que las licencias afectadas se encuentran en un estado de desactivación antes de que venzan por completo. Durante este período de gracia, puedes seguir usando el servicio mientras cambias a una suscripción nueva.

Para garantizar que tus usuarios conserven el acceso, transfiere sus licencias a una suscripción nueva y activa de forma automática o manual.

En la siguiente imagen, se muestra un ejemplo de una licencia que se desactiva en la consola deGoogle Cloud :

Administra las licencias de usuario

En esta sección, se describe cómo ver licencias, exportar datos del usuario y asignar, transferir y quitar licencias para usuarios individuales.

Ver licencias

Para ver las licencias y los usuarios a los que se les asignaron, haz lo siguiente:

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

   Gemini Enterprise

2. Haz clic en Administrar usuarios.

3. Selecciona la opción Multirregión de la licencia existente.

Exporta datos del usuario

La tabla de usuarios de la consola de Google Cloud no admite la clasificación ni el filtrado. Si necesitas ordenar, filtrar o analizar tus datos de usuarios, puedes exportar hasta 1,000,000 de registros de usuarios a un archivo de valores separados por comas (CSV).

El archivo CSV exportado incluye las siguientes columnas.

Nombre de la columna	Descripción
user_principal	Dirección de correo electrónico del usuario.
license_config	Nombre completo del recurso Google Cloud de la suscripción asignada al usuario (por ejemplo,projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). El ID de configuración de la licencia corresponde a la edición de Gemini Enterprise (por ejemplo, Standard o Plus) asignada al usuario.
assignment_time	Es la marca de tiempo (en UTC) en la que un administrador asignó la licencia.
last_login_time	Es la marca de tiempo (en UTC) en la que el usuario accedió por última vez.
license_assignment_state	Es el estado de la asignación de la licencia. Los siguientes valores están disponibles: ASSIGNED: El usuario tiene una licencia asignada. NO_LICENSE: El usuario no tiene una licencia porque un administrador no le asignó una o quitó una licencia existente. BLOCKED: Una política o un administrador impiden que el usuario reciba una licencia.

Para exportar datos del usuario a un archivo CSV, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Gemini Enterprise > Administrar usuarios.

   Administra usuarios

2. Selecciona la opción Multirregión de la licencia existente.

3. En la sección Usuarios, haz clic en Exportar todos los usuarios.

   Según el tamaño de la tabla de usuarios, el proceso de exportación puede tardar hasta 2 minutos y medio en completarse. Durante este tiempo, la consola muestra un estado de carga. Cuando finalice la exportación, tu navegador descargará el archivo CSV en su ubicación de descarga predeterminada.

Soluciona problemas de exportación

En la siguiente tabla, se enumeran los problemas comunes que se producen cuando se exportan datos del usuario y sus soluciones.

Problema	Solución
El botón Export all users está oculto	Asegúrate de que haya usuarios asignados a licencias en la región múltiple seleccionada. Si no hay usuarios asignados, no aparecerá el botón Export all users.
La solicitud de exportación falla con un error de límite excedido	Si tu lista de usuarios supera el límite de exportación de 1,000,000 de usuarios, la consola de Google Cloud rechazará la solicitud de exportación y mostrará un mensaje de error de límite excedido.
La solicitud de exportación falla con un error de permiso denegado	Asegúrate de que tu cuenta tenga el rol de administrador de Gemini Enterprise, que incluye el permiso discoveryengine.userStores.listUserLicenses requerido.

Asignar licencias a los usuarios

En esta sección, se explica cómo asignar licencias a usuarios nuevos de forma automática o manual. Puedes asignar una licencia a un usuario nuevo en cualquier momento y, después de que se asigne, el usuario podrá acceder a Gemini Enterprise de inmediato.

Agrega usuarios y asígnales licencias automáticamente

Para asignar licencias a los usuarios automáticamente cuando accedan a la app de Gemini Enterprise, haz lo siguiente:

Nota: Asegúrate de que tu suscripción tenga suficientes licencias para la cantidad máxima de usuarios que se espera que usen Gemini Enterprise.

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

   Gemini Enterprise

2. Haz clic en Administrar usuarios.

3. Selecciona la opción Multirregión de la licencia existente.

4. Selecciona Asignar licencias automáticamente y, luego, selecciona la suscripción.

   Cada vez que un usuario sin una licencia asignada manualmente accede, Gemini Enterprise le asigna automáticamente una licencia de esta suscripción. Si no quedan licencias en la suscripción, Gemini Enterprise les muestra a los usuarios un mensaje en el que se les notifica que no tienen acceso.

   Para obtener más información sobre las suscripciones, consulta la sección Acerca de las suscripciones.

Agrega usuarios y asígnales licencias de forma manual

Para darles acceso a usuarios específicos a Gemini Enterprise, puedes asignarles licencias manualmente desde una suscripción activa.

Console

Para asignar licencias a los usuarios de forma manual, haz lo siguiente:

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

   Gemini Enterprise

2. Haz clic en Administrar usuarios.

3. Selecciona la opción Multirregión de la licencia existente.

4. Haz clic en Agregar usuarios.

5. En la página Agregar usuarios, haz lo siguiente:

   1. Ingresa las direcciones de correo electrónico de los usuarios. Asegúrate de usar la misma dirección de correo electrónico que utilizará para acceder a la app de Gemini Enterprise.

   2. Selecciona la suscripción que se asignará a esos usuarios.

   3. Haz clic en Enviar.

REST

Para asignar licencias a los usuarios de forma manual, ejecuta el siguiente comando:

Término clave: En Gemini Enterprise, el término app se puede usar indistintamente con el término motor en el contexto de las APIs. Un motor de Gemini Enterprise es un motor de búsqueda genérico en el que el campo app_type se establece en APP_TYPE_INTRANET.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":false
  }'

Reemplaza lo siguiente:

• PROJECT_ID: el ID de tu proyecto.
• ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
  • us para la multirregión de EE.UU.
  • eu para la multirregión de la UE
  • global para la ubicación global
  Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
• LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
• USER_EMAIL: La dirección de correo electrónico del usuario que deseas agregar a la licencia.
• PROJECT_NUMBER: Es el número de tu proyecto de Google Cloud .
• SUBSCRIPTION_ID: Es el ID de tu suscripción a Gemini Enterprise.

Cómo transferir licencias de suscripciones vencidas

Los usuarios no pueden acceder a Gemini Enterprise si la suscripción venció. Existen dos enfoques para devolverles el acceso:

• Transfiere automáticamente a los usuarios existentes con licencias vencidas a la suscripción predeterminada.

• Transfiere manualmente a los usuarios existentes a una suscripción nueva.

Nota: Si anteriormente bloqueaste el acceso de un usuario a una licencia, Gemini Enterprise le otorgará acceso en un plazo de 30 minutos después de que le asignes la nueva licencia.

Transferir automáticamente a los usuarios a una suscripción activa

Para transferir automáticamente a los usuarios a una suscripción activa, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Gemini Enterprise > Administrar usuarios.

   Licencia de Gemini Enterprise

2. Selecciona la opción Multirregión de la licencia existente.

3. Asegúrate de tener una suscripción activa. Si no tienes una, obtén una suscripción.

4. Selecciona Asignar licencias automáticamente y elige la suscripción activa.

5. Selecciona Actualizar automáticamente la licencia vencida.

   Cuando un usuario con una licencia vencida vuelva a acceder, Gemini Enterprise le otorgará automáticamente una licencia en la suscripción elegida.

Cómo transferir usuarios manualmente a una suscripción activa

Para transferir usuarios manualmente a una suscripción activa, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Gemini Enterprise > Administrar usuarios.

   Licencia de Gemini Enterprise

2. Selecciona la opción Multirregión de la licencia existente.

3. Asegúrate de tener una suscripción activa. Si no tienes una, obtén una suscripción.

4. Selecciona los usuarios y haz clic en Asignar otra licencia.

5. En el panel Edit Users, selecciona la suscripción y haz clic en Submit.

Enumera las licencias

Para enumerar las licencias y los usuarios asignados a ellas, ejecuta el siguiente comando:

Término clave: En Gemini Enterprise, el término app se puede usar indistintamente con el término motor en el contexto de las APIs. Un motor de Gemini Enterprise es un motor de búsqueda genérico en el que el campo app_type se establece en APP_TYPE_INTRANET.

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

Reemplaza lo siguiente:

• PROJECT_ID: el ID de tu proyecto.
• ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
  • us para la multirregión de EE.UU.
  • eu para la multirregión de la UE
  • global para la ubicación global
  Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
• LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.

Cómo quitar usuarios de una licencia

Puedes quitar una licencia de un usuario en cualquier momento. Cuando se quita una licencia, el usuario pierde el acceso a Gemini Enterprise de inmediato. Para quitar usuarios de una licencia, haz lo siguiente:

Console

Para quitar usuarios de una licencia con la consola de Google Cloud , haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Gemini Enterprise > Administrar usuarios.

   Licencia de Gemini Enterprise

2. Selecciona la opción Multirregión de la licencia existente.

3. En la tabla de usuarios, selecciona los usuarios.

4. Para quitar usuarios de una licencia, elige una de las siguientes opciones:

   • Para quitar la licencia solo de los usuarios seleccionados, haz clic en Anular la asignación de la licencia.
   • Para quitar la licencia y borrar a los usuarios seleccionados del proyecto, haz clic en Anular la asignación y borrar la licencia.

5. Haz clic en Confirmar.

REST

Para quitar usuarios de una licencia, ejecuta el siguiente comando:

Término clave: En Gemini Enterprise, el término app se puede usar indistintamente con el término motor en el contexto de las APIs. Un motor de Gemini Enterprise es un motor de búsqueda genérico en el que el campo app_type se establece en APP_TYPE_INTRANET.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

Reemplaza lo siguiente:

• PROJECT_ID: el ID de tu proyecto.
• ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
  • us para la multirregión de EE.UU.
  • eu para la multirregión de la UE
  • global para la ubicación global
  Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
• LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
• USER_EMAIL: Es la dirección de correo electrónico del usuario que deseas quitar de la licencia.

¿Qué sigue?

• Obtén más información sobre las preguntas frecuentes sobre las licencias de Gemini Enterprise.
• Obtén más información sobre los roles y permisos de IAM.