Découvrir les langues disponibles

Ce document décrit comment utiliser l'API Cloud Translation pour répertorier les langues disponibles.

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/language/translate/v2/languages

Obtenir la liste des langues disponibles

Commande curl

Pour obtenir la liste de toutes les langues disponibles, exécutez une requête GET sur le point de terminaison https://translation.googleapis.com/language/translate/v2/languages. L'exemple suivant montre un exemple de requête GET effectuée avec curl. L'exemple utilise le jeton d'accès pour 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 le guide de démarrage rapide.

curl -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
    "https://translation.googleapis.com/language/translate/v2/languages"

Si la requête aboutit, le serveur renvoie un code d'état HTTP 200 OK et la réponse au format JSON :

{
  "data": {
    "languages": [
      {
        "language": "en"
      },
      {
        "language": "fr"
      },
      ...
      {
        "language": "zh-CN"
      }
    ]
  }
}

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. La liste est triée alphabétiquement par code de langue.

C#

Avant d'essayer cet exemple, suivez les instructions de configuration de C# dans le guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes. Pour plus d'informations, consultez la documentation de référence de l'API Translation en C#.

using Google.Cloud.Translation.V2;
using System;
using System.Collections.Generic;

public partial class TranslateSample
{
    public IList<Language> ListLanguageCodes()
    {
        TranslationClient client = TranslationClient.Create();
        IList<Language> response = client.ListLanguages();
        foreach (var language in response)
        {
            Console.WriteLine(language.Code);
        }
        return response;
    }
}

Go

Avant d'essayer cet exemple, suivez les instructions de configuration de Go dans le guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes/0}. Pour plus d'informations, consultez la documentation de référence de l'API Translation en Go.

func listSupportedLanguages(w io.Writer, targetLanguage string) error {
	ctx := context.Background()

	lang, err := language.Parse(targetLanguage)
	if err != nil {
		return err
	}

	client, err := translate.NewClient(ctx)
	if err != nil {
		return err
	}
	defer client.Close()

	langs, err := client.SupportedLanguages(ctx, lang)
	if err != nil {
		return err
	}

	for _, lang := range langs {
		fmt.Fprintf(w, "%q: %s\n", lang.Tag, lang.Name)
	}

	return nil
}

Java

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

// TODO(developer): Uncomment these lines.
// import com.google.cloud.translate.*;
// Translate translate = TranslateOptions.getDefaultInstance().getService();

List<Language> languages = translate.listSupportedLanguages();

for (Language language : languages) {
  System.out.printf("Name: %s, Code: %s\n", language.getName(), language.getCode());
}

Node.js

Avant d'essayer cet exemple, suivez les instructions de configuration de Node.js dans le guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes. Pour plus d'informations, consultez la documentation de référence de l'API Translation en Node.js.

// Imports the Google Cloud client library
const {Translate} = require('@google-cloud/translate');

// Creates a client
const translate = new Translate();

// Lists available translation language with their names in English (the default).
const [languages] = await translate.getLanguages();

console.log('Languages:');
languages.forEach(language => console.log(language));

PHP

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

use Google\Cloud\Translate\TranslateClient;

$translate = new TranslateClient();
foreach ($translate->languages() as $code) {
    print("$code\n");
}

Python

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

"""Lists all available languages."""
translate_client = translate.Client()

results = translate_client.get_languages()

for language in results:
    print(u'{name} ({language})'.format(**language))

Ruby

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

# project_id = "Your Google Cloud project ID"

require "google/cloud/translate"

translate = Google::Cloud::Translate.new project: project_id
languages = translate.languages

puts "Supported language codes:"
languages.each do |language|
  puts language.code
end

Répertorier les langues disponibles pour la langue cible

Commande curl

Voici un autre exemple qui renvoie la liste des langues disponibles. Les noms de langue renvoyés sont écrits dans une langue cible spécifiée. La liste renvoyée est triée par ordre alphabétique selon la langue cible.

Pour détecter la langue d'un texte, effectuez une requête POST, et fournissez un JSON permettant d'identifier la langue cible dans le corps de la requête. Voici un exemple de requête POST utilisant curl.

curl -X POST \
     -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
     -H "Content-Type: application/json; charset=utf-8" \
     --data "{
  'target': 'zh-TW'
}" "https://translation.googleapis.com/language/translate/v2/languages"

Si la requête aboutit, le serveur renvoie un code d'état HTTP 200 OK et la réponse au format JSON :

{
  "data": {
    "languages": [
      {
        "language": "zh-CN",
        "name": "中文(簡體)"
      },
      {
        "language": "fr",
        "name": "法文"
      },
      ...
      {
        "language": "en",
        "name": "英文"
      }
    ]
  }
}

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 (zh-TW).

C#

Avant d'essayer cet exemple, suivez les instructions de configuration de C# dans le guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes. Pour plus d'informations, consultez la documentation de référence de l'API Translation en C#.

using Google.Cloud.Translation.V2;
using System;
using System.Collections.Generic;

public partial class TranslateSample
{
    public IList<Language> ListLanguageNames()
    {
        TranslationClient client = TranslationClient.Create();
        // List all the languages in English.
        IList<Language> languages = client.ListLanguages(target: "en");
        foreach (var language in languages)
        {
            Console.WriteLine($"{language.Code}\t{language.Name}");
        }
        return languages;
    }
}

Go

Avant d'essayer cet exemple, suivez les instructions de configuration de Go dans le guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes/0}. Pour plus d'informations, consultez la documentation de référence de l'API Translation en Go.

func listSupportedLanguages(w io.Writer, targetLanguage string) error {
	ctx := context.Background()

	lang, err := language.Parse(targetLanguage)
	if err != nil {
		return err
	}

	client, err := translate.NewClient(ctx)
	if err != nil {
		return err
	}
	defer client.Close()

	langs, err := client.SupportedLanguages(ctx, lang)
	if err != nil {
		return err
	}

	for _, lang := range langs {
		fmt.Fprintf(w, "%q: %s\n", lang.Tag, lang.Name)
	}

	return nil
}

Java

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

// TODO(developer): Uncomment these lines.
// import com.google.cloud.translate.*;
// Translate translate = TranslateOptions.getDefaultInstance().getService();

List<Language> languages =
    translate.listSupportedLanguages(Translate.LanguageListOption.targetLanguage("es"));

for (Language language : languages) {
  System.out.printf("Name: %s, Code: %s\n", language.getName(), language.getCode());
}

Node.js

Avant d'essayer cet exemple, suivez les instructions de configuration de Node.js dans le guide de démarrage rapide de l'API Translation à l'aide des bibliothèques clientes. Pour plus d'informations, consultez la documentation de référence de l'API Translation en Node.js.

// Imports the Google Cloud client library
const {Translate} = require('@google-cloud/translate');

// Creates a client
const translate = new Translate();

/**
 * TODO(developer): Uncomment the following line before running the sample.
 */
// const target = 'The target language for language names, e.g. ru';

// Lists available translation language with their names in a target language
const [languages] = await translate.getLanguages(target);

console.log('Languages:');
languages.forEach(language => console.log(language));

PHP

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

use Google\Cloud\Translate\TranslateClient;

// $targetLanguage = 'en'; // Print the names of the languages in which language?

$translate = new TranslateClient();
$result = $translate->localizedLanguages([
    'target' => $targetLanguage,
]);
foreach ($result as $lang) {
    print("$lang[code]: $lang[name]\n");
}

Python

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

"""Lists all available languages and localizes them to the target language.

Target must be an ISO 639-1 language code.
See https://g.co/cloud/translate/v2/translate-reference#supported_languages
"""
translate_client = translate.Client()

results = translate_client.get_languages(target_language=target)

for language in results:
    print(u'{name} ({language})'.format(**language))

Ruby

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

# project_id = "Your Google Cloud project ID"

# To receive the names of the supported languages, provide the code
# for the language in which you wish to receive the names
# language_code = "en"

require "google/cloud/translate"

translate = Google::Cloud::Translate.new project: project_id
languages = translate.languages language_code

puts "Supported languages:"
languages.each do |language|
  puts "#{language.code} #{language.name}"
end

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

Envoyer des commentaires concernant…

API Cloud Translation
Besoin d'aide ? Consultez notre page d'assistance.