[Cloud Translation Basic API(V2)] JavaでTranslation Basic APIを使う

Googleが提供しているCloud Translation APIをJavaで使ってみました。
APIには、BasicとAdvancedがありますが、こちらの記事は**Basic**の方を扱います。

**Cloud Translation APIとは**
テキストを翻訳するAPIです。
翻訳には、Googleの事前トレーニング済みカスタムモデル、
または翻訳に特化した大規模言語モデル（LLM）が使用されます。

APIには、「Basic」と「Advanced」の２つのエディションがあります。
Basicでも翻訳は可能ですが、Advancedではさらに機能の追加がされています。
機能の違いは公式ドキュメントの[⧉Basic と Advanced の比較](https://cloud.google.com/translate/docs/editions?hl=ja)をご覧ください。

APIの利用料金は、どちらも 500,000文字/月まで無料です。
料金の詳細は公式ドキュメントの
[⧉Google AI でドキュメント、音声、動画をリアルタイムで翻訳できます](https://cloud.google.com/translate/?hl=ja#pricing)
をご覧ください。

|No|||目次|
|---|---|---|---|
|1|||[Cloud Translation APIを使用するための準備](#1-cloud-translation-apiを使用するための準備)|
||1||[プロジェクトの作成](#11-プロジェクトの作成)|
||2||[Cloud Translation APIの設定](#12-cloud-translation-apiの設定)|
||3||[APIを使用するためのキー取得](#13-apiを使用するためのキー取得)|
|||1|[サービス アカウント](#131-サービス-アカウント)|
|||2|[OAuth2.0 クライアントID](#132-oauth20-クライアントid)|
|||3|[APIキー](#133-apiキー)|
|2|||[Cloud Translation APIを使ってみる](#2-cloud-translation-apiを使ってみる)|
||1||[googleライブラリの読み込み](#21-googleライブラリの読み込み)|
||2||[Translateインスタンスを取得](#22-translateインスタンスを取得)|
|||1|[サービスアカウントを利用する場合](#221-サービスアカウントを利用する場合)|
|||2|[OAuth 2.0 クライアントIDを利用する場合](#222-oauth-20-クライアントidを利用する場合)|
|||3|[APIキーを利用する場合](#223-apiキーを利用する場合)|
||3||[プログラムの実行](#23-プログラムの実行)|
|3|||[いろいろとAPIを叩いてみる](#3-いろいろとapiを叩いてみる)|
||1||[v2.detect](#31-v2detect)|
||2||[v2.languages](#32-v2languages)|

# 1. Cloud Translation APIを使用するための準備
設定は下記から行います。
[⧉Google クラウド プラットフォーム](https://console.cloud.google.com/)

やることは大きく分けて下記の3つです。
[１.GCPプロジェクトの作成](#11-プロジェクトの作成)
[２.Cloud Translation APIの有効化](#12-cloud-translation-apiの設定)
[３.プログラムで使用するキーの取得](#13-apiを使用するためのキー取得)

3.は、サービスアカウントかOAuth2.0かAPIキーを利用する3つの方法があります。

### 1.1. プロジェクトの作成
まずはGCPでプロジェクトを作成します。
詳細はこちらの記事を参照ください
[⧉[Google Sheets API] Google Sheets API v4をJavaで操作する(1.1. プロジェクトの作成)](https://qiita.com/doran/items/3d43f776188b2281044c/#11-プロジェクトの作成)

### 1.2. Cloud Translation APIの設定

Cloud Translation APIを使えるようにします。
###### 1. メニューの 「APIとサービス」 -> 「ライブラリ」 を選択します。
<img width="480" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/114621/2fda7515-ffdf-11d7-4142-fed896cc8413.png">

###### 2. translationと入力して「Cloud Translation API」を検索します。
<img width="480" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/114621/041693a4-5f48-eea5-c38e-64bf773b0113.png">

###### 3. 「有効にする」ボタンを押して「Cloud Translation API」を使用可能にします。
<img width="480" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/114621/19d56f2d-5e97-d40c-2e43-0234d9cd80f1.png">

### 1.3. APIを使用するためのキー取得
プログラムからAPIを実行するための準備を行います。
サービスアカウント、OAuth2.0、APIキーを利用する3つの方法があります。

#### 1.3.1. サービス アカウント
同じ内容を下記の記事に掲載してますので、下記の記事を参照ください。
[⧉[Google Sheets API] Google Sheets API v4をJavaで操作する(1.3. Googleサービスアカウントの作成)](https://qiita.com/doran/items/3d43f776188b2281044c/#13-googleサービスアカウントの作成)

#### 1.3.2. OAuth2.0 クライアントID
同じ内容を下記の記事に掲載してますので、下記の記事を参照ください。
[⧉[Google Drive API v3] JavaでDrive APIを使う(1.3.2. OAuth2.0 クライアントID)](https://qiita.com/doran/items/15b2c59adb410ddeeb8a/#132-oauth20-クライアントid)

#### 1.3.3. APIキー
APIを操作するためにAPIキーを取得します。

「APIとサービス」 -> 「認証情報」　を選択すると以下の画面が表示されます。
<img width="480" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/114621/d7801ca1-1ac3-21c2-4dc6-22af9a031367.png">

「認証情報を作成」 -> 「APIキー」 を選択します。
<img width="480" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/114621/f360485a-787f-3dc8-e1cf-92d3db21d51e.png">

APIキーが作成されますので、「自分のAPIキー」の値を保持してください。
この値をプログラムで指定します。
<img width="380" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/114621/bccbd62b-3554-ace2-5d71-1b668aaf977d.png">

# 2. Cloud Translation APIを使ってみる
### 2.1. googleライブラリの読み込み
Cloud Translation APIを使用するためにライブラリのパスを設定します。
私の環境はpom.xmlで下記を指定しています。
Javaのバージョンは21を使用しています。

```xml
<dependencies>
    <dependency>
        <groupId>com.google.api-client</groupId>
        <artifactId>google-api-client</artifactId>
    </dependency>
    <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>google-cloud-translate</artifactId>
    </dependency>
    <!-- OAuth2.0で認証を行う場合のみ使用します -->
    <dependency>
        <groupId>com.google.oauth-client</groupId>
        <artifactId>google-oauth-client-jetty</artifactId>
    </dependency>
</dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.google.cloud</groupId>
            <artifactId>libraries-bom</artifactId>
            <version>26.34.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
```

### 2.2. Translateインスタンスを取得

#### 2.2.1. サービスアカウントを利用する場合
コード中の「JSONファイルのパス」は、
[⧉[Google Sheets API] Google Sheets API v4をJavaで操作する(1.3. Googleサービスアカウントの作成)](https://qiita.com/doran/items/3d43f776188b2281044c#13-googleサービスアカウントの作成)
で取得したJSONファイルのパスを指定してください。

コード中の「スコープ」は、
実行するAPIによって異なるので適時に変更してください。
```java
private static Translate getTranslate() throws Exception {
    HttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();
    GsonFactory jsonFactory = GsonFactory.getDefaultInstance();
    
    try(InputStream input = new FileInputStream("JSONファイルのパス")){
        GoogleCredentials credentials = GoogleCredentials
                .fromStream(input)
                .createScoped(Arrays.asList("スコープ"));
        
        return new Translate(transport, jsonFactory, new HttpCredentialsAdapter(credentials));
    }
}
```
#### 2.2.2. OAuth 2.0 クライアントIDを利用する場合
コード中の「JSONファイルのパス」は、
[⧉[Google Drive API v3] JavaでDrive APIを使う(1.3.2.1 認証情報の作成)](https://qiita.com/doran/items/15b2c59adb410ddeeb8a/#1321-認証情報の作成)
で取得したJSONファイルのパスを指定してください。

コード中の「認証情報を保存するフォルダパス」は、
認証情報が保存されるフォルダのパスを指定してください。
このコードを実行するとOAuth同意画面が表示されます。
ユーザーが同意をすると認証情報を保存するフォルダにファイルが生成されます。
このファイルが存在した場合は、再度実行してもOAuth同意画面は表示されません。

コード中の「スコープ」は、
実行するAPIによって異なるので適時に変更してください。
途中でスコープを変更した場合は再度のOAuth同意が必要になるので
「認証情報を保存するフォルダパス」にあるファイルを削除するか、パスを変えてください。
```java
private static Translate getTranslate() throws Exception {
    HttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();
    GsonFactory jsonFactory = GsonFactory.getDefaultInstance();
    
    try(Reader reader = new InputStreamReader(new FileInputStream("JSONファイルのパス"))){
        GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(jsonFactory,reader);

        GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder(
                transport, jsonFactory, clientSecrets, 
                Arrays.asList("スコープ"))
            .setDataStoreFactory(new FileDataStoreFactory(new java.io.File("認証情報を保存するフォルダパス")))
            .build();
        
        LocalServerReceiver receiver = new LocalServerReceiver.Builder().build();
        Credential credential = new AuthorizationCodeInstalledApp(flow, receiver).authorize("user");
        
        return new Translate.Builder(transport, GsonFactory.getDefaultInstance(), credential).build();
    }
}
```

#### 2.2.3. APIキーを利用する場合
コード中の「APIキー」は、
[1.3. APIを使用するためのキー取得(1.3.3. APIキー)](#133-apiキー)
で取得したAPIキーを指定してください。

```java
private static Translate getTranslate() throws Exception {
    HttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();
    GsonFactory jsonFactory = GsonFactory.getDefaultInstance();
    
    TranslateRequestInitializer key = new TranslateRequestInitializer("APIキー");
    return new Translate.Builder(transport, jsonFactory, null)
            .setGoogleClientRequestInitializer(key).build();
}
```

### 2.3. プログラムの実行
プログラムを動かします。

サンプルでは、翻訳がサポートされている言語のリストを取得しています。

```java
public static void main(String[] args) throws Exception{
    Translate translate = getTranslate();
    Translate.Languages languages = translate.languages();
    Translate.Languages.List list = languages.list();
    
    LanguagesListResponse res = list.execute();
    System.out.println(res);
}

```
# 3. いろいろとAPIを叩いてみる
いろいろなAPIを叩いてみます。

### 3.1. v2.detect
|メソッド|概要|記事|
|---|---|---|
|list|テキストを翻訳|[⧉[Cloud Translation Basic API(V2)] Javaでテキストを翻訳する](https://qiita.com/doran/items/cc71238d9752ddff719d)|
|detect|テキストに使われている言語を取得|[⧉[Cloud Translation Basic API(V2)] Javaでテキストに使用されている言語を検出する](https://qiita.com/doran/items/e9a9dba7e79f976a7194)|

### 3.2. v2.languages
|メソッド|概要|記事|
|---|---|---|
|list|翻訳がサポートされている言語のリストを取得|[⧉[Cloud Translation Basic API(V2)] Javaで翻訳がサポートされている言語のリストを取得する](https://qiita.com/doran/items/271769ab54bd8526c5bf)|

<br>
<br>
おしまい。。