Démarrage rapide

Cette page montre comment créer une requête d'API Cloud Translation avec curl.

Avant de commencer

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

  2. Configurez un projet dans la console GCP.

    Configurer un projet

    Cliquez pour effectuer les opérations suivantes :

    • Créer ou sélectionner un projet
    • Activer Cloud Translationl'API requise pour ce projet
    • Créer un compte de service
    • Télécharger une clé privée au format JSON

    Vous pouvez afficher et gérer ces ressources à tout moment dans la console GCP.

  3. Définissez la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS pour pointer vers le chemin du fichier JSON contenant la clé de votre compte de service. Cette variable ne s'applique qu'à la session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez de nouveau la définir.

  4. Installez et initialisez le SDK Cloud.

Faire une requête dans l'API Cloud Translation

Pour effectuer une requête dans l'API Cloud Translation, appelez la méthode REST dans la méthode de traduction v2.

  1. Utilisez curl pour effectuer une requête sur le point de terminaison https://translation.googleapis.com/language/translate/v2.

    La commande curl inclut JSON au texte à traduire (q), la langue source (source) et la langue cible (target).

    Les langues source et cible sont identifiées à l'aide des codes iso-639-1. La langue source est l'anglais (en), et la langue cible est l'espagnol (es). Le format de la requête est noté comme "text" pour le texte brut.

    L'exemple de commande curl utilise la commande gcloud auth application-default print-access-token pour obtenir un jeton d'authentification.

    curl -s -X POST -H "Content-Type: application/json" \
        -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
        --data "{
      'q': 'The Great Pyramid of Giza (also known as the Pyramid of Khufu or the
            Pyramid of Cheops) is the oldest and largest of the three pyramids in
            the Giza pyramid complex.',
      'source': 'en',
      'target': 'es',
      'format': 'text'
    }" "https://translation.googleapis.com/language/translate/v2"
      

    Un résultat semblable aux lignes suivantes doit s'afficher :

    {
      "data": {
        "translations": [
          {
            "translatedText": "La Gran Pirámide de Giza (también conocida como la
             Pirámide de Khufu o la Pirámide de Keops) es la más antigua y más
             grande de las tres pirámides en el complejo de la pirámide de Giza."
          }
        ]
      }
    }
    
      

Félicitations ! Vous avez envoyé votre première requête à l'API Cloud Translation !

Effectuer un nettoyage

Pour éviter des frais Google Cloud Platform inutiles, supprimez votre projet à l'aide de la console GCP si vous n'en avez plus besoin.

Étapes suivantes

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.