翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# リストを使用してカスタム語彙を作成する
<a name="custom-vocabulary-create-list"></a>

**重要**  
リスト形式のカスタム語彙は廃止が予定されているため、新しいカスタム語彙を作成する場合は、[テーブル形式](custom-vocabulary-create-table.md)を使用することを強くおすすめします。

 AWS マネジメントコンソール、、または AWS SDKs を使用して AWS CLI、リストからカスタム語彙を作成できます。
+ **AWS マネジメントコンソール**: カスタム語彙を含むテキストファイルを作成してアップロードする必要があります。行区切りまたはカンマ区切りのエントリを使用できます。リストはテキスト (\*.txt) ファイルとして保存する必要があります。`LF` と の両方の`CRLF`行末がサポートされています。
+ **AWS CLI** および **AWS SDK**: [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html#transcribe-CreateVocabulary-request-Phrases](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html#transcribe-CreateVocabulary-request-Phrases) フラグを使用して、API コールにカスタム語彙をカンマで区切ったエントリとして含める必要があります。

エントリに複数の単語が含まれている場合は、各単語をハイフンでつなぐ必要があります。たとえば、「ロサンゼルス」を **Los-Angeles**、「アンドララベリャ」を **Andorra-la-Vella** とします。

以下は 2 つの有効なリスト形式の例です。メソッド固有の例については、「[カスタム語彙リストの作成](#custom-vocabulary-create-list-examples)」を参照してください。
+ カンマで区切られたエントリ:

  ```
  Los-Angeles,CLI,Eva-Maria,ABCs,Andorra-la-Vella
  ```
+ 行で区切られたエントリ:

  ```
  Los-Angeles
  CLI
  Eva-Maria
  ABCs
  Andorra-la-Vella
  ```

**重要**  
使用する言語でサポートされている文字のみを使用できます。詳細については、ご使用の言語の「[文字セット](charsets.md)」を参照してください。

カスタム語彙リストは、[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html) オペレーションではサポートされていません。医療用のカスタム語彙を作成する場合は、テーブル形式を使用する必要があります。手順については、「[テーブルを使用してカスタム語彙を作成する](custom-vocabulary-create-table.md)」を参照してください。

## カスタム語彙リストの作成
<a name="custom-vocabulary-create-list-examples"></a>

で使用するカスタム語彙リストを処理するには Amazon Transcribe、次の例を参照してください。

### AWS CLI
<a name="vocab-create-list-cli"></a>

この例では、リスト形式のカスタム語彙ファイルで[語彙の作成](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html)コマンドを使用します。詳細については、「[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)」を参照してください。

```
aws transcribe create-vocabulary \ 
--vocabulary-name {{my-first-vocabulary}} \ 
--language-code {{en-US}} \ 
--phrases {{{CLI,Eva-Maria,ABCs}}}
```

ここでは、[語彙の作成](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html)コマンドと、カスタム語彙を作成するリクエストボディを使用した別の例を示します。

```
aws transcribe create-vocabulary \
--cli-input-json file://{{filepath}}/{{my-first-vocab-list}}.json
```

ファイル *my-first-vocab-list.json* には、次のリクエストボディが含まれています。

```
{
  "VocabularyName": "{{my-first-vocabulary}}",
  "LanguageCode": "{{en-US}}",
  "Phrases": [
        "{{CLI}}","{{Eva-Maria}}","{{ABCs}}"
  ]
}
```

`VocabularyState` を`PENDING` から `READY` に変更すると、カスタム語彙を文字起こしに使用できるようになります。カスタム語彙の現在のステータスを表示するには、以下を実行します。

```
aws transcribe get-vocabulary \
--vocabulary-name {{my-first-vocabulary}}
```

### AWS SDK for Python (Boto3)
<a name="vocab-create-list-python-batch"></a>

この例では AWS SDK for Python (Boto3) 、 を使用して、[create\_vocabulary メソッドを使用してリストからカスタム語](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_vocabulary)彙を作成します。詳細については、「[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)」を参照してください。

機能固有の例、シナリオ例、クロスサービス例など、 AWS SDKs[SDK を使用した Amazon Transcribe のコード例 AWS SDKs](service_code_examples.md)「」の章を参照してください。

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
vocab_name = "{{my-first-vocabulary}}"
response = transcribe.create_vocabulary(
    LanguageCode = '{{en-US}}',
    VocabularyName = vocab_name,
    Phrases = [
        '{{CLI}}','{{Eva-Maria}}','{{ABCs}}'
    ]
)

while True:
    status = transcribe.get_vocabulary(VocabularyName = vocab_name)
    if status['VocabularyState'] in ['READY', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```

**注記**  
カスタム語彙ファイル用に新しい Amazon S3 バケットを作成する場合は、[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)リクエストを行う IAM ロールにこのバケットへのアクセス許可があることを確認してください。ロールに正しいアクセス許可がない場合、リクエストは失敗します。オプションで、 `DataAccessRoleArn`パラメータを含めることで、リクエスト内で IAM ロールを指定できます。の IAM ロールとポリシーの詳細については Amazon Transcribe、「」を参照してください[Amazon Transcribe アイデンティティベースのポリシーの例](security_iam_id-based-policy-examples.md)。