個別のコンテンツエンタイトルメント

このトピックは、定期購入のエンタイトルメントに含まれない購入、レンタル、録画に適用されます。Fire TVは、エンタイトルメント情報を使用し、行作成に適したエンタイトルメントを特定して、詳細ページを適切なプロバイダーで更新する場合があります。購入、レンタル、DVRの録画は [My Stuff] ページの対応する行に追加される場合もあります。

送信する内容
送信するタイミング
送信方法
次のステップ

送信する内容

トリガーされたときは、すべてのデータを送信します。重複はAmazonが処理するため、開発者自身が除外する必要はありません。

この情報は、個々のコンテンツ（定期購入ではない）のエンタイトルメントについて送信してください。

フィールド名	必須（○／×）	説明
コンテンツID	○	カタログ統合を通じてFire TVに提供されたコンテンツIDに対応します。
タイプ	○	次のいずれかです。録画、購入、レンタル。これにより、Fire TVはUIでユーザー向けのコンテンツに正しくラベルを付けることができます。
有効期限	×	このコンテンツエンタイトルメントの有効期限が切れるときのタイムスタンプ。ない場合は、有効期限がないことを意味します。
エンタイトルメント取得日	○	ユーザーがコンテンツを購入したときのタイムスタンプ。エピソードが録画された時刻である場合もあります。
取得プロフィールID	×	パーソナライゼーションの目的で使用されます（省略可能）。Amazonでは、エンタイトルメントはすべてのプロフィールに適用されるものと想定しています。

送信するタイミング

アプリの初回インストール時とログイン時
新しい個別コンテンツの購入時またはレンタル時
個別のコンテンツエンタイトルメントの有効期限が切れたり、無効になった場合。
有効期限の日付や時刻が変更された場合。
Fire TVのオンデバイスサービスから更新するように求められたとき。

送信方法

次のコードを使用して、個別のコンテンツエンタイトルメントデータを送信します。

Java
Kotlin

AmazonEntitlementReceiver entitlementReceiver = AmazonEntitlementReceiver.getInstance(getContext())
AmazonContentEntitlement entitlement = AmazonContentEntitlement.builder()
   .contentId(
         AmazonContentId.builder()
            .id("id")
            .namespace("namespace")
            .build()
   ).acquisitionTimestampMs(System.currentTimeMillis())
   .expirationTimestampMs(0)
   .type(AmazonEntitlementType.PURCHASE)
   .build();
entitlementReceiver.addContentEntitlement(entitlement);

val entitlementReceiver: AmazonEntitlementReceiver =
            AmazonEntitlementReceiver.getInstance(context))
val subscription: AmazonSubscriptionEntitlement = AmazonSubscriptionEntitlement
    .builder()
    .subscriptionId("base_subscription")
    .acquisitionTimestampMs(System.currentTimeMillis())
    .expirationTimestampMs(0)
    .build()
val subscriptionEntitlements: List<AmazonSubscriptionEntitlement> = arrayListOf(subscription)
entitlementReceiver.setSubscriptions(subscriptionEntitlements)

次のステップ

次のデータの種類では、ウォッチリストについて説明します。

Last updated: 2024年3月18日