as

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

ポリシーカタログ

ポリシーカタログ

ポリシーカタログは、ほかのカタログから参照できる、地理的制限とエンタイトルメント価格帯に関する再利用可能なルールを定義します。以下のセクションでは、PolicyCatalogに含まれる要素について説明します。

PolicyCatalog

ポリシーは、コンテンツ配信の提供ルールと制限を定義します。

プロパティ 詳細
親要素 DataCollections
データ型 PolicyCatalogType
子要素 説明
Delete ポリシーカタログからポリシーを削除するための管理動詞です。
RegionPolicy 地域ごとの提供ルールと制限を定義します。
EntitlementPolicy コンテンツにアクセスするための視聴権限を表すエンタイトルメントの詳細を定義します。
属性 説明
id

ポリシーカタログの一意の識別子です。デフォルト値はDEFAULT_POLICY_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



↑先頭に戻る

RegionPolicy

特定の地域と郵便番号に対する地理的な提供ルールを定義します。

プロパティ 詳細
親要素 PolicyCatalog
データ型 RegionPolicyType
子要素 説明
Region 国/地域と郵便番号を使用して、特定の地域を定義します。
属性 説明
id
必須

この地域ポリシーの一意の識別子です。

データ型: ID

version

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

データ型:long



↑先頭に戻る

Region

国/地域と郵便番号を使用して、特定の地域を定義します。

プロパティ 詳細
親要素 RegionPolicy
データ型 RegionType
子要素 説明
PostalCode 地域の固有の郵便番号を表します。
属性 説明
filter
必須

地域の郵便番号フィルターです。有効な値は次のとおりです。

  • allow_all - PostalCodeのリストとは関係なく、地域内のすべての郵便番号を許可します。
  • allow_only - PostalCode要素に明示的に含まれている郵便番号のみを許可します。
  • block_only - PostalCode要素に含まれている郵便番号のみをブロックします。

データ型: PolicyFilterType

territories
必須

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

データ型: TerritoriesType



↑先頭に戻る

PostalCode

特定の郵便番号を定義します。地域ポリシーでは、コンテンツの提供状況を制御するために郵便番号が使用されます。会場の住所の要素では、住所の郵便番号として使用されます。

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


↑先頭に戻る

EntitlementPolicy

カタログ価格帯のエンタイトルメントの詳細を定義します。

プロパティ 詳細
親要素 PolicyCatalog
データ型 EntitlementPolicyType
子要素 説明
EntitlementId
必須
アプリからAmazon定期購入エンタイトルメントAPIに送信されるエンタイトルメントIDです。
ShortDisplayNames エンタイトルメントの短い表示名です。たとえば、Buy Box(推奨視聴オプション)の下に「スポーツ」と表示されます。
LongDisplayNames エンタイトルメントの長い表示名です。たとえば、購入フロー中に「スポーツアドオン」と表示されます。
Tags Tag要素のリストです。
属性 説明
id
必須

このエンタイトルメントポリシーの一意の識別子です。

データ型: ID

version

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

データ型:long

type
必須

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

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

データ型: EntitlementTypeEnumType

defaultForSignedInUser

このカタログ価格帯が、アプリにサインインしたすべてのユーザーに提供されることを示します。

データ型:boolean



↑先頭に戻る

EntitlementId

アプリからAmazon定期購入エンタイトルメントAPIに送信されるエンタイトルメントIDです。

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


↑先頭に戻る

ShortDisplayNames

エンタイトルメントのローカライズされた短い表示名のリストです。

プロパティ 詳細
親要素 EntitlementPolicy
データ型 ShortDisplayNameList
子要素 説明
ShortDisplayName
必須
エンタイトルメント名のローカライズされた文字列です。


↑先頭に戻る

ShortDisplayName

エンタイトルメントの短い表示名です。たとえば、Buy Box(推奨視聴オプション)の下にテキストとして表示されます。最大8文字に制限されます。

プロパティ 詳細
親要素 ShortDisplayNames
データ型 LocalizedStringType
属性 説明
language
必須

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

データ型: LanguageType

territories

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

データ型: TerritoriesType

default

一致する言語がない場合、カタログシステムはこの値をデフォルトとして使用します。プロパティごとに、元の言語または言語と地域に対応する1つの値にのみ適用できます。タイトル、キャプション付きの画像、説明、概要はこの規則に従います。

データ型:boolean



↑先頭に戻る

LongDisplayNames

エンタイトルメントのローカライズされた長い表示名のリストです。

プロパティ 詳細
親要素 EntitlementPolicy
データ型 LongDisplayNameList
子要素 説明
LongDisplayName
必須
エンタイトルメント名のローカライズされた文字列です。


↑先頭に戻る

LongDisplayName

エンタイトルメントの長い表示名です。たとえば、購入フローでテキストとして表示されます。

プロパティ 詳細
親要素 LongDisplayNames
データ型 LocalizedStringType
属性 説明
language
必須

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

データ型: LanguageType

territories

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

データ型: TerritoriesType

default

一致する言語がない場合、カタログシステムはこの値をデフォルトとして使用します。プロパティごとに、元の言語または言語と地域に対応する1つの値にのみ適用できます。タイトル、キャプション付きの画像、説明、概要はこの規則に従います。

データ型:boolean



↑先頭に戻る

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



↑先頭に戻る

Last updated: 2026年5月28日