java translate

JavaのGoogle Cloud Translation Client

クラウド翻訳のためのJava Idiomaticクライアント。

• 製品ドキュメント
• クライアントライブラリのドキュメント

？ 2022年10月、このライブラリはGoogle-Cloud-Java/Java-Translateに移動しました。このリポジトリは将来アーカイブされます。将来のリリースは、新しいリポジトリ（https://github.com/googleapis/google-cloud-java/releases）に表示されます。 Mavenアーティファクト座標（ com.google.cloud:google-cloud-translate ）は同じままです。

クイックスタート

BOMでMavenを使用している場合は、これを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 >

BOMなしでMavenを使用している場合は、これを依存関係に追加してください。

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

Gradle 5.x以降を使用している場合は、これを依存関係に追加します。

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

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

BOMなしでGradleを使用している場合は、これを依存関係に追加します。

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

SBTを使用している場合は、これを依存関係に追加します。

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

認証

Base DirectoryのReadMeの認証セクションを参照してください。

許可

API呼び出しを作成するクライアントアプリケーションは、目的のクラウド変換APIに必要な承認スコープを付与する必要があり、認証されたプリンシパルは、クラウド変換API呼び出しを使用してGCPリソースにアクセスするために必要なIAMの役割を持つ必要があります。

はじめる

前提条件

Cloud Translation APIを有効にしたGoogle Cloud Platform Consoleプロジェクトが必要です。 Googleクラウド翻訳を使用するために請求を有効にする必要があります。これらの指示に従って、プロジェクトを設定します。また、Google Cloud SDKをインストールし、コマンドラインで次のコマンドを実行することにより、ローカル開発環境をセットアップする必要があります。GCLoudAuth gcloud auth loginとgcloud config set project [YOUR PROJECT ID] 。

インストールとセットアップ

google-cloud-translateライブラリを取得する必要があります。 QuickStartセクションを参照して、コードの依存関係としてgoogle-cloud-translate追加してください。

クラウド翻訳について

クラウド翻訳は、数千の言語ペア間でテキストを動的に翻訳できます。翻訳により、Webサイトやプログラムがプログラムで翻訳サービスと統合されます。

クラウド翻訳クライアントライブラリドキュメントを参照して、このクラウド翻訳クライアントライブラリの使用方法を学びます。

アプリケーションの例

TranslateExample 、Google Translationの機能の一部を提供する単純なコマンドラインインターフェイスです。

許可されたサービスオブジェクトを作成します

Google翻訳に認証されたリクエストを作成するには、資格情報を持つサービスオブジェクトを作成するか、APIキーを使用する必要があります。認証する最も簡単な方法は、アプリケーションのデフォルト資格情報を使用することです。これらの資格情報は環境から自動的に推測されるため、サービスオブジェクトを作成するには次のコードのみが必要です。

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

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

このコードは、APIキーでも使用できることに注意してください。デフォルトでは、APIキーがGOOGLE_API_KEY Environment変数で探しられます。 APIキーが設定されたら、 TranslateOptions.getDefaultInstance().getService()を介して作成された翻訳サービスでメソッドを呼び出すことにより、API呼び出しを行うことができます。

次のように、APIキーを明示的に設定することもできます。

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

言語の検出

Googleの翻訳を使用すると、いくつかのテキストの言語を検出できます。このサービスは、検出された言語のコードと自信のレベルを提供します。

ファイルの上部に次のインポートを追加します。

 import com . google . cloud . translate . Detection ;

次に、テキストサンプルを選択します。

 final String mysteriousText = "Hola Mundo" ;

次に、次のコードを追加して、テキストの言語を検出します。

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

テキストの翻訳

Google翻訳を使用すると、テキストを翻訳できます。 1つ以上のテキストを翻訳する場合、ソース言語を提供するか、サービスに検出させることができます。

ファイルの上部に次のインポートを追加します。

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

次に、次のコードを追加してテキストを翻訳し、以前に検出された言語（ detectedLanguage ）をソース言語として、英語をターゲット言語として指定します（ソース言語を提供することはオプションです。 ：

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

完全なソースコード

DetectlanguageandTranslate.javaでは、上記のすべてのコードを1つのプログラムにまとめました。プログラムは、アプリケーションのデフォルト資格情報または有効なAPIキーのいずれかが利用可能であると想定しています。

サンプル

サンプルはsamples/ディレクトリにあります。

サンプル	ソースコード	試してみてください
クイックスタートサンプル	ソースコード
用語集とモデルでテキストを翻訳します	ソースコード
バッチ翻訳ドキュメント	ソースコード
ドキュメントを翻訳します	ソースコード

トラブルシューティング

ヘルプを得るには、共有トラブルシューティングドキュメントの指示に従ってください。

輸送

クラウド翻訳は、輸送層にGRPCとHTTP/JSONの両方を使用します。

サポートされているJavaバージョン

このクライアントを使用するには、Java 8以上が必要です。

GoogleのJavaクライアントライブラリ、Google Cloudクライアントライブラリ、Google Cloud APIライブラリは、Oracle Java SEサポートロードマップに従います（Oracle Java SE製品リリースセクションを参照）。

新しい開発のため

一般に、新たな機能開発は、Oracleのプレミアサポートでカバーされている最低Java LTSバージョンのサポートで発生します（通常、最初の一般的な可用性から5年続く）。特定のライブラリに必要な最小JVMが変更された場合、SEMVERの主要なリリースが伴います。

Java 11および（2021年9月）Java 17は、新しい開発の最良の選択肢です。

生産システムを最新の状態に保ちます

Googleは、Oracleの拡張サポートでカバーされている現在のすべてのLTSバージョンでクライアントライブラリをテストします（通常、最初の一般的な可用性から8年続く）。

レガシーサポート

Googleのクライアントライブラリは、すべてのパッチをバックポートすることは不可能なため、最良の努力ベースで機能の更新を受け取らない長期的な安定したライブラリを備えたJava Runtimesのレガシーバージョンをサポートしています。

Googleは、Java 7を使用し続けるアプリに最適な努力に基づいて更新を提供しますが、AppはJVMをサポートするライブラリの現在のバージョンにアップグレードする必要がある場合があります。

特定の情報を見つける場所

最新のバージョンとサポートされているJavaバージョンは、個々のGithubリポジトリgithub.com/GoogleAPIs/java-SERVICENAMEおよびGoogle-cloud-javaで識別されます。

バージョン化

このライブラリはセマンティックバージョンに従います。

貢献

このライブラリへの貢献はいつでも歓迎され、強く奨励されています。

詳細については、開始方法については、貢献を参照してください。

このプロジェクトは、貢献者行動規範でリリースされていることに注意してください。このプロジェクトに参加することにより、その条件を順守することに同意します。詳細については、行動規範を参照してください。

ライセンス

Apache 2.0-詳細については、ライセンスを参照してください。

CIステータス

Javaバージョン	状態
Java 8
Java 8 OSX
Java 8 Windows
Java 11

Javaは、Oracleおよび/またはその関連会社の登録商標です。