开发者控制台

观看列表

观看列表

这适用于在客户的观看列表中添加和删除内容。Fire TV可能会使用观看列表信息来更新客户的通用观看列表。

要发送的内容

如果触发器是应用安装和登录,或者Fire TV的设备端服务要求刷新,则为所有观看列表项目提供action=add。否则,仅发送已添加和已删除的项目。触发后,发送所有数据。亚马逊会处理重复内容,因此无需自行过滤掉这些内容。

字段名 必填项(是/否) 描述
Content ID(内容ID) 对应于通过目录集成提供给Fire TV的内容ID。
Activity Date(活动日期) 客户添加或删除权利时的时间戳。
List Action(列出操作) ADDED(已添加)或REMOVED(移除)。
Internal Profile ID(内部个人资料ID) 提供经过混淆处理的Profile ID(个人资料ID),以便Fire TV将活动与正确的应用客户关联。

何时发送

  • 初次安装和登录应用时。
  • 客户的观看列表中添加或删除项目时。此操作可以在设备外发生。
  • Fire TV的设备端服务要求刷新时。
  • 切换到新的个人资料时。

发送方式

要共享客户添加到观看列表的最新作品,请使用以下代码:

AmazonCustomerListReceiver listReceiver = AmazonCustomerListReceiver.getInstance(getContext());
AmazonCustomerListEntry listEntry = AmazonCustomerListEntry.builder()
   .contentId(AmazonContentId.builder()
      .id("contentId")
      .namespace(AmazonContentId.NAMESPACE_CDF_ID).build())
   .addedTimestampMs(System.currentTimeMillis())
   .profileId(AmazonProfileId.builder()
      .id("myProfileId1")
      .namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
      .build())
   .build();

listReceiver.addCustomerListEntry(AmazonCustomerListType.WATCHLIST, listEntry);
val listReceiver: AmazonCustomerListReceiver = AmazonCustomerListReceiver.getInstance(context)
val listEntries: List<AmazonCustomerListEntry> = ArrayList()
val listEntry: AmazonCustomerListEntry = AmazonCustomerListEntry.builder()
    .contentId(
        AmazonContentId.builder()
            .id("contentId")
            .namespace(AmazonContentId.NAMESPACE_CDF_ID).build()
    )
    .addedTimestampMs(System.currentTimeMillis())
    .profileId(
        AmazonProfileId.builder()
            .id("myProfileId1")
            .namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
            .build()
    )
    .build()
listEntries.add(listEntry)
val listEntry2: AmazonCustomerListEntry = AmazonCustomerListEntry.builder()
    .contentId(
        AmazonContentId.builder()
            .id("contentId2")
            .namespace(AmazonContentId.NAMESPACE_CDF_ID).build()
    )
    .addedTimestampMs(System.currentTimeMillis())
    .profileId(
        AmazonProfileId.builder()
            .id("myProfileId1")
            .namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
            .build()
    )
    .build()
listEntries.add(listEntry2)
listReceiver.setCustomerList(AmazonCustomerListType.WATCHLIST, listEntries)

发送客户的完整观看列表

以下示例代码展示了如何发送客户的完整观看列表。

AmazonCustomerListReceiver listReceiver = AmazonCustomerListReceiver.getInstance(getContext());        List<AmazonCustomerListEntry> listEntries = new ArrayList<>();
   AmazonCustomerListEntry listEntry = AmazonCustomerListEntry.builder()
      .contentId(AmazonContentId.builder()
         .id("contentId")
         .namespace(AmazonContentId.NAMESPACE_CDF_ID).build())
      .addedTimestampMs(System.currentTimeMillis())
      .profileId(AmazonProfileId.builder()
         .id("myProfileId1")
         .namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
         .build())
      .build();
   listEntries.add(listEntry);
   
   AmazonCustomerListEntry listEntry2 = AmazonCustomerListEntry.builder()
      .contentId(AmazonContentId.builder()
         .id("contentId2")
         .namespace(AmazonContentId.NAMESPACE_CDF_ID).build())
      .addedTimestampMs(System.currentTimeMillis())
      .profileId(AmazonProfileId.builder()
         .id("myProfileId1")
         .namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
         .build())
      .build();
   listEntries.add(listEntry2);

listReceiver.setCustomerList(AmazonCustomerListType.WATCHLIST, listEntries);
val listReceiver: AmazonCustomerListReceiver = AmazonCustomerListReceiver.getInstance(context)
val listEntries: List<AmazonCustomerListEntry> = ArrayList()
val listEntry: AmazonCustomerListEntry = AmazonCustomerListEntry.builder()
    .contentId(
        AmazonContentId.builder()
            .id("contentId")
            .namespace(AmazonContentId.NAMESPACE_CDF_ID).build()
    )
    .addedTimestampMs(System.currentTimeMillis())
    .profileId(
        AmazonProfileId.builder()
            .id("myProfileId1")
            .namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
            .build()
    )
    .build()
listEntries.add(listEntry)
val listEntry2: AmazonCustomerListEntry = AmazonCustomerListEntry.builder()
    .contentId(
        AmazonContentId.builder()
            .id("contentId2")
            .namespace(AmazonContentId.NAMESPACE_CDF_ID).build()
    )
    .addedTimestampMs(System.currentTimeMillis())
    .profileId(
        AmazonProfileId.builder()
            .id("myProfileId1")
            .namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
            .build()
    )
    .build()
listEntries.add(listEntry2)
listReceiver.setCustomerList(AmazonCustomerListType.WATCHLIST, listEntries)

后续步骤

我们的数据类型参考是可供您便捷查阅的数据类型参考资源。


Last updated: 2023年11月29日