動的取り込みの通知

Dynamic Ingest API 通知

取り込みプロセスの結果に関する通知を受け取るコールバック URL を 1 つ以上指定できます。指定する URL は、POST リクエストを受け付けることができるアプリ用のものである必要があります。通知は JSON 形式で送信されます。

セットアップ

ここに例があります。

パブ ID 57838016001 のユーザー
ダイナミックインジェストを使用して https://s3.amazonaws.com/bucket/mysourcevideo.mp4 にあるソースビデオファイルをアップロードしたい
動画 ID 5199670523001 のカタログに既存のタイトルをアップロードしたい
マルチプラットフォーム標準静的プロファイルの使用
http://host1/path1 と http://host2/path2 にある 2 つのエンドポイントでコールバックを受信したい

DI 要求は次のようになります。

POSTリクエスト

https://ingest.api.brightcove.com/v1/accounts/57838016001/videos/5199670523001/ingest-requests

リクエスト本文

    {
      "master": {
        "url": "https://s3.amazonaws.com/bucket/mysourcevideo.mp4"
      },
      "profile": "multi-platform-standard-static",
      "callbacks": ["http://host1/path1”, “http://host2/path2”]
    }

通知の例

通知はPOSTリクエストとして送信され、リクエスト本文の通知はJSONとして送信されます ^[1]。一般的なビデオ取り込みジョブからの通知の完全なセットは次のとおりです。

{
      "entity": "default\/audio192",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/audio192",
      "language": "en",
      "variant": "main",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/audio64",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/audio64",
      "language": "en",
      "variant": "main",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/audio96",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/audio96",
      "language": "en",
      "variant": "main",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/audio128",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/audio128",
      "language": "en",
      "variant": "main",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "5660367449001",
      "entityType": "DIGITAL_MASTER",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video450",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video450",
      "bitrate": 451,
      "width": 480,
      "height": 270,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "5660367449001",
      "entityType": "TITLE",
      "version": "1",
      "action": "PUBLISH",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "thumbnail",
      "entityType": "ASSET",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "poster",
      "entityType": "ASSET",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video900",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video900",
      "bitrate": 901,
      "width": 640,
      "height": 360,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video700",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video700",
      "bitrate": 700,
      "width": 640,
      "height": 360,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video1200",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video1200",
      "bitrate": 1204,
      "width": 960,
      "height": 540,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video1700",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video1700",
      "bitrate": 1703,
      "width": 960,
      "height": 540,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video3500",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video3500",
      "bitrate": 3498,
      "width": 1920,
      "height": 1080,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video2000",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video2000",
      "bitrate": 2000,
      "width": 1280,
      "height": 720,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video3800",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video3800",
      "bitrate": 3804,
      "width": 1920,
      "height": 1080,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "5660367449001",
      "entityType": "TITLE",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

通知フィールド

項目	説明
`status`	は`FAILED`、`SUCCESS`レンディションの取り込みまたは作成が成功しなかった場合、リクエストが成功した場合になります
`accountId`	アカウント ID
`videoId`	動画ID
`jobId`	動的取り込み要求のジョブ ID
`entity`	エンティティの名前、または TITLE の動画の Video Cloud ID
`entityType`	報告された資産の種類-例:タイトル（ビデオ）、DIGITAL_MASTER、アセット（レンディション、キャプションファイル、またはイメージ）
`bitrate`	レンディションのビットレート
`width`	レンディションのフレーム幅
`height`	レンディションのフレーム高さ
`errorMessage`	インジェストが失敗した場合に失敗した理由の説明
`version`	文字列は常に`"1"`
`action`	発生したアクション (CREATE など)

通知の解釈

を含む通知"action": "CREATE"そして"status": "SUCCESS"プロセスの完了を示します。

entityTypeがの場合TITLE、取り込まれたビデオの処理が完了します。
ではentityType: TITLE、action: PUBLISHビデオがアクティブ化される時間を示します。すぐにアクティブな動画の場合、これは時間とほぼ同じ時間になります。CREATE
の場合entityTypeですASSET、DYNAMIC_RENDITIONまたはDIGITAL_MASTER、次に、レンディション、画像、マニフェスト、WebVTTファイル、またはデジタルマスターがビデオに正常に追加されました。

注：a "status": "SUCCESS"に題名処理が完了したことを示しますが、必ずしもすべてのレンディションが正常に作成されたことを意味するわけではありません。ビデオの動的取り込みが成功したかどうかを判断するには、を参照してください。動的取り込みリクエストのステータスを取得する。

ファイアウォール

組織がファイアウォールを通過する着信トラフィックのソースに関して厳格なポリシーを持っている場合、AWS us-east-1 / VirginiaIPを許可します。これは変更される可能性があるため、すべての AWS IP をホワイトリストに登録する必要があります。見るhttp://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html詳細については。

ページコンテンツ

動的取り込みの通知

Dynamic Ingest API 通知

セットアップ

POSTリクエスト

リクエスト本文

通知の例

通知フィールド

通知の解釈

ファイアウォール