as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
テスト
公開
収益化
ユーザーエンゲージメント
デバイスの仕様
リソース

オファーカタログ

オファーカタログ

オファーカタログは、コンテンツがユーザーによってどのようにアクセスされ、検出されるかを定義します。エンタイトルメント、起動ターゲット、検出メタデータが含まれます。以下のセクションでは、OfferCatalogに含まれる要素について説明します。

OfferCatalog

ユーザーがコンテンツにアクセスする方法やコンテンツを検索する方法を定義する、オファー関連のエンティティを格納します。

プロパティ 詳細
親要素 DataCollections
データ型 OfferCatalogType
子要素 説明
Delete カタログからオファーを削除するための管理動詞です。
ProgramOffers 特定の番組のアクセス詳細を定義します。
ProgramAiringOffers 番組の特定の放送のアクセス詳細を定義します。
StationOffers 特定のステーションのアクセス詳細を定義します。
ProgramDiscovery ランキング、レーティング、プロモーションバッジなど、番組の検出属性を定義します。
属性 説明
id

オファーカタログの識別子です。デフォルト値はDEFAULT_OFFER_CATALOGです。

データ型: ID

version

リビジョンごとに増加する整数です。バージョン管理に使用されます。デフォルト値は1です。

データ型:long

action

カタログの申請時に実行するアクションを示します。デフォルト値はupsertです。
有効な値は、upsertreplaceです。

データ型: CatalogActionType



↑先頭に戻る

Delete

カタログからプログラムによってアイテムを削除できるようにする管理動詞です。統合システムがDelete要素を処理すると、指定したIDのアイテムがシステムから削除されます。

プロパティ 詳細
親要素 DataCollections
ProgramCatalog
ScheduleCatalog
OfferCatalog
StationCatalog
LineupCatalog
PolicyCatalog
データ型 DeleteType
属性 説明
id
必須

削除するエンティティの一意の識別子です。

データ型: ID

version

削除するエンティティのバージョンです。エンティティの現在のバージョン以上である必要があります。デフォルト値は1です。

データ型:long



↑先頭に戻る

ProgramOffers

番組オファーのリストです。

プロパティ 詳細
親要素 OfferCatalog
データ型 ProgramOffersType
子要素 説明
ProgramOffer
必須
番組のアクセス詳細を定義します。
属性 説明
id
必須

番組オファーの識別子です。

データ型: ID

version

番組オファーのバージョンです。デフォルト値は1です。

データ型:long

programRef
必須

このオファーを特定の番組に関連付ける参照識別子です。

データ型: ID

programCatalogRef

提供される番組が含まれているカタログへの参照です。デフォルト値はDEFAULT_PROGRAM_CATALOGです。

データ型: ID



↑先頭に戻る

ProgramAiringOffers

放送オファーのリストです。

プロパティ 詳細
親要素 OfferCatalog
データ型 ProgramAiringOffersType
子要素 説明
ProgramAiringOffer
必須
放送のアクセス詳細を定義します。
属性 説明
id
必須

放送中のオファーの識別子です。

データ型: ID

version

放送オファーのバージョンです。デフォルト値は1です。

データ型:long

programRef
必須

このオファーを特定の番組または番組放送に関連付ける参照識別子です。

データ型: ID

programCatalogRef

提供される番組または番組放送が含まれているカタログへの参照です。デフォルト値はDEFAULT_PROGRAM_CATALOGです。

データ型: ID



↑先頭に戻る

StationOffers

ステーションオファーのリストです。

プロパティ 詳細
親要素 OfferCatalog
データ型 StationOffersType
子要素 説明
StationOffer
必須
ステーションのアクセス詳細を定義します。
属性 説明
id
必須

ステーションオファーの識別子です。

データ型: ID

version

ステーションオファーのバージョンです。

データ型:long

stationRef
必須

このオファーを特定のステーションに関連付ける参照識別子です。

データ型: ID

stationCatalogRef

提供されるステーションが含まれているカタログへの参照です。デフォルト値はDEFAULT_STATION_CATALOGです。

データ型: ID



↑先頭に戻る

ProgramDiscovery

ランキング、レーティング、プロモーションバッジなど、番組の検出属性を定義します。

プロパティ 詳細
親要素 OfferCatalog
データ型 ProgramDiscoveryType
子要素 説明
Ranks Rank要素のリストです。
CustomerRatings CustomerRating要素のリストです。
Badges Badge要素のリストです。
属性 説明
start

検出可能期間の開始日時です。

データ型: DateTimeType

end

検出可能期間の終了日時です。

データ型: DateTimeType

territories

番組またはステーションを検出可能にする国を示します。国/地域コードのコンマ区切りのリストです。たとえば、"US,CA"のように指定します。値がすべての国/地域に適用されることを示すには、GLOBALを使用します。

データ型: TerritoriesType

programRef
必須

このオファーを特定の番組または番組放送に関連付ける参照識別子です。

データ型: ID

programCatalogRef

提供される番組または番組放送が含まれているカタログへの参照です。デフォルト値はDEFAULT_PROGRAM_CATALOGです。

データ型: ID



↑先頭に戻る

ProgramOffer

番組のアクセス詳細を定義します。

プロパティ 詳細
親要素 ProgramOffers
データ型 ProgramOfferType
子要素 説明
Entitlements
必須
コンテンツにアクセスするための視聴権限を表すエンタイトルメントのリストです。
AudioLanguages 利用可能なオーディオ言語オプションを格納します。
SubtitleLanguages 利用可能な字幕言語オプションを格納します。
VideoResolutions 利用可能なビデオ解像度オプションを格納します。
VideoAttributes 利用可能なビデオ属性オプションを格納します。
AudioAttributes 利用可能なオーディオ属性オプションを格納します。
Ads 番組内の広告を示します。これは空の要素です。
Tags Tag要素のリストです。
GeoRestrictions コンテンツへのアクセスを定義する地理的制限のリストです。
LaunchTargets LaunchTarget要素のリストです。
属性 説明
start

定期購入の有効期間の開始日時です。

データ型: DateTimeType

end

定期購入の有効期間の終了日時です。

データ型: DateTimeType

territories

国/地域コードのコンマ区切りのリストです。たとえば、"US,CA"のように指定します。デフォルト値はGLOBALです(値がすべての国/地域に適用されることを示します)。

データ型: TerritoriesType



↑先頭に戻る

Entitlements

コンテンツにアクセスするための視聴権限を表すエンタイトルメントのリストです。

プロパティ 詳細
親要素 ProgramOffer
ProgramAiringOffer
StationOffer
データ型 EntitlementListType
子要素 説明
Entitlement
必須
コンテンツにアクセスするための視聴権限を表すエンタイトルメントの詳細です。typepolicyRefのいずれかの属性を指定する必要があります。両方を指定することはできません。
  • シンプルな標準エンタイトルメント(freeまたはsubscription)を使用し、追加のポリシー構成を必要としない場合は、typeを指定します。
  • 定期購入エンタイトルメントAPIを使用してユーザーの視聴権限をAmazonと共有する場合は、policyRefを指定します。


↑先頭に戻る

Entitlement

コンテンツにアクセスするための視聴権限を表すエンタイトルメントの詳細です。typepolicyRefのいずれかの属性を指定する必要があります。両方を指定することはできません。

  • シンプルな標準エンタイトルメント(freeまたはsubscription)を使用し、追加のポリシー構成を必要としない場合は、typeを指定します。
  • 定期購入エンタイトルメントAPIを使用してユーザーの視聴権限をAmazonと共有する場合は、policyRefを指定します。

プロパティ 詳細
親要素 Entitlements
データ型 EntitlementType
属性 説明
type
必須

typepolicyRefのいずれかが必須です。エンタイトルメントのタイプを示します。有効な値は次のとおりです。

  • free - コンテンツは無料で利用できます。
  • subscription - コンテンツには定期購入またはアドオンの定期購入が必要です。たとえば、プレミアム価格帯のコンテンツやスポーツアドオンを必要とするコンテンツがあります。

データ型: EntitlementTypeEnumType

policyRef
必須

typepolicyRefのいずれかが必須です。エンタイトルメントの詳細を定義するポリシーを参照します。

データ型:string

policyCatalogRef

参照先のポリシーが含まれているポリシーカタログへの参照です。デフォルト値はDEFAULT_POLICY_CATALOGです。

データ型: ID



↑先頭に戻る

AudioLanguages

利用可能なオーディオ言語オプションを格納します。

プロパティ 詳細
親要素 Airing
ProgramOffer
StationOffer
Station
データ型 AudioLanguageList
子要素 説明
AudioLanguage
必須
番組またはステーションのオーディオ言語です。


↑先頭に戻る

AudioLanguage

番組またはステーションのオーディオ言語です。

プロパティ 詳細
親要素 AudioLanguages
データ型 AudioLanguageType - 番組のオーディオ言語を表すstringです。
属性 説明
language
必須

このアイテムの言語データを示します。

データ型: LanguageType

default

デフォルトのオーディオ言語であることを示します。

データ型:boolean

original

これがコンテンツの元の言語かどうかを示します。元の言語にはtrue、吹き替えコンテンツにはfalseを使用します。

データ型:boolean



↑先頭に戻る

SubtitleLanguages

利用可能な字幕言語オプションを格納します。

プロパティ 詳細
親要素 Airing
ProgramOffer
StationOffer
Station
データ型 SubtitleLanguageList
子要素 説明
SubtitleLanguage
必須
番組またはステーションの字幕言語です。


↑先頭に戻る

SubtitleLanguage

番組またはステーションの字幕言語です。

プロパティ 詳細
親要素 SubtitleLanguages
データ型 SubtitleLanguageType - 番組の字幕言語を表すstringです。
属性 説明
language
必須

このアイテムの言語データを示します。

データ型: LanguageType

closed

クローズドキャプションの場合はtrue、焼き込み字幕の場合はfalseを指定するか省略します。

データ型:boolean

default

SubtitleLanguage要素のリストの中でデフォルトの字幕言語を示します。

データ型:boolean



↑先頭に戻る

VideoResolutions

利用可能なビデオ解像度オプションを格納します。

プロパティ 詳細
親要素 ProgramOffer
ProgramAiringOffer
StationOffer
Station
データ型 VideoResolutionList
子要素 説明
VideoResolution
必須
提供されるビデオ解像度を示す固定の列挙体です。有効な値は、SDHDFullHD4K8Kです。


↑先頭に戻る

VideoResolution

提供されるビデオ解像度を示す固定の列挙体です。有効な値は、SDHDFullHD4K8Kです。

プロパティ 詳細
親要素 VideoResolutions
データ型 ResolutionType


↑先頭に戻る

VideoAttributes

利用可能なビデオ属性オプションを格納します。

プロパティ 詳細
親要素 ProgramOffer
ProgramAiringOffer
StationOffer
データ型 VideoAttributeList
子要素 説明
VideoAttribute
必須
オファーの一部として含まれる番組のビデオ属性です。


↑先頭に戻る

VideoAttribute

オファーの一部として含まれる番組のビデオ属性です。例として、SDRHDR10+Dolby Visionなどがあります。

プロパティ 詳細
親要素 VideoAttributes
データ型 string


↑先頭に戻る

AudioAttributes

利用可能なオーディオ属性オプションを格納します。

プロパティ 詳細
親要素 ProgramOffer
ProgramAiringOffer
StationOffer
データ型 AudioAttributeList
子要素 説明
AudioAttribute
必須
番組のオーディオ属性です。


↑先頭に戻る

AudioAttribute

番組のオーディオ属性です。例として、Dolby Digital 5.1DD 5.1DD7.1DD7.1+Dolby Atmosがあります。

プロパティ 詳細
親要素 AudioAttributes
データ型 string


↑先頭に戻る

Ads

番組内の広告を示します。これは空の要素です。

プロパティ 詳細
親要素 ProgramOffer
ProgramAiringOffer
StationOffer
データ型 AdsType - コンテンツの再生中に動的広告が挿入されるかどうかを示す空の要素です。


↑先頭に戻る

Tags

Tag要素のリストです。

プロパティ 詳細
親要素 Movie
TVEpisode
TVSeason
TVSeries
Extra
SportsEvent
Event
Other
OffAir
ToBeAnnounced
Airing
ProgramOffer
StationOffer
ProgramAiringOffer
Station
EntitlementPolicy
データ型 TagList
子要素 説明
Tag
必須
番組や放送の分類、プロモーション、カスタム処理の適用に使用される追加のメタデータです。


↑先頭に戻る

Tag

番組や放送の分類、プロモーション、カスタム処理の適用に使用される追加のメタデータです。これらの値のスキーム、キー、有効な形式は、開発者とAmazonの間で相談して決定する必要があります。この機能は、非標準または新規のユースケースがある場合に、専用のエンティティや属性が追加され、新しいバージョンの仕様に組み込まれるまでの間、それらのユースケースに対応する手段として使用できます。

プロパティ 詳細
親要素 Tags
データ型 TagType - 必須のscheme属性とkey属性が追加されたstringです。
属性 説明
scheme
必須

キーと値のペアに使用する、普遍的に一意の名前空間です。

データ型:string

key
必須

キーと値のペアのキーを示します。値は要素の値です。

データ型:string



↑先頭に戻る

GeoRestrictions

コンテンツへのアクセスを定義する地理的制限のリストです。

プロパティ 詳細
親要素 Airing
ProgramOffer
StationOffer
Lineup
データ型 GeoRestrictionList
子要素 説明
GeoRestriction
必須
コンテンツへのアクセスを制限するGeoRestrictionの詳細です。


↑先頭に戻る

GeoRestriction

コンテンツへのアクセスを制限するGeoRestrictionの詳細です。

プロパティ 詳細
親要素 GeoRestrictions
データ型 GeoRestrictionType
属性 説明
policyRef
必須

地理的制限の詳細を定義するポリシーへの参照です。

データ型: ID

policyCatalogRef

参照先のポリシーが含まれているポリシーカタログへの参照です。デフォルト値はDEFAULT_POLICY_CATALOGです。

データ型: ID



↑先頭に戻る

LaunchTargets

LaunchTarget要素のリストです。

プロパティ 詳細
親要素 ProgramOffer
ProgramAiringOffer
StationOffer
データ型 LaunchTargetList
子要素 説明
LaunchTarget
必須
さまざまなデバイス、サービス、プレゼンテーションで特定の番組、放送、ステーションを起動するために必要な情報を指定します。


↑先頭に戻る

LaunchTarget

さまざまなデバイス、サービス、プレゼンテーションで特定の番組、放送、ステーションを起動するために必要な情報を指定します。

プロパティ 詳細
親要素 LaunchTargets
データ型 LaunchTargetType - 特定の番組、放送、ステーションを起動するために必要な情報を指定するstringです。
属性 説明
type

有効な起動ターゲットタイプを表す列挙体です。有効な値は、 WEBFIRETVです。

データ型: LaunchTargetTypeEnum



↑先頭に戻る

ProgramAiringOffer

放送のアクセス詳細を定義します。

プロパティ 詳細
親要素 ProgramAiringOffers
データ型 ProgramAiringOfferType
子要素 説明
Airing
必須
番組放送の詳細です。
Entitlements
必須
コンテンツにアクセスするための視聴権限を表すエンタイトルメントのリストです。
VideoResolutions 利用可能なビデオ解像度オプションを格納します。
VideoAttributes 利用可能なビデオ属性オプションを格納します。
AudioAttributes 利用可能なオーディオ属性オプションを格納します。
Ads 番組内の広告を示します。これは空の要素です。
Tags Tag要素のリストです。
LaunchTargets LaunchTarget要素のリストです。
属性 説明
start

定期購入の有効期間の開始日時です。

データ型: DateTimeType

end

定期購入の有効期間の終了日時です。

データ型: DateTimeType

territories

国/地域コードのコンマ区切りのリストです。たとえば、"US,CA"のように指定します。デフォルト値はGLOBALです(値がすべての国/地域に適用されることを示します)。

データ型: TerritoriesType

scheduleCatalogRef

放送が含まれているカタログへの参照です。デフォルト値はDEFAULT_SCHEDULE_CATALOGです。

データ型: ID



↑先頭に戻る

Airing

Airingエンティティは、番組を時間枠に関連付けます。スケジュールのコンテンツを定義するために、ref属性を使用して既存の番組エントリの識別子を参照する必要があります。スケジュールにはレーティングを定義できますが、それらは1つのスケジュールエントリに対するオーバーライドであり、コンテンツ自体のレーティングには影響しません。

プロパティ 詳細
親要素 Schedule
ProgramAiringOffer
データ型 AiringType
子要素 説明
Live この番組がリアルタイムで放送されていることを示します。これは空の要素です。
New 番組の初回放送であることを示します。これは空の要素です。
Edited 放送が元のバージョンから変更されているかどうかを示します。
Ratings Rating要素のリストです。
AudioLanguages 利用可能なオーディオ言語オプションを格納します。
SubtitleLanguages 利用可能な字幕言語オプションを格納します。
Tags Tag要素のリストです。
GeoRestrictions スケジュールに適用するポリシー参照のリストです(地域制限など)。
属性 説明
id
必須

放送エンティティの識別子です。

データ型: ID

startTime
必須

放送の開始時刻です。

データ型: DateTimeType

duration
必須

放送の継続時間です。

データ型: DurationType

programRef
必須

放送に関連付けられている番組への参照です。

データ型: ID

programCatalogRef

放送される番組が含まれている番組カタログへの参照です。スケジュールに指定された番組カタログをオーバーライドします。デフォルト値はDEFAULT_PROGRAM_CATALOGです。

データ型: ID



↑先頭に戻る

Live

この番組がリアルタイムで放送されていることを示します。これは空の要素です。

プロパティ 詳細
親要素 Airing
データ型 string


↑先頭に戻る

New

番組の初回放送であることを示します。これは空の要素です。

プロパティ 詳細
親要素 Airing
データ型 string


↑先頭に戻る

Edited

放送が元のバージョンから変更されているかどうかを示します。

プロパティ 詳細
親要素 Airing
データ型 EditedType
属性 説明
cropped

コンテンツがトリミングされていることを示します。トリミングでは縦横比が編集されます。通常はTVに適した縦横比にするために行われます。

データ型:boolean

content

番組がコンテンツ向けに編集されていることを示します。コンテンツ向けの編集では、番組の放送時間が短縮されます。これは、制限の対象となるシーンを削除したり、長さを放送時間枠に合わせたりするために行われることがあります。

データ型:boolean

language

番組が言語に合わせて編集されていることを示します。通常、言語を編集しても番組の長さには影響しませんが、音声が吹き替えられたり、レーティング制限を緩和するために冒涜的な表現がミュートされたりすることがあります。

データ型:boolean



↑先頭に戻る

Ratings

Rating要素のリストです。

プロパティ 詳細
親要素 Movie
TVEpisode
TVSeason
TVSeries
Extra
SportsEvent
Event
Other
Airing
Station
データ型 RatingList
子要素 説明
Rating
必須
年齢に応じた視聴制限の認定情報を提供します。


↑先頭に戻る

Rating

年齢に応じた視聴制限の認定情報を提供します。adultProductフラグとnotRatedフラグは、番組に年齢制限ルールが適用されることを示すブール型の属性です。レーティング値は、実際の番組と放送に設定します。Rating要素にはコンテンツ記述子が含まれ、コンテンツ記述子にはコードおよび対応する説明が含まれます。説明はレーティングシステムの運用機関から取得し、その運用機関の第一言語を使用します。一部の国/地域では、コンテンツ記述子が法的に義務付けられています。サポートされているレーティングと記述子は、Video Centralのドキュメント(英語のみ)に記載されています。グローバルレーティング仕様を使用してください。

カタログ固有の条件として、次の動作が適用されます。

  • スケジュールカタログ: 放送にレーティングを指定すると、番組のレーティング情報が上書きされます。
  • ステーションカタログ: 番組または放送にレーティングがない場合、カタログシステムはステーションのレーティングを使用します。

プロパティ 詳細
親要素 Ratings
データ型 RatingType - 年齢に応じた視聴制限の認定情報を含む構造体です。
子要素 説明
Descriptors Descriptor要素のリストです。
属性 説明
system
必須

動画のコンテンツレーティングシステムです。

データ型:string

certification
必須

視聴者に対する番組の適格性に基づく認定値です。

データ型:string

adultProduct

番組に年齢制限ルールが適用されているかどうかを示します。

データ型:boolean

notRated

番組に年齢制限ルールが適用されているかどうかを示します。

データ型:boolean

territories

国/地域コードのコンマ区切りのリストです。たとえば、"US,CA"のように指定します。デフォルト値はGLOBALです(値がすべての国/地域に適用されることを示します)。

データ型: TerritoriesType

sourceName

ソースの名前です。指定しない場合、カタログシステムはデータの送信元をデータ要素のソースとして使用します。

データ型: SourceNameType

sourceDate

情報が取得された日付です。指定しない場合、システムはデータの送信日を使用します。

データ型: SourceDateType

sourceId

値を提供したデータレコードの識別子(内部または外部)またはURIです。指定しない場合、デフォルトは親エンティティのIDになります。

データ型: SourceIdType



↑先頭に戻る

Descriptors

Descriptor要素のリストです。

プロパティ 詳細
親要素 Rating
データ型 DescriptorList
子要素 説明
Descriptor
必須
Descriptor要素は、コンテンツ記述子を提供します。コンテンツ記述子には、コードおよび対応する説明が含まれます。


↑先頭に戻る

Descriptor

Descriptor要素は、コンテンツ記述子を提供します。コンテンツ記述子には、コードおよび対応する説明が含まれます。説明はレーティングシステムの運用機関から取得し、その運用機関の第一言語を使用します。一部の国/地域では、コンテンツ記述子が法的に義務付けられています。サポートされているレーティングと記述子は、Video Centralのドキュメント(英語のみ)に記載されています。グローバルレーティング仕様を使用してください。

プロパティ 詳細
親要素 Descriptors
データ型 DescriptorType
属性 説明
code

記述子の2文字のコードです。

データ型:string



↑先頭に戻る

StationOffer

ステーションのアクセス詳細を定義します。

プロパティ 詳細
親要素 StationOffers
データ型 StationOfferType
子要素 説明
Entitlements
必須
コンテンツにアクセスするための視聴権限を表すエンタイトルメントのリストです。
AudioLanguages 利用可能なオーディオ言語オプションを格納します。
SubtitleLanguages 利用可能な字幕言語オプションを格納します。
VideoResolutions 利用可能なビデオ解像度オプションを格納します。
VideoAttributes 利用可能なビデオ属性オプションを格納します。
AudioAttributes 利用可能なオーディオ属性オプションを格納します。
Ads 番組内の広告を示します。これは空の要素です。
Tags Tag要素のリストです。
GeoRestrictions コンテンツへのアクセスを定義する地理的制限のリストです。
LaunchTargets LaunchTarget要素のリストです。
StationTransport ステーショントランスポートの詳細です。
属性 説明
start

定期購入の有効期間の開始日時です。

データ型: DateTimeType

end

定期購入の有効期間の終了日時です。

データ型: DateTimeType

territories

国/地域コードのコンマ区切りのリストです。たとえば、"US,CA"のように指定します。デフォルト値はGLOBALです(値がすべての国/地域に適用されることを示します)。

データ型: TerritoriesType



↑先頭に戻る

StationTransport

さまざまなデバイス、サービス、プレゼンテーションで特定のステーションタイトルを起動するために必要な情報を指定します。

プロパティ 詳細
親要素 StationOffer
Channel
データ型 StationTransportType - 特定のステーションタイトルを起動するために必要な情報を指定するstringです。
属性 説明
channelnum
必須

視聴者に表示されるチャンネル番号です。小数点とサブチャンネルを含めることができます(「2.1」など)。

データ型:string

subsystem

配信システムのタイプです。有効な値は、 DVB-TDVB-SDVB-CISDB-TISDB-SISDB-CATSCATSC3DTMBです。

データ型:string

onid

オリジナルネットワークIDです。ネットワークを一意に識別します。

データ型:string

tsid

トランスポートストリームIDです。多重ストリームを識別します。

データ型:string

sid

サービスIDです。トランスポートストリーム内の特定のサービスを識別します。

データ型:string



↑先頭に戻る

Ranks

Rank要素のリストです。

プロパティ 詳細
親要素 ProgramDiscovery
データ型 RankList
子要素 説明
Rank
必須
Rankは、カタログ内のほかのすべての番組と比較した相対的なスコアです。


↑先頭に戻る

Rank

Rankは、カタログ内のほかのすべての番組と比較した相対的なスコアです。値が低い番組は、値が高いほかのアイテムよりも上位にランク付けされていることを意味します。アイテムに設定できる最高ランクは1です。複数のアイテムを同じランクに設定することもできます。

プロパティ 詳細
親要素 Ranks
データ型 RankType - 番組のランク付けを含む構造体です。
属性 説明
territories

国/地域コードのコンマ区切りのリストです。たとえば、"US,CA"のように指定します。デフォルト値はGLOBALです(値がすべての国/地域に適用されることを示します)。

データ型: TerritoriesType

value

データ型:nonNegativeInteger



↑先頭に戻る

CustomerRatings

CustomerRating要素のリストです。

プロパティ 詳細
親要素 ProgramDiscovery
データ型 CustomerRatingList
子要素 説明
CustomerRating
必須
ユーザー評価には、クラウドソーシングまたは専門家のレビューによるタイトルの相対的評価が含まれます。ソース、スコア、スコア基準(最大スコア)、システムのコホートサイズと、データがソースから取得された日付が必要です。


↑先頭に戻る

CustomerRating

ユーザー評価には、クラウドソーシングまたは専門家のレビューによるタイトルの相対的評価が含まれます。ソース、スコア、スコア基準(最大スコア)、システムのコホートサイズと、データがソースから取得された日付が必要です。

プロパティ 詳細
親要素 CustomerRatings
データ型 CustomerRating - クラウドソーシングまたは専門家のレビューによるタイトルの相対的評価を含む構造体。
属性 説明
territories

国/地域コードのコンマ区切りのリストです。たとえば、"US,CA"のように指定します。デフォルト値はGLOBALです(値がすべての国/地域に適用されることを示します)。

データ型: TerritoriesType

score

コンテンツに与えられた実際の評価値またはスコアです。

データ型:decimal

maxScore

評価システムで獲得し得る最大スコアです。

データ型:decimal

numVotes

与えられた投票または評価の合計数です。

データ型:unsignedInt

sourceName

評価を提供する組織またはシステムの名前です。

データ型:string

sourceDate

評価データが収集された日付または最後に更新された日付です。

データ型: DateType



↑先頭に戻る

Badges

Badge要素のリストです。

プロパティ 詳細
親要素 ProgramDiscovery
データ型 BadgeList
子要素 説明
Badge
必須
バッジは、番組タイトルの提供元や提供状況に関する追加情報をユーザーに表示できるようにするための列挙値を含みます。バッジのテキストや図形は、ユーザーの言語と国/地域に合わせてローカライズできます。


↑先頭に戻る

Badge

バッジは、番組タイトルの提供元や提供状況に関する追加情報をユーザーに表示できるようにするための列挙値を含みます。バッジのテキストや図形は、ユーザーの言語と国/地域に合わせてローカライズできます。

プロパティ 詳細
親要素 Badges
データ型 BadgeType - タイトルの提供元や提供状況に関する追加情報をユーザーに表示するための構造体です。
属性 説明
territories

国/地域コードのコンマ区切りのリストです。たとえば、"US,CA"のように指定します。デフォルト値はGLOBALです(値がすべての国/地域に適用されることを示します)。

データ型: TerritoriesType

scheme

バッジの名前空間です。サポートされているスキームはember_badgeです。ember_badgeの有効な値は次のとおりです。

  • original - 自社制作または独占ライセンスのコンテンツ。
  • new - 最近カタログに追加されたコンテンツ。
  • premiere - シリーズ、シーズン、映画の初回リリースまたは初公開。
  • finale - シリーズまたはシーズンの最終エピソード。
  • coming_soon - 近日公開される予定のコンテンツ。
  • leaving_soon - 近日カタログから削除される予定のコンテンツ。
newcoming_soonleaving_soonなど、時間に依存するバッジが表す具体的な期間については、Amazonの担当者にお問い合わせください。

データ型:string



↑先頭に戻る

Last updated: 2026年5月28日