Traduire du texte avec Cloud Translation Advanced
Ce document explique comment traduire un exemple de texte à l'aide de Cloud Translation Advanced.
Avant de commencer
Pour pouvoir utiliser l'API Cloud Translation, vous devez disposer d'un projet pour lequel cette API est activée, ainsi que des identifiants appropriés. Vous pouvez également installer des bibliothèques clientes pour les langages de programmation courants afin de faciliter les appels à l'API. Pour en savoir plus, consultez la page Configuration.
Traduire un exemple de texte
L'exemple suivant montre comment utiliser Cloud Translation - Advanced pour traduire du texte dans une langue cible donnée.
REST
Utilisez curl
ou PowerShell pour effectuer une requête.
Les langues source et cible sont identifiées à l'aide des codes ISO-639. La langue source est l'anglais (en), et la langue cible est le russe (ru). Le format de la requête est noté comme "text" pour le texte brut.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_NUMBER_OR_ID : ID numérique ou alphanumérique de votre projet Google Cloud.
Méthode HTTP et URL :
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Corps JSON de la requête :
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!"], "mimeType": "text/plain" }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "translations": [{ "translatedText": "Доктор Ватсон, иди сюда!" }] }
Go
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Go.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration pour Java du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Java.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Avant d'essayer cet exemple, suivez les instructions de configuration pour Node.js du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Node.js.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration pour Python du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Python.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Langues supplémentaires
C# : Veuillez suivre les Instructions de configuration pour C# sur la page des bibliothèques clientes, puis consultez la Documentation de référence sur Cloud Translation pour .NET.
PHP : Veuillez suivre les Instructions de configuration pour PHP sur la page des bibliothèques clientes, puis consultez la Documentation de référence sur Cloud Translation pour PHP.
Ruby : Veuillez suivre les instructions de configuration de Ruby sur la page des bibliothèques clientes, puis consultez la documentation de référence sur Cloud Translation pour Ruby.
Autres ressources
- Pour plus d'informations sur la traduction de texte, consultez le guide d'utilisation Traduire du texte (version Advanced).
- Pour obtenir de l'aide sur la résolution des erreurs ou des problèmes courants, consultez la page Dépannage.
- Pour obtenir des réponses aux questions d'ordre général sur Cloud Translation, consultez la page Questions fréquentes générales.
- Cloud Translation est disponible dans deux éditions. Pour en savoir plus sur chaque édition, consultez la page Comparer les versions Basic et Advanced.