GSP049

Présentation

L'API Cloud Translation utilise la technologie de traduction automatique neuronale de Google pour traduire instantanément des textes, dans plus d'une centaine de langues.

Dans cet atelier, vous allez utiliser l'API pour traduire du texte et détecter dans quelle langue il est écrit.

Points abordés

Dans cet atelier, vous allez utiliser l'API Cloud Translation pour effectuer ce qui suit :

• Créer une requête pour l'API Cloud Translation et appeler l'API avec curl
• Traduire du texte
• Utiliser l'édition Premium
• Détecter la langue

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique vous permet de suivre les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Pour réaliser cet atelier :

• Vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome).

Remarque : Ouvrez une fenêtre de navigateur en mode incognito (recommandé) ou de navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le compte temporaire de participant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.

• Vous disposez d'un temps limité. N'oubliez pas qu'une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.

Remarque : Utilisez uniquement le compte de participant pour cet atelier. Si vous utilisez un autre compte Google Cloud, des frais peuvent être facturés à ce compte.

Démarrer l'atelier et se connecter à la console Google Cloud

1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, une boîte de dialogue s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau "Détails concernant l'atelier", qui contient les éléments suivants :

   • Le bouton "Ouvrir la console Google Cloud"
   • Le temps restant
   • Les identifiants temporaires que vous devez utiliser pour cet atelier
   • Des informations complémentaires vous permettant d'effectuer l'atelier

2. Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).

   L'atelier lance les ressources, puis ouvre la page "Se connecter" dans un nouvel onglet.

   Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.

   Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.

3. Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.

   {{{user_0.username | "Username"}}}

   Vous trouverez également le nom d'utilisateur dans le panneau "Détails concernant l'atelier".

4. Cliquez sur Suivant.

5. Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.

   {{{user_0.password | "Password"}}}

   Vous trouverez également le mot de passe dans le panneau "Détails concernant l'atelier".

6. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis pour l'atelier. Ne saisissez pas ceux de votre compte Google Cloud. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

7. Accédez aux pages suivantes :

   • Acceptez les conditions d'utilisation.
   • N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
   • Ne vous inscrivez pas à des essais sans frais.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Pour accéder aux produits et services Google Cloud, cliquez sur le menu de navigation ou saisissez le nom du service ou du produit dans le champ Recherche.

Activer Cloud Shell

Cloud Shell est une machine virtuelle qui contient de nombreux outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Cloud Shell vous permet d'accéder via une ligne de commande à vos ressources Google Cloud.

1. Cliquez sur Activer Cloud Shell  en haut de la console Google Cloud.

2. Passez les fenêtres suivantes :

   • Accédez à la fenêtre d'informations de Cloud Shell.
   • Autorisez Cloud Shell à utiliser vos identifiants pour effectuer des appels d'API Google Cloud.

Une fois connecté, vous êtes en principe authentifié et le projet est défini sur votre ID_PROJET : . Le résultat contient une ligne qui déclare l'ID_PROJET pour cette session :

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud est l'outil de ligne de commande pour Google Cloud. Il est préinstallé sur Cloud Shell et permet la complétion par tabulation.

3. (Facultatif) Vous pouvez lister les noms des comptes actifs à l'aide de cette commande :

gcloud auth list

4. Cliquez sur Autoriser.

Résultat :

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Facultatif) Vous pouvez lister les ID de projet à l'aide de cette commande :

gcloud config list project

Résultat :

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Remarque : Pour consulter la documentation complète sur gcloud, dans Google Cloud, accédez au guide de présentation de la gcloud CLI.

Définir la région de votre projet

Exécutez la commande suivante pour définir la région de votre projet :

export REGION={{{project_0.default_region | REGION}}} gcloud config set compute/region $REGION

Tâche 1 : Créer une clé API

Étant donné que vous allez par la suite utiliser curl pour envoyer une requête à l'API Translation, vous devez générer une clé API à transmettre dans l'URL de votre requête.

1. Pour créer une clé API, dans le menu de navigation (), cliquez sur API et services > Identifiants.

2. Cliquez sur +CRÉER DES IDENTIFIANTS.

3. Dans le menu déroulant, sélectionnez Clé API.

4. Copiez la clé que vous venez de générer.

Enregistrez la clé API dans une variable d'environnement pour éviter d'avoir à insérer sa valeur dans chaque requête.

5. Exécutez la commande suivante dans Cloud Shell. Veillez à remplacer <your_api_key> par la clé que vous venez de copier :

export API_KEY= YOUR_API_KEY

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer une clé API

Tâche 2 : Traduire du texte

Dans cet exemple, vous allez traduire la chaîne "My name is Steve" en espagnol.

• Transmettez à l'API Translation le texte à traduire, ainsi que la variable d'environnement de la clé API, en exécutant la commande curl suivante :

TEXT="My%20name%20is%20Steve" curl "https://translation.googleapis.com/language/translate/v2?target=es&key=${API_KEY}&q=${TEXT}"

La réponse que vous obtenez doit se présenter comme suit :

{ "data": { "translations": [ { "translatedText": "Mi nombre es Steve", "detectedSourceLanguage": "en" } ] } }

Vous y voyez le texte traduit ainsi que la langue source détectée par l'API.

Remarque : Mode Premium

L'API Google Cloud Translation utilise un modèle d'édition standard pour la plupart des tâches de traduction. Google a amélioré son service de traduction en le dotant d'un système de traduction automatique neuronale plus robuste. Pour en savoir plus sur l'utilisation de ce modèle premium, consultez la documentation Cloud Translation.

Tâche 3 : Détecter la langue

En plus de traduire du texte, l'API Translation peut aussi détecter dans quelle langue il est écrit. Dans cet exemple, vous allez détecter la langue de deux chaînes.

• Transmettez le texte à examiner à l'API Translation, ainsi que la variable d'environnement de la clé API, en exécutant la commande curl suivante :

TEXT_ONE="Meu%20nome%20é%20Steven" TEXT_TWO="日本のグーグルのオフィスは、東京の六本木ヒルズにあります" curl -X POST "https://translation.googleapis.com/language/translate/v2/detect?key=${API_KEY}" -d "q=${TEXT_ONE}" -d "q=${TEXT_TWO}"

La réponse que vous obtenez doit se présenter comme suit :

{ "data": { "detections": [ [ { "isReliable": false, "language": "pt", "confidence": 1 } ], [ { "language": "ja", "isReliable": false, "confidence": 1 } ] ] } }

Les langues renvoyées par cet exemple sont "pt" et "ja". Il s'agit des codes ISO-639-1 pour le portugais et le japonais. Cette liste des langues acceptées par l'API Translation répertorie tous les codes de langue possibles qui peuvent être renvoyés.

Félicitations !

Vous avez appris à traduire du texte avec l'API Cloud Translation.

Atelier suivant

• Analyse des entités et des sentiments avec l'API Natural Language
• Il parle ! Créez une voix synthétique à l'aide de Text-to-Speech

Étapes suivantes et informations supplémentaires

• Découvrez des exemples d'applications de l'API Translation créées à l'aide de bibliothèques clientes dans différents langages de programmation courants.
• Découvrez l'API Vision et l'API Speech.

Formations et certifications Google Cloud

Les formations et certifications Google Cloud vous aident à tirer pleinement parti des technologies Google Cloud. Nos cours portent sur les compétences techniques et les bonnes pratiques à suivre pour être rapidement opérationnel et poursuivre votre apprentissage. Nous proposons des formations pour tous les niveaux, à la demande, en salle et à distance, pour nous adapter aux emplois du temps de chacun. Les certifications vous permettent de valider et de démontrer vos compétences et votre expérience en matière de technologies Google Cloud.

Dernière mise à jour du manuel : 13 décembre 2024

Dernier test de l'atelier : 3 décembre 2024

Copyright 2025 Google LLC. Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.