AndroidでMicrosoft Translator Text API を使って翻訳する ～準備編～

# AndroidでMicrosoft Translator Text APIを使って翻訳する ～準備編～

MicrosoftTranslatorTextAPIを使って翻訳するAndroidアプリを作ったので、
導入方法を備忘録として残しておきます。
MicrosftTranslatorTextAPIは１ヵ月に200万文字までであれば無料でテキスト翻訳をしてくれるAPIです。
**無料**というところが良いですね。
翻訳精度は実際に動かしてみて確認します。

こちらの記事では**APIに使用するキーを取得するまで**の流れを書いています。

**2017/11/28 追記**
実装編を書きました。
[AndroidでMicrosoft Translator Text APIを使って翻訳する ～実装編～](https://qiita.com/y_kts_n/items/a6c535e626d618be3cdb)

## 1. MicrosoftAzureアカウントを作成する 
MicrosoftAzureアカウントを作成するには、Microsoftアカウントが必要になります。
既にMicrosoftアカウントを持っている場合は下記のログイン画面からログインできます。
https://portal.azure.com

![msa.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/3e90b9e6-9e3f-d335-52ff-de0687e07539.png)

Microsoftアカウントを持っていない場合は作成してください。

## 2. Azureサブスクリプションの取得
1で作成したアカウントでログインすると、ダッシュボードが表示されます。

![msad.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/22c0fc3c-c933-7206-fc8c-e2e92159d83c.png)

MicrosoftTranslatorTextAPIを使用するにはAzureサブスクリプションを取得する必要があります。
ダッシュボード画面右上のCreate DevOpsをクリックし、Azureサブスクリプションを取得します。

![mass.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/1905dd88-1e4c-6537-cc38-4eb42fdcea3c.png)

「新しいサブスクリプションにサインアップしてください」をクリックすると下の画面が表示されます。

![msax.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/a048a7fb-aa90-cf3a-ceea-6cc588c92863.png)


クレジットカードによる本人確認が必要になります。
お手元にクレジットカードを用意し、手順に従って登録してください。

あくまで本人確認なのでお金が勝手に支払われるといった心配はありません。
Azure内の有料コンテンツを利用する時にこちらのカードから代金が引かれるようです。
今回は無料のプランのTranslatorTextAPIを使用するのでお金はかかりません。
**30 日間の ¥ 20,500 のクレジットから開始し、引き続き無料でご利用いただけます**
と何やらややこしいことが書いてありますが、
「登録してから30日間であれば20,500円までの有料コンテンツを無料で利用できる」
ということらしいです。最初は月に20,500円強制で支払われるのかと思いビクビクしてました。

※追記
以下の情報をいただきました。
[Visual Studio Dev Essentials](https://www.visualstudio.com/ja/dev-essentials/)に登録しておくと、１２ヶ月の間、毎月３０００円分までAzureの有料コンテンツが無料で利用できるようです。
太っ腹ですね！他にAzureの機能を使ってみたい方はとりあえず登録しておくと良さそうですね。

## 3. リソースグループを登録する
APIを利用するにはリソースグループというものを登録しておく必要があります。
![msrr.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/8bdbebd8-81ac-ec93-04f0-19159b5e0ded.png)
ダッシュボードに戻り、画面左メニューの「リソースグループ」をクリックしてください。
下の画面が表示されます。

![msrr2.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/9eb0a0b0-2c80-1dee-565d-cfaf78407c22.png)
「＋追加」をクリックします。


![msrr3.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/6c2ebddd-66aa-bb0e-086d-a2354c8cc7d1.png)

入力欄が表示されるので、入力します。
リソースグループ名は何でもいいです。私は「TranslatorTest」としました。
サブスクリプションとリソースグループの場所は選択してください。
画面下部にあるCreateボタンをクリックし、登録を完了してください。

## 4. MarketplaceからMicrosoftTranslatorTextAPIを利用する準備をする
リソースグループの登録が完了したら再びダッシュボード画面に戻ってください。
MarketplaceからAPIの利用準備を開始します。
![msaa.png](https://qiita-image-store.s3.amazonaws.com/0/154882/9572eb3c-ba8b-aed3-0e49-b1c4c7de7b5d.png)
ボタンがあるのでクリックします。

![msam.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/f62c31df-cd8e-40aa-44c2-8f39b14d5fec.png)
Marketplaceが表示されます。
検索バーに「Translator Text API」と入力して検索するとヒットします。

![msam2.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/f3a19c79-b580-9c8e-d700-82ac168fcc12.png)

Translator Text APIをクリックします。

![msat.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/b088b5ac-9644-ca82-b6c9-4ff27b810449.png)

こんな画面が表示されるので下部の作成ボタンをクリックします。

![msac.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/c34a6f44-151f-0834-2cb9-43c5e23303c6.png)

作成画面が表示されるので、入力していきます。
・アカウント名：何でもよさそう。アプリの名前やパッケージ名？（testという名前でも通ったので一意である必要はなさそうです）
・サブスクリプション：無料試用版
・**価格レベル：F0（2M 月に最大200万文字までの翻訳）**
・リソースグループ：先ほど作成したものを選択します。
・リソースグループの場所：何でもいいです。

無料で利用したい場合は価格レベルは必ず**F0**を選択するようにしましょう。
価格レベル一覧は以下のようになっています。
![msap.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/f9092ec8-6e73-df2e-a768-e41078ea7b4f.png)

画面下部の作成ボタンをクリックするとCognitive Servicesのアカウントが作成されます。

## 5. アプリで使用するキーの確認
実際にアプリでAPIを利用するのに必要なキーを確認します。
ダッシュボードに戻ると、「すべてのリソース」欄に4で登録したアカウント名が表示されているはずです。
もしされていなければ左部メニューの「すべてのリソース」をクリックしてください。
![msak.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/775d40b3-8b74-d91a-11f2-0768965db8c7.png)
「すべてのリソース」内の該当アカウント名をクリックします。

![msak2.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/ae57e709-57b8-b63f-17cd-cfea7af060e4.png)
色々表示されてます。
アプリで使うのはサブスクリプションIDではないことに注意して下さい。
「キーの管理」の「Show acces keys...」リンクをクリックします。

![msak3.PNG](https://qiita-image-store.s3.amazonaws.com/0/154882/be00e0ca-e38a-a806-ed25-95babe5976a3.png)
ここで表示されたキー1 キー2が実際にアプリで使用するキーになります。
キー1とキー2のどちらでも大丈夫なようですが、とりあえずキー１を使うのでコピーしてどこかにメモっておきます。

これでAPIの利用準備は完了です。
長くなったので実際にアプリで利用する方法は別記事に記載します。