Questo documento descrive come utilizzare Cloud Translation - Basic (v2) per tradurre il 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 presente tra i tag. L'output conserva i tag HTML (non tradotti), con il testo tradotto tra i tag, nella misura possibile a causa delle differenze tra le lingue di origine e di destinazione. L'ordine dei tag HTML nell'output può differire dall'ordine nel testo di input a causa di modifiche all'ordine delle parole nella traduzione.
Prima di iniziare
Per iniziare a utilizzare l'API Cloud Translation, devi avere un progetto in cui sia abilitata l'API Cloud Translation e disporre delle credenziali appropriate. Puoi anche installare librerie client per linguaggi di programmazione comuni per facilitare le chiamate all'API. Per saperne di più, consulta la pagina Configurazione.
Traduzione di testo
Questa sezione illustra alcuni modi per richiedere le traduzioni dall'endpoint https://translation.googleapis.com/language/translate/v2
.
Traduzione delle stringhe di input
REST
Per tradurre il testo, effettua una richiestaPOST
e fornisci
nel corpo della richiesta il codice JSON che identifica la lingua di destinazione (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 puoi superare i 128 segmenti di testo. Puoi specificare le lingue di destinazione utilizzando i codici ISO-639.
Di seguito è riportato un esempio di richiesta POST
mediante curl
o PowerShell. In questo esempio viene utilizzato il token di accesso per un account di servizio configurato per il progetto utilizzando Google Cloud CLI.
Per istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un account di servizio e sull'ottenimento di un token di accesso, consulta la pagina Configurazione.
Metodo e URL HTTP:
POST https://translation.googleapis.com/language/translate/v2
Corpo JSON richiesta:
{ "q": ["Hello world", "My name is Jeff"], "target": "de" }
Per inviare la richiesta, espandi una delle seguenti 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 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 scoprire di più, consulta la documentazione di riferimento per l'API Cloud Translation Go.
Per eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta 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 scoprire di più, consulta la documentazione di riferimento per l'API Cloud Translation Java.
Per eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta 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 scoprire di più, consulta la documentazione di riferimento per l'API Cloud Translation Node.js.
Per eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta 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 scoprire di più, consulta la documentazione di riferimento per l'API Cloud Translation Python.
Per eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta 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 poi consulta la documentazione di riferimento di Cloud Translation per .NET.
PHP: segui le istruzioni di configurazione di PHP nella pagina delle librerie client e poi 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 consulta la documentazione di riferimento di Cloud Translation per Ruby.
Parametro modello
Quando effettui una richiesta di traduzione in Cloud Translation - Basic, il tuo testo viene tradotto utilizzando il modello Google Neural Machine Translation (NMT). Non puoi utilizzare altri modelli. Per utilizzare i modelli AutoML per tradurre il 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 dei problemi o degli errori più comuni, consulta la pagina Risoluzione dei problemi.