サポート サポート問い合わせ先 | システムステータス システムステータス

クイックスタート: Dynamic Ingest API

このクイックスタートでは、 Video Cloud Dynamic Ingest API CURLを介して

概要

あなたはいくつかのことを Dynamic Ingest APIしかし、その主な機能は、 Video Cloud。 このクイックスタートでは、APIを使用して最初の動画を習得するための簡単なチュートリアルを提供しています。

このチュートリアルでは、CURLという一般的なコマンドラインツールを使用してHTTPリクエストを作成します。 CURLに精通していない場合は、 CURLを設定する。 CURLはデフォルトでインストールされ、MacおよびLinuxシステムには注意が必要です。 Windowsでは、それをインストールする必要があります - 指示はCURLの設定ガイドにあります。

ステップ

クライアントの資格情報を取得する

これは、APIリクエストのクライアント認証情報を作成するための1回限りの手順です。 必要なクライアント証明書がすでにある場合は、この手順をスキップできます。

  1. 〜に API クレデンシャルの管理 スタジオのセクション。

  2. ナビゲーションヘッダーの 新しいアプリケーションを登録する
  3. 適切なアカウントを選択し、 少なくとも これらの権限:

    • ダイナミックインジェスト作成
    • 摂取プロファイル設定の読み取り
    • 摂取プロファイル読込
  4. コピーして保存 クライアントIDクライアントシークレット (ダイアログを閉じるとクライアント秘密をもう一度得る方法はありません!)。

OAuthトークンを取得する

挽き目 client_idclient_secret ユーザー名とパスワードとして使用され、トークン(基本認証)を取得します。これは、後続の要求を認証するために使用されます。

  1. 下のコードをテキストエディタにコピーして、 CLIENT_IDCLIENT_SECRET 自分のクライアントの資格情報で
        curl --request POST \
        --url https://oauth.brightcove.com/v4/access_token \
        --user CLIENT_ID:CLIENT_SECRET \
        --header 'content-type: application/x-www-form-urlencoded' \
        --data grant_type=client_credentials

    あなたのコードは次のようになります:

        curl --request POST \
        --url https://oauth.brightcove.com/v4/access_token \
        --user 0072bebf-0616-442c-84de-7215bb176061:7M0vMete8vP_Dmb9o4a16iws4RQR74PO-JNDKkCOyXFkSIe_iRKdHiiNO6vuBWadn5xFw \
        --header 'content-type: application/x-www-form-urlencoded' \
        --data grant_type=client_credentials
  2. 変更したコードをコピーして端末(またはコマンドラインアプリ)に貼り付け、Returnキーを押して実行します。
  3. 応答は次のようになります。
        {
          "access_token":"AMv4uy9puUMrSPtfOUo412Euy8gY1pcjv6RozlH9ALrHyekxY_u-83KWMECgigG9u_gSQoh_gpe8ChAQ1FHclNHgU4h_2qj-8ei19Ve-m4OJ2UOmJwJBZQht_6bIMJMZUZBIvIAGT-8av-uMOpqnnXVJ1qu2rPQeGraIjEkhTnXnGaa-RNUxisRkIoIktN1o9BFzrbLa1xstvPgVhdg78uVg8uDA8X0K9kfibxBfdIkDBzKJAViZZ3gQa56uit2r79GZ_t2KSUgLq1rOPsd0TflHwCAGtSaAHlvb44m-hUKFAOJa-FtXakQ72QcIXha5PhSjYTJZiUa4EbjxXpR6aLvPW4mGQcDzo8bQQ4Hnq8bsa_8l5eUjOm51WI96WhTPJCt4bBWVJKyLM8P7va_Ho6zJc2yOJHDamilRlyOS-DxN4U30m_2AxhHF3DKJO8fWl5srtpbZRPANOq5B6cpAkOiQafoXUv0ntP9nzRwyO-oXVvH4iLDTAArOTXPh-A7OD8QogWu9wb13vO48CvRPsGv9PfT4ZCxzUa3M2NXn8wontkSARzHVNqf6fh-iF6ifalPTw-Z9MhpPd-qwpcHbJfmu5EcJAR3K3QDYttjeRrmEvTBOgbQttapvI2h6rMQqgytiHXpxYgz3Hr1yKe1cuVI8z3haT5pb-FIfOfHKyr7vQ3RDXjdTTJZMYpOhKNjL0oEH2ev_bIGmbGnqUMcuAGhQgMiCVQUKwoLUGHTRG91ZWMCP7CfTEdcVc10jDSELcZ1SBig5_G42ymv1w3KauK6ZwE_Xmu4NrPZiPo-r3u_K08x8Rz8gS1b9mFtcPj6yux058WAW--HIoIQRFGeppiO3S6s1hzkU2jiKMGtTnB8X4MIJXLPq8LHcZO81appEzraHFUG5ewtKRTq5Ck6OFndlSmhT8KIKid806wI5b39eeoe-4c8Os23QuyWIQthG-YdcTSueNoqZ3-5e7HztoYbzNIKvtrdLpwgMAclD9fzs3oCclECAQaaLD3hWENE3n78_TzPt4OvQ4o8L17JTmozZYCq3VDnsp_M9Bb6az8mZfDX5_ALunsE65dv91aXFCjTJigVJ_r28k7kLVct-PVZ1XPSjdAyGoxttMeYpl24737aUZBqPAirHJK-griQlPBh04E0Ay5ip03gJvJxvGuzRE5r8hKD0lVQjfre9huiSjJX-xts4kbY",
          "token_type":"Bearer",
          "expires_in":300
        }
  4. なお、 access_token 5分で失効しますが、コードを再実行して必要なときに新しいコードを取得することができます。 次の手順でAPIリクエストが返された場合は、新しいAPIが必要であることがわかります UNAUTHORIZED エラー。

ビデオを作成する

への呼び出し CMS API ビデオオブジェクトを Video Cloud。 リクエストの本文には次のようなメタデータが規定されています。 namedescription。 唯一の必須フィールドは、 name.

  1. 次のコードをテキストエディタにコピーして置き換えます。 ACCOUNT_ID あなた自身で Video Cloud アカウントID、 ACCESS_TOKEN 前のステップでの要求への応答からのトークンで置き換えます。
        curl --request POST \
        --url https://cms.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/ \
        --header 'authorization: Bearer ACCESS_TOKEN' \
        --header 'content-type: application/json' \
        --data '{"name": "My Video"}'
  2. JSONレスポンスには動画のさまざまなメタデータが含まれますが、私たちの目的のために重要なフィールドは一番上にあります:
        {
          "id": "123456789001",
          …
        }

    あなたはこれを使用します id 下記のインジェストリクエストで、 Video Cloud ビデオソースファイルを関連付けるビデオを知っています。

入金依頼

ダイナミックインジェストを呼び出すと、取り込むファイルの場所がわかります。

  1. 次のコードをテキストエディタにコピーして置き換えます。 ACCOUNT_ID あなた自身で Video Cloud アカウントID、 VIDEO_ID id ビデオを作成したときに返された値、 ACCESS_TOKEN 前のステップでの要求への応答からのトークンで置き換えます。
        curl --request POST \
          --url https://ingest.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/VIDEO_ID/ingest-requests \
          --header 'authorization: Bearer ACCESS_TOKEN' \
          --header 'content-type: application/json' \
          --data '{
            "master": {
              "url": "https://learning-services-media.brightcove.com/videos/mp4/Great_Blue_Heron.mp4"
            },
            "callbacks": ["https://solutions.brightcove.com/bcls/di-api/di-callback-app.php"]
          }'

    ここで紹介する動画とコールバックアプリは、テスト目的でBrightcove Learning Servicesによって提供されていることに注意してください。 これらを独自のビデオやコールバックアプリへのパスに置き換えることができます。 取り込みジョブに関する通知を受け取る必要がない場合は、省略できます callbacks フィールド。

    コールバックアプリを使用している場合は、 通知を表示する。 このアプリは他のいくつかのアプリのコールバックに使用されるので、ジョブIDを使ってあなたの仕事に関連するものを検索します。

  2. あなたは次のような応答を受け取るべきです:
        {"id":"bcc3dd36-50de-4343-b42a-ad02bd8f0241"}
  3. ジョブIDは、このジョブに関連付けられている通知を特定するのに役立ちます。また、サポート担当者に連絡する必要がある場合にも便利です

上記の手順を正常に完了した場合は、 Dynamic Ingest API。 トラブルや質問があった場合は、お気軽にお問い合わせください ブライトコーブ学習サービス 助けて。

APIを使用して広範囲に作業する場合は、CURL以外のテストツールを試すことができます。


ページの最終更新日:12年2020月XNUMX日