Prérequis

Pour commencer à utiliser Cloud Translation, vous devez disposer d'un projet pour lequel l'API Cloud Translation est activée et d'identifiants pour effectuer des appels authentifiés. Les sections suivantes présentent la configuration à mettre en place avant d'effectuer votre premier appel à l'API Cloud Translation.

Le processus de configuration utilise Google Cloud Console, interface Web qui vous permet de provisionner, configurer, gérer et surveiller les systèmes dans Google Cloud. Si vous n'avez encore jamais utilisé Google Cloud Console, consultez la page Cloud Console pour plus d'informations.

Avant de commencer

Cloud Translation est disponible dans deux éditions(Basic et Advanced). Choisissez bien l'édition que vous souhaitez utiliser, car chacune dispose de son propre ensemble de bibliothèques clientes.

Créer ou sélectionner un projet

Pour utiliser les services fournis par Google Cloud, vous devez créer un projet. Un projet permet d'organiser toutes vos ressources Google Cloud. Il se compose d'un ensemble de collaborateurs, d'API activées (et d'autres ressources), d'outils de surveillance, d'informations de facturation et de contrôles d'authentification et d'accès. Vous pouvez créer un projet, ou en créer plusieurs et les utiliser pour organiser vos ressources Google Cloud dans une hiérarchie des ressources. Lorsque vous créez un projet, notez l'ID du projet. Vous en aurez besoin pour effectuer des appels d'API. Pour en savoir plus sur les projets, consultez la documentation concernant Resource Manager.

Nous vous recommandons de créer des projets distincts pour les essais, les tests et la production. Après avoir créé un projet, enregistrez le numéro ou l'ID du projet. Vous devez l'indiquer lorsque vous appelez l'API Cloud Translation.

Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

Accéder au sélecteur de projet

Activer la facturation

Vous devez activer la facturation pour utiliser Cloud Translation. Pour plus d'informations sur les tarifs de Cloud Translation, consultez la page Tarifs.

Un compte de facturation sert à déterminer qui assume les frais pour un ensemble de ressources donné. Il peut être associé à un ou plusieurs projets. Les frais d'utilisation du projet sont imputés au compte de facturation associé. Dans la plupart des cas, vous configurez la facturation lorsque vous créez un projet. Pour en savoir plus, consultez la documentation concernant la facturation.

Vérifiez que la facturation est activée pour votre projet Google Cloud.

Activer l'API

Vous devez activer l'API Cloud Translation pour votre projet. Pour en savoir plus sur l'activation des API, consultez la documentation concernant Service Usage.

Activez Cloud Translation API.

Activer l'API

Définir les quotas d'utilisation

Cloud Translation comprend un système de gestion des quotas pour vous aider et pour aider Google à gérer l'utilisation du service. Par défaut, le nombre de caractères que vous pouvez envoyer par jour est illimité. Si vous avez un budget défini, nous vous recommandons de surveiller votre utilisation quotidienne et d'ajuster les quotas en fonction de vos dépenses planifiées.

Pour plus d'informations sur les quotas, consultez la page Quotas et limites.

Configurer l'authentification

Si vous comptez utiliser l'API Cloud Translation, vous devez configurer l'authentification. Toute application cliente qui utilise l'API doit être authentifiée et se voir accorder l'accès aux ressources demandées. Pour en savoir plus, consultez la page S'authentifier auprès de Cloud Translation.

Rôles de gestion de l'authentification et des accès (IAM)

Lorsqu'un compte principal (compte utilisateur, compte de service, etc.) appelle une API, Google Cloud exige que celui-ci dispose des autorisations appropriées. Vous pouvez accorder des autorisations en attribuant des rôles à un compte principal. Pour en savoir plus, consultez la page Contrôler les accès avec IAM.

Installer des bibliothèques clientes

Les bibliothèques clientes sont disponibles dans plusieurs langages courants. Nous vous recommandons d'utiliser ces bibliothèques clientes pour appeler Cloud Translation, car elles facilitent l'accès aux API. Si une bibliothèque cliente ne répond pas à vos besoins ou n'est pas disponible pour votre langage, créez votre propre code personnalisé. Pour en savoir plus, consultez la page Utiliser votre propre code client.

Par exemple, lorsque vous utilisez une bibliothèque cliente, celle-ci peut déterminer vos identifiants de manière implicite via la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS. Vous n'avez pas besoin d'indiquer explicitement vos identifiants dans le code. Pour en savoir plus, consultez la page Présentation des bibliothèques clientes dans la documentation des API Cloud.

Bibliothèques clientes Cloud Translation – Basic

Sélectionnez le langage de programmation que vous utilisez pour le développement, puis exécutez la commande associée. Pour en savoir plus, consultez la présentation des bibliothèques clientes de Cloud Translation Basic.

C#

nuget install Google.Cloud.Translation.V2

Go

go get 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>26.34.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

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

implementation 'com.google.cloud:google-cloud-translate:2.38.0'

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

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

Si vous utilisez Visual Studio Code, 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-v2

Bibliothèques clientes Cloud Translation – Advanced

Sélectionnez le langage de programmation que vous utilisez pour le développement, puis exécutez la commande associée. Pour en savoir plus, consultez la présentation des bibliothèques clientes de Cloud Translation – Advanced.

C#

nuget install Google.Cloud.Translate.V3 -Pre

Go

go get cloud.google.com/go/translate/apiv3

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>26.34.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

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

implementation 'com.google.cloud:google-cloud-translate:2.38.0'

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

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

Si vous utilisez Visual Studio Code, 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 --upgrade google-cloud-translate

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

Installer Google Cloud CLI

Si vous envisagez d'envoyer des requêtes Cloud Translation via la ligne de commande (par exemple via des commandes curl), installez et initialisez gcloud CLI, incluse dans Google Cloud CLI. Le lien suivant fournit plus d'informations :

Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :

gcloud init

Tester le SDK et s'authentifier

Si vous avez configuré la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS, vous pouvez utiliser gcloud pour tester votre environnement d'authentification. Exécutez la commande suivante et vérifiez qu'aucune erreur ne se produit et que les identifiants sont bien renvoyés :

gcloud auth application-default print-access-token

La commande précédente est utilisée par tous les exemples REST de ligne de commande Cloud Translation pour authentifier les appels d'API.

Étape suivante

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud Translation en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Profiter d'un essai gratuit de Cloud Translation