サポートに連絡する| システムステータス
ページコンテンツ

バックロット/ビデオクラウドCMSコネクタ

Backlot CMS APIアダプタは、Video Cloud API への移行中にインテグレーションとアプリを動作させるのに役立つように、 Backlot APIオペレーションの選択セットをサポートします。Video Cloud プラットフォーム API の詳細については、「Brightcove API の使用を開始する」を参照してください。

要件

広告セットのエンドポイント

Video Cloud にはという概念はありませんがad_set、動画に関連付けられている広告セットデータはに移行されcue_pointsad_set_idは、広告セットに関連付けられている動画を識別できるように、その名前のカスタムフィールドに格納されます。

「Video Cloud への移行」を参照してください。広告セットデータをさまざまな広告ソースのキューポイントにマッピングする方法については、「広告セット」を参照してください。

次の表に、サポートされているBacklot API ad_setsオペレーションを示します。

ad_sets エンドポイント
バックロット API エンドポイント 方法 サポートされている 備考
v2/ad_sets GET Yes
  • Video Cloud には広告セットの概念がありません。各広告セットに関連付けられている情報の一部は、広告セットが関連付けられた動画のキューポイントデータとして移行されます。詳細については、「広告セット」を参照してください。
POST No
  • Video Cloud には広告セットの概念がないため、広告セットを作成しようとすると失敗します
v2/ad_sets/{set_id} GET Yes
  • Video Cloud には広告セットの概念がありません。各広告セットに関連付けられている情報の一部は、広告セットが関連付けられた動画のキューポイントデータとして移行されます。詳細については、「広告セット」を参照してください。
PATCH Yes
  • このリクエストは、関連する動画のキューポイントデータを更新します
DELETE Yes
  • このリクエストは、関連する動画のキューポイントデータを削除します
v2/ad_sets/{set_id}ads POST Yes
  • 関連動画にキューポイントを追加します
DELETE Yes
  • 関連動画からキューポイントを削除します。

資産エンドポイント

次の表に、サポートされているBacklot API assetオペレーションを示します。

SQL ステートメントを使用してアセットオペレーションのフィルタリングを提供する Query APIは、一部しかサポートされていないことに注意してください。whereorderbyおよびクエリはサポートされていません。limitクエリはうまくいくはずです。

資産エンドポイント
バックロット API エンドポイント 方法 サポートされている 備考
/v2/assets GET Yes
  • ad type videos はタグ付きのビデオクラウドで通常の動画になりますooyala_my_ads
  • youtubeタイプビデオは Video Cloud に移行されません
  • external_idは Video Cloud に移行されていますが、Playback API で使用できる読み取り専用フィールドになります(ビデオクラウドコンテンツを配信する Ooyala プレーヤー用)
  • 定期的な時間制限と IP 制限が Video Cloud に移行されない
POST Yes
  • 詳細については、Backlot API を使用した取り込みを参照してください。
  • Video Cloud の取り込みでは、5 MB 以上(最後のチャンクを除く)である必要があります。を低く設定するとエラーが返されます。chunk_sizechunk_size
  • Video Cloud youtubeではタイプビデオはサポートされていないため、これらのタイプのビデオを作成しようとすると、エラーが返されます。adタイプビデオは、タグを持つ通常の動画として作成できますooyala_my_ads
  • youtubeタイプビデオは Video Cloud に移行されません
/v2/assets/{asset_id} GET Yes
  • ad type videos はタグ付きのビデオクラウドで通常の動画になりますooyala_my_ads
  • youtubeタイプビデオは Video Cloud に移行されません
POST No
  • プロパティを更新するだけPATCH
PATCH Yes
DELETE Yes 動画が再生リストに属している場合、Video Cloud では削除できないことに注意してください
/v2/assets/{asset_id}/ad_set GET Yes
/v2/assets/{asset_id}/closed_captions GET Yes
  • このリクエストは、キャプションコンテンツに設定された場所を持つ HTTP 302 応答を返します。Video Cloud は、DFXP ではなく HTML5 のキャプションの標準形式である WebVTT を返すことに注意してください。
PUT Yes
  • 既存のWebVTTテキストトラックを置き換えます。WebVTTまたはDFXPキャプションをアップロードできることに注意してください-DFXPはWebVTTに変換されます

    注:Video Cloud に移行された DFXP キャプションは WebVTT テキストトラックに変換されます。これは Brightcove Player で使用されています。データの移行に関する重要な注意事項は 2 つあります。

    • 複数の言語のキャプションがDFXPに格納されている場合、それは分割され、異なる言語の複数のWebVTTテキストトラックに変換されます。英語のテキストトラックがデフォルトとして設定されます。デフォルトの言語はで変更できますスタジオ必要に応じて。
    • テキストトラックには言語識別子が必要なため、DFXP ファイルに言語識別子が含まれていない場合、変換された WebVTT enキャプションに割り当てられます。これが正しい言語でない場合は、クローズドキャプションメニューに正しい言語が表示されるように、 Studioでテキストトラックのプロパティを編集して修正する必要があります。
DELETE Yes  
/v2/assets/{asset_id}/drm_attributes/{drm_type} GET No
  • Video Cloud の DRM は、drm_disabledフィールドにパッケージ化されないようにフラグが設定されていない限り、DRM 対応アカウントのすべてのビデオに適用されます。
PATCH No
  • Video Cloud の DRM は、drm_disabledフィールドにパッケージ化されないようにフラグが設定されていない限り、DRM 対応アカウントのすべてのビデオに適用されます。
/v2/assets/{asset_id}/generated_preview_images GET No
  • Video Cloud に複数のサムネイル画像を保存しない
/v2/assets/{asset_id}/labels GET Yes
  • labelsすべてがに移行されるためtags、このリクエストはビデオタグを返します。
POST Yes
  • labelsすべてがに移行されるためtags、このリクエストはビデオタグを追加します。Video Cloud でのラベルの直接更新はサポートされていないことに注意してください。
/v2/assets/{asset_id}/labels/{label_id} PUT Yes
  • これにより、Video Cloud のラベル (a tag ) が置き換えられます。Video Cloud でのラベルの直接更新はサポートされていないことに注意してください。
DELETE Yes
  • これにより、Video Cloud のラベル (a tag ) が削除されます。Video Cloud でのラベルの直接更新はサポートされていないことに注意してください。
/v2/assets/{asset_id}/metadata GET Yes
  • metadatatagsアイテムはフォーム内でに移行されますmeta:;:{key}:;:{value}。各タグの長さは、シングルバイト文字が 128 文字に制限されています。
PUT Yes
  • metadatatagsアイテムはフォームに移行されますmeta:;:{key}:;:{value} -これリクエストは、その形式のタグを追加または置換します。各タグの長さは、シングルバイト文字が 128 文字に制限されています。
PATCH Yes
  • metadatatagsアイテムはフォームに移行されますmeta:;:{key}:;:{value} -これリクエストはその形式でタグを変更します
DELETE Yes
  • metadatatagsアイテムはフォームに移行されますmeta:;:{key}:;:{value} -これリクエストはその形式のすべてのタグを削除します
/v2/assets/{asset_id}/movie_urls GET Yes
  • movie_urlssourcesビデオクラウドにいる
POST Yes
  • Video Cloud でも同じように動作します-このリクエストはビデオにリモートrendition(したがってsource)を追加します
/v2/assets/{asset_id}/movie_urls/{type} DELETE Yes
  • このリクエストは、指定されたタイプのリモートレンディションのみを削除します。
/v2/assets/{asset_id}/player GET Yes
  • Video Cloud はプレーヤーをビデオに関連付けないため、このリクエストはデフォルトの Ooyala プレーヤーコンストラクトを返します。代わりに、ビデオによって任意の動画を任意のプレーヤーインスタンスに関連付けることができますid。ビデオクラウドプレーヤーは、プレーヤー管理 API 経由で入手できます。
/v2/assets/{asset_id}/player/{player_id} GET No
  • Video Cloud は、プレーヤーをビデオに関連付けることはありません。代わりに、ビデオによって、任意の動画を任意のプレーヤーインスタンスに関連付けることができますid。ビデオクラウドプレーヤーは、プレーヤー管理 API 経由で入手できます。
/v2/assets/{asset_id}/preview_image_urls GET Yes
  • Video Cloud は複数のサムネイル画像を保存しないため、posterこのリクエストは画像を返します
POST Yes
  • Video Cloud は複数のサムネイル画像を保存しないため、posterこのリクエストはリストの最初の画像を使用して画像を設定します。
PUT Yes
  • Video Cloud は複数のサムネイル画像を保存しないため、posterこのリクエストはリストの最初の画像を使用して画像を設定します。
DELETE No
  • Video Cloud は単一のポスター画像のみを保存し、置き換えることはできますが、削除することはできません。
/v2/assets/{asset_id}/preview_image_files/{image_id} DELETE No
  • Video Cloud は単一のポスター画像のみを保存し、置き換えることはできますが、削除することはできません。
/v2/assets/{asset_id}/preview_image_files GET Yes
  • Video Cloud は複数のサムネイル画像を保存しないため、posterこのリクエストは画像の URL を返します
POST Yes
  • Video Cloud は複数のサムネイル画像を保存しないため、このリクエストでは、リスト内の最初の画像 URL をリモートアセットとして使用して画像を設定します。poster
PUT Yes
  • Video Cloud は複数のサムネイル画像を保存しないため、このリクエストでは、リスト内のリスト URL の最初の画像をリモートアセットとして設定します。poster
DELETE No
  • Video Cloud は単一のポスター画像のみを保存し、置き換えることはできますが、削除することはできません。
/v2/assets/{asset_id}/primary_preview_image GET No
  • Video Cloud は単一のポスター画像しか保存しないため、このリクエストではそれを返します。
/v2/assets/{asset_id}/primary_preview_image PUT No
  • Video Cloud は単一のポスター画像しか保存しないため、このリクエストはポスターを置き換えます
/v2/assets/{asset_id}/publishing_rule GET Yes
  • Video Cloud が動画ではなくプレーヤーに他の再生制限を設定するため、地理制限とスケジューリングのみが返されます
/v2/assets/{asset_id}/publishing_rule/{rule_id} PUT Yes
  • Video Cloud には、公開ルールの概念はありません。ビデオの地情報制限とスケジューリングプロパティのみを更新できます。公開ルール ID は、名前のカスタムフィールドに格納されます。publishing_rule_id
/v2/assets/{asset_id}/source_file_info GET No  
/v2/assets/{asset_id}/streams GET Yes
  • ビデオクラウドを返すsources
/v2/assets/{asset_id}/uploading_urls GET Yes
/v2/assets/{asset_id}/upload_status PUT Yes
/v2/assets/{asset_id}/youtube GET No
  • Video Cloud ではサポートされていません- Brightcove Social for Video Cloud の代替案を参照してください
PUT No
  • Video Cloud ではサポートされていません- Brightcove Social for Video Cloud の代替案を参照してください
PATCH No
  • Video Cloud ではサポートされていません- Brightcove Social for Video Cloud の代替案を参照してください
/v2/assets/{asset_id}/lineup GET No  
PUT No  
/v2/assets/lineup/{asset_id} PUT No  
DELETE No  
/v2/assets/{asset_id}/closed_captions GET Yes
  • text_trackビデオのデフォルトを返します。text_track移行した動画には1つしかありません。Video Cloud で追加できます。テキストトラックをさらに追加する場合は、このリクエストで返されるようにデフォルトトラックを設定します。

    注:Video Cloud に移行された DFXP キャプションは WebVTT テキストトラックに変換されます。これは Brightcove Player で使用されています。データの移行に関する重要な注意事項は 2 つあります。

    • DFXP に複数の言語キャプションが格納されている場合、WebVTT では 1 つのファイルで複数の言語キャプションがサポートされていないため、英語のキャプションだけがWebVTT テキストトラックに格納されます。追加の言語でキャプションを作成する場合は、それらを個々の DFXP ファイルに分割し、Studio を使用して取り込む必要があります。
    • テキストトラックには言語識別子が必要なため、DFXP ファイルに言語識別子が含まれていない場合、変換された WebVTT enキャプションに割り当てられます。これが正しい言語でない場合は、クローズドキャプションメニューに正しい言語が表示されるように、 Studioでテキストトラックのプロパティを編集して修正する必要があります。
PUT Yes
  • text_trackビデオのデフォルトを置き換えます。取り込んだキャプションは WebVTT または DFXP 形式にすることができます。DFXP は WebVTT に変換されます。
DELETE Yes
  • text_track動画のデフォルトを削除する予定

DRMポリシー

DRM ポリシーエンドポイントはサポートされていません。

アセットエンドポイントの削除

削除済みアセットエンドポイントはサポートされていません。

端点にラベルを付けます

ラベルは Video Cloud tagsにとして移行されます。ラベルとは異なり、タグは個々の動画に設定されます。アカウントレベルの「タグセット」はなく、タグは階層化されません。ラベル階層は、次のように Video Cloud タグに保存されます。

Labels to Tags
ラベルをタグに

これらの違いとは別に、タグはラベルを使用する多くの方法で使用できます。たとえば、次のようになります。

次の表に、サポートされているBacklot API labelsエンドポイントを示します。

Backlot API ラベルのエンドポイント
バックロット API エンドポイント 方法 サポートされている 備考
/v2/labels GET Yes tagsラベルはビデオクラウドのように表示されます
/v2/labels POST Yes tagsラベルはビデオクラウドのように表示されます
/v2/labels/by_full_path/{paths} GET Yes tagsラベルはビデオクラウドのように表示されます
/v2/labels/by_full_path/{paths} POST Yes tagsラベルはビデオクラウドのように表示されます
/v2/labels/{label_id} GET Yes tagsラベルはビデオクラウドのように表示されます
/v2/labels/{label_id} PATCH Yes tagsラベルはビデオクラウドのように表示されます
/v2/labels/{label_id} DELETE Yes ラベルは Video Cloud tagsのように表示されます。プレイリストによって参照されているラベルは削除されないことに注意してください。
/v2/labels/{label_id}/children GET Yes tagsラベルはビデオクラウドのように表示されます
/v2/labels/{label_id}/assets GET Yes tagsラベルはビデオクラウドのように表示されます

パッケージエンドポイント

パッケージエンドポイントはサポートされていません。

プレイヤーのエンドポイント

次の表に、サポートされているBacklot API playersオペレーションを示します。

Backlot API プレーヤーエンドポイント
バックロット API エンドポイント 方法 サポートされている 備考
/v2/players GET Yes  
POST No  
/v2/players/{player_id} GET No  
PATCH No  
DELETE No  
/v2/players/{player_id}/metadata GET No  
PATCH No  
PUT No  
DELETE No  
/v2/players/{player_id}/scrubber_image PUT No  
/v2/players/{player_id}/watermark PUT No  
/v2/players/{player_id}/third_party_modules/{module_id} GET No  
PUT No  
PATCH No  
DELETE No  

プレイリストのエンドポイント

次の表に、サポートされているBacklot API playlistsオペレーションを示します。Ooyala と Video Cloud プレイリストの違いについては、プレイリストのフィールドも参照してください

バックロット API プレイリストエンドポイント
バックロット API エンドポイント 方法 サポートされている 備考
/v2/playlists GET Yes  
POST Yes  
/v2/playlists/{playlist_id} GET Yes  
PUT Yes  
PATCH Yes  
DELETE Yes  

プロファイルの処理エンドポイント

下の表は何を示していますバックロットAPIplaylists操作はいいえサポートされています。こちらもご覧くださいプロファイルAPIの取り込み取り込みプロファイルの管理 Video Cloudの取り込みプロファイルがどのように機能するかをよりよく理解するために、アカウントはDynamic Deliveryアカウントであるため、従来の取り込みシステムに関するドキュメントに注意を払う必要はありません。

プロバイダーレベルの DRM ポリシーのエンドポイント

プロバイダーレベルの DRM ポリシーエンドポイントはサポートされていません。

プロバイダーのエンドポイント

プロバイダのエンドポイントはサポートされていません。

ルールのエンドポイントの公開

公開ルールによって実装された再生制限は、Video Cloud の個々のアセットに適用されます。ドメイン制限は移行されません。Video Cloud では、これらは動画ではなくプレーヤーに設定されているためです。

動画アセットについて
  • 地理的制限
  • スケジューリング (開始日と終了日)

Ooyala パブリッシングルールの地理的制限とスケジュールに関連するプロパティは、公開ルールに関連付けられたビデオに適用され、idその名前のカスタムフィールドに格納されます。publishing_rule_idBacklot API公開ルール操作は、公開ルールに関連付けられているすべての動画で機能しますが、スケジュール設定または地理的制限のみが返されます。

Backlot API 処理プロファイルエンドポイント
バックロット API エンドポイント 方法 サポートされている 備考
/v2/processing_profiles GET Yes  
/v2/processing_profiles/{profile_id} GET Yes  

リセラーエンドポイント

リセラーエンドポイントはサポートされていません。

統計エンドポイント

統計エンドポイントはサポートされていません。

シンジケーションのエンドポイント

シンジケーションエンドポイントはサポートされていません。ただし、ブライトコーブグローバルサービスでは、Ooyala サービスに合わせてシンジケーションサービスを構築できます。詳細については、アカウントマネージャーにお問い合わせください。

サードパーティモジュールのエンドポイント

統計エンドポイントはサポートされていません。


ページの最終更新日05 Oct 2021