Utiliser l'API Translation avec Python

1. Présentation

L'API Translation fournit une interface de programmation simple qui permet de traduire dynamiquement une chaîne arbitraire dans n'importe quelle langue compatible à l'aide d'une traduction automatique neuronale de pointe. Il peut également être utilisé pour détecter une langue lorsque la langue source est inconnue.

Dans ce tutoriel, vous allez utiliser l'API Translation avec Python. Les concepts abordés incluent la liste des langues disponibles, la traduction de texte et la détection de la langue d'un texte donné.

Points abordés

• Configurer votre environnement
• Comment répertorier les langues disponibles
• Comment traduire du texte
• Détecter les langues

Prérequis

• Un projet Google Cloud
• Un navigateur tel que Chrome ou Firefox
• Connaissances de base sur Python

Enquête

Comment allez-vous utiliser ce tutoriel ?

Je vais le lire uniquement Je vais le lire et effectuer les exercices

Quel est votre niveau d'expérience avec Python ?

Débutant Intermédiaire Expert

Comment évalueriez-vous votre expérience des services Google Cloud ?

<ph type="x-smartling-placeholder"></ph> Débutant Intermédiaire Expert .

2. Préparation

Configuration de l'environnement au rythme de chacun

1. Connectez-vous à la console Google Cloud, puis créez un projet ou réutilisez un projet existant. (Si vous ne possédez pas encore de compte Gmail ou Google Workspace, vous devez en créer un.)

• Le nom du projet est le nom à afficher pour les participants au projet. Il s'agit d'une chaîne de caractères non utilisée par les API Google. Vous pourrez toujours le modifier.
• L'ID du projet est unique parmi tous les projets Google Cloud et non modifiable une fois défini. La console Cloud génère automatiquement une chaîne unique (en général, vous n'y accordez d'importance particulière). Dans la plupart des ateliers de programmation, vous devrez indiquer l'ID de votre projet (généralement identifié par PROJECT_ID). Si l'ID généré ne vous convient pas, vous pouvez en générer un autre de manière aléatoire. Vous pouvez également en spécifier un et voir s'il est disponible. Après cette étape, l'ID n'est plus modifiable et restera donc le même pour toute la durée du projet.
• Pour information, il existe une troisième valeur (le numéro de projet) que certaines API utilisent. Pour en savoir plus sur ces trois valeurs, consultez la documentation.

Attention : Un ID de projet est unique. Une fois que vous l'avez choisi, personne d'autre ne peut l'employer. Vous en êtes le seul utilisateur. Même si un projet est supprimé, son ID ne peut pas être réutilisé.

Remarque : Si vous utilisez un compte Gmail, vous pouvez conserver l'emplacement par défaut défini sur Aucune organisation. Si vous utilisez un compte Google Workspace, choisissez un emplacement qui ait du sens pour votre organisation.

2. Vous devez ensuite activer la facturation dans la console Cloud pour utiliser les ressources/API Cloud. L'exécution de cet atelier de programmation est très peu coûteuse, voire sans frais. Pour désactiver les ressources et éviter ainsi que des frais ne vous soient facturés après ce tutoriel, vous pouvez supprimer le projet ou les ressources que vous avez créées. Les nouveaux utilisateurs de Google Cloud peuvent participer au programme d'essai sans frais pour bénéficier d'un crédit de 300 $.

Démarrer Cloud Shell

Bien que Google Cloud puisse être utilisé à distance depuis votre ordinateur portable, vous allez utiliser Cloud Shell dans cet atelier de programmation, un environnement de ligne de commande exécuté dans le cloud.

Activer Cloud Shell

1. Dans Cloud Console, cliquez sur Activer Cloud Shell .

Si vous démarrez Cloud Shell pour la première fois, un écran intermédiaire vous explique de quoi il s'agit. Si un écran intermédiaire s'est affiché, cliquez sur Continuer.

Le provisionnement et la connexion à Cloud Shell ne devraient pas prendre plus de quelques minutes.

Cette machine virtuelle contient tous les outils de développement nécessaires. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute dans Google Cloud, ce qui améliore considérablement les performances du réseau et l'authentification. Une grande partie, voire la totalité, de votre travail dans cet atelier de programmation peut être effectué dans un navigateur.

Une fois connecté à Cloud Shell, vous êtes authentifié et le projet est défini sur votre ID de projet.

2. Exécutez la commande suivante dans Cloud Shell pour vérifier que vous êtes authentifié :

gcloud auth list

Résultat de la commande

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

Remarque : gcloud est l'outil de ligne de commande performant et unifié de Google Cloud. Il est préinstallé dans Cloud Shell. Il est également compatible avec la saisie semi-automatique via la touche de tabulation. Pour en savoir plus, consultez la section de présentation de l'outil de ligne de commande gcloud.

3. Exécutez la commande suivante dans Cloud Shell pour vérifier que la commande gcloud connaît votre projet:

gcloud config list project

Résultat de la commande

[core]
project = <PROJECT_ID>

Si vous obtenez un résultat différent, exécutez cette commande :

gcloud config set project <PROJECT_ID>

Résultat de la commande

Updated property [core/project].

Remarque:Si vous suivez ce tutoriel en dehors de Cloud Shell, suivez Configurer les identifiants par défaut de l'application.

3. Cofiguration de l'environnement

Avant de pouvoir utiliser l'API Translation, vous devez l'activer en exécutant la commande suivante dans Cloud Shell:

gcloud services enable translate.googleapis.com

L'écran qui s'affiche devrait ressembler à ce qui suit :

Operation "operations/..." finished successfully.

Vous pouvez maintenant utiliser l'API Translation.

Définissez la variable d'environnement suivante (à utiliser dans votre application):

export PROJECT_ID=$(gcloud config get-value core/project)

echo "→ PROJECT_ID: $PROJECT_ID"

Remarque: Cette variable d'environnement ne s'applique qu'à votre session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez définir à nouveau cette variable.

Accédez à votre répertoire d'accueil:

cd ~

Créez un environnement virtuel Python pour isoler les dépendances:

virtualenv venv-translate

Activez l'environnement virtuel :

source venv-translate/bin/activate

Remarque: Pour arrêter d'utiliser l'environnement virtuel et revenir à la version Python de votre système, vous pouvez exécuter la commande deactivate.

Installez IPython et la bibliothèque cliente de l'API Translation:

pip install ipython google-cloud-translate

L'écran qui s'affiche devrait ressembler à ce qui suit :

...
Installing collected packages: ..., ipython, google-cloud-translate
Successfully installed ... google-cloud-translate-3.11.0 ...

Vous êtes maintenant prêt à utiliser la bibliothèque cliente de l'API Translation.

Remarque: Si vous configurez votre propre environnement de développement Python en dehors de Cloud Shell, suivez ces consignes.

Dans les étapes suivantes, vous allez utiliser un interpréteur Python interactif appelé IPython, que vous avez installé à l'étape précédente. Démarrez une session en exécutant ipython dans Cloud Shell:

ipython

L'écran qui s'affiche devrait ressembler à ce qui suit :

Python 3.9.2 (default, Feb 28 2021, 17:03:44)
Type 'copyright', 'credits' or 'license' for more information
IPython 8.12.0 -- An enhanced Interactive Python. Type '?' for help.

In [1]:

Remarque : Si nécessaire, vous pouvez quitter votre session IPython à l'aide de la commande exit.

Copiez le code suivant dans votre session IPython:

from os import environ

from google.cloud import translate


PROJECT_ID = environ.get("PROJECT_ID", "")
assert PROJECT_ID
PARENT = f"projects/{PROJECT_ID}"

Remarques :

• La variable d'environnement PROJECT_ID définie précédemment est utilisée.
• La variable PARENT sera utilisée pour les requêtes lors des prochaines étapes. Elle fait référence au projet de l'appelant.

Vous êtes prêt à envoyer votre première requête et à lister les langues prises en charge...

4. Liste des langues disponibles

Dans cette section, vous allez lister toutes les langues disponibles dans l'API Translation.

Pour répertorier les langages disponibles, copiez le code suivant dans votre session IPython:

def print_supported_languages(display_language_code: str):
    client = translate.TranslationServiceClient()

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

    languages = response.languages
    print(f" Languages: {len(languages)} ".center(60, "-"))
    for language in languages:
        language_code = language.language_code
        display_name = language.display_name
        print(f"{language_code:10}{display_name}")
    

Appelez la fonction :

print_supported_languages("en")

Vous devriez obtenir un résultat semblable à celui-ci:

---------------------- Languages: 136 ----------------------
af        Afrikaans
ak        Akan
sq        Albanian
am        Amharic
ar        Arabic
...
cy        Welsh
xh        Xhosa
yi        Yiddish
yo        Yoruba
zu        Zulu

Si vous obtenez une erreur PermissionDenied, saisissez exit pour quitter IPython, puis revenez à l'étape Configuration et conditions requises.

Découvrez les avantages de la langue d'affichage en français:

print_supported_languages("fr")

Vous devriez obtenir la même liste, triée avec les noms français, comme ceci:

---------------------- Languages: 136 ----------------------
af        Afrikaans
sq        Albanais
de        Allemand
am        Amharique
en        Anglais
...
vi        Vietnamien
xh        Xhosa
yi        Yiddish
yo        Yorouba
zu        Zoulou

Vous pouvez essayer avec un autre code de langue.

Résumé

Au cours de cette étape, vous avez pu lister toutes les langues disponibles dans l'API Translation. Vous trouverez la liste complète des langues disponibles sur la page Langues acceptées.

5. Traduire du texte

Vous pouvez utiliser l'API Translation pour traduire des textes d'une langue à une autre. Le texte est traduit à l'aide du modèle de traduction automatique neuronale (NMT, Neural Machine Translation). Si le modèle NMT n'est pas compatible avec la combinaison linguistique demandée, le modèle de traduction automatique sous-phrasique (PBMT) est utilisé. Pour en savoir plus sur Google Traduction et ses modèles de traduction, consultez l'annonce du NMT.

Pour traduire du texte, copiez le code suivant dans votre session IPython:

def translate_text(text: str, target_language_code: str) -> translate.Translation:
    client = translate.TranslationServiceClient()

    response = client.translate_text(
        parent=PARENT,
        contents=[text],
        target_language_code=target_language_code,
    )

    return response.translations[0]
    

Appelez la fonction pour traduire le même texte dans différentes langues:

text = "Hello World!"
target_languages = ["tr", "de", "es", "it", "el", "zh", "ja", "ko"]

print(f" {text} ".center(50, "-"))
for target_language in target_languages:
    translation = translate_text(text, target_language)
    source_language = translation.detected_language_code
    translated_text = translation.translated_text
    print(f"{source_language} → {target_language} : {translated_text}")
    

Vous devriez obtenir ce qui suit:

------------------ Hello World! ------------------
en → tr : Selam Dünya!
en → de : Hallo Welt!
en → es : ¡Hola Mundo!
en → it : Ciao mondo!
en → el : Γειά σου Κόσμε!
en → zh : 你好世界！
en → ja : 「こんにちは世界」
en → ko : 안녕하세요 세계!

Résumé

Au cours de cette étape, vous avez pu utiliser l'API Translation pour traduire du texte dans plusieurs langues. En savoir plus sur la traduction de texte.

6. Détecter les langues

Vous pouvez également utiliser l'API Translation pour détecter la langue d'une chaîne de texte.

Copiez le code suivant dans votre session IPython:

def detect_language(text: str) -> translate.DetectedLanguage:
    client = translate.TranslationServiceClient()

    response = client.detect_language(parent=PARENT, content=text)

    return response.languages[0]
    

Appelez la fonction pour détecter la langue des différentes phrases:

sentences = [
    "Selam Dünya!",
    "Hallo Welt!",
    "¡Hola Mundo!",
    "Ciao mondo!",
    "Γειά σου Κόσμε!",
    "你好世界！",
    "「こんにちは世界」",
    "안녕하세요 세계!",
]
for sentence in sentences:
    language = detect_language(sentence)
    confidence = language.confidence
    language_code = language.language_code
    print(
        f"Confidence: {confidence:4.0%}",
        f"Language: {language_code:5}",
        sentence,
        sep=" | ",
    )
    

Vous devriez obtenir ce qui suit:

Confidence: 100% | Language: tr    | Selam Dünya!
Confidence:  80% | Language: de    | Hallo Welt!
Confidence: 100% | Language: es    | ¡Hola Mundo!
Confidence: 100% | Language: it    | Ciao mondo!
Confidence: 100% | Language: el    | Γειά σου Κόσμε!
Confidence: 100% | Language: zh-CN | 你好世界！
Confidence: 100% | Language: ja    | 「こんにちは世界」
Confidence: 100% | Language: ko    | 안녕하세요 세계!

Résumé

Au cours de cette étape, vous avez pu détecter la langue d'un texte à l'aide de l'API Translation. En savoir plus sur la détection des langues

7. Félicitations !

Vous avez appris à utiliser l'API Translation avec Python.

Nettoyage

Pour nettoyer votre environnement de développement à partir de Cloud Shell:

• Si vous êtes toujours dans votre session IPython, revenez au shell: exit
• Cessez d'utiliser l'environnement virtuel Python: deactivate
• Supprimez le dossier d'environnement virtuel: cd ~ ; rm -rf ./venv-translate.

Pour supprimer votre projet Google Cloud à partir de Cloud Shell, procédez comme suit:

• Récupérez l'ID de votre projet actuel: PROJECT_ID=$(gcloud config get-value core/project)
• Assurez-vous qu'il s'agit bien du projet que vous souhaitez supprimer: echo $PROJECT_ID
• Supprimez le projet: gcloud projects delete $PROJECT_ID

En savoir plus

• Documentation Cloud Translation: https://cloud.google.com/translate/docs
• Python sur Google Cloud: https://cloud.google.com/python
• Bibliothèques clientes Cloud pour Python: https://github.com/googleapis/google-cloud-python

Licence

Ce document est publié sous une licence Creative Commons Attribution 2.0 Generic.