ポリシーカタログ
ポリシーカタログは、ほかのカタログから参照できる、地理的制限とエンタイトルメント価格帯に関する再利用可能なルールを定義します。以下のセクションでは、PolicyCatalogに含まれる要素について説明します。
PolicyCatalog
ポリシーは、コンテンツ配信の提供ルールと制限を定義します。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
DataCollections |
| データ型 | PolicyCatalogType |
| 子要素 | 説明 |
|
ポリシーカタログからポリシーを削除するための管理動詞です。 |
|
地域ごとの提供ルールと制限を定義します。 |
|
コンテンツにアクセスするための視聴権限を表すエンタイトルメントの詳細を定義します。 |
| 属性 | 説明 |
id
|
ポリシーカタログの一意の識別子です。デフォルト値は データ型: ID |
version
|
リビジョンごとに増加する整数です。バージョン管理に使用されます。デフォルト値は データ型:long |
action
|
カタログの申請時に実行するアクションを示します。デフォルト値は データ型: CatalogActionType |
↑先頭に戻る
Delete
カタログからプログラムによってアイテムを削除できるようにする管理動詞です。統合システムがDelete要素を処理すると、指定したIDのアイテムがシステムから削除されます。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
DataCollectionsProgramCatalogScheduleCatalogOfferCatalogStationCatalogLineupCatalogPolicyCatalog |
| データ型 | DeleteType |
| 属性 | 説明 |
id
必須 |
削除するエンティティの一意の識別子です。 データ型: ID |
version
|
削除するエンティティのバージョンです。エンティティの現在のバージョン以上である必要があります。デフォルト値は データ型:long |
↑先頭に戻る
RegionPolicy
特定の地域と郵便番号に対する地理的な提供ルールを定義します。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
PolicyCatalog |
| データ型 | RegionPolicyType |
| 子要素 | 説明 |
|
国/地域と郵便番号を使用して、特定の地域を定義します。 |
| 属性 | 説明 |
id
必須 |
この地域ポリシーの一意の識別子です。 データ型: ID |
version
|
リビジョンごとに増加する整数です。バージョン管理に使用されます。デフォルト値は データ型:long |
↑先頭に戻る
Region
国/地域と郵便番号を使用して、特定の地域を定義します。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
RegionPolicy |
| データ型 | RegionType |
| 子要素 | 説明 |
|
地域の固有の郵便番号を表します。 |
| 属性 | 説明 |
filter
必須 |
地域の郵便番号フィルターです。有効な値は次のとおりです。
データ型: PolicyFilterType |
territories
必須 |
国/地域コードのコンマ区切りのリストです。たとえば、 データ型: TerritoriesType |
↑先頭に戻る
PostalCode
特定の郵便番号を定義します。地域ポリシーでは、コンテンツの提供状況を制御するために郵便番号が使用されます。会場の住所の要素では、住所の郵便番号として使用されます。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
AddressRegion |
| データ型 | string |
↑先頭に戻る
EntitlementPolicy
カタログ価格帯のエンタイトルメントの詳細を定義します。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
PolicyCatalog |
| データ型 | EntitlementPolicyType |
| 子要素 | 説明 |
必須 |
アプリからAmazon定期購入エンタイトルメントAPIに送信されるエンタイトルメントIDです。 |
|
エンタイトルメントの短い表示名です。たとえば、Buy Box(推奨視聴オプション)の下に「スポーツ」と表示されます。 |
|
エンタイトルメントの長い表示名です。たとえば、購入フロー中に「スポーツアドオン」と表示されます。 |
|
Tag要素のリストです。 |
| 属性 | 説明 |
id
必須 |
このエンタイトルメントポリシーの一意の識別子です。 データ型: ID |
version
|
リビジョンごとに増加する整数です。バージョン管理に使用されます。デフォルト値は データ型:long |
type
必須 |
データ型: EntitlementTypeEnumType |
defaultForSignedInUser
|
このカタログ価格帯が、アプリにサインインしたすべてのユーザーに提供されることを示します。 データ型:boolean |
↑先頭に戻る
EntitlementId
ShortDisplayNames
エンタイトルメントのローカライズされた短い表示名のリストです。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
EntitlementPolicy |
| データ型 | ShortDisplayNameList |
| 子要素 | 説明 |
必須 |
エンタイトルメント名のローカライズされた文字列です。 |
↑先頭に戻る
ShortDisplayName
エンタイトルメントの短い表示名です。たとえば、Buy Box(推奨視聴オプション)の下にテキストとして表示されます。最大8文字に制限されます。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
ShortDisplayNames |
| データ型 | LocalizedStringType |
| 属性 | 説明 |
language
必須 |
このアイテムの言語データを示します。 データ型: LanguageType |
territories
|
国/地域コードのコンマ区切りのリストです。たとえば、 データ型: TerritoriesType |
default
|
一致する言語がない場合、カタログシステムはこの値をデフォルトとして使用します。プロパティごとに、元の言語または言語と地域に対応する1つの値にのみ適用できます。タイトル、キャプション付きの画像、説明、概要はこの規則に従います。 データ型:boolean |
↑先頭に戻る
LongDisplayNames
エンタイトルメントのローカライズされた長い表示名のリストです。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
EntitlementPolicy |
| データ型 | LongDisplayNameList |
| 子要素 | 説明 |
必須 |
エンタイトルメント名のローカライズされた文字列です。 |
↑先頭に戻る
LongDisplayName
エンタイトルメントの長い表示名です。たとえば、購入フローでテキストとして表示されます。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
LongDisplayNames |
| データ型 | LocalizedStringType |
| 属性 | 説明 |
language
必須 |
このアイテムの言語データを示します。 データ型: LanguageType |
territories
|
国/地域コードのコンマ区切りのリストです。たとえば、 データ型: TerritoriesType |
default
|
一致する言語がない場合、カタログシステムはこの値をデフォルトとして使用します。プロパティごとに、元の言語または言語と地域に対応する1つの値にのみ適用できます。タイトル、キャプション付きの画像、説明、概要はこの規則に従います。 データ型:boolean |
↑先頭に戻る
Tags
Tag要素のリストです。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
MovieTVEpisodeTVSeasonTVSeriesExtraSportsEventEventOtherOffAirToBeAnnouncedAiringProgramOfferStationOfferProgramAiringOfferStationEntitlementPolicy |
| データ型 | TagList |
| 子要素 | 説明 |
必須 |
番組や放送の分類、プロモーション、カスタム処理の適用に使用される追加のメタデータです。 |
↑先頭に戻る
Tag
番組や放送の分類、プロモーション、カスタム処理の適用に使用される追加のメタデータです。これらの値のスキーム、キー、有効な形式は、開発者とAmazonの間で相談して決定する必要があります。この機能は、非標準または新規のユースケースがある場合に、専用のエンティティや属性が追加され、新しいバージョンの仕様に組み込まれるまでの間、それらのユースケースに対応する手段として使用できます。
| プロパティ | 詳細 |
|---|---|
| 親要素 |
Tags |
| データ型 | TagType - 必須のscheme属性とkey属性が追加されたstringです。
|
| 属性 | 説明 |
scheme
必須 |
キーと値のペアに使用する、普遍的に一意の名前空間です。 データ型:string |
key
必須 |
キーと値のペアのキーを示します。値は要素の値です。 データ型:string |
↑先頭に戻る
Last updated: 2026年5月28日

