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

    概要:Ingest Profiles API

    このトピックでは、Ingest ProfilesAPIの概要を説明します。Ingest Profiles API を使用すると、Video Cloud アカウントのレンディションプロファイルの作成、取得、更新、削除を行うことができます。

    取り込みプロファイルの管理

    インジェストプロファイルは、動画をアップロードまたは再トランスコードするときに、トランスコーディングの仕様として使用されます。これらのプロファイルは、Ingest Profiles API を使用して管理できます。

    用語集

    プロファイルJSON

    以下の「プロファイル JSON」という用語は、プロファイルオブジェクトの JSON 表現を意味します。リストには、最上位のプロファイルフィールドとレンディションオブジェクトのコレクションが含まれます。すべてのアカウントに含まれる標準プロファイルの JSON については「標準プロファイル」、DRM パッケージを含むサンプルプロファイルについては「コンテンツセキュリティ (DRM および HLSE) 」を参照してください。

    プロフィール ID

    profile idは、idnameプロファイル内のトップレベルフィールドまたはトップレベルフィールドのいずれかになります。この例では(プロファイルの断片):

        {
            "id": "5591b5ede4b0f7138939ad8c",
            "version": 4,
            "name": "screencast-1280",
            "description": "A high resolution profile optimized for screencasts with 1280 x 720 resolution.", ...

    「screencast-1280」または「5591b5ede4b0f7138939ad8c」はどちらも有効なプロファイルIDです。プロファイルを初めて作成するときは、ID を含まない名前を持つプロファイルを指定します。応答には、ID を含む作成されたプロファイルが含まれます。その後、後続の API 呼び出しでどちらを使用することもできます。

    参照ID

    は、reference_idプロファイル内のレンディションを一意に識別します。参照 ID は DRM パッケージングに使用され、将来的には他の目的に使用される可能性があります。プロファイル内で一意である以外に、参照 ID には任意の文字列を指定できます。スペースを含めることはできません。レンディションの形式を簡単に識別できるスキームを使用することをお勧めします。たとえばmp4_1mp4_2hls1hls2など

    プロファイルのバージョン

    A versionは、アカウントのプロファイルのリビジョン番号です。これは、長い整数値で表されます。注:JSON表現では引用符で囲まれていません。

    アクティブなプロファイル

    プロファイルは、activeアップロードに使用できるかどうかです。たとえば、プロファイルを更新すると、アクティブなバージョン番号が増分された新しいプロファイルが取得され、古いバージョンは非アクティブになります。

    標準プロファイル

    プロファイルとは、standardBrightcoveが使用するために提供されている場合です(つまり、単一のアカウントに固有のカスタムプロファイルではありません)。

    既定のプロファイル

    プロファイルとはdefault、プロファイルが明示的に選択されていないときに使用される場合です。アカウント設定がない場合、または設定でデフォルトのプロファイルを設定していない場合は、アカウントタイプに応じて Brightcove standardプロファイルの 1 つが使用されます。

    ベース URL

    サービス URL は次のとおりです。

        https://ingestion.api.brightcove.com/v1/

    認証

    API の認証は、Brightcoveの OAuth2 実装を介して行われます。アカウントで次の操作を行うアクセス許可を持つクライアント資格情報 (クライアント ID とクライアントシークレット) が必要です。

    • video-cloud/ingest-profiles/profile/read
    • video-cloud/ingest-profiles/profile/write
    • video-cloud/ingest-profiles/account/read
    • video-cloud/ingest-profiles/account/write

    client_idとを取得するにはclient_secret、OAuth UI に移動してアプリを登録する必要があります。

    また、CURL または Postman 経由で資格を取得することもできます。以下を参照してください。

    クライアントの認証情報を使用して、API を呼び出すためのアクセストークンを取得します。アクセストークンは Authorization ヘッダーで渡されます。

        Authorization: Bearer {your_access_token}

    詳細については、 Oauth セクションを参照してください

    最大レンディション

    取り込みプロファイルで定義できるレンディションの最大数は25です。それ以上の数を定義すると、リクエストはエラー409応答を返します:プロファイルレンディションカウントが設定されたレンディション制限を超えています。

    条件付き出力

    取り込むビデオの品質が大きく異なる場合(たとえば、ビデオに低品質のカメラを搭載した電話で作成されたユーザー生成コンテンツが含まれている場合)、ビットレートまたはその他のプロパティを条件として、一部のレンディションの生成を行うことができます。ソースビデオ。これにより、冗長なレンディションの作成と保存が防止されます。見る条件付き出力これを行う方法の詳細については。

    アカウント操作

    アカウントレベルでは、アカウントのすべてのプロファイルを取得し、新しいプロファイルを作成できます。

    終点

        /accounts/{account_id}/profiles

    すべてのプロファイルを取得

    アカウントのすべてのプロファイル(標準プロファイルを含む)を取得するには、上記のエンドポイントに GET リクエストを送信します。

    プロファイルの作成

    新しいプロファイルを作成するには、上記のエンドポイントに POST リクエストを送信します。これには、プロファイルの JSON データをリクエスト本文に含めます。を参照してくださいサンプルプロファイル以下のJSONデータの例、およびプロファイルフィールドリファレンス許容フィールド用。

    単一プロファイル操作

    個々のプロファイルについては、名前または ID でプロファイルを取得したり、プロファイルを置き換えたり、プロファイルを削除したりできます。

    終点

        /accounts/{account_id}/profiles/{profile_id}

    ではprofile_id、次のいずれかを使用できます。

    • 名前(バランス高精細など)
    • 生成されたID(例:54de14cce4b0a6d2bf9cb08a)

    IDでプロファイルを取得する

    単一のプロファイルを取得するには、上記のエンドポイントに GET リクエストを行います。

    プロファイルを更新する

    プロファイルを更新するには、上記のエンドポイントにPUTリクエストを送信します。 完了 リクエスト本文のプロファイルのJSONデータ。

    プロファイルを削除する

    プロファイルを削除するには、上記のエンドポイントに DELETE リクエストを行います。

    このアクションは元に戻せません

    デフォルトのプロファイル操作

    エンドポイントを使用して、アカウントのデフォルトのビデオオンデマンドおよびライブビデオプロファイルを取得、設定、または更新できます。

        /accounts/{account_id}/configuration

    デフォルトのプロファイルを取得する

    上記のエンドポイントに GET リクエストを実行して、アカウントのデフォルトプロファイルを取得します。

    デフォルトプロファイルが設定されていない場合は、システムのデフォルトプロファイルが返されます。

    デフォルトプロファイルの設定

    デフォルトのプロファイルを設定するには、リクエスト本文に JSON を含めて、上記のエンドポイントに POST リクエストを実行します。

        {
          "account_id": {account_id},
          "default_profile_id": {default_profile_id}
        }

    ではdefault_profile_id、次のいずれかを使用できます。

    • 名前(バランス高精細など)
    • 生成されたID(例:54de14cce4b0a6d2bf9cb08a)

    既定のプロファイルを更新する

    デフォルトのプロファイルを更新するには、リクエスト本文に次の JSON を含めて、上記のエンドポイントに PUT リクエストを実行します。

        {
          "id": {configuration_id},
          "account_id": {account_id},
          "default_profile_id": {default_profile_id}
        }

    GET または POST configuration_id要求への応答からを取得します。

    デフォルトのライブプロファイルの設定

    デフォルトのライブプロファイルの設定は、デフォルトのビデオオンデマンドプロファイルの設定とまったく同じです。ただし、リクエスト本文でのこの変更を除きます。

        {
          "id": {configuration_id},
          "account_id": {account_id},
          "default_live_profile_id": {default_live_profile_id}
        }

    注意:

    • 存在しないプロファイルを指定すると、要求は失敗します

    サンプルプロファイル

    標準プロファイルドキュメントには、すべての Video Cloud アカウントに現在存在するすべてのデフォルトプロファイルが表示されます。

    透かし

    ビデオに透かし(またはロゴ画像)を追加する場合は、取り込みプロファイルの透かしフィールドを使用できます。

    透かしのあるレンディションプロファイルの例を次に示します。

        ...
        "renditions": [
            {
              "media_type": "video",
              "id": "559697ece4b072e9641b8404",
              "reference_id": "mp0",
              "format": "mp4",
              "audio_codec": "aac",
              "audio_bitrate": 64,
              "video_codec": "h264",
              "speed": 3,
              "video_bitrate": 450,
              "decoder_bitrate_cap": 771,
              "decoder_buffer_size": 1028,
              "keyframe_rate": 0.5,
              "max_frame_rate": 30,
              "width": 480,
              "height": 270,
              "h264_profile": "baseline",
              "watermarks": [
                {
                  "y": "70%",
                  "width": "20%",
                  "url": "http://learning-services-media.brightcove.com/images/bc_logo.png"
                }
              ]
          }, ...

    フィールドの完全な説明については、<ahref = "https://zencoder.support.brightcove.com/encoding-settings/assets/encoding-settings-watermarks.html>透かしフィールドリファレンス</a>を参照してください。</ p> </ section> </ article>


    ページの最終更新日22 Sep 2021