オファーステータス API

約7分で読めます 1月 26, 2026

オファーステータスAPIを使用すると、タイトルがプライムビデオのストアフロントで公開されているかどうか、公開されていない場合はその理由を確認できます。Slateやストアフロントを手動で確認する代わりに、カタログデータを独自のシステムに一元化することで、すべての事業分野と地域をリアルタイムで可視化できます。


オファーステータスAPIを使用する理由

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


リクエストとレスポンススキーマ

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

リクエストフォーマット

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


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

パラメーター

タイプ

必須

説明

licensor

文字列

Yes

オンボーディング時にプライムビデオから提供されたお客様の組織識別子

ALID

文字列

Yes

投稿内容と一致するタイトル識別子(ALIDまたはSKU)

marketplace

文字列

No

タイトルが提出されたAmazonマーケットプレイス。デフォルトはGLOBALで、指定する必要はありません。
指定できる値: GLOBAL、US、DE、JP、GB

territory

文字列

No

オファー状況を確認したい2文字の地域コード(US、GB、AUなど)。これはデフォルトですべての地域に設定され、指定する必要はありません。これが提供されない場合、すべてのオファーステータスが返されます

リクエスト例

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


レスポンススキーマ

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

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

属性

タイプ

必須

説明

OfferStatuses

OfferStatus[]

Yes

オファーステータスオブジェクトの配列、範囲ごとに1つ(事業分野/地域の組み合わせ)

errors

string

No

障害発生時のエラーリスト

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

属性

タイプ

必須

説明

ALID

文字列

Yes

メタデータ投稿と一致するタイトル識別子

GroupingEntity

string

条件付き

チャンネルまたはサブスクリプションの識別子(SVODオファーには必須)

Licensor

Publisher
(公開者)

Yes

プライムビデオにライセンスを付与している組織に関する情報

OverallStatus

ステータス

Yes

現在のavailコンテキスト/範囲内の全期間の全体的なステータス

PlatformID

String[]

Yes

タイトルのグローバルタイトル識別子(GTI)のリスト

Transaction

Transaction[]

Yes

利用可能期間とそのステータスのリスト

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

属性

タイプ

必須

注意

DisplayName

文字列

Yes

組織のわかりやすい名前

OrganizationID

文字列

Yes

オンボーディング時にプライムビデオから提供された組織識別子(アベイルズで使用されている値と一致する必要があります)

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

属性

タイプ

必須

注意

Comments

文字列

No

Amazonからのメモ(人間が読めるフォーマット、現在はnull)

Start

日付

Yes

コンテキストの最も早い期間開始日

End

日付

Yes

コンテキストの最新の期間終了日。

Progress Code

ENUM

Yes

コンテキストの進捗コード

_timestamp

日付

Yes

前回ステータスが変更または更新された日時

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

属性

タイプ

必須

注意

ContractID

文字列

Yes

タイトルが関連付けられている契約

FeatureStatus

FeatureStatus

Yes

期間のステータス

End

日付

Yes

コンテキストの最新の期間終了日

Progress Code

ENUM

Yes

コンテキストの進捗コード

_timestamp

日付

Yes

ステータスが最後に変更または更新された日時

FormatProfile

FormatProfile[]

Yes

利用可能なビデオの画質。指定できる値: SD、HD、UHD、MAX

LicenseType

Enum

Yes

指定できる値: SVOD, FVOD, EST, POEST, VOD

Territory

String[]

Yes

期間の地域

TransactionID

文字列

No

リリース予定—部分抽出で渡されるAvailID(現在はnull)になります。

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

属性

タイプ

必須

注意

Comments

文字列

No

Amazonからのメモ(人間が読めるフォーマット、現在はnull)

Start

日付

Yes

期間開始日

End

日付

Yes

期間終了日

Progress Code

ENUM

Yes

期間のProgress Code(現在はnull—OverallStatusを使用してコンテキストがライブかどうかを確認してください)

_timestamp

日付

Yes

前回ステータスが変更または更新された日時

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

属性

タイプ

必須

注意

value[]

Enum

Yes

利用可能なビデオの画質。指定できる値: SD、HD、UHD、MAX

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


サンプルレスポンス

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

SVODの例:


よくある質問

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

まだヘルプが必要ですか?

お問い合わせ

このガイドの内容



インターナルサーバーエラー、もう一度お試しください。
セッションがタイムアウトしました

続行するにはサインインしてください

サインイン
edit