[Important] Update for Standardizing Product Variation

(This Change is applicable to all regions)

Dear developers,

To provide a better buyer experience and more accurate product search & recommendation, Shopee will standardize variations for all listings. On Open API side, you can v2.product.get_variations or v2.global_product.get_variations to pass category_id to get all the standard variation.

There are two levels of standardization: the first level is called variation_id, and the second level is called variation_group_id. The values are referred to as variation_option_id.

When calling v2.product.init_tier_variation or v2.global_product.init_tier_variation to add or modify variation structures, you need to pass variation_id. If there are two levels of variations under this category, variation_group_id must be passed. If you want to use customized variations, then pass variation_id=0 and pass variation_name.

Tips:

1. If you input variation_name & variation_id, and variation_id !=0, it will not allow you to input variation_name.

2. If variation_id = 0, then you must pass the variation_name.

The logic for standard variations remains consistent when calling the update variation APIs v2.product.update_tier_variation or v2.global_product.update_tier_variation, as well as v2.global_product.create_publish_task, which creates a variation to be published on the local site for global products.

Note: Currently, it is a transitional phase where standardise_tier_variation is not mandatory. However, on May 30th we will sunset the old field tier_variation for all APIs, and standardise_tier_variation will be set as a mandatory field. Please complete the integration as soon as possible.

Calling v2.product.get_model_list and v2.global_product.get_global_model_list will return variation_id, variation_name, variation_group_id, variation_option_id, as well as their corresponding image_id and URL.

Related APIs:

v2.product.init_tier_variation

v2.product.update_tier_variation

v2.product.get_model_list

(new)v2.product.get_variations

v2.global_product.init_tier_variation

v2.global_product.update_tier_variation

v2.global_product.get_global_model_list

(new)v2.global_product.get_variations

Effective time: Lived

(此变动适用于所有地区的店铺)

尊敬的开发者：

为了提供更好的买家体验和更准确的产品搜索与推荐，Shopee将对所有商品变体进行变体标准化。在Open API端，您可以使用v2.product.get_variation 或 v2.global_product.get_variation, 入参 category_id以获取所有标准变体。

标准化变体分为两个层级：第一层级称为variation_id，第二层级称为variation_group_id。其取值称为variation_option_id。

调用v2.product.init_tier_variation或v2.global_product.init_tier_variation添加或修改变体结构时，需要传入variation_id。如果该类目下的变体有两个层级，则必须传入variation_group_id。如果您想要使用自定义的变体，则传入variation_id=0。

注意：

1）如果传入variation_id，并且variation_type_id !=0，则无需输入variation_name。

2）如果variation_id = 0，则必须传入 variation_name。

调用更新变体接口 v2.product.update_tier_variation或 v2.global_product.update_tier_variation，以及 v2.global_product.create_publish_task（用于创建即将发布到local站点的变体）的标准化变体逻辑保持一致。

注意：目前处于过渡阶段，standardise_tier_variation 不是必传字段。但是 5月30日将下线tier_variation 旧字段，standardise_tier_variation 将被设定为必填字段。建议开发者尽快完成对接。

调用v2.product.get_model_list和v2.global_product.get_global_model_list将返回variation_id、variation_name、variation_group_id、variation_option_id以及相应的image_id和url。

影响接口：

v2.product.init_tier_variation

v2.product.update_tier_variation

v2.product.get_model_list

(new)v2.product.get_variations

v2.global_product.init_tier_variation

v2.global_product.update_tier_variation

v2.global_product.get_global_model_list

(new)v2.global_product.get_variations

生效时间：已上线