Cómo traducir una hoja de cálculo completa utilizando la API de traducción por IA de Aspose.Cells Cloud
El punto final TranslateSpreadsheet, parte de la API de traducción de hojas de cálculo, lee cada elemento de texto en un libro, envía el contenido a un servicio de traducción impulsado por IA y devuelve un nuevo archivo de hoja de cálculo donde todos los datos textuales se presentan en el targetLanguage especificado. La operación mantiene intacta la estructura original, los estilos de celda, las fórmulas y la estructura multi-hoja, lo que la hace ideal para internacionalizar informes, paneles de control y documentos basados en datos. Los formatos de archivo admitidos incluyen XLS, XLSX, XLSM, CSV y ODS. Se devuelven errores para códigos de idioma inválidos, fallos de autenticación o interrupciones del servicio de traducción.
API de traducción de hojas de cálculo
API web
PUT https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet
Parámetros de solicitud:
| Nombre del parámetro | Tipo | Ubicación | Obligatorio/Opcional | Descripción |
|---|---|---|---|---|
| Spreadsheet | Archivo | Obligatorio | FormData | El libro de Excel que se va a traducir. Las extensiones aceptables: .xls, .xlsx, .xlsm, .csv, .ods. Tamaño máximo del archivo: 50 MB. Ejemplo: budget.xlsx. |
| targetLanguage | string | Obligatorio | Query | Código de idioma ISO 639‑1 para el idioma de salida deseado (por ejemplo, “es” para español, “fr” para francés, “de” para alemán). Debe ser un idioma admitido por el servicio de IA subyacente. |
| region | string | Opcional | Query | Identificador de región de la hoja de cálculo que influye en el formato específico de la configuración regional, como fechas, números y monedas. Valores comunes: “US”, “EU”, “CN”. Si se omite, se utiliza la configuración de región original del libro. |
| password | string | Opcional | Query | Contraseña para abrir un libro protegido. Déjelo en blanco si el archivo no está protegido con contraseña. |
Respuesta
Respuesta correcta (200 OK)
Encabezados:
Content‑Type: application/octet-stream // o text/csv cuando se solicita salida en CSV
Content‑Disposition: attachment; filename=“translated.xlsx”
Content‑Length: <tamaño en bytes>
Cuerpo:
<flujo binario que contiene el archivo de hoja de cálculo traducido>
Las respuestas de error siguen el modelo estándar de errores de Aspose.Cells Cloud (application/json) con campos code, message y details (opcional).
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | OK | Filtro aplicado correctamente; la respuesta contiene detalles de la operación. |
| 400 | Solicitud incorrecta | Parámetros faltantes o inválidos (por ejemplo, tipo de archivo no admitido). |
| 401 | No autorizado | Token JWT inválido o faltante. |
| 413 | Carga útil demasiado grande | El archivo subido excede el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado del servidor. |
¿Dónde debemos utilizar la API de traducción de hojas de cálculo?
- Informes financieros internacionales – Convertir informes trimestrales en Excel a múltiples idiomas para oficinas regionales, preservando fórmulas y diseños de gráficos.
- Paneles de control de marketing multilingües – Generar automáticamente versiones localizadas de paneles de rendimiento de ventas para equipos globales.
- Distribución de contenido educativo – Traducir libretas de calificaciones, hojas de tareas u hojas de cálculo curriculares para estudiantes en diferentes países sin necesidad de copiar y pegar manualmente.
- Cumplimiento normativo – Generar hojas de cálculo específicas por idioma para cumplimiento normativo, conservando reglas de validación y listas de validación de datos.
¿Por qué debería utilizar la API de traducción de hojas de cálculo?
- Precisión impulsada por IA – Utiliza modelos avanzados de traducción neuronal para conversiones lingüísticas contextualmente conscientes y de alta calidad.
- Sin interrupción del diseño – Mantiene fórmulas de celda, formato condicional, gráficos y orden de hojas de cálculo exactamente como en el archivo original.
- Procesamiento multi-hoja en una sola llamada – Traduce todas las hojas de cálculo en una sola solicitud, eliminando la necesidad de bucles por hoja.
- Integración fluida en la nube – Funciona con la autenticación de Aspose.Cells Cloud, permitiendo canalizaciones automatizadas en CI/CD, funciones sin servidor o sistemas back-end empresariales.
Cómo utilizar la API de traducción de hojas de cálculo con SDK
Especificación de la API de traducción de hojas de cálculo
La Especificación de la API de traducción de hojas de cálculo proporciona una interfaz de programación accesible públicamente para realizar interacciones REST directamente desde un navegador web.
SDK de API de Excel
Utilizar los SDK de Aspose.Cells Cloud
Utilizar el SDK es la forma más rápida de desarrollar, ya que oculta los detalles de bajo nivel, permitiéndole fusionar una hoja de cálculo en otra con un código breve.
Consulte el repositorio de GitHub para ver una lista completa de los SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código muestran cómo interactuar con los servicios web de Aspose.Cells mediante diversos SDK: