Téléchargement java translate - Téléchargement du code source java translate

java translate

Autre code source

v2.3.5

Télécharger

Client de traduction de cloud Google pour Java

Client idiomatique Java pour la traduction du nuage.

Documentation du produit
Documentation de la bibliothèque client

? En octobre 2022, cette bibliothèque a déménagé sur Google-Cloud-Java / Java-Translate. Ce référentiel sera archivé à l'avenir. Les versions futures apparaîtront dans le nouveau référentiel (https://github.com/googleapis/google-cloud-java/releases). Les coordonnées des artefacts Maven ( com.google.cloud:google-cloud-translate nud-translate) restent les mêmes.

Start

Si vous utilisez Maven avec Bom, ajoutez-le à votre fichier pom.xml:

< dependencyManagement >
  < dependencies >
    < dependency >
      < groupId >com.google.cloud</ groupId >
      < artifactId >libraries-bom</ artifactId >
      < version >26.1.3</ 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 maven sans bom, ajoutez-le à vos dépendances:

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

Si vous utilisez Gradle 5.x ou version ultérieure, ajoutez ceci à vos dépendances:

implementation platform( ' com.google.cloud:libraries-bom:26.1.4 ' )

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

Si vous utilisez Gradle Without Bom, ajoutez-le à vos dépendances:

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

Si vous utilisez SBT, ajoutez-le à vos dépendances:

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

Authentification

Voir la section d'authentification dans la lecture du répertoire de base.

Autorisation

Les appels d'API de création d'application client doivent être accordés dans les lunettes d'autorisation requises pour les API de traduction cloud souhaitées, et le principal authentifié doit avoir le (s) rôle (s) IAM requis pour accéder aux ressources GCP à l'aide des appels d'API de traduction cloud.

Commencer

Condition préalable

Vous aurez besoin d'un projet de console Google Cloud Platform avec l'API de traduction cloud activée. Vous devrez permettre à Billing d'utiliser la traduction de Google Cloud. Suivez ces instructions pour mettre en place votre projet. Vous devrez également configurer l'environnement de développement local en installant le SDK Google Cloud et en exécutant les commandes suivantes dans la ligne de commande: gcloud auth login et gcloud config set project [YOUR PROJECT ID] .

Installation et configuration

Vous devrez obtenir la bibliothèque google-cloud-translate . Voir la section QuickStart pour ajouter google-cloud-translate comme une dépendance dans votre code.

À propos de la traduction du cloud

La traduction du cloud peut traduire dynamiquement le texte entre des milliers de paires de langues. La traduction permet aux sites Web et aux programmes de s'intégrer par programme avec le service de traduction.

Voir les documents de bibliothèque client de traduction cloud pour apprendre à utiliser cette bibliothèque client de traduction cloud.

Exemple d'application

TranslateExample est une interface de ligne de commande simple qui fournit une partie de la fonctionnalité de Google Traduction.

Création d'un objet de service autorisé

Pour faire des demandes authentifiées à Google Traduction, vous devez créer un objet de service avec des informations d'identification ou utiliser une clé API. La façon la plus simple d'authentifier est d'utiliser les informations d'identification par défaut de l'application. Ces informations d'identification sont automatiquement déduites de votre environnement, vous n'avez donc besoin que du code suivant pour créer votre objet de service:

 import com . google . cloud . translate . Translate ;
import com . google . cloud . translate . TranslateOptions ;

Translate translate = TranslateOptions . getDefaultInstance (). getService ();

Notez que ce code peut également être utilisé avec une clé API. Par défaut, une clé API est recherchée dans la variable d'environnement GOOGLE_API_KEY . Une fois la touche API définie, vous pouvez passer des appels API en invoquant des méthodes sur le service de traduction créé via TranslateOptions.getDefaultInstance().getService() .

Vous pouvez également définir explicitement la clé API comme suit:

 Translate translate = TranslateOptions . newBuilder (). setApiKey ( "myKey" ). build (). getService ();

Détection de la langue

Avec Google Traduction, vous pouvez détecter la langue d'un texte. Le service vous fournira le code de la langue détectée et un niveau de confiance.

Ajoutez l'importation suivante en haut de votre fichier:

 import com . google . cloud . translate . Detection ;

Ensuite, choisissez un échantillon de texte:

 final String mysteriousText = "Hola Mundo" ;

Ajoutez ensuite le code suivant pour détecter la langue du texte:

 Detection detection = translate . detect ( mysteriousText );
String detectedLanguage = detection . getLanguage ();

Traduction de texte

Google Traduction vous permet de traduire un texte. Lorsque vous traduisez un ou plusieurs textes, vous pouvez soit fournir la langue source ou laisser le service le détecter pour vous.

Ajoutez les importations suivantes en haut de votre fichier:

 import com . google . cloud . translate . Translate . TranslateOption ;
import com . google . cloud . translate . Translation ;

Ensuite, ajoutez le code suivant pour traduire le texte, en spécifiant la langue précédemment détectée ( detectedLanguage ) comme sa langue source et son anglais comme langue cible (fournir la langue source est facultative, s'il n'est pas spécifié, le service essaiera de le détecter automatiquement) :

 Translation translation = translate . translate (
    mysteriousText ,
    TranslateOption . sourceLanguage ( detectedLanguage ),
    TranslateOption . targetLanguage ( "en" ));

Code source complet

Dans DetectLanguageAndTranslate.java, nous avons mis en place tout le code indiqué ci-dessus en un seul programme. Le programme suppose que les informations d'identification par défaut d'application ou une clé API valide sont disponibles.

Échantillons

Les échantillons sont dans les samples/ répertoire.

Échantillon	Code source	Essayez-le
Échantillon de QuickStart	code source
Traduire le texte avec le glossaire et le modèle	code source
Document de traduire par lots	code source
Traduire le document	code source

Dépannage

Pour obtenir de l'aide, suivez les instructions du document de dépannage partagé.

Transport

La traduction cloud utilise à la fois Grpc et HTTP / JSON pour la couche de transport.

Versions Java prises en charge

Java 8 ou plus est requis pour utiliser ce client.

Les bibliothèques clients Java de Google, les bibliothèques de clients de Google Cloud et les bibliothèques API de Google Cloud, suivent la feuille de route Oracle Java SE Support (voir la section Oracle Java SE Product Releases).

Pour le nouveau développement

En général, le développement de nouvelles fonctionnalités se produit avec la prise en charge de la version Java LTS la plus basse couverte par le support Premier d'Oracle (qui dure généralement 5 ans à partir de la disponibilité générale initiale). Si la JVM minimale requise pour une bibliothèque donnée est modifiée, elle s'accompagne d'une version majeure de Semver.

Java 11 et (en septembre 2021) Java 17 sont les meilleurs choix pour le nouveau développement.

Garder les systèmes de production à jour

Google teste ses bibliothèques clients avec toutes les versions LTS actuelles couvertes par la prise en charge étendue d'Oracle (qui dure généralement 8 ans à partir de la disponibilité générale initiale).

Support hérité

Les bibliothèques clients de Google prennent en charge les versions héritées de Java Runtime avec des bibliothèques stables à long terme qui ne reçoivent pas les mises à jour des fonctionnalités sur la base des meilleurs efforts, car il peut ne pas être possible de reporter tous les correctifs.

Google fournit des mises à jour sur la base des meilleurs efforts aux applications qui continuent d'utiliser Java 7, bien que les applications devraient avoir besoin de passer aux versions actuelles de la bibliothèque qui prend en charge leur JVM.

Où trouver des informations spécifiques

Les dernières versions et les versions Java prises en charge sont identifiées sur le référentiel individuel GitHub github.com/GoogleAPIs/java-SERVICENAME et sur google-cloud-java.

Versioning

Cette bibliothèque suit le versioning sémantique.

Contributif

Les contributions à cette bibliothèque sont toujours les bienvenues et très encouragées.

Voir contribuer pour plus d'informations sur la façon de commencer.

Veuillez noter que ce projet est publié avec un code de conduite de contributeur. En participant à ce projet, vous acceptez de respecter ses conditions. Voir Code de conduite pour plus d'informations.