オファーステータス API

• 一元管理 — カタログデータを他の流通チャネルとともに自社システムに直接取り込むため、ステータスチェックのたびにSlateにログインする必要はありません
• 問題の迅速な解決 — 利用可能状況の問題を即座に検出し、タイトルの公開を妨げている原因を突き止めることで、解決までの時間を最大3日短縮します
• プロアクティブなカタログ管理 — すべての地域とオファータイプにわたってカタログ全体をプログラム的に監視し、ビジネスの成長に合わせて業務を拡大できます
• リアルタイムのローンチ検証 — ストアフロントを手動で確認したり、ステータスの更新を待ったりすることなく、コンテンツが正常にローンチされたことを即座に知ることができます

このセクションでは、開発者がオファーステータスAPIをシステムに統合するための技術仕様について説明します。このリファレンスは、APIによって返されるリクエストフォーマット、レスポンス構造、およびデータタイプの理解に役立ちます。

オファーステータスAPIは、すべてのクエリパラメータがURLを介して渡される単純なGETリクエスト構造を使用しており、リクエスト本文は必要ありません。これにより、標準のHTTPクライアントまたはコマンドラインツールを使用して、システムに簡単に統合してテストできます。タイトル識別子とオプションのフィルターを使用してURLを作成し、GETリクエストを送信してオファーの現在のステータスを取得するだけです。

パラメーター
この表は、オファーステータス情報のクエリに使用できるパラメーターを定義しています。

リクエスト例

注意: リクエストパラメータが具体的であればあるほど、レスポンスはより的を絞ったものになります。マーケットプレイスや地域などのオプションパラメータを省略すると、APIはそのALIDに関連するすべての適用範囲のステータス情報を返します。

レスポンススキーマは、オファーステータスAPIによって返されるデータ構造を定義します。これらのデータタイプを理解しておくと、レスポンスを解析し、ステータス情報をシステムに効果的に統合するのに役立ちます。

ステータスレスポンスを取得
リクエストされたタイトルのオファーステータス情報を含む最上位のレスポンス。各レスポンスには、リクエストパラメータでフィルタリングされたステータスデータが含まれているため、さまざまな事業分野や地域にわたる利用可能状況の状態を把握できます。

オファーステータスタイプ 単一のオファーのステータスを表すコアデータ構造。これには、各利用可能期間の全体的なステータス情報と詳細なトランザクションレベルのデータが含まれます。

Publisher type　（公開者タイプ）
組織をコンテンツライセンサーとして識別します。この値は、Prime Videoがオンボーディング時に提供します。

ステータスタイプ
日付範囲や現在の進捗コードなど、オファーの全体的なステータス情報を提供します。

Transaction type (トランザクションタイプ）
関連するライセンス条件とステータスを含む単一の利用可能期間を表します。各トランザクションは、特定のライセンスタイプ、地域、およびフォーマットプロファイルの組み合わせに対応しています。

FeatureStatusタイプ
日付範囲や進捗コードなど、特定の利用可能期間の詳細なステータス情報を提供します。

FormatProfile type　（FormatProfileタイプ）
利用可能状況に対してビデオ品質ティアを指定します。コンテンツを複数の品質ティア(例: HDとUHDの両方)で提供している場合は、複数のフォーマットプロファイルを1回のトランザクションに含めることができます。

注意: 上記のスキーマは、現在のAPIレスポンス構造を表しています。一部のフィールド(コメント、FeatureStatusのProgressCode、TransactionIDなど)は、現在はnullですが、将来のリリースでは事前入力される可能性があります。

この例は、さまざまな地域で複数の利用可能期間を持つSVODタイトルに対する一般的なAPIレスポンスを示しています。レスポンスには、全体的なステータス、トランザクションの詳細、フォーマットプロファイルなど、ステータス情報がどのように構造化されているかが示されます。

SVODの例:

以下のセクションには、オファーステータス APIの使用に関してよく寄せられる質問への回答が記載されています。