Migra de avanzado a básico

Los usuarios existentes de Cloud Translation Basic (v2) que deseen usar las últimas funciones de Cloud Translation, como los glosarios y los modelos de AutoML, deben migrar sus aplicaciones para usar Cloud Translation Advanced (v3). Para obtener una comparación, consulta Compara Basic y Advanced.

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

Migra a la edición Advanced

En los siguientes pasos, se describen las acciones necesarias para actualizar tus aplicaciones existentes de Cloud Translation Basic a Cloud Translation Advanced.

1. Realiza un inventario de tus proyectos, aplicaciones y usuarios de Google Cloud que acceden a la API de Cloud Translation Basic. Deberás proporcionar cuentas de servicio y actualizarlas para que usen las bibliotecas cliente de Cloud Translation Advanced.
2. Configura las cuentas de servicio y la autenticación para tu aplicación.
3. Usa funciones de IAM para establecer permisos en las cuentas de servicio.
4. Habilita Cloud Translation Advanced en tu proyecto. Si usas modelos de AutoML con Cloud Translation Advanced, también debes habilitar AutoML. Para obtener más información, consulta la guía de Configuración.
5. Utiliza los métodos y bibliotecas cliente de Cloud Translation Advanced. En el caso de las solicitudes de Cloud Translation Advanced, debes incluir el número (o ID del proyecto) y su ubicación, como global o us-central1.
6. Verifica que el tamaño de tus solicitudes de traducción para Cloud Translation Advanced 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 Advanced y Basic

En las siguientes secciones, se describen las diferencias clave entre las ediciones Advanced y Basic para ayudarte a comprender tus tareas de migración.

Cuentas de servicio

En Cloud Translation Basic, puedes enviar solicitudes autenticadas mediante claves de API o cuentas de servicio.

Cloud Translation Advanced tiene funciones que requieren recursos administrados por el cliente. Estos recursos precisan de la función de IAM y de la administración de permisos. 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 Advanced.

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

Funciones de IAM

Cuando usas cuentas de servicio de Cloud Translation Basic, estas solo se usan para la autenticación. Puedes realizar llamadas a Cloud Translation Basic, sin importar los permisos asociados con la cuenta de servicio. Sin embargo, en el caso de Cloud Translation Advanced, los permisos sí se aplican.

A fin de otorgar permisos a las cuentas de servicio para llamar a Cloud Translation Advanced, asígnales funciones de IAM. Cloud Translation Advanced tiene varias funciones 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 textos, debes asignarle la función roles/cloudtranslate.user. Para obtener más información, consulta las funciones de IAM en Detalles de Cloud Translation Advanced.

Si planeas usar modelos de AutoML o cualquier función que use Cloud Storage, también debes incluir las funciones adecuadas para esos servicios. Para ver una lista de todas las funciones de IAM, consulta la documentación sobre las Funciones de IAM.

Modelos de traducción

Cuando solicitas una traducción mediante Cloud Translation Basic, Google usa un modelo de traducción automática neuronal (NMT) previamente entrenado. Para Cloud Translation Advanced, puedes usar el modelo de NMT previamente entrenado o un modelo personalizado de AutoML Translation.

Las cuentas de servicio que usas para las solicitudes de traducción deben tener los permisos para acceder a los modelos de NMT y AutoML, que se pueden ubicar 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 proyectos pueden usar esos modelos, pero requieren permisos para hacerlo.

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

Bibliotecas cliente

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

Recursos, proyectos y ubicaciones

Las solicitudes a Cloud Translation Advanced requieren el nombre del recurso que deseas usar. Por lo general, un recurso es un nombre calificado que incluye el nombre del proyecto y su ubicación, que 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 así:

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

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

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

Nota: Todos tus recursos incluidos en una sola solicitud a Cloud Translation Advanced 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, operaciones de larga duración), debes usar us-central1. También puedes usar us-central1 cuando uses modelos de traducción general y detección de idiomas. Solo puedes usar la ubicación global cuando uses modelos de traducción general y detección de idiomas.

Cloud Translation - Advanced también proporciona extremos multirregionales, como translate-eu.googleapis.com, para mantener el manejo de datos dentro de la UE. Este es un extremo único para la UE y no una configuración de la 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.

Consulta Cuotas para obtener más información sobre las cuotas y los límites.

¿Qué sigue?

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