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

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

入門

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

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

ステップ

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

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

にAPI資格情報の管理スタジオのセクション。
クリック新規申請の登録
適切なアカウントを選択し、 少なくとも これらの権限：
- 動的取り込み作成
- 取り込みプロファイル構成の読み取り
- 摂取プロファイルを読む
をコピーして保存しますクライアントIDそしてクライアントシークレット作成されます（ダイアログを閉じた後、クライアントシークレットを再度取得する方法はありません！）。

OAuthトークンを取得する

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

以下のコードをテキストエディタにコピーして、置き換えます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

変更したコードをコピーしてターミナル（またはコマンドラインアプリ）に貼り付け、Returnキーを押して実行します。

応答は次のようになります。

    {
      "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
    }

注意してくださいaccess_token有効期限は5分ですが、コードを再実行して、必要なときにいつでも新しいコードを取得できます。次の手順のAPIリクエストで新しいものが必要な場合は、UNAUTHORIZEDエラー。

ビデオを作ろう

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

次のコードをテキストエディタにコピーして置き換えます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"}'

JSON応答には、ビデオのさまざまなメタデータが含まれますが、私たちの目的では、重要なフィールドが上部にあります。
```
    {
      "id": "123456789001",
      …
    }
```
これを使用しますid以下の取り込みリクエストで、ビデオソースファイルを関連付けるビデオをVideoCloudに通知します。

取り込みリクエスト

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

次のコードをテキストエディタにコピーして置き換えます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を使用してジョブに関連付けられているアプリを検索します。

次のような応答が返されます。

    {"id":"bcc3dd36-50de-4343-b42a-ad02bd8f0241"}

このジョブに関連付けられた通知を識別するのに役立つため、またはサポートに連絡する必要がある場合は、ジョブIDを保存する必要があります。

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

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

ページコンテンツ