Questa guida descrive come utilizzare la versione preferita dell'API Cloud Translation per elencare le lingue supportate.
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:
Elenca le lingue supportate
REST
Per ottenere un elenco di tutte le lingue supportate, invia una richiesta GET all'URL https://translation.googleapis.com/v3/projects/project-number-or-id/locations/location/supportedLanguages.
Di seguito è riportato un esempio di richiesta GET mediante curl e PowerShell. L'esempio utilizza il token di accesso per un service account configurato per il progetto utilizzando Google Cloud CLI di Google Cloud .
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:
GET https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/global/supportedLanguages
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"languages": [
"languageCode": "af",
"supportSource": true,
"supportTarget": true
},
{
"languageCode": "am",
"supportSource": true,
"supportTarget": true
},
{
"languageCode": "ar",
"supportSource": true,
"supportTarget": true
},
....
{
"languageCode": "zu",
"supportSource": true,
"supportTarget": true
}
]
}
L'elenco è in ordine alfabetico in base al codice lingua. 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. Ad esempio:
{
"languageCode": "zh-TW",
"supportSource": true,
"supportTarget": true
},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 Configura l'autenticazione per un ambiente di sviluppo locale.