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 la console Google Cloud , une interface Web qui vous permet de provisionner, configurer, gérer et surveiller les systèmes dansGoogle Cloud. Si vous n'avez encore jamais utilisé la console Google Cloud , consultez la page Console Cloud pour en savoir plus.

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.

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

Rôles requis pour sélectionner ou créer un projet

• Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

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.

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.

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

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 l'API Cloud Translation.

Rôles requis pour activer les API

Pour activer les API, vous avez besoin du rôle IAM Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

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 qu'il 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.

Si vous utilisez Maven, ajoutez les lignes suivantes à votre pom.xml fichier. 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.78.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 :

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

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

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

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

• Cloud Code pour VS Code
• Cloud Code pour IntelliJ

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.

Remarque : Les bibliothèques clientes Java de Google Cloud ne sont actuellement pas compatibles avec 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 @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.

Si vous utilisez Maven, ajoutez les lignes suivantes à votre pom.xml fichier. 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.78.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 :

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

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

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

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

• Cloud Code pour VS Code
• Cloud Code pour IntelliJ

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.

Remarque : Les bibliothèques clientes Java de Google Cloud ne sont actuellement pas compatibles avec 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 @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 la gcloud CLI, incluse dans Google Cloud CLI. Le lien suivant fournit plus d'informations :

Installez Google Cloud CLI. Une fois que Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :

gcloud init

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

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 la présentation du produit pour en savoir plus sur l'utilisation des 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 Storage en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

Profiter d'un essai sans frais de Cloud Translation