Questo documento descrive come utilizzare Cloud Translation - Basic (v2) per tradurre il testo.
Il testo inserito può essere testo normale o HTML. Cloud Translation - Basic non traduce nessun tag HTML nell'input, ma solo il testo visualizzato tra i tag. Nella misura possibile, l'output conserva i tag HTML (non tradotti), con il testo tradotto tra i tag, a causa delle differenze tra le lingue di origine e di destinazione. L'ordine dei tag HTML nell'output potrebbe differire dall'ordine nel testo di input a causa delle modifiche all'ordine delle parole nella traduzione.
Prima di iniziare
Prima di iniziare a utilizzare l'API Cloud Translation, devi avere un progetto in cui sia abilitata l'API Cloud Translation e disporre di una chiave privata con le credenziali appropriate. Puoi anche installare librerie client per linguaggi di programmazione comuni per aiutarti a 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 &CMD LINE
Per tradurre un testo, fai una richiestaPOST
e fornisci
nel corpo della richiesta il codice JSON che identifichi la lingua di origine (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 relativi codici
ISO-639-1.
Di seguito è riportato un esempio di richiesta POST
tramite
curl
o PowerShell. L'esempio utilizza il token di accesso per un account di servizio configurato per il progetto utilizzando l'interfaccia a riga di comando di Google Cloud.
Per istruzioni sull'installazione dell'interfaccia a riga di comando di Google Cloud, sulla configurazione di un progetto con un account di servizio e su come ottenere un token di accesso, consulta la pagina Configurazione.
Metodo HTTP e URL:
POST https://translation.googleapis.com/language/translate/v2
Corpo JSON richiesta:
{ "q": ["Hello world", "My name is Jeff"], "target": "de" }
Per inviare la richiesta, scegli una delle seguenti opzioni:
Curling
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/language/translate/v2 "
PowerShell
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/language/translate/v2 " | Select-Object -Expand Content
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 target
richiesta (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 per la configurazione di Go nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Translation Go.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java Translation.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Translation.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida alla traduzione con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di traduzione.
Lingue aggiuntive
C#: Segui le istruzioni per la configurazione di C# nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per .NET.
PHP: segui le istruzioni per la configurazione di PHP nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per PHP.
Ruby: segui le istruzioni di configurazione di Rubby nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per Ruby.
Parametro modello
Quando invii una richiesta di traduzione a Cloud Translation - Basic, il 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 - Avanzato.
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 la risoluzione dei problemi o degli errori comuni, consulta la pagina Risoluzione dei problemi.