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

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

このトピックでは、 Ingest Profiles API アカウントの取り込みプロファイルとトランスコードプロファイルを管理します。 このチュートリアルではこれらの操作について説明します。

概要

挽き目 Ingest Profiles API あなたがすることができます:

  • あなたのアカウントのプロフィールを取得する

  • 新しいプロファイルを作成する

  • プロフィールを更新する

  • プロファイルを削除する

  • アカウントのデフォルトプロファイルを設定または更新する

安らかなAPI

挽き目 Ingest Profiles API RESTful APIです。 HTTPSリクエストを受け付け、JSONレスポンスを返します。

これは、Ruby、Java、PHP、Python、JavaScript(AJAXまたはnodejs経由)などの任意の言語でAPIを使用できることを意味します。できることは、HTTPS要求を行い、JSON応答を処理することだけです。

ベースURL

そのベースURL Ingest Profiles API 次のとおりです。

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

承認

API呼び出しは、OAuth2アクセストークンを使用して承認されます。 トークンは、リクエストとともに認証ヘッダーに渡されます。

    Authorization: Bearer {access_token}

アクセストークンは有効期間が短い(5分)ため、リクエストを行うたびに取得する必要があります

これらの演習では、 代理 アクセストークンを取得して要求を行います。

練習のためのセットアップ

セットアップ

あなたは2つのオプションがあります。

  • サンプルアカウントで演習を行う(推奨)
  • 自分のアカウントを使用する

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

アカウントのプロフィールを取得する

アカウントのすべてのプロファイルを取得するには、エンドポイントにGETリクエストを行います。

    /accounts/{account_id}/profiles

例:

    https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles

エクササイズ1:すべてのプロファイルを取得する

次のGETリクエストを作成します。

プロファイルの作成

プロファイルの作成

プロファイルを作成するには、エンドポイントにPOST要求を行います。

    /accounts/{account_id}/profiles

例:

    https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles

プロファイルのJSONはリクエスト本体として含まれています。 を参照してください プロファイルフィールドリファレンス プロファイル、レンディション、およびDRMパッケージのフィールド用

エクササイズ2:プロフィールを作成する

次のPOST要求を行います。

(応答は次のスライドに表示されます)

エクササイズ2レスポンス

単一のプロファイルを取得する

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

IDでプロファイルを取得するには、エンドポイントにGET要求を行います。

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

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

  • 名前(例えば、バランスのとれた高精細度)
  • generated id (e.g. 54de14cce4b0a6d2bf9cb08a)

例:

    https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles/screencast
    https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles/54de14cce4b0a6d2bf9cb08a

エクササイズ3:1つのプロファイルを取得

作成したプロファイルを取得するには、次のGETリクエストを行います。

プロファイルの更新

IDでプロフィールを更新する

IDでプロファイルを更新するには、エンドポイントにPUT要求を行います。

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

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

  • 名前(例えば、バランスのとれた高精細度)
  • generated id (e.g. 54de14cce4b0a6d2bf9cb08a)

例:

    https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles/my-test-profile

プロファイルを作成したときと同じように、要求本体にプロファイルデータを含めます。 プロファイルデータ しなければなりません 含める id プロフィールのために!

エクササイズ4:プロフィールを更新

次のPUTリクエストを作成して、作成したプロファイルを更新します(説明が更新されます)。

(応答は次のスライドに表示されます)

エクササイズ4レスポンス

プロファイルの削除

IDでプロファイルを削除する

IDでプロファイルを削除するには、エンドポイントにDELETE要求を行います。

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

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

  • 名前(例えば、バランスのとれた高精細度)
  • generated id (e.g. 54de14cce4b0a6d2bf9cb08a)

例:

    https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles/my-test-profile

エクササイズ5:プロフィールを削除

作成したプロファイルを更新するには、次のDELETE要求を行います(元に戻すことはできません)。

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

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

アカウントのデフォルトプロファイルを取得するには、エンドポイントにGET要求を行います。

    /accounts/account_id/configuration

例:

    https://ingestion.api.brightcove.com/v1/accounts/57838016001/configuration
                        

エクササイズ6:デフォルトプロファイルを取得する

アカウントのデフォルトプロファイルを取得するには、次のGETリクエストを行います。

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

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

アカウントのデフォルトプロファイルを設定するには、エンドポイントにPOST要求を行います。

    /accounts/account_id/configuration

このJSONをリクエスト本体として含める

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

他の操作と同じように、名前またはIDを profile_id.

  • 名前(例えば、バランスのとれた高精細度)
  • generated id (e.g. 54de14cce4b0a6d2bf9cb08a)

例:

    https://ingestion.api.brightcove.com/v1/accounts/57838016001/configuration
                        

エクササイズ7:デフォルトプロファイルを設定する

デフォルトのプロファイルを設定するために、次のPOSTリクエストを行います(アカウントにすでにデフォルトプロファイルがある場合は失敗します - 次の練習ではデフォルトを更新します)。

(応答は次のスライドに表示されます)

エクササイズ7レスポンス

デフォルトプロファイルの更新

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

アカウントのデフォルトプロファイルを更新するには、エンドポイントにPUTリクエストを送信します。

    /accounts/account_id/configuration

このJSONをリクエスト本体として含める

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

デフォルトのプロファイルを取得すると、設定IDが返されます。 デフォルトのプロファイルがない場合は、 デフォルトプロファイルの設定。 他の操作と同じように、名前またはIDを profile_id.

  • 名前(例:高解像度)
  • generated id (e.g. 54de14cce4b0a6d2bf9cb08a)

例:

    https://ingestion.api.brightcove.com/v1/accounts/57838016001/configuration
                        

エクササイズ8:デフォルトプロファイルを更新する

次のPUTリクエストを作成して、アカウントのデフォルトプロファイルを更新します。

(応答は次のスライドに表示されます)

エクササイズ8レスポンス


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