Rolling offers

What's new

The API now returns rolling offers, a new kind of item that walks the player through a sequence of cards. The item type accepts a new rolling value, store items gain a rolling_offer object type, and a new RollingRead schema describes the offer itself.

Impact

Rolling offers can show up anywhere the API returns an item or a store item. RollingRead carries the usual item fields (name, price, images, SKU) plus a settings object with the list of rolling_items (at least two), each with its own quantity, free-item flag, discount, badge, and bonus items. Settings also hold the block background and an optional schedule for cyclic restarts. effective_at records when player progress in the offer was last reset.

Changes

Resource	Change
get_items	Added `RollingRead` to the item variants in the response and the `rolling` value to the item `type`
get_store_items	Added `RollingRead` to the store item `item` variants and the `rolling_offer` value to `object_type`
get_all_store_items	Added `RollingRead` to the store item `item` variants and the `rolling_offer` value to `object_type`
create_store_item	Added `RollingRead` to the store item `item` variants and the `rolling_offer` value to `object_type` in the response
bulk_update_store_items	Added `RollingRead` to the store item `item` variants and the `rolling_offer` value to `object_type` in the response
update_store_item	Added `RollingRead` to the store item `item` variants and the `rolling_offer` value to `object_type` in the response
create_item, update_item, bulk_create_or_update_items, bulk_update_items	Added the `rolling` value to the item `type` in the request and response
get_item, translate_item	Added the `rolling` value to the item `type` in the response
Coupons, daily rewards, loyalty tiers, and get_player_store_items	Added the `rolling` value to the `type` of nested, bonus, and reward items in responses
Components	Added the `RollingRead`, `RollingOfferSettings`, and `RollingItem` schemas. Added `rolling` to `ItemType` and `rolling_offer` to `StoreItemObjectType` and `ItemSource`

Upgrade

If you parse item type, store item object_type, or the item source, handle the new rolling and rolling_offer values, or fall back gracefully on values you don't recognize.
If you deserialize store items into a fixed set of item variants, add RollingRead. Its model_type is RollingRead.

需要技术支持？
联系我们的集成技术团队： [email protected]