Découvrir les langues disponibles (v3beta1)

Ce document explique comment utiliser l'API Cloud Translation pour répertorier les langues disponibles à l'aide de Cloud Translation v3beta1.

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/v3beta1/projects/project-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/v3beta1/projects/<var>project-id</var>/locations/<var>location</var>/supportedLanguages. Vous trouverez ci-dessous un exemple de requête GET effectuée avec curl et PowerShell. Cet exemple fait intervenir le jeton d'accès associé à un compte de service configuré pour le projet à l'aide du SDK Cloud de Google Cloud Platform. 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 Démarrage rapide.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • project-id : ID de votre projet GCP

Méthode HTTP et URL :

GET https://translation.googleapis.com/v3beta1/projects/project-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/v3beta1/projects/project-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/v3beta1/projects/project-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 pour les langues disponibles. Certains codes de langue incluent également un code pays, tel que zh-CN ou zh-TW. Par exemple :

   {
      "languageCode": "zh-TW",
      "supportSource": true,
      "supportTarget": true
    },

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java du guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Translation pour Java.

static SupportedLanguages listSupportedLanguages(String projectId, String location) {
  try (TranslationServiceClient translationServiceClient = TranslationServiceClient.create()) {

    LocationName locationName =
        LocationName.newBuilder().setProject(projectId).setLocation(location).build();
    GetSupportedLanguagesRequest getSupportedLanguagesRequest =
        GetSupportedLanguagesRequest.newBuilder().setParent(locationName.toString()).build();

    // Call the API
    ApiFuture<SupportedLanguages> future =
        translationServiceClient
            .getSupportedLanguagesCallable()
            .futureCall(getSupportedLanguagesRequest);

    SupportedLanguages response = future.get();
    List<SupportedLanguage> languages = response.getLanguagesList();
    for (SupportedLanguage language : languages) {
      System.out.printf("Code: %s\n", language.getLanguageCode());
    }

    return response;

  } catch (Exception e) {
    throw new RuntimeException("Couldn't create client.", e);
  }
}

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 avec les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Translation pour Node.js.

/**
 * TODO(developer): Uncomment these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const location = 'global';

// Imports the Google Cloud Translation library
const {TranslationServiceClient} = require('@google-cloud/translate').v3beta1;

// Instantiates a client
const translationClient = new TranslationServiceClient();

async function listLanguages() {
  // Construct request
  const request = {
    parent: translationClient.locationPath(projectId, location),
  };

  // Run request
  const [response] = await translationClient.getSupportedLanguages(request);

  console.log(`Supported languages:`);
  for (const language of response.languages) {
    console.log(`Language Code: ${language.languageCode}`);
  }
}

listLanguages();

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python du guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Translation pour Python.

from google.cloud import translate_v3beta1 as translate
client = translate.TranslationServiceClient()

# project_id = YOUR_PROJECT_ID
location = 'global'

parent = client.location_path(project_id, location)

response = client.get_supported_languages(parent)

print('Supported Languages:')
for language in response.languages:
    print('Language Code: {}'.format(language.language_code))

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-id : ID de votre projet GCP

Méthode HTTP et URL :

GET https://translation.googleapis.com/v3beta1/projects/project-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/v3beta1/projects/project-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/v3beta1/projects/project-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, soit l'albanais (sq) dans l'exemple ci-dessus.

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java du guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Translation pour Java.

static SupportedLanguages listSupportedLanguagesWithTarget(String projectId, String location) {
  try (TranslationServiceClient translationServiceClient = TranslationServiceClient.create()) {

    LocationName locationName =
        LocationName.newBuilder().setProject(projectId).setLocation(location).build();
    GetSupportedLanguagesRequest getSupportedLanguagesRequest =
        GetSupportedLanguagesRequest.newBuilder()
            .setParent(locationName.toString())
            .setDisplayLanguageCode("en-US")
            .build();

    // Call the API
    ApiFuture<SupportedLanguages> future =
        translationServiceClient
            .getSupportedLanguagesCallable()
            .futureCall(getSupportedLanguagesRequest);

    SupportedLanguages response = future.get();
    List<SupportedLanguage> languages = response.getLanguagesList();

    for (SupportedLanguage language : languages) {
      System.out.printf(
          "Name: %s, Code: %s\n", language.getDisplayName(), language.getLanguageCode());
    }
    return response;

  } catch (Exception e) {
    throw new RuntimeException("Couldn't create client.", e);
  }
}

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 avec les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Translation pour Node.js.

/**
 * TODO(developer): Uncomment these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const location = 'global';

// Imports the Google Cloud Translation library
const {TranslationServiceClient} = require('@google-cloud/translate').v3beta1;

// Instantiates a client
const translationClient = new TranslationServiceClient();

async function listLanguages() {
  // Construct request
  const request = {
    parent: translationClient.locationPath(projectId, location),
    displayLanguageCode: 'fr',
  };

  // Run request
  const [response] = await translationClient.getSupportedLanguages(request);

  console.log(`Supported languages:`);
  for (const language of response.languages) {
    console.log(`Language Code: ${language.languageCode}`);
    console.log(`Display Name: ${language.displayName}`);
  }
}

listLanguages();

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python du guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Translation pour Python.

from google.cloud import translate_v3beta1 as translate
client = translate.TranslationServiceClient()

# project_id = YOUR_PROJECT_ID
# display_language_code = 'is'
location = 'global'

parent = client.location_path(project_id, location)

response = client.get_supported_languages(
    parent=parent,
    display_language_code=display_language_code)

print('Supported Languages:')
for language in response.languages:
    print('Language Code: {}'.format(language.language_code))
    print('Display Name: {}\n'.format(language.display_name))

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.