Come tradurre un intero foglio di calcolo utilizzando l'API di traduzione AI di Aspose.Cells Cloud
L’endpoint TranslateSpreadsheet, parte dell'API di traduzione foglio di calcolo, legge ogni elemento di testo in un libro, invia il contenuto a un servizio di traduzione alimentato dall’AI e restituisce un nuovo file foglio di calcolo in cui tutti i dati testuali sono renderizzati nella targetLanguage specificata. L’operazione mantiene intatti la struttura originale, gli stili delle celle, le formule e la struttura multi-foglio, rendendola ideale per la globalizzazione di report, dashboard e documenti basati sui dati. I formati di file supportati includono XLS, XLSX, XLSM, CSV e ODS. Gli errori vengono restituiti per codici linguistici non validi, errori di autenticazione o disservizi del servizio di traduzione.
API di traduzione foglio di calcolo
API Web
PUT https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet
Parametri della richiesta:
| Nome parametro | Tipo | Posizione | Obbligatorio/Opzionale | Descrizione |
|---|---|---|---|---|
| Spreadsheet | File | Richiesto | FormData | Il libro Excel da tradurre. Estensioni accettabili: .xls, .xlsx, .xlsm, .csv, .ods. Dimensione massima file: 50 MB. Esempio: budget.xlsx. |
| targetLanguage | string | Richiesto | Query | Codice linguistico ISO 639-1 per la lingua di output desiderata (ad esempio, “es” per spagnolo, “fr” per francese, “de” per tedesco). Deve essere una lingua supportata dal servizio AI sottostante. |
| region | string | Opzionale | Query | Identificatore di area geografica del foglio di calcolo che influisce sul formato specifico della localizzazione, come date, numeri e valuta. Valori comuni: “US”, “EU”, “CN”. Se omesso, viene utilizzata l’impostazione regionale originale del libro. |
| password | string | Opzionale | Query | Password per aprire un libro protetto. Lasciare vuoto quando il file non è protetto da password. |
Risposta
Risposta positiva (200 OK)
Intestazioni:
Content-Type: application/octet-stream // oppure text/csv quando viene richiesto l’output CSV
Content-Disposition: attachment; filename=“translated.xlsx”
Content-Length:
Corpo:
Le risposte di errore seguono il modello standard di errore di Aspose.Cells Cloud (application/json) con campi code, message e details opzionale.
Codici di stato HTTP
| Codice | Significato | Descrizione |
|---|---|---|
| 200 | OK | Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione. |
| 400 | Richiesta non valida | Parametri mancanti o non validi (ad esempio, tipo di file non supportato). |
| 401 | Non autorizzato | Token JWT non valido o mancante. |
| 413 | Payload troppo grande | Il file caricato supera il limite di dimensione. |
| 500 | Errore interno del server | Errore imprevisto del server. |
Dove dovremmo utilizzare l’API di traduzione foglio di calcolo?
- Reso conto finanziario internazionale – Converti report trimestrali Excel in più lingue per uffici regionali, mantenendo formule e layout dei grafici.
- Dashboard di marketing multilingue – Genera automaticamente versioni localizzate delle dashboard di performance delle vendite per team globali.
- Distribuzione di contenuti educativi – Traduci quaderni, schede di esercizi o fogli di calcolo curricolari per studenti in diversi paesi, senza copiare e incollare manualmente.
- Conformità normativa – Produci fogli di calcolo per la conformità specifici per lingua, mantenendo regole di convalida e liste di convalida dati.
Perché dovresti utilizzare l’API di traduzione foglio di calcolo?
- Precisione basata sull’AI – Sfrutta modelli neurali di traduzione all’avanguardia per conversioni linguistiche contestualmente consapevoli e di alta qualità.
- Nessuna alterazione della struttura – Mantiene esattamente come nel file sorgente le formule delle celle, la formattazione condizionale, i grafici e l’ordine dei fogli.
- Elaborazione multi-foglio in una singola chiamata – Traduce tutti i fogli di lavoro in una sola richiesta, eliminando la necessità di cicli per foglio.
- Integrazione cloud senza interruzioni – Funziona con l’autenticazione di Aspose.Cells Cloud, consentendo pipeline automatizzate in CI/CD, funzioni serverless o back-end aziendali.
Come utilizzare l’API di traduzione foglio di calcolo con gli SDK
Specifica dell’API di traduzione foglio di calcolo
La Specifica dell’API di traduzione foglio di calcolo fornisce un’interfaccia di programmazione pubblicamente accessibile per eseguire interazioni REST direttamente da un browser web.
SDK per API Excel
Utilizzare gli SDK di Aspose.Cells Cloud
L’utilizzo dell’SDK è il modo più rapido per sviluppare, poiché nasconde i dettagli a basso livello, consentendoti di unire un foglio di calcolo in un altro con codice minimo.
Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come interagire con i servizi web di Aspose.Cells utilizzando vari SDK: