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

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

    このクイックスタートでは、を使用してVideoCloudにビデオを追加する手順を説明します。Dynamic Ingest API CURL経由。

    はじめに

    Dynamic Ingest APIを使用していくつかのことを行うことができますが、その主な機能はVideoCloudにビデオを追加することです。このクイックスタートは、APIを使用して最初のビデオを取り込む方法を説明する簡単なチュートリアルを提供します。

    このチュートリアルでは、CURLと呼ばれる一般的なコマンドラインツールを使用してHTTPリクエストを作成します。CURLに慣れていない場合は、を参照してください。 CURLを設定する。CURLはデフォルトでインストールされ、MacおよびLinuxシステムであることに注意してください。Windowsでは、インストールする必要があります。手順は、CURLのセットアップガイドに記載されています。

    ステップ

    クライアント認証情報を取得する

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

    1. API資格情報の管理スタジオのセクション。

    2. クリック新規申請の登録
    3. 適切なアカウントを選択し、少なくともこれらの権限:

      • 動的取り込み作成
      • 取り込みプロファイル構成の読み取り
      • 摂取プロファイルを読む
    4. をコピーして保存しますクライアントIDそしてクライアントシークレット作成されます(ダイアログを閉じた後、クライアントシークレットを再度取得する方法はありません!)。

    OAuthトークンを取得する

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

    1. 以下のコードをテキストエディタにコピーして、置き換えますCLIENT_IDそしてCLIENT_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リクエストで新しいものが必要な場合は、UNAUTHORIZEDエラー。

    ビデオを作成する

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

    1. 次のコードをテキストエディタにコピーして置き換えますACCOUNT_ID独自のVideoCloudアカウント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以下の取り込みリクエストで、ビデオソースファイルを関連付けるビデオをVideoCloudに通知します。

    取り込みリクエスト

    動的取り込みを呼び出すと、取り込むファイルの場所がわかります。

    1. 次のコードをテキストエディタにコピーして置き換えますACCOUNT_ID独自のVideoCloudアカウント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 LearningServicesによって提供されていることに注意してください。これらを、独自のビデオやコールバックアプリへのパスに置き換えることができます。取り込みジョブに関する通知を受け取る必要がない場合は、省略できます。callbacksフィールド。

      コールバックアプリを使用する場合は、通知を表示する。このアプリは他のいくつかのアプリによるコールバックに使用されるため、ジョブIDを使用してジョブに関連付けられているアプリを検索します。

    2. 次のような応答が返されます。
          {"id":"bcc3dd36-50de-4343-b42a-ad02bd8f0241"}
    3. このジョブに関連付けられた通知を識別するのに役立つため、またはサポートに連絡する必要がある場合は、ジョブIDを保存する必要があります。

    上記の手順を正常に完了した場合は、Dynamic IngestAPIを使用してアカウントに動画を取り込みました。ご不明な点やご質問がございましたら、お気軽にお問い合わせくださいBrightcove ブ学習サービス助けを求めて。

    APIを幅広く使用する場合は、CURL以外のテストツールを試すことをお勧めします。