Traduzione di testo

Questa pagina mostra come tradurre un testo di esempio con le versioni Basic e Advanced di Cloud Translation.

Prima di iniziare

Prima di poter iniziare a utilizzare l'API Cloud Translation, devi avere un progetto in cui sia abilitata l'API Cloud Translation e le credenziali appropriate. Puoi anche installare librerie client per i linguaggi di programmazione più comuni per facilitare le chiamate all'API. Per saperne di più, consulta la pagina Configurazione.

Scegli la versione dell'API che preferisci:

Esegui la traduzione del testo

Cloud Translation - Advanced è ottimizzato per la personalizzazione e per i casi d'uso di contenuti in formato lungo. Oltre al modello di traduzione automatica neurale (NMT), la versione Advanced ti offre l'accesso al modello LLM di traduzione (il modello di traduzione in stile LLM di Google più recente e di qualità più elevata) e la possibilità di creare modelli personalizzati.

Cloud Translation - Advanced fornisce anche funzionalità avanzate di traduzione del testo, come la traduzione di documenti e la creazione di glossari per garantire che la terminologia specifica del tuo dominio venga tradotta correttamente.

Per le traduzioni con la versione Advanced, l'input può essere testo normale o HTML. L'API Cloud Translation non traduce i tag HTML nell'input, ma solo il testo che appare tra i tag. L'output conserva i tag HTML (non tradotti), con il testo tradotto tra i tag nella misura possibile in base alle differenze tra le lingue di origine e di destinazione.

Esempio di traduzione di testo

REST

Per tradurre il testo, invia una richiesta POST e fornisci il codice JSON nel corpo della richiesta che identifica la lingua di partenza (source_language_code), la lingua di destinazione (target_language_code) e il testo da tradurre (contents). Puoi fornire più stringhe di testo da tradurre includendole nel codice JSON (vedi esempio). Identifica le lingue di origine e 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 service account configurato per il progetto utilizzando Google CloudGoogle Cloud CLI. Per istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un service account e sul recupero di un token di accesso, consulta la pagina Configurazione.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud

Metodo HTTP e URL: 

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText

Corpo JSON della richiesta: 

{
  "sourceLanguageCode": "en",
  "targetLanguageCode": "ru",
  "contents": ["Dr. Watson, come here!", "Bring me some coffee!"]
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "translations": [
    {
      "translatedText": "Доктор Ватсон, иди сюда!",
    },
    {
      "translatedText": "Принеси мне кофе!",
    }
  ]
}

L'array translations contiene due campi translatedText con le traduzioni fornite nella lingua targetLanguageCode richiesta (ru: russo). 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 per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Go.

Per eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta