Ce document explique comment utiliser l'API Cloud Translation pour répertorier les langues disponibles à l'aide de Cloud Translation – Advanced.
Avant de commencer
Pour pouvoir utiliser l'API Cloud Translation, vous devez disposer d'un projet pour lequel cette API est activée, ainsi que d'identifiants appropriés. Vous pouvez également installer des bibliothèques clientes pour les langages de programmation courants afin de faciliter les appels à l'API.
Pour en savoir plus, consultez la page Configuration.
Envoyer une requête sur les langues disponibles
Pour découvrir les langues disponibles pour cette API, envoyez une requête HTTP à l'aide d'une URL au format suivant :
https://translation.googleapis.com/v3/projects/project-number-or-id/locations/location/supportedLanguages
Obtenir la liste des langues disponibles
API REST et ligne de commande
Pour obtenir la liste de toutes les langues disponibles, envoyez une requête GET
à l'URL https://translation.googleapis.com/v3/projects/project-number-or-id/locations/location/supportedLanguages
.
Vous trouverez ci-dessous un exemple de requête GET
effectuée avec curl
et PowerShell. L'exemple se sert du jeton d'accès associé à un compte de service configuré pour le projet à l'aide du SDK Cloud de Google Cloud.
Pour obtenir des instructions sur l'installation du SDK Cloud, la configuration d'un projet avec un compte de service et l'obtention d'un jeton d'accès, consultez la page Configuration.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- project-number-or-id par le numéro ou l'ID de votre projet Google Cloud
Méthode HTTP et URL :
GET https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global/supportedLanguages
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
.Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global/supportedLanguages
PowerShell
.Exécutez la commande suivante :
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global/supportedLanguages " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{ "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 } ] }
La liste est triée alphabétiquement par code de langue. Cette requête renvoie les codes de langue ISO-639-1 correspondant aux langues disponibles. Certains codes de langue incluent également un code pays, tel que zh-CN ou zh-TW. Exemple :
{ "languageCode": "zh-TW", "supportSource": true, "supportTarget": true },
C#
Avant d'essayer cet exemple, suivez les instructions de configuration pour C# du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour C#.
Go
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Go.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration pour Java du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Java.
Node.js
Avant d'essayer cet exemple, suivez les instructions de configuration pour Node.js du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Node.js.
PHP
Avant d'essayer cet exemple, suivez les instructions de configuration pour PHP du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour PHP.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration pour Python du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Python.
Ruby
Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Ruby.
Répertorier les langues disponibles avec le nom écrit dans la langue cible
API REST et ligne de commande
Voici un autre exemple qui renvoie la liste des langues disponibles, avec les noms écrits dans la langue cible spécifiée. La liste renvoyée est triée par ordre alphabétique selon la langue cible.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- project-number-or-id par le numéro ou l'ID de votre projet Google Cloud
Méthode HTTP et URL :
GET https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global/supportedLanguages?display_language_code=sq
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
.Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global/supportedLanguages?display_language_code=sq
PowerShell
.Exécutez la commande suivante :
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global/supportedLanguages?display_language_code=sq " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{ "languages": [{ "languageCode": "af", "displayName": "Afrikanisht", "supportSource": true, "supportTarget": true }, { "languageCode": "am", "displayName": "Amarikisht", "supportSource": true, "supportTarget": true }, { "languageCode": "en", "displayName": "Anglisht", "supportSource": true, "supportTarget": true }, ...{ "languageCode": "zu", "displayName": "Zulu", "supportSource": true, "supportTarget": true } ] }
Dans ce cas, la requête renvoie les mêmes codes de langue que ci-dessus, ainsi que les chaînes name
qui donnent les noms des langues écrits dans la langue cible. Dans cet exemple, la langue est l'albanais (sq).
C#
Avant d'essayer cet exemple, suivez les instructions de configuration pour C# du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour C#.
Go
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Go.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration pour Java du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Java.
Node.js
Avant d'essayer cet exemple, suivez les instructions de configuration pour Node.js du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Node.js.
PHP
Avant d'essayer cet exemple, suivez les instructions de configuration pour PHP du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour PHP.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration pour Python du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Python.
Ruby
Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby du guide de démarrage rapide de l'API Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Translation pour Ruby.