[AWS SDK for JavaScript V3 API リファレンスガイド](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)では、 AWS SDK for JavaScript バージョン3 (V3) のすべての API オペレーションについて詳しく説明します。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Transcribeの例 Amazon Transcribe を使用すると、開発者はアプリケーションに音声認識機能を簡単に追加できます。 ![\[JavaScript 環境、SDK、および Amazon Transcribeの関係\]](http://docs.aws.amazon.com/ja_jp/sdk-for-javascript/v3/developer-guide/images/code-samples-transcribe.png) 「Amazon Transcribe」(Amazon Transcribe)のJavaScriptAPIは、[TranscribeService](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/Transcribe/)クライアントクラスを介して公開されます。 **Topics** + [ # Amazon Transcribeの例 ](transcribe-examples-section.md) + [ # Amazon Transcribe Medicalの例 ](transcribe-medical-examples-section.md) # Amazon Transcribeの例 この例では、一連のNode.jsモジュールを使用して、`TranscribeService`クライアントクラスの次のメソッドを使用して文字起こしジョブを作成、一覧表示、および削除します。 + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartTranscriptionJobCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/) Amazon Transcribe ユーザーの詳細については、[Amazon Transcribe 開発者ガイド](https://docs.aws.amazon.com//transcribe/latest/dg/what-is-transcribe.html)を参照してください。 ## 前提条件タスク この例をセットアップして実行するには、まず次のタスクを完了する必要があります。 + これらの Node TypeScript の例を実行するようにプロジェクト環境を設定し、必要な AWS SDK for JavaScript モジュールとサードパーティーモジュールをインストールします。「[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/README.md)」の指示に従います。　 + ユーザーの認証情報を使用して、共有設定ファイルを作成します。共有認証情報ファイルの提供の詳細については、「*AWS SDK とツールのリファレンスガイド*」の「[共有設定ファイルおよび認証情報ファイル](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)」を参照してください。 **重要** これらの例は、ECMAScript6 (ES6) を使用してクライアントサービスオブジェクトとコマンドをimport/export する方法を示します。 これには Node.js バージョン13.x以降が必要です。Node.js の最新バージョンをダウンロードしてインストールするには、「[Node.js ダウンロード](https://nodejs.org/en/download)」を参照してください。 CommonJS 構文を使用する場合は、[JavaScript ES6/CommonJS 構文](sdk-example-javascript-syntax.md)を参照してください。 ## Amazon Transcribe ジョブを開始します この例は、 AWS SDK for JavaScriptを使用してAmazon音声文字変換ジョブを開始する方法を示しています。詳細については、[StartTranscriptionJobCommand](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartTranscriptionJobCommand/)を参照してください。 `libs`ディレクトリを作成し、ファイル名`transcribeClient.js`でNode.js モジュールを作成します。以下のコードをコピーして、ペーストして、Amazon Transcribe クライアントオブジェクトを作成します。*REGION* を自分の AWS リージョンに置き換えます。 ``` import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon Transcribe service client object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient }; ``` このサンプルコードは、[このGitHubに](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)で見つけられます。 `transcribe-create-job.js`ファイル名を使用してNode.jsモジュールを作成します。前に示したように、必要なクライアントとパッケージのインストールを含むSDKが設定されていることを確認してください。必要なパラメータを指定してパラメータ オブジェクトを作成します。`StartMedicalTranscriptionJobCommand`コマンドを使用してジョブを開始します。 **注記** *MEDICAL\$1JOB\$1NAME*をトランスクリプションジョブの名前に置き換えてください。*OUTPUT\$1BUCKET\$1NAME*には、出力が保存されるAmazonS3バケットを指定します。*JOB\$1TYPE*には、ジョブのタイプを指定します。*SOURCE\$1LOCATION*には、ソースファイルの場所を指定します。*SOURCE\$1FILE\$1LOCATION*には、入力メディアファイルの場所を指定します。 ``` // Import the required AWS SDK clients and commands for Node.js import { StartTranscriptionJobCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { TranscriptionJobName: "JOB_NAME", LanguageCode: "LANGUAGE_CODE", // For example, 'en-US' MediaFormat: "SOURCE_FILE_FORMAT", // For example, 'wav' Media: { MediaFileUri: "SOURCE_LOCATION", // For example, "https://transcribe-demo.s3-REGION.amazonaws.com/hello_world.wav" }, OutputBucketName: "OUTPUT_BUCKET_NAME", }; export const run = async () => { try { const data = await transcribeClient.send( new StartTranscriptionJobCommand(params), ); console.log("Success - put", data); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` この例を実行するには、コマンドプロンプトで以下を入力します。 ``` node transcribe-create-job.js ``` このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_create_job.js)にあります。 ## AmazonTranscribeジョブを一覧表示します この例は、 AWS SDK for JavaScriptを使用して「Amazon Transcribe」(Amazon Transcribe)文字起こしジョブを一覧表示する方法を示しています。変更できる他の設定の詳細については、[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/)を参照してください。 `libs`ディレクトリを作成し、ファイル名`transcribeClient.js`でNode.js モジュールを作成します。以下のコードをコピーして、ペーストして、Amazon Transcribe クライアントオブジェクトを作成します。*REGION* を自分の AWS リージョンに置き換えます。 ``` import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon Transcribe service client object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient }; ``` このサンプルコードは、[このGitHubに](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)で見つけられます。 `transcribe-list-jobs.js`ファイル名を使用してNode.jsモジュールを作成します。前に示したように、必要なクライアントとパッケージのインストールを含むSDKが設定されていることを確認してください。必要なパラメータを使用して パラメータオブジェクトを作成します。 **注記** *KEY\$1WORD*を、返されるジョブ名が含まれている必要のあるキーワードに置き換えます。 ``` // Import the required AWS SDK clients and commands for Node.js import { ListTranscriptionJobsCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { JobNameContains: "KEYWORD", // Not required. Returns only transcription // job names containing this string }; export const run = async () => { try { const data = await transcribeClient.send( new ListTranscriptionJobsCommand(params), ); console.log("Success", data.TranscriptionJobSummaries); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` この例を実行するには、コマンドプロンプトで以下を入力します。 ``` node transcribe-list-jobs.js ``` このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_list_jobs.js)にあります。 ## Amazon Transcribe ジョブを削除します この例では、 AWS SDK for JavaScriptを使用してAmazon Transcribe文字起こしジョブを削除する方法を示します。オプションの詳細については、[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/)を参照してください。 `libs`ディレクトリを作成し、ファイル名`transcribeClient.js`でNode.js モジュールを作成します。以下のコードをコピーして、ペーストして、Amazon Transcribe クライアントオブジェクトを作成します。*REGION* を自分の AWS リージョンに置き換えます。 ``` import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Transcribe service object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient }; ``` このサンプルコードは、[このGitHubに](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)で見つけられます。 `transcribe-delete-job.js`ファイル名を使用してNode.jsモジュールを作成します。前に示したように、必要なクライアントとパッケージのインストールを含むSDKが設定されていることを確認してください。 AWS リージョンと、削除するジョブの名前を指定します。 **注記** *JOB\$1NAME*を削除するジョブの名前に置き換えてください。 ``` // Import the required AWS SDK clients and commands for Node.js import { DeleteTranscriptionJobCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { TranscriptionJobName: "JOB_NAME", // Required. For example, 'transciption_demo' }; export const run = async () => { try { const data = await transcribeClient.send( new DeleteTranscriptionJobCommand(params), ); console.log("Success - deleted"); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` この例を実行するには、コマンドプロンプトで以下を入力します。 ``` node transcribe-delete-job.js ``` このサンプルコードは、[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_delete_job.js)で公開されています。 # Amazon Transcribe Medicalの例 この例では、一連のNode.jsモジュールを使用して、`TranscribeService`クライアントクラスの次のメソッドを使用して、医療文字起こしジョブを作成、一覧表示、および削除します。 + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/) Amazon Transcribe ユーザーの詳細については、[Amazon Transcribe 開発者ガイド](https://docs.aws.amazon.com//transcribe/latest/dg/what-is-transcribe.html)を参照してください。 ## 前提条件タスク この例をセットアップして実行するには、まず次のタスクを完了する必要があります。 + これらの Node TypeScript の例を実行するようにプロジェクト環境を設定し、必要な AWS SDK for JavaScript モジュールとサードパーティーモジュールをインストールします。「[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/README.md)」の指示に従います。　 + ユーザーの認証情報を使用して、共有設定ファイルを作成します。共有認証情報ファイルの提供の詳細については、「*AWS SDK とツールのリファレンスガイド*」の「[共有設定ファイルおよび認証情報ファイル](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)」を参照してください。 **重要** これらの例は、ECMAScript6 (ES6) を使用してクライアントサービスオブジェクトとコマンドをimport/export する方法を示します。 これには Node.js バージョン13.x以降が必要です。Node.js の最新バージョンをダウンロードしてインストールするには、「[Node.js ダウンロード](https://nodejs.org/en/download)」を参照してください。 CommonJS 構文を使用する場合は、[JavaScript ES6/CommonJS 構文](sdk-example-javascript-syntax.md)を参照してください。 ## Amazon Transcribe のメディカル文字起こしジョブを開始します この例では、 AWS SDK for JavaScriptを使用してAmazon Transcribe のメディカル文字起こしジョブをスタートする方法を示します。詳細については、 [startMedicalTranscriptionJob ](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/)を参照してください。 `libs`ディレクトリを作成し、ファイル名`transcribeClient.js`でNode.js モジュールを作成します。以下のコードをコピーして、ペーストして、Amazon Transcribe クライアントオブジェクトを作成します。*REGION* を自分の AWS リージョンに置き換えます。 ``` import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Transcribe service object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient }; ``` このサンプルコードは、[このGitHubに](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)で見つけられます。 `transcribe-create-medical-job.js`ファイル名を使用してNode.jsモジュールを作成します。前に示したように、必要なクライアントとパッケージのインストールを含むSDKが設定されていることを確認してください。必要なパラメータを指定してパラメータ オブジェクトを作成します。`StartMedicalTranscriptionJobCommand`コマンドを使用してメディカル ジョブをスタートします **注記** *MEDICAL\$1JOB\$1NAME*をメディカル文字起こしジョブの名前に置き換えてください。*OUTPUT\$1BUCKET\$1NAME*には、出力が保存されるAmazonS3バケットを指定します。*JOB\$1TYPE*には、ジョブのタイプを指定します。*SOURCE\$1LOCATION*には、ソースファイルの場所を指定します。*SOURCE\$1FILE\$1LOCATION*には、入力メディアファイルの場所を指定します。 ``` // Import the required AWS SDK clients and commands for Node.js import { StartMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // Required OutputBucketName: "OUTPUT_BUCKET_NAME", // Required Specialty: "PRIMARYCARE", // Required. Possible values are 'PRIMARYCARE' Type: "JOB_TYPE", // Required. Possible values are 'CONVERSATION' and 'DICTATION' LanguageCode: "LANGUAGE_CODE", // For example, 'en-US' MediaFormat: "SOURCE_FILE_FORMAT", // For example, 'wav' Media: { MediaFileUri: "SOURCE_FILE_LOCATION", // The S3 object location of the input media file. The URI must be in the same region // as the API endpoint that you are calling.For example, // "https://transcribe-demo.s3-REGION.amazonaws.com/hello_world.wav" }, }; export const run = async () => { try { const data = await transcribeClient.send( new StartMedicalTranscriptionJobCommand(params), ); console.log("Success - put", data); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` この例を実行するには、コマンドプロンプトで以下を入力します。 ``` node transcribe-create-medical-job.js ``` このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_create_medical_job.js)にあります。 ## Amazon Transcribe メディカルジョブを一覧表示します この例では、 AWS SDK for JavaScriptを使用して Amazon Transcribe Transcribeジョブを一覧表示する方法を示します。詳細については、[ListTranscriptionMedicalJobsCommand](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListMedicalTranscriptionJobsCommand/)を参照してください。 `libs`ディレクトリを作成し、ファイル名`transcribeClient.js`でNode.js モジュールを作成します。以下のコードをコピーして、ペーストして、Amazon Transcribe クライアントオブジェクトを作成します。*REGION* を自分の AWS リージョンに置き換えます。 ``` import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon Transcribe service client object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient }; ``` このサンプルコードは、[このGitHubに](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)で見つけられます。 `transcribe-list-medical-jobs.js`ファイル名を使用してNode.jsモジュールを作成します。前に示したように、必要なクライアントとパッケージのインストールを含むSDKが設定されていることを確認してください。必要なパラメータを使用してパラメータオブジェクトを作成し、`ListMedicalTranscriptionJobsCommand` コマンドを使用してメディカルジョブを一覧表にします。 **注記** *KEYWORD*を、返されるジョブ名が含まれている必要のあるキーワードに置き換えます。 ``` // Import the required AWS SDK clients and commands for Node.js import { ListMedicalTranscriptionJobsCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { JobNameContains: "KEYWORD", // Returns only transcription job names containing this string }; export const run = async () => { try { const data = await transcribeClient.send( new ListMedicalTranscriptionJobsCommand(params), ); console.log("Success", data.MedicalTranscriptionJobName); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` この例を実行するには、コマンドプロンプトで以下を入力します。 ``` node transcribe-list-medical-jobs.js ``` このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_list_medical_jobs.js)にあります。 ## Amazon Transcribe メディカル ジョブを削除します この例では、 AWS SDK for JavaScriptを使用して Amazon Transcribe 文字起こしジョブを削除する方法を示します。オプションの詳細については、[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteMedicalTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteMedicalTranscriptionJobCommand/)を参照してください。 `libs`ディレクトリを作成し、ファイル名`transcribeClient.js`でNode.js モジュールを作成します。以下のコードをコピーして、ペーストして、Amazon Transcribe クライアントオブジェクトを作成します。*REGION* を自分の AWS リージョンに置き換えます。 ``` import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Transcribe service object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient }; ``` このサンプルコードは、[このGitHubに](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)で見つけられます。 `transcribe-delete-job.js`ファイル名を使用してNode.jsモジュールを作成します。前に示したように、必要なクライアントとパッケージのインストールを含むSDKが設定されていることを確認してください。必要なパラメータを使用してパラメータオブジェクトを作成し、`DeleteMedicalJobCommand`のコマンドを使用してメディカルジョブを削除します。 **注記** *JOB\$1NAME*を削除するジョブの名前に置換します。 ``` // Import the required AWS SDK clients and commands for Node.js import { DeleteMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // For example, 'medical_transciption_demo' }; export const run = async () => { try { const data = await transcribeClient.send( new DeleteMedicalTranscriptionJobCommand(params), ); console.log("Success - deleted"); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` この例を実行するには、コマンドプロンプトで以下を入力します。 ``` node transcribe-delete-medical-job.js ``` このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_delete_medical_job.js)にあります。