Investigación del flujo de traducción de productos de Shopify con IA

Elige la vía de traducción que necesitas

Usa las herramientas para comerciantes de Shopify cuando una persona editora pueda gestionar directamente las traducciones. Usa la GraphQL Admin API cuando necesites una cola de revisión externa repetible y un desarrollador pueda mantener la aplicación. En la vía de API, un cliente de modelo separado redacta el texto mientras Shopify gestiona las traducciones almacenadas.

Empieza con una tienda de desarrollo y un producto. Lee sus campos traducibles, prepara un candidato, obtén la revisión y solo después envía los cambios previstos. Mantén separados los ajustes del modelo, las credenciales de la tienda y los permisos de publicación para poder inspeccionar y corregir cada paso de forma independiente.

Elige un flujo para comerciantes o una aplicación

La documentación de Translate & Adapt de Shopify describe la edición manual y la traducción automática, con revisión antes de publicar. Puede bastar cuando el comerciante quiere control editorial directo sin construir una aplicación. Una integración personalizada solo tiene sentido cuando un requisito concreto, como una cola de revisión externa, justifica hacerse cargo del conector.

Elige según quién mantendrá la cola de revisión y el mapeo de campos. Para una aplicación de terceros, inspecciona su configuración documentada, sus permisos y su comportamiento de exportación antes de instalarla. Un editor dirigido al comerciante y una aplicación con redacción externa mediante un modelo resuelven necesidades operativas diferentes.

Planifica los límites de autenticación y versión

La referencia de translatableResource requiere read_translations; translationsRegister requiere write_translations. Usa una tienda de desarrollo y registra la instalación de la aplicación, la versión de API y los scopes concedidos durante las pruebas. Una credencial de gateway de LLM no autentica una solicitud a la Shopify Admin API y un token de Shopify no debe enviarse al endpoint del modelo.

Empieza con acceso de lectura para el descubrimiento cuando el diseño de la aplicación lo permita. Añade solo los permisos necesarios para el flujo autorizado posterior. Fija una versión de API compatible después de revisar su referencia, en lugar de desplegar contra un alias latest no registrado. Mantén los tokens en el servidor y exclúyelos de las exportaciones de revisión y de los logs de solicitudes.

Lee los campos traducibles junto con sus digests

La consulta documentada devuelve un identificador de recurso y entradas traducibles con key, value, digest y locale. Conserva esos digests específicos de campo junto a la instantánea de origen. Vinculan una traducción propuesta al contenido que se leyó realmente, no a un título de producto copiado de una hoja de cálculo.

La consulta de abajo está adaptada del esquema oficial como ejemplo de solo lectura. Proporciona un GID de producto autorizado en un entorno de desarrollo. Inspecciona las claves devueltas y usa una lista de campos permitidos explícita; usa el locale de origen devuelto en lugar de inferirlo del idioma del navegador.

query TranslationSource($resourceId: ID!) {
  translatableResource(resourceId: $resourceId) {
    resourceId
    translatableContent {
      key
      value
      digest
      locale
    }
  }
}

Genera un candidato de traducción fuera de Shopify

Crea un registro interno de candidato que contenga el ID del recurso, la clave del campo, el source digest, el locale objetivo, la revisión del glosario y el valor de borrador. Envía al modelo solo el texto y el contexto de producto necesario. Mantén fuera del parche generado el SKU, el precio, la moneda, el inventario y la identidad de la variante.

Valida el texto obligatorio, los placeholders y la terminología aprobada antes de que el candidato llegue a un revisor bilingüe. Pide a un revisor de producto que compruebe las afirmaciones y advertencias contra la fuente original. Una extensión del navegador que traduzca el escaparate no crea este registro ni demuestra que Shopify haya almacenado una traducción; solo sirve como ayuda de inspección.

Registra solo traducciones aprobadas y vigentes

La mutación translationsRegister acepta campos traducidos con translatableContentDigest. Su resultado documentado incluye userErrors. Un conector debe inspeccionar ese resultado en lugar de tratar una respuesta HTTP por sí sola como prueba de un registro correcto.

Antes de una escritura autorizada, compara la fuente actual con la instantánea revisada. Si ha cambiado, retén el candidato y obtén una nueva revisión. Mantén una lista explícita de cambios de campo previstos y de traducciones anteriores para poder recuperar. Empieza con un campo en la tienda de desarrollo y vuelve a leerlo antes de ampliar el parche.

Verifica el escaparate por separado

La traducción almacenada y la disponibilidad en el escaparate son puntos de control separados en el flujo documentado de Shopify. Planifica con el comerciante la configuración del locale y las comprobaciones del tema. Guardar un valor traducido no debe autorizar automáticamente publicar un idioma o cambiar los ajustes del mercado.

En la tienda de desarrollo, inspecciona el producto objetivo, el selector de locale, el contenido de fallback, los enlaces y las etiquetas de variante. Vuelve a leer la traducción almacenada y compárala con el valor aprobado. Si falta un campo, investiga el soporte del recurso o el renderizado del tema antes de generar otra traducción. Conserva las observaciones sin presentar una tienda de desarrollo como un éxito comercial en vivo.

Evidencia y límites del conector

Las referencias oficiales establecen las interfaces de traducción de Shopify. Aquí no se ha probado una aplicación conectada a APIsRouter y las fuentes revisadas no establecen un ajuste arbitrario de baseURL de gateway en Shopify o Translate & Adapt. Trata la vía de aplicación personalizada como investigación de conector hasta obtener un resultado en una tienda de desarrollo.

Para una prueba completa, conserva la versión de la aplicación, el registro de autenticación con scopes, la consulta de origen, el candidato, la aprobación, el resultado del registro y la comparación de lectura posterior. Incluye un conflicto por cambio de fuente y una solicitud rechazada. Registra la identidad y el uso del modelo por separado de las operaciones de la tienda para que la afirmación de compatibilidad tenga un alcance claro.

Preguntas frecuentes