Migra de Avanzado a Básico

Los usuarios existentes de Cloud Translation Básico (v2) que deseen usar sus funciones más recientes, como los glosarios y los modelos de AutoML, deberán migrar sus aplicaciones para usar Cloud Translation Avanzado (v3). Para obtener una comparación, consulta Compara Básico y Avanzado.

La migración a Avanzado incluye el uso de Identity and Access Management (IAM) y a las bibliotecas cliente de esta edición. En las siguientes secciones, se describen las tareas de migración y las diferencias clave entre las dos ediciones.

Migra a Avanzado

En los siguientes pasos, se describen las acciones obligatorias para actualizar tus aplicaciones existentes de Cloud Translation Básico a Cloud Translation Avanzado.

1. Realiza un inventario de tus proyectos, aplicaciones y usuarios de Google Cloud que acceden a la API de Cloud Translation Básico. Deberás proporcionar cuentas de servicio y actualizarlas para que usen las bibliotecas cliente de Cloud Translation Avanzado.
2. Configura las cuentas de servicio y la autenticación para tu aplicación.
3. Usa los roles de IAM para establecer los permisos en las cuentas de servicio.
4. Habilita Cloud Translation Avanzado en tu proyecto. Si usas modelos de AutoML con Cloud Translation Avanzado, también debes habilitar AutoML. Para obtener más información, consulta la guía de Configuración
5. Usa los métodos y las bibliotecas cliente de Cloud Translation Avanzado. Para las solicitudes de Avanzado, debes incluir el número o ID del proyecto, así como su ubicación (por ejemplo, global o us-central1).
6. Verifica que el tamaño de tus solicitudes de traducción para Cloud Translation Avanzado no supere el límite.
7. Planifica la supervisión de la cuota de solicitud de traducción. Ambas versiones de la API comparten las mismas cuotas diarias y mensuales.
8. Revisa cualquier posible cambio en la facturación.

Diferencias clave entre Avanzado y Básico

En las siguientes secciones, se describen las diferencias clave entre Avanzado y Básico que te ayudarán a comprender tus tareas de migración.

Cuentas de servicio

En Cloud Translation Básico, puedes enviar solicitudes autenticadas con claves de API o cuentas de servicio.

Cloud Translation Avanzado incluye funciones que requieren recursos administrados por el cliente. Estos recursos deben contar con un rol de IAM y con la administración de permisos adecuada. Por este motivo, no puedes usar claves de API para autenticarte en el servicio. En su lugar, debes usar cuentas de servicio cuando realizas la autenticación en Cloud Translation Avanzado.

Para obtener más información, consulta la guía de configuración.

Roles de IAM

Las cuentas de servicio de Cloud Translation Básico solo se usan para la autenticación. Puedes realizar llamadas a Cloud Translation Básico, independientemente de los permisos asociados a la cuenta de servicio. Sin embargo, en el caso de Cloud Translation Avanzado, los permisos sí se aplican.

Asigna roles de IAM a las cuentas de servicio para otorgarles permisos y llamar a Cloud Translation Avanzado. Avanzado tiene varios roles de IAM que puedes asignarle a tu cuenta de servicio para acceder a recursos específicos de tu proyecto. Por ejemplo, si deseas usar tu cuenta de servicio para traducir texto, debes asignarle el rol roles/cloudtranslate.user. Para obtener más información, consulta los roles de IAM descritos en Detalles de Cloud Translation Avanzado.

Si tienes pensado usar modelos de AutoML o cualquier función que use Cloud Storage, también debes incluir los roles adecuados para esos servicios. Para ver una lista completa, consulta la documentación sobre los Roles de IAM.

Modelos de traducción

Cuando solicitas una traducción con Cloud Translation Básico, Google usa un modelo de traducción automática neuronal (NMT) previamente entrenado. Para Cloud Translation Avanzado, puedes usar el modelo entrenado previamente de NMT, el LLM de Translation o un modelo personalizado de AutoML Translation.

Las cuentas de servicio que uses para las solicitudes de traducción deben tener permisos de acceso a los modelos de NMT y AutoML, que pueden ubicarse en diferentes proyectos. Por ejemplo, puedes tener un proyecto central que contenga tus modelos de traducción para simplificar el mantenimiento y la facturación. Las cuentas de servicio de ese proyecto o de otros pueden usar esos modelos, pero requieren permisos para hacerlo.

Para obtener más información sobre los modelos de traducción, consulta Traduce texto (Avanzado).

Bibliotecas cliente

Las bibliotecas cliente y los métodos de Cloud Translation Avanzado son diferentes de los de Cloud Translation Básico. Por ejemplo, las llamadas a Cloud Translation Avanzado requieren nombres de recursos. Para obtener más información, consulta la descripción general de las bibliotecas cliente de Cloud Translation Avanzado o prueba la guía de inicio rápido para traducir texto (Avanzado).

Recursos, proyectos y ubicaciones

Las solicitudes a Cloud Translation Avanzado requieren el nombre del recurso que deseas usar. Por lo general, un recurso tiene un nombre calificado que incluye el nombre del proyecto y su ubicación. Esto especifica dónde se ejecuta la solicitud. Por ejemplo, el nombre de un modelo de AutoML es un nombre de recurso.

Si tu proyecto de Google Cloud tiene el nombre my-project y la ubicación del recurso es us-central1, el nombre completo de tus recursos podría verse de la siguiente manera:

projects/MY_PROJECT/locations/us-central1/...

La URL a la que envías una solicitud getSupportedLanguages podría verse de la siguiente manera:

https://translation.googleapis.com/v3/projects/my-project/locations/us-central1/supportedLanguages

Nota: Todos los recursos incluidos en una sola solicitud a Cloud Translation Avanzado deben tener la misma ubicación. En la actualidad, solo se admiten las ubicaciones global y us-central1. En todos los recursos personalizados (modelos de AutoML, glosarios y operaciones de larga duración), debes usar us-central1. También puedes usar us-central1 para los modelos de traducción general y detección de idiomas, pero la ubicación global solo se puede usar en estos modelos.

Cloud Translation Avanzado también proporciona extremos multirregionales, como translate-eu.googleapis.com, para mantener el manejo de datos en la UE. Se trata de un extremo único para la UE y no de una configuración de ubicación en la API global. Para obtener más información, consulta Extremos globales y multirregionales.

Límite de contenido por solicitud

La API de Cloud Translation está optimizada para traducir solicitudes más pequeñas. La longitud máxima recomendada de cada solicitud es de 5,000 caracteres (puntos de código). Sin embargo, cuantos más caracteres incluyas, más alta será la latencia de la respuesta. En el caso de Cloud Translation Advanced, la cantidad máxima de puntos de código para una única solicitud es de 30,000. En el caso de Cloud Translation Basic, el tamaño máximo es de 100,000 bytes.

La API de Cloud Translation rechaza las solicitudes que superen el tamaño máximo y arroja un error 400 INVALID_ARGUMENT, sin importar la cuota disponible.

Para obtener más información sobre las cuotas y los límites, consulta Cuotas.

¿Qué sigue?

Usa Cloud Translation Avanzado para traducir texto, crear glosarios o realizar solicitudes por lotes.