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. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the file path of the JSON file that contains your service account key. This variable only applies to your current shell session, so if you open a new session, set the variable again.

  4. Install and initialize the Cloud SDK.

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.