Questo documento descrive come utilizzare l'API Cloud Translation (v2) per elencare le lingue supportate.
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.
Elenco delle lingue supportate
REST
Per ottenere un elenco di tutte le lingue supportate, effettua una richiesta GET
all'endpoint https://translation.googleapis.com/language/translate/v2/languages
.
Di seguito è riportato un esempio di richiesta GET
mediante curl
e PowerShell.
L'esempio utilizza il token di accesso per un account di servizio configurato per il progetto utilizzando Google Cloud CLI. Per istruzioni sull'installazione dell'interfaccia alla gcloud CLI, sulla configurazione di un progetto con un account di servizio e sull'ottenimento di 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:
GET https://translation.googleapis.com/language/translate/v2/languages
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "languages": [ { "language": "en" }, { "language": "fr" }, { "language": "zh-CN" } ] }
Questa query restituisce i codici lingua ISO-639 per le lingue supportate. Alcuni codici lingua includono anche un codice paese, come zh-CN o zh-TW. L'elenco è ordinato alfabeticamente per codice lingua. L'esempio precedente è stato abbreviato a causa di limiti di spazio.
Go
Java
Node.js
Python
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.
Elenca le lingue supportate con il nome della lingua di destinazione
REST
Ecco un altro esempio che restituisce l'elenco delle lingue supportate. I nomi delle lingue restituite sono scritti in una lingua di destinazione specifica. L'elenco restituito è in ordine alfabetico in base alla lingua di destinazione.
Per elencare le lingue supportate in una lingua di destinazione, effettua una richiesta POST
e fornisci JSON che identifichi la lingua di destinazione nel corpo della richiesta. Di seguito è riportato un esempio di richiesta POST
mediante curl
o PowerShell.
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/languages
Corpo JSON della richiesta:
{ "target": "zh-TW" }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "data": { "languages": [ { "language": "zh-CN", "name": "中文(簡體)" }, { "language": "fr", "name": "法文" }, { "language": "en", "name": "英文" } ] } }
In questo caso, la query restituisce gli stessi codici di lingua precedenti, insieme a stringhe name
che forniscono i nomi delle lingue scritte nella lingua di destinazione, zh-TW. L'esempio precedente è stato abbreviato a causa di limiti di spazio.
Go
Java
Node.js
Python
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.
Risorse aggiuntive
- Per assistenza sulla risoluzione di problemi o errori comuni, consulta la pagina Risoluzione dei problemi.