CallAnalyticsJob

コール分析ジョブに関する詳細情報を提供します。

ジョブのステータスを表示するには、を参照してくださいCallAnalyticsJobStatus。ステータスが COMPLETED の場合、ジョブは終了しました。完成したトランスクリプトは、で指定された URI で確認できますTranscriptFileUri。ステータスがの場合FAILED、FailureReason文字起こしジョブが失敗した理由の詳細が表示されます。

個人情報 (PII) の編集を有効にすると、編集された文字起こしが、で指定した場所に表示されますRedactedTranscriptFileUri。

メディアファイル内のオーディオを編集することを選択した場合、RedactedMediaFileUri編集されたメディアファイルは回答欄で指定された場所にあります。

目次

CallAnalyticsJobName

コール分析ジョブの名前。Job 名は大文字と小文字が区別され、内で一意である必要がありますAWS アカウント。

タイプ: 文字列

長さの制限: 最小長は 1 です。最大長は 200 です。

Pattern: ^[0-9a-zA-Z._-]+

必須: いいえ

CallAnalyticsJobStatus

指定されたコール分析ジョブのステータスを提供します。

ステータスがの場合COMPLETED、ジョブは終了し、で指定した場所で結果を確認できますTranscriptFileUri (またはRedactedTranscriptFileUri、文字起こしをリクエストした場合)。ステータスがの場合FAILED、FailureReason文字起こしジョブが失敗した理由の詳細が表示されます。

タイプ: 文字列

有効な値: QUEUED | IN_PROGRESS | FAILED | COMPLETED

必須: いいえ

ChannelDefinitions

どのスピーカーがどのチャンネルにあるかを示します。

型: ChannelDefinition オブジェクトの配列

配列メンバー: 2 項目の定数。

必須: いいえ

CompletionTime

指定されたコール分析ジョブが処理を終了した日付と時刻。

YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTCタイムスタンプは次の形式です。たとえば、2022-05-04T12:33:13.922000-07:00は、2022 年 5 月 4 日午後 12 時 33 分 (UTC) に処理を開始した文字起こしジョブを表します。

型: タイムスタンプ

分位数は、確率分布を等しい確率の領域に分割したものです。

CreationTime

指定した Call Analytics ジョブリクエストが行われた日付と時刻。

YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTCタイムスタンプは次の形式です。たとえば、2022-05-04T12:32:58.761000-07:00は、2022 年 5 月 4 日午後 12 時 32 分 (UTC-7) に処理を開始した文字起こしジョブを表します。

型: タイムスタンプ

分位数は、確率分布を等しい確率の領域に分割したものです。

DataAccessRoleArn

リクエストに含めた Amazon リソースネーム (ARN)。

タイプ: 文字列

長さの制限: 最小長は 20 です。最大長は 2,048 です。

パターン: ^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$

必須: いいえ

FailureReason

CallAnalyticsJobStatusがの場合はFAILED、Call AnalyticsFailureReason ジョブリクエストが失敗した理由に関する情報が含まれます。

FailureReason フィールドは、次のいずれかの値を含みます。

• Unsupported media format.

  MediaFormatで指定されたメディア形式は無効です。MediaFormatサポートされているフォーマットのリストについては、を参照してください。

• The media format provided does not match the detected media format.

  で指定されたメディア形式は、MediaFormat入力ファイルの形式と一致しません。メディアファイルのメディアフォーマットを確認し、指定された値を修正してください。

• Invalid sample rate for audio file.

  MediaSampleRateHertzで指定されたサンプルレートは無効です。サンプルレートは 8,000 から 48,000 ヘルツの間である必要があります。

• The sample rate provided does not match the detected sample rate.

  で指定されたサンプルレートが、MediaSampleRateHertz入力メディアファイルで検出されたサンプルレートと一致しません。メディアファイルのサンプルレートを確認し、指定された値を修正してください。

• Invalid file size: file size too large.

  メディアファイルのサイズは、Amazon Transcribe が処理できるサイズより大きいです。詳細については、「ガイドラインとクォータ」を参照してください。

• Invalid number of channels: number of channels too large.

  音声には、Amazon Transcribe が処理できるよりも多くのチャネルが含まれています。詳細については、「ガイドラインとクォータ」を参照してください。

タイプ: 文字列

必須: いいえ

IdentifiedLanguageScore

メディアファイルで識別された言語に関連する信頼度スコア。

信頼度スコアは 0 から 1 までの値です。値が大きいほど、識別された言語がメディアで話されている言語と正しく一致する可能性が高いことを示します。

タイプ: 浮動小数点

必須: いいえ

LanguageCode

コール分析ジョブの作成に使用する言語コード。サポートされる言語とそれに関連する言語コードのリストについては、「サポートされる言語」の表を参照してください。

メディアファイルで話している言語が分からない場合は、このフィールドを省略すると、Amazon Transcribe がメディアの言語を自動的に識別します。言語識別の精度を上げるために、複数の言語コードを含めると、Amazon Transcribe が文字起こしに最も近い言語コードを選択します。

タイプ: 文字列

有効な値: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

必須: いいえ

Media

コール分析リクエストで使用したメディアファイルの Amazon S3 ロケーションを提供します。

型: Media オブジェクト

必須: いいえ

MediaFormat

入力メディアファイルの形式。

タイプ: 文字列

有効な値: mp3 | mp4 | wav | flac | ogg | amr | webm

必須: いいえ

MediaSampleRateHertz

入力メディアファイル内のオーディオトラックのサンプルレート (単位:ヘルツ)。

型: 整数

有効範囲: 最小値 は 8,000 です。48,000 の最大値。

必須: いいえ

Settings

リクエストに含まれていた追加設定に関する情報を提供します。その他の設定には、コンテンツ編集と言語識別設定が含まれます。

型: CallAnalyticsJobSettings オブジェクト

必須: いいえ

StartTime

指定されたコール分析ジョブが処理を開始した日付と時刻。

YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTCタイムスタンプは次の形式です。たとえば、2022-05-04T12:32:58.789000-07:00は、2022 年 5 月 4 日午後 12 時 32 分 (UTC-7) に処理を開始した文字起こしジョブを表します。

型: タイムスタンプ

分位数は、確率分布を等しい確率の領域に分割したものです。

Transcript

文字起こしへのアクセスに使用できる Amazon S3 URI を提供します。

型: Transcript オブジェクト

必須: いいえ

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWS SDK for Ruby V3