Questo documento descrive come utilizzare Cloud Translation - Basic (v2) per tradurre un testo.
Il testo di input può essere in testo normale o HTML. Cloud Translation - Basic non traduce nessun Tag HTML nell'input, solo il testo visualizzato tra i tag. L'output conserva i tag HTML (non tradotti) con 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 nel testo di input a causa di cambiamenti nell'ordine delle parole nella traduzione.
Prima di iniziare
Per poter iniziare a utilizzare l'API Cloud Translation, devi avere un progetto con l'API Cloud Translation sia abilitata e devi disporre delle credenziali appropriate. Puoi installare anche librerie client per i linguaggi di programmazione più comuni chiamate all'API. Per ulteriori informazioni, consulta la pagina Configurazione.
Traduzione di testo
Questa sezione illustra alcuni modi per richiedere traduzioni da
Endpoint https://translation.googleapis.com/language/translate/v2
.
Traduzione delle stringhe di input
REST
Per tradurre il testo, effettua una richiestaPOST
e fornisci
JSON nel corpo della richiesta che identifica la lingua in cui tradurre (target
)
e il testo da tradurre (q
). Puoi fornire più segmenti di testo
traduci includendo più campi q
o un elenco di valori per q
. Non puoi superare i 128 segmenti di testo. Puoi specificare le lingue di destinazione per
usando
ISO-639
i codici.
Di seguito è riportato un esempio di richiesta POST
che utilizza
curl
o PowerShell. Nell'esempio viene utilizzato il token di accesso per un account di servizio
per il progetto utilizzando Google Cloud CLI di Google Cloud.
Per istruzioni sull'installazione di Google Cloud CLI:
configurare un progetto con un account di servizio e ottenere un token di accesso.
consulta la pagina Configurazione.
Prima di utilizzare i dati 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, scegli una delle seguenti opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json
.
ed esegui questo comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
-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 questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }
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 traslazioni
specificato nel campo target
richiesto
lingua (de
: tedesco). Le traduzioni vengono elencate nello stesso ordine delle
nell'array di origine corrispondente nella richiesta.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Go documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Java documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Node.js documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Python documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le Istruzioni per la configurazione di C# Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per .NET.
PHP Segui le Istruzioni per la configurazione dei file PHP Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per PHP.
Rubino: Segui le Istruzioni per la configurazione di Ruby Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per Ruby.
Parametro modello
Quando effettui una richiesta di traduzione in Cloud Translation - Basic, il testo viene viene tradotto utilizzando il modello di traduzione automatica neurale (NMT) di Google. Non puoi utilizzare qualsiasi altro modello. 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 in che modo Cloud Translation funziona nel mondo reale diversi scenari. 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 nella risoluzione di problemi o errori comuni, consulta le Risoluzione dei problemi.