Language Translator > IBM  Language Translator > チュートリアル Step1


IBM  Language Translator のチュートリアル Step1を実行します。


## 初期設定

以下のページからひとまずサインインをすませます。
[IBM Watson トップページ - Japan](https://www.ibm.com/watson/jp-ja/)
メールの確認がsendgrid経由で届きます。
少ないとは思いますがsendgirdをネットワーク遮断している組織はそこから先へ進めないのでメールアドレスを変えてトライしてみてください。


### APIsからLanguage 言語系
[IBM Watson APIs サービスカタログ - Japan](https://www.ibm.com/watson/jp-ja/developercloud/services-catalog.html)


### Language Translator
[IBM - Language Translator | IBM Watson Developer Cloud - Japan](https://www.ibm.com/watson/jp-ja/developercloud/language-translator.html)

よく分かりにくいですが、ロケーションを米国南部以外は選択できませんでした。
![image](https://qiita-image-store.s3.amazonaws.com/0/49910/0582f97b-82ae-8013-e17a-2aca9268ab3d.png)


価格プランをLite（無料）を選んで先へ進みます。


## ダッシュボード
無事に初期登録と Language Translatorの設定が終われば、ダッシュボードに一覧が表示されます。

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/f8dd79b8-555f-bd0c-0a15-af0ec8440776.png)

サービス名をクリックして先へ進みます。

### 管理ページ
デフォルトで管理ページが表示されます。
Language Translatorの説明が並んでいます。
チュートリアルとデモへのアクセスもこのページから出来ます。

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/abf87c9c-640a-fc88-ab5b-2d1b7af9723a.png)

ちょっと待って！
さっそくチュートリアルへといきたいところですが、資格情報を登録しないとチュートリアルを実行する事ができないので、まずは資格情報を登録します。

### 資格情報の登録
左側メニューからサービス資格情報を選びます。
新規資格情報ボタンがあるので押下します。
![image](https://qiita-image-store.s3.amazonaws.com/0/49910/527af0ba-be6e-96fb-2a11-a853847a1338.png)

必用に応じて名前を変更し、「インラインの構成パラメーターの追加」はひとまず空白で進めます。

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/dc659b50-2b16-332e-3b2e-2d8f7839a83e.png)

無事に追加が終わるとキーの一覧に表示されます。資格情報の表示でユーザー名とパスワードを確認します。
※後ほど使いますのでファイル等に保存しときます。

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/86ebfae6-6cb3-2867-1463-682e3e34b64a.png)

## チュートリアル
左側メニューから開始を選びます。
Before you begin等が並んでいますが、ちょっと下のほうにスクロールしてStep 1: Translate textへ行きます。
![image](https://qiita-image-store.s3.amazonaws.com/0/49910/a4bc188a-5957-d3ca-a367-0984d4d309be.png)

### Step 1: Translate text

「Hello、world！」を翻訳しよう　みたいな事が書いてあります。
サンプルは英語→スペイン語なので、英語→日本語に変えています。
* Language Translatorでは日本語は"ja" と指定します。
* ユーザー名とパスワードは前述資格情報でメモったものを使います。

```shell-session
curl -X POST --user {username}:{password} --header "Content-Type: application/json" --header "Accept: application/json" --data "{\"text\":\"Hello\",\"source\":\"en\",\"target\":\"ja\"}" https://gateway.watsonplatform.net/language-translator/api/v2/translate
```

#### テスト
curlかpostman等でテストしてみましょう。

* curlの使い方は以下参照
 [Windows > curlを使う - Qiita](https://qiita.com/sugasaki/items/ba9737d13db33d2cd71f)
* postmanの使い方は後述

jsonで以下のような応答があれば成功
認証エラー等があれば、エラーがjsonで返ってきます。

```json
{
    "translations": [
        {
            "translation": "こんにちは"
        }
    ],
    "word_count": 1,
    "character_count": 5
}
```


### 付録

## POSTMANでのPOSTテスト

POSTMANはインストール済とします。

### Authの入力
新規設定、Autuorizationタブにて以下を入力します。

* HTTPメソッドからPOSTを選びます。
* URLには　https://gateway.watsonplatform.net/language-translator/api/v2/translate
* TYPEはBasic Authを選択
* ユーザー名とパスワードは資格情報にて取得したものをセット
* 

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/4de6f0fb-62c8-93a1-836b-0bf1da4b8ecc.png)

### Headerの入力
Headerタブにて以下を入力します。（順不同）
* Accept：application/json
* Content-Type：application/json

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/76b2a8ae-cf4b-2a31-7845-5aefed84c369.png)

※Authorizationは自動で登録されます。

### Bodyの入力
Bodyタブで以下のように入力します。
* text：Hello
* source：en
* target：ja

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/a0bb0558-350d-bba3-cf9c-bfbe43b60d3d.png)


### 実行

Sendボタンを押します。

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/d3c6b828-fc9f-ed57-544b-ca2e9743dafa.png)

しばらく待つと画面下部に応答結果が表示されます。

![image](https://qiita-image-store.s3.amazonaws.com/0/49910/fb26dbc2-bc50-169b-0e93-cf4a7045dd31.png)