Configuration

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 indiquer l'une ou l'autre de ces valeurs lorsque vous appelez l'API Cloud Translation.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

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.

Remarque : Pour vous aider à gérer votre budget, vous pouvez définir des limites d'utilisation pour vos projets. Pour en savoir plus, consultez la section Définir des quotas d'utilisation.

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.

Make sure that billing is enabled for your Google Cloud project.

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.

Enable the Cloud Translation API.

Enable the 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.

Remarque :Les autorisations de rôle ne s'appliquent qu'à Cloud Translation – Advanced. Vous pouvez utiliser des comptes de service pour les deux éditions mais vous ne pouvez définir que des autorisations spécifiques pour Cloud Translation – Advanced. Pour Cloud Translation - Basic, vous pouvez effectuer n'importe quelle requête quelles que soient les autorisations du compte de service.

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

Attention : La bibliothèque cliente Java n'est pas compatible avec Android.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.50.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>

If you are using Gradle, add the following to your dependencies:

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

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

Attention : La bibliothèque cliente Java n'est pas compatible avec Android.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.50.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>

If you are using Gradle, add the following to your dependencies:

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

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

Remarque : Vous pouvez ignorer cette étape si vous ne comptez pas utiliser la ligne de commande pour effectuer des appels d'API authentifiés.

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 :

Install the Google Cloud CLI, then initialize it by running the following command:

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

• Utilisez les guides de démarrage rapide pour effectuer des appels de traduction simples :

  • Guide de démarrage rapide de Cloud Translation – Basic
  • Cloud Translation – Démarrage rapide

• Consultez les guides pratiques pour découvrir comment utiliser diverses fonctionnalités de Cloud Translation.

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