Obtén licencias de Gemini Enterprise

En esta página, se describe cómo obtener suscripciones a Gemini Enterprise y asignar licencias a tus usuarios.

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 por su dirección de correo electrónico.

  • Licencias asignadas automáticamente: Puedes elegir que las licencias que forman parte de una suscripción se asignen automáticamente a un usuario la primera vez que acceda a la interfaz de Gemini Enterprise o NotebookLM Enterprise.

Las licencias son específicas para las multirregiones. Por ejemplo, si los usuarios quieren acceder a apps en la multirregión us y en global, asígnale una licencia en cada una.

Información sobre las suscripciones

Para obtener licencias, primero debes tener una suscripción a una edición de Gemini Enterprise. Para obtener información sobre las ediciones disponibles, consulta Comparación de las ediciones de Gemini Enterprise.

Las suscripciones son específicas de las regiones. Los usuarios que crean apps en la región global necesitan licencias de una suscripción a global. Del mismo modo, los usuarios que necesiten mantener sus apps y datos en la Unión Europea deberán tener licencias de una suscripción a eu.

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.

Antes de comenzar

Antes de comenzar los procedimientos de esta página, asegúrate de lo siguiente:

  • Completaste las tareas en Configura Gemini Enterprise. Esto incluye configurar una cuenta de facturación para tu proyecto y otorgar, al menos, el rol de Discovery Engine User a los usuarios a los que les otorgarás una licencia para usar Gemini Enterprise.

  • Tienes el rol de administrador de Discovery Engine.

Obtén una suscripción

Para obtener una suscripción a Gemini Enterprise, haz lo siguiente:

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

    Gemini Enterprise

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

  3. En la edición a la que te quieras suscribir, 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.

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.

  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.

Agrega usuarios y asígnales licencias de forma manual

Para darles acceso a Gemini Enterprise a usuarios específicos, 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:

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/global/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/global/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask":{
         "paths":[
            "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. Asigna 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 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.

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:

  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, la suscripción.

    Se asigna una licencia de esta suscripción cada vez que accede un usuario que no tiene una licencia asignada manualmente. Si no quedan licencias en la suscripción, se les mostrará a los usuarios un mensaje en el que se les notificará que no tienen acceso.

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

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 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, se 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:

REST

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. Asigna 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

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:

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":{
         "paths":[
            "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. Asigna 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?