Questo documento descrive come utilizzare Cloud Translation - Basic (v2) per tradurre un testo.
Il testo di input può essere testo normale o HTML. Cloud Translation - Basic non traduce alcun tag HTML nell'input, ma solo il testo visualizzato tra i tag. L'output contiene i tag HTML (non tradotti) e il testo tradotto tra i tag per quanto possibile a causa delle differenze tra la lingua di origine e quella di destinazione. L'ordine dei tag HTML nell'output potrebbe essere diverso da quello del testo di input a causa delle modifiche all'ordine delle parole nella traduzione.
Prima di iniziare
Prima di poter iniziare a utilizzare l'API Cloud Translation, devi disporre di un progetto in cui l'API Cloud Translation sia abilitata e delle credenziali appropriate. Puoi anche installare librerie client per i linguaggi di programmazione più comuni per effettuare chiamate all'API. Per ulteriori informazioni, consulta la pagina Configurazione.
Traduzione di testo
Questa sezione illustra alcuni modi per richiedere traduzioni dall'endpoint https://translation.googleapis.com/language/translate/v2
.
Traduzione di stringhe di input
REST
Per tradurre il testo, effettua una richiestaPOST
e fornisci nel corpo della richiesta un JSON che identifichi la lingua in cui tradurre (target
) e il testo da tradurre (q
). Puoi fornire più segmenti di testo da tradurre includendo più campi q
o un elenco di valori per il campo q
. Non è possibile avere più di 128 segmenti di testo. Puoi specificare le lingue di destinazione utilizzando i relativi codici ISO-639.
Di seguito è riportato un esempio di richiesta POST
mediante curl
o PowerShell. L'esempio utilizza il token di accesso per un account di servizio configurato per il progetto utilizzando Google Cloud CLI di Google Cloud.
Per istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un account di servizio e su come ottenere un token di accesso, consulta la pagina Configurazione.
Prima di utilizzare qualsiasi dato della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER_OR_ID
: l'ID numerico o alfanumerico del tuo progetto Google Cloud
Metodo HTTP e URL:
POST https://translation.googleapis.com/language/translate/v2
Corpo JSON della richiesta:
{ "q": ["Hello world", "My name is Jeff"], "target": "de" }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "data": { "translations": [ { "translatedText": "Hallo Welt", "detectedSourceLanguage": "en" }, { "translatedText": "Mein Name ist Jeff", "detectedSourceLanguage": "en" } ] } }
L'array translations
contiene due campi translatedText
con le traduzioni
fornite nella lingua richiesta target
(de
: tedesco). Le traduzioni sono elencate nello stesso ordine dell'array di origine corrispondente nella richiesta.
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Cloud Translation utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Translation Go.
Per autenticarti su Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta la pagina Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Cloud Translation utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Translation Java.
Per autenticarti su Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta la pagina Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Cloud Translation utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Translation Node.js.
Per autenticarti su Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta la pagina Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Cloud Translation utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Translation Python.
Per autenticarti su Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta la pagina Configurare l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: segui le istruzioni di configurazione di C# nella pagina delle librerie client e consulta la documentazione di riferimento di Cloud Translation per .NET.
PHP: segui le istruzioni di configurazione dei file PHP nella pagina delle librerie client e consulta la documentazione di riferimento di Cloud Translation per PHP.
Ruby: segui le istruzioni di configurazione di Ruby nella pagina delle librerie client e poi visita la documentazione di riferimento di Cloud Translation per Ruby.
Parametro del modello
Quando effettui una richiesta di traduzione in Cloud Translation - Basic, il testo viene tradotto utilizzando il modello NMT (Google Neural Machine Translation). Non puoi utilizzare nessun altro modello. Per utilizzare i modelli AutoML per tradurre un testo, utilizza Cloud Translation - Advanced.
Provalo
Se non hai mai utilizzato Google Cloud, crea un account per valutare le prestazioni di Cloud Translation in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Prova Cloud Translation gratuitamenteRisorse aggiuntive
- Per assistenza sulla risoluzione di problemi o errori comuni, consulta la pagina Risoluzione dei problemi.