サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    動的取り込みの通知

    このトピックでは、動的取り込み API を使用して送信された動的配信インジェストジョブの通知について説明します。

    動的取り込み 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リクエスト

    リクエスト本文

        {
          "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 FAILEDSUCCESSレンディションの取り込みまたは作成が成功しなかった場合、リクエストが成功した場合になります
    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: TITLEaction: PUBLISHビデオがアクティブ化される時間を示します。すぐにアクティブな動画の場合、これは時間とほぼ同じ時間になります。CREATE
    • の場合entityTypeですASSETDYNAMIC_RENDITIONまたはDIGITAL_MASTER、次に、レンディション、画像、マニフェスト、WebVTTファイル、またはデジタルマスターがビデオに正常に追加されました。