Guide de démarrage rapide (version Basic)

Cette page explique comment effectuer une requête Cloud Translation – Basic (v2) 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 Cloud Console.

    Configurer un projet

    Cliquez pour effectuer les opérations suivantes :

    • Créer ou sélectionner un projet
    • Activez l'API Cloud Translation pour ce projet.
    • Créez un compte de service.
    • Téléchargez une clé privée au format JSON.

    Vous pouvez consulter et gérer ces ressources à tout moment dans Cloud Console.

  3. Définissez la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS pour qu'elle pointe 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 Translation, appelez la méthode translate v2 à l'aide d'une méthode REST.

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

    La commande curl inclut le code JSON avec le 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 se sert de 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 à ceci 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 !

Installer la bibliothèque cliente Cloud Translation – Basic

Les bibliothèques clientes sont disponibles pour plusieurs langages courants. Il s'agit de l'option recommandée. Pour installer une bibliothèque cliente, procédez comme suit :

C#

nuget install Google.Cloud.Translation.V2

Go

go get -u cloud.google.com/go/translate

Java

Si vous utilisez Maven, ajoutez les lignes suivantes à votre fichier pom.xml. Pour en savoir plus sur les BOM, consultez la page The Google Cloud Platform Libraries BOM (BOM des bibliothèques Google Cloud Platform).

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>10.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

Si vous utilisez Gradle, ajoutez les éléments suivants à vos dépendances :

compile 'com.google.cloud:google-cloud-translate:1.95.2'

Si vous utilisez sbt, ajoutez les éléments suivants à vos dépendances :

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "1.95.2"

Si vous utilisez IntelliJ ou Eclipse, vous pouvez ajouter des bibliothèques clientes à votre projet à l'aide des plug-ins IDE suivants :

Les plug-ins offrent des fonctionnalités supplémentaires, telles que la gestion des clés pour les comptes de service. Reportez-vous à la documentation de chaque plug-in pour plus de détails.

Node.js

Pour savoir comment configurer votre environnement de développement Node.js, consultez le guide de configuration d'un environnement de développement Node.js.

npm install --save @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Pour savoir comment configurer votre environnement de développement Python, consultez le guide de configuration d'un environnement de développement Python.

pip install google-cloud-translate==2.0.1

Ruby

Pour savoir comment configurer votre environnement de développement Ruby, consultez le guide de configuration d'un environnement de développement Ruby.

gem install google-cloud-translate

Pour obtenir des instructions d'installation, consultez la page Bibliothèques clientes Translation.

Nettoyer

Pour éviter d'encourir des frais inutiles liés à Google Cloud, supprimez votre projet à l'aide de Cloud Console si vous n'en avez plus besoin.

Étapes suivantes