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.
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.
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.
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
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.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
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
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.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
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 :
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 :
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