商品服务

商品管理相关的API服务，包括商品CRUD、库存管理、规格管理等功能。

异步商品服务

kwaixiaodian.client.services.item.AsyncItemService(client: AsyncBaseClient)

商品服务

提供商品创建、更新、查询、库存与媒体管理等功能。

说明 - Source of truth: 仅以 java_sdk_reference/ 与 docs/ 为准，不做接口猜测。 - 异常：底层 execute 在开放平台返回非 0 错误码或解析失败时抛出 KwaixiaodianAPIError；网络异常会抛出 KwaixiaodianNetworkError。 - uid 必须保持为最后一个可选参数；本类与同步版在参数顺序与含义上保持一致。

初始化商品服务

参数：

名称	类型	描述	默认
client	AsyncBaseClient	基础客户端实例	必需

方法：

名称	描述
list	获取商品列表
get	获取商品详情
get_categories	获取商品分类
get_category_config	获取分类配置
get_optional_categories	获取可选分类
get_suggested_categories	获取推荐分类
get_category_prop_standard	获取分类属性标准
search_category_prop_values	搜索分类属性值
check_category_standard	检查分类标准
search_category_standard	搜索分类标准
get_brand_list	获取品牌列表
get_qualification_config	获取资质配置
get_saleprop_rule	获取销售属性规则
get_sku_list	获取SKU列表
update_sku_price	更新SKU价格
add_sku_goods_relation	添加SKU商品关系
update_sku_goods_relation	更新SKU商品关系
get_sku_goods_relation	获取SKU商品关系
delete_sku_goods_relation	删除SKU商品关系
manage_stock	库存管理
upload_image	商品图片上传
issue_upload_token	素材上传 token 签发
get_video_list	获取视频列表
delete_video	删除视频
edit_autopass	商品自动通过编辑
update_detail_images	更新商品详情图片
get_detail_page_link	获取商品详情页链接
get_diagnosis	获取商品诊断信息
apply_main_pic_video	申请商品主图视频
delete_main_pic_video	删除商品主图视频
update_shelf_status	更新商品上下架状态
precheck_new_item	新建商品预检
new	新建商品
edit	编辑商品
get_size_chart_group_list	获取尺码表分组列表
add_size_chart_template	添加尺码表模板
delete_size_chart_template	删除尺码表模板
edit_size_chart_template	编辑尺码表模板
get_size_chart_template	获取尺码表模板
get_size_chart_template_list	获取尺码表模板列表
get_size_chart_template_meta	获取尺码表模板元数据
get_deleted_items	获取已删除商品
get_material_detail	获取素材详情
verify_upload_token	验证上传令牌
apply_item_standard	申请商品标准
query_standard_apply	查询标准申请状态
correct_item_standard	纠正商品标准
edit_video_caption	编辑视频字幕
get_video_count	获取视频数量
get_video_info	获取视频信息
delete	删除商品
update_stock	更新商品SKU库存

Functions

list(access_token: str, kwai_item_id: Optional[int] = None, rel_item_id: Optional[int] = None, item_status: Optional[int] = None, item_type: Optional[int] = None, page_number: int = 1, page_size: int = 20, on_offline_status: Optional[int] = None, uid: Optional[int] = None) -> ItemListResponse async

获取商品列表

OpenAPI: open.item.list.get (GET) Java: OpenItemListGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemListGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
kwai_item_id	Optional[int]	快手商品ID（可选）。	None
rel_item_id	Optional[int]	关联商品ID（可选）。	None
item_status	Optional[int]	商品状态（可选）。	None
item_type	Optional[int]	商品类型（可选）。	None
page_number	int	页码，默认 1。	1
page_size	int	页大小，默认 20。	20
on_offline_status	Optional[int]	上下线状态（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemListResponse	ItemListResponse	商品列表与分页信息。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

See Also

docs/开发指南和规则协议/开发文档/API限流说明.md

get(access_token: str, item_id: int, uid: Optional[int] = None) -> ItemGetResponse async

获取商品详情

OpenAPI: open.item.get (GET) Java: OpenItemGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
item_id	int	商品ID（kwaiItemId）。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemGetResponse	ItemGetResponse	商品详情。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_categories(access_token: str, uid: Optional[int] = None) -> ItemCategoryResponse async

获取商品分类

OpenAPI: open.item.category (GET) Java: OpenItemCategoryRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemCategoryRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemCategoryResponse	ItemCategoryResponse	商品分类列表。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_category_config(access_token: str, category_id: Optional[int] = None, uid: Optional[int] = None) -> ItemCategoryConfigResponse async

获取分类配置

OpenAPI: open.item.category.config (GET) Java: OpenItemCategoryConfigRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemCategoryConfigRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	Optional[int]	分类ID（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemCategoryConfigResponse	ItemCategoryConfigResponse	类目配置集合。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_optional_categories(access_token: str, uid: Optional[int] = None) -> ItemOptionalCategoryResponse async

获取可选分类

OpenAPI: open.item.category.optional.get (GET) Java: OpenItemCategoryOptionalGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemCategoryOptionalGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemOptionalCategoryResponse	ItemOptionalCategoryResponse	可选类目列表。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_suggested_categories(access_token: str, item_title: Optional[str] = None, image_urls: Optional[List[str]] = None, item_desc: Optional[str] = None, uid: Optional[int] = None) -> ItemSuggestedCategoryResponse async

获取推荐分类

OpenAPI: open.item.category.suggested.get (GET) Java: OpenItemCategorySuggestedGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemCategorySuggestedGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
item_title	Optional[str]	商品标题（可选）。	None
image_urls	Optional[List[str]]	商品图片URL列表（可选）。	None
item_desc	Optional[str]	商品描述（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSuggestedCategoryResponse	ItemSuggestedCategoryResponse	推荐类目集合。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_category_prop_standard(access_token: str, leaf_category_id: int, uid: Optional[int] = None) -> ItemCategoryPropStandardResponse async

获取分类属性标准

OpenAPI: open.item.category.prop.standard.get (POST) Java: OpenItemCategoryPropStandardGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemCategoryPropStandardGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
leaf_category_id	int	叶子类目ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemCategoryPropStandardResponse	ItemCategoryPropStandardResponse	属性标准列表。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

search_category_prop_values(access_token: str, category_id: int, prop_id: int, prop_value: Optional[str] = None, cursor: Optional[int] = None, limit: Optional[int] = None, uid: Optional[int] = None) -> ItemCategoryPropValueSearchResponse async

搜索分类属性值

OpenAPI: open.item.category.prop.value.search (GET) Java: OpenItemCategoryPropValueSearchRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemCategoryPropValueSearchRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	分类ID。	必需
prop_id	int	属性ID。	必需
prop_value	Optional[str]	属性值搜索关键字（可选）。	None
cursor	Optional[int]	分页游标（可选）。	None
limit	Optional[int]	条数限制（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemCategoryPropValueSearchResponse	ItemCategoryPropValueSearchResponse	属性值分页结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

check_category_standard(access_token: str, leaf_category_id: int, uid: Optional[int] = None) -> ItemCategoryStandardCheckResponse async

检查分类标准

OpenAPI: open.item.category.standard.check (GET) Java: OpenItemCategoryStandardCheckRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemCategoryStandardCheckRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
leaf_category_id	int	叶子类目ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemCategoryStandardCheckResponse	ItemCategoryStandardCheckResponse	标准检查结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

search_category_standard(access_token: str, standard_id: Optional[int] = None, leaf_category_id: Optional[int] = None, standard_key_prop_list: Optional[List[Dict[str, Any]]] = None, uid: Optional[int] = None) -> ItemCategoryStandardSearchResponse async

搜索分类标准

OpenAPI: open.item.category.standard.search (POST) Java: OpenItemCategoryStandardSearchRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemCategoryStandardSearchRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
standard_id	Optional[int]	标准ID（可选）。	None
leaf_category_id	Optional[int]	叶子类目ID（可选）。	None
standard_key_prop_list	Optional[List[Dict[str, Any]]]	关键属性列表（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemCategoryStandardSearchResponse	ItemCategoryStandardSearchResponse	标准信息数据。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_brand_list(access_token: str, cursor: Optional[int] = None, category_id: Optional[int] = None, prop_id: Optional[int] = None, prop_value: Optional[str] = None, uid: Optional[int] = None) -> ItemBrandListResponse async

获取品牌列表

OpenAPI: open.item.brand.list.get (POST) Java: OpenItemBrandListGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemBrandListGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
cursor	Optional[int]	游标（可选）。	None
category_id	Optional[int]	类目ID（可选）。	None
prop_id	Optional[int]	属性ID（可选）。	None
prop_value	Optional[str]	属性值（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemBrandListResponse	ItemBrandListResponse	品牌分页数据。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_qualification_config(access_token: str, category_id: int, uid: Optional[int] = None) -> ItemQualificationConfigResponse async

获取资质配置

OpenAPI: open.item.qualification.collection.config (POST) Java: OpenItemQualificationCollectionConfigRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemQualificationCollectionConfigRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	分类ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemQualificationConfigResponse	ItemQualificationConfigResponse	资质配置集合。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_saleprop_rule(access_token: str, category_id: int, spu_id: Optional[int] = None, item_id: Optional[int] = None, uid: Optional[int] = None) -> ItemSalePropRuleResponse async

获取销售属性规则

OpenAPI: open.item.saleprop.rule (POST) Java: OpenItemSalepropRuleRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSalepropRuleRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	类目ID。	必需
spu_id	Optional[int]	SPU ID（可选）。	None
item_id	Optional[int]	商品ID（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSalePropRuleResponse	ItemSalePropRuleResponse	销售属性规则配置。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_sku_list(access_token: str, kwai_item_id: int, rel_sku_id: Optional[int] = None, sku_status: Optional[int] = None, uid: Optional[int] = None) -> ItemSkuListResponse async

获取SKU列表

OpenAPI: open.item.sku.list.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSkuListGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSkuListGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
kwai_item_id	int	快手商品ID	必需
rel_sku_id	Optional[int]	关联SKU ID（可选）	None
sku_status	Optional[int]	SKU状态（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemSkuListResponse	ItemSkuListResponse	SKU 列表

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

skus = await item_service.get_sku_list(
    access_token="your_token",
    kwai_item_id=12345
)

for sku in skus.result:
    print(f"SKU ID: {sku.sku_id}, 价格: {sku.price_yuan}元, 库存: {sku.stock}")

update_sku_price(access_token: str, item_id: int, sku_id: int, price: int, uid: Optional[int] = None) -> ItemSkuPriceUpdateResponse async

更新SKU价格

OpenAPI: open.item.sku.price.update (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSkuPriceUpdateRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSkuPriceUpdateRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
sku_id	int	SKU ID	必需
price	int	新价格（分）	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemSkuPriceUpdateResponse	ItemSkuPriceUpdateResponse	价格更新结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.update_sku_price(
    access_token="your_token",
    item_id=12345,
    sku_id=67890,
    price=9900  # 99元
)

if result.is_success:
    print("SKU价格更新成功")

add_sku_goods_relation(access_token: str, item_id: int, relations: List[SkuGoodsRelationParam], uid: Optional[int] = None) -> ItemSkuGoodsRelationModifyResponse async

添加SKU商品关系

OpenAPI: open.item.sku.goods.relation.add (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSkuGoodsRelationAddRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSkuGoodsRelationAddRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
relations	List[SkuGoodsRelationParam]	SKU 与三方货品关系列表	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemSkuGoodsRelationModifyResponse	ItemSkuGoodsRelationModifyResponse	修改结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

update_sku_goods_relation(access_token: str, item_id: int, relations: List[SkuGoodsRelationParam], uid: Optional[int] = None) -> ItemSkuGoodsRelationModifyResponse async

更新SKU商品关系

OpenAPI: open.item.sku.goods.relation.update (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSkuGoodsRelationUpdateRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSkuGoodsRelationUpdateRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
relations	List[SkuGoodsRelationParam]	SKU 与三方货品关系列表	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemSkuGoodsRelationModifyResponse	ItemSkuGoodsRelationModifyResponse	修改结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

get_sku_goods_relation(access_token: str, sku_ids: List[int], uid: Optional[int] = None) -> ItemSkuGoodsRelationResponse async

获取SKU商品关系

OpenAPI: open.item.sku.goods.relation.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSkuGoodsRelationGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSkuGoodsRelationGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
sku_ids	List[int]	SKU ID 列表	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemSkuGoodsRelationResponse	ItemSkuGoodsRelationResponse	关系数据

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

delete_sku_goods_relation(access_token: str, item_id: int, relations: List[SkuGoodsRelationParam], update_item_stock_model: Optional[bool] = None, uid: Optional[int] = None) -> ItemSkuGoodsRelationModifyResponse async

删除SKU商品关系

OpenAPI: open.item.sku.goods.relation.delete (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSkuGoodsRelationDeleteRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSkuGoodsRelationDeleteRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
relations	List[SkuGoodsRelationParam]	SKU 与三方货品关系列表	必需
update_item_stock_model	Optional[bool]	是否更新商品库存模型（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemSkuGoodsRelationModifyResponse	ItemSkuGoodsRelationModifyResponse	修改结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

manage_stock(access_token: str, sku_stock_infos: List[SkuStockInfo], seq_no: Optional[str] = None, item_id: Optional[int] = None, category_id: Optional[int] = None, support_negative_stock: Optional[bool] = None, uid: Optional[int] = None) -> ItemStockManageResponse async

库存管理

OpenAPI: open.stock.manage (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenStockManageRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenStockManageRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
sku_stock_infos	List[SkuStockInfo]	SKU 库存操作列表	必需
seq_no	Optional[str]	幂等序列号（可选）	None
item_id	Optional[int]	商品ID（可选）	None
category_id	Optional[int]	类目ID（可选）	None
support_negative_stock	Optional[bool]	是否支持负库存（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemStockManageResponse	ItemStockManageResponse	操作结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

upload_image(access_token: str, upload_type: int, img_url: Optional[str] = None, img_bytes: Optional[bytes] = None, uid: Optional[int] = None) -> ItemImageUploadResponse async

商品图片上传

OpenAPI: open.item.image.upload (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemImageUploadRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemImageUploadRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
upload_type	int	上传类型（1: URL, 2: 文件）	必需
img_url	Optional[str]	图片URL（URL上传时使用）	None
img_bytes	Optional[bytes]	图片字节数据（文件上传时使用）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemImageUploadResponse	ItemImageUploadResponse	图片上传结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

# URL上传
result = await item_service.upload_image(
    access_token="your_token",
    upload_type=1,
    img_url="https://example.com/image.jpg"
)
# 文件上传
with open("image.jpg", "rb") as f:
    img_bytes = f.read()
result = await item_service.upload_image(
    access_token="your_token",
    upload_type=2,
    img_bytes=img_bytes
)

issue_upload_token(access_token: str, material_upload_type: int, file_name: str, file_length: int, uid: Optional[int] = None) -> ItemMaterialUploadTokenIssueResponse async

素材上传 token 签发

OpenAPI: open.item.material.upload.token.issue (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemMaterialUploadTokenIssueRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMaterialUploadTokenIssueRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
material_upload_type	int	素材上传类型	必需
file_name	str	文件名	必需
file_length	int	文件长度	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemMaterialUploadTokenIssueResponse	ItemMaterialUploadTokenIssueResponse	签发结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.issue_upload_token(
    access_token="your_token",
    material_upload_type=1,
    file_name="video.mp4",
    file_length=1024000
)

get_video_list(access_token: str, video_type: Optional[int] = None, aspect_ratio: Optional[int] = None, audit_status: Optional[int] = None, create_time_start: Optional[int] = None, create_time_end: Optional[int] = None, page_index: Optional[int] = None, page_size: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoListResponse async

获取视频列表

OpenAPI: open.item.video.list (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemVideoListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoListRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
video_type	Optional[int]	视频类型（可选）	None
aspect_ratio	Optional[int]	视频宽高比（可选）	None
audit_status	Optional[int]	审核状态（可选）	None
create_time_start	Optional[int]	创建开始时间（毫秒，可选）	None
create_time_end	Optional[int]	创建结束时间（毫秒，可选）	None
page_index	Optional[int]	页码（可选）	None
page_size	Optional[int]	页面大小（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemVideoListResponse	ItemVideoListResponse	视频分页列表

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

delete_video(access_token: str, video_ids: List[str], video_type: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoDeleteResponse async

删除视频

OpenAPI: open.item.video.delete (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemVideoDeleteRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoDeleteRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
video_ids	List[str]	视频ID列表	必需
video_type	Optional[int]	视频类型（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemVideoDeleteResponse	ItemVideoDeleteResponse	删除结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

edit_autopass(access_token: str, item_id: int, purchase_limit: Optional[bool] = None, limit_count: Optional[int] = None, item_remark: Optional[str] = None, sku_list: Optional[List[OpenApiAutoPassSkuDTO]] = None, service_rule: Optional[ServiceRule] = None, express_template_id: Optional[int] = None, sale_time_flag: Optional[bool] = None, time_of_sale: Optional[int] = None, pay_way: Optional[int] = None, uid: Optional[int] = None) -> ItemAutopassEditResponse async

商品自动通过编辑

OpenAPI: open.item.autopass.edit (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemAutopassEditRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemAutopassEditRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
purchase_limit	Optional[bool]	购买限制	None
limit_count	Optional[int]	限制数量	None
item_remark	Optional[str]	商品备注	None
sku_list	Optional[List[OpenApiAutoPassSkuDTO]]	SKU列表	None
service_rule	Optional[ServiceRule]	服务规则	None
express_template_id	Optional[int]	快递模板ID	None
sale_time_flag	Optional[bool]	销售时间标志	None
time_of_sale	Optional[int]	销售时间	None
pay_way	Optional[int]	支付方式	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemAutopassEditResponse	ItemAutopassEditResponse	编辑结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.edit_autopass(
    access_token="your_token",
    item_id=12345,
    purchase_limit=True,
    limit_count=100
)

update_detail_images(access_token: str, kwai_item_id: int, detail_image_urls: List[str], uid: Optional[int] = None) -> ItemDetailImagesUpdateResponse async

更新商品详情图片

OpenAPI: open.item.detail.images.update (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemDetailImagesUpdateRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDetailImagesUpdateRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
kwai_item_id	int	快手商品ID	必需
detail_image_urls	List[str]	详情图片URL列表	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemDetailImagesUpdateResponse	ItemDetailImagesUpdateResponse	更新结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.update_detail_images(
    access_token="your_token",
    kwai_item_id=12345,
    detail_image_urls=[
        "https://example.com/image1.jpg",
        "https://example.com/image2.jpg"
    ]
)

get_detail_page_link(access_token: str, item_id: int, type: int, item_product_client_info: Optional[Dict[str, Any]] = None, uid: Optional[int] = None) -> ItemDetailPageLinkResponse async

获取商品详情页链接

OpenAPI: open.item.detail.page.link (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemDetailPageLinkRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDetailPageLinkRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
type	int	类型	必需
item_product_client_info	Optional[Dict[str, Any]]	商品客户端信息	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemDetailPageLinkResponse	ItemDetailPageLinkResponse	详情页链接

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.get_detail_page_link(
    access_token="your_token",
    item_id=12345,
    type=1
)

get_diagnosis(access_token: str, item_id: int, uid: Optional[int] = None) -> ItemDiagnosisGetResponse async

获取商品诊断信息

OpenAPI: open.item.diagnosis.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemDiagnosisGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDiagnosisGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemDiagnosisGetResponse	ItemDiagnosisGetResponse	诊断信息

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.get_diagnosis(
    access_token="your_token",
    item_id=12345
)

apply_main_pic_video(access_token: str, item_id: int, video_id: str, video_type: int, uid: Optional[int] = None) -> ItemMainPicVideoApplyResponse async

申请商品主图视频

OpenAPI: open.item.main.pic.video.apply (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemMainPicVideoApplyRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMainPicVideoApplyRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
video_id	str	视频ID	必需
video_type	int	视频类型	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemMainPicVideoApplyResponse	ItemMainPicVideoApplyResponse	申请结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.apply_main_pic_video(
    access_token="your_token",
    item_id=12345,
    video_id="video_123",
    video_type=1
)

delete_main_pic_video(access_token: str, item_id: int, uid: Optional[int] = None) -> ItemMainPicVideoDeleteResponse async

删除商品主图视频

OpenAPI: open.item.main.pic.video.delete (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemMainPicVideoDeleteRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMainPicVideoDeleteRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemMainPicVideoDeleteResponse	ItemMainPicVideoDeleteResponse	删除结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.delete_main_pic_video(
    access_token="your_token",
    item_id=12345
)

update_shelf_status(access_token: str, kwai_item_id: int, shelf_status: int, uid: Optional[int] = None) -> ItemShelfStatusUpdateResponse async

更新商品上下架状态

OpenAPI: open.item.shelf.status.update (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemShelfStatusUpdateRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemShelfStatusUpdateRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
kwai_item_id	int	快手商品ID	必需
shelf_status	int	上架状态	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemShelfStatusUpdateResponse	ItemShelfStatusUpdateResponse	更新结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.update_shelf_status(
    access_token="your_token",
    kwai_item_id=12345,
    shelf_status=1  # 1: 上架, 0: 下架
)

precheck_new_item(access_token: str, leaf_category_id: int, uid: Optional[int] = None) -> ItemNewPrecheckResponse async

新建商品预检

OpenAPI: open.item.new.precheck (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemNewPrecheckRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemNewPrecheckRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
leaf_category_id	int	叶子类目ID	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemNewPrecheckResponse	ItemNewPrecheckResponse	预检结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

示例：

result = await item_service.precheck_new_item(
    access_token="your_token",
    leaf_category_id=12345
)

new(access_token: str, title: Optional[str] = None, rel_item_id: Optional[int] = None, category_id: Optional[int] = None, image_urls: Optional[List[str]] = None, sku_list: Optional[List[OpenApiAddSkuDTO]] = None, purchase_limit: Optional[bool] = None, limit_count: Optional[int] = None, item_prop_values: Optional[List[AddItemPropValue]] = None, details: Optional[str] = None, detail_image_urls: Optional[List[str]] = None, stock_partner: Optional[bool] = None, item_remark: Optional[str] = None, service_rule: Optional[ServiceRule] = None, express_template_id: Optional[int] = None, sale_time_flag: Optional[bool] = None, time_of_sale: Optional[int] = None, pay_way: Optional[int] = None, multiple_stock: Optional[bool] = None, poi_ids: Optional[List[int]] = None, white_base_image_url: Optional[str] = None, transparent_image_url: Optional[str] = None, short_title: Optional[str] = None, selling_point: Optional[str] = None, instructions: Optional[str] = None, save_shelf_item_qualification_data: Optional[List[QualificationDataDTO]] = None, off_shore_mode: Optional[int] = None, spu_id: Optional[int] = None, item_video_id: Optional[str] = None, three_quarters_image_urls: Optional[List[str]] = None, item_video: Optional[ItemVideoProto] = None, size_chart_template_id: Optional[int] = None, uid: Optional[int] = None) -> ItemNewResponse async

新建商品

OpenAPI: open.item.new (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemNewRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemNewRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
title	Optional[str]	商品标题（可选）	None
rel_item_id	Optional[int]	关联商品ID（可选）	None
category_id	Optional[int]	分类ID（可选）	None
image_urls	Optional[List[str]]	图片URL列表（可选）	None
sku_list	Optional[List[OpenApiAddSkuDTO]]	SKU 列表（可选）	None
purchase_limit	Optional[bool]	购买限制（可选）	None
limit_count	Optional[int]	限制数量（可选）	None
item_prop_values	Optional[List[AddItemPropValue]]	属性列表（可选）	None
details	Optional[str]	详情描述（可选）	None
detail_image_urls	Optional[List[str]]	详情图片（可选）	None
stock_partner	Optional[bool]	库存合作（可选）	None
item_remark	Optional[str]	备注（可选）	None
service_rule	Optional[ServiceRule]	服务规则（可选）	None
express_template_id	Optional[int]	运费模板ID（可选）	None
sale_time_flag	Optional[bool]	定时上架标记（可选）	None
time_of_sale	Optional[int]	上架时间戳（可选）	None
pay_way	Optional[int]	支付方式（可选）	None
multiple_stock	Optional[bool]	多库存开关（可选）	None
poi_ids	Optional[List[int]]	门店ID列表（可选）	None
white_base_image_url	Optional[str]	白底图（可选）	None
transparent_image_url	Optional[str]	透明图（可选）	None
short_title	Optional[str]	短标题（可选）	None
selling_point	Optional[str]	卖点（可选）	None
instructions	Optional[str]	使用说明（可选）	None
save_shelf_item_qualification_data	Optional[List[QualificationDataDTO]]	资质数据（可选）	None
off_shore_mode	Optional[int]	跨境模式（可选）	None
spu_id	Optional[int]	SPU ID（可选）	None
item_video_id	Optional[str]	视频ID（可选）	None
three_quarters_image_urls	Optional[List[str]]	3/4图（可选）	None
item_video	Optional[ItemVideoProto]	视频对象（可选）	None
size_chart_template_id	Optional[int]	尺码表模板ID（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemNewResponse	ItemNewResponse	新建结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

edit(access_token: str, item_id: int, title: Optional[str] = None, category_id: Optional[int] = None, image_urls: Optional[List[str]] = None, sku_list: Optional[List[OpenApiUpdateSkuDTO]] = None, item_video_id: Optional[str] = None, purchase_limit: Optional[bool] = None, limit_count: Optional[int] = None, item_prop_values: Optional[List[ItemPropValue]] = None, details: Optional[str] = None, detail_image_urls: Optional[List[str]] = None, update_detail_image_urls: Optional[bool] = None, item_remark: Optional[str] = None, service_rule: Optional[ServiceRule] = None, express_template_id: Optional[int] = None, sale_time_flag: Optional[bool] = None, time_of_sale: Optional[int] = None, pay_way: Optional[int] = None, update_item_prop_values: Optional[bool] = None, poi_ids: Optional[List[int]] = None, white_base_image_url: Optional[str] = None, transparent_image_url: Optional[str] = None, short_title: Optional[str] = None, selling_point: Optional[str] = None, instructions: Optional[str] = None, save_shelf_item_qualification_data: Optional[List[QualificationDataDTO]] = None, update_item_qualification: Optional[bool] = None, spu_id: Optional[int] = None, update_three_quarters_image_urls: Optional[bool] = None, three_quarters_image_urls: Optional[List[str]] = None, item_video: Optional[ItemVideoProto] = None, size_chart_template_id: Optional[int] = None, uid: Optional[int] = None) -> ItemEditResponse async

编辑商品

OpenAPI: open.item.edit (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemEditRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemEditRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
title	Optional[str]	商品标题（可选）	None
category_id	Optional[int]	分类ID（可选）	None
image_urls	Optional[List[str]]	图片URL列表（可选）	None
sku_list	Optional[List[OpenApiUpdateSkuDTO]]	SKU 列表（可选）	None
item_video_id	Optional[str]	视频ID（可选）	None
purchase_limit	Optional[bool]	购买限制（可选）	None
limit_count	Optional[int]	限制数量（可选）	None
item_prop_values	Optional[List[ItemPropValue]]	属性列表（可选）	None
details	Optional[str]	详情描述（可选）	None
detail_image_urls	Optional[List[str]]	详情图片（可选）	None
update_detail_image_urls	Optional[bool]	是否更新详情图（可选）	None
item_remark	Optional[str]	备注（可选）	None
service_rule	Optional[ServiceRule]	服务规则（可选）	None
express_template_id	Optional[int]	运费模板ID（可选）	None
sale_time_flag	Optional[bool]	定时上架标记（可选）	None
time_of_sale	Optional[int]	上架时间戳（可选）	None
pay_way	Optional[int]	支付方式（可选）	None
update_item_prop_values	Optional[bool]	是否更新属性（可选）	None
poi_ids	Optional[List[int]]	门店ID列表（可选）	None
white_base_image_url	Optional[str]	白底图（可选）	None
transparent_image_url	Optional[str]	透明图（可选）	None
short_title	Optional[str]	短标题（可选）	None
selling_point	Optional[str]	卖点（可选）	None
instructions	Optional[str]	使用说明（可选）	None
save_shelf_item_qualification_data	Optional[List[QualificationDataDTO]]	资质数据（可选）	None
update_item_qualification	Optional[bool]	是否更新资质（可选）	None
spu_id	Optional[int]	SPU ID（可选）	None
update_three_quarters_image_urls	Optional[bool]	是否更新3/4图（可选）	None
three_quarters_image_urls	Optional[List[str]]	3/4图（可选）	None
item_video	Optional[ItemVideoProto]	视频对象（可选）	None
size_chart_template_id	Optional[int]	尺码表模板ID（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemEditResponse	ItemEditResponse	编辑结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

get_size_chart_group_list(access_token: str, uid: Optional[int] = None) -> ItemSizeChartGroupListGetResponse async

获取尺码表分组列表

OpenAPI: open.item.size.chart.group.list.get (GET) Java: OpenItemSizeChartGroupListGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartGroupListGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartGroupListGetResponse	ItemSizeChartGroupListGetResponse	尺码表分组列表。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

add_size_chart_template(access_token: str, size_chart: AddSizeChartParam, uid: Optional[int] = None) -> ItemSizeChartTemplateAddResponse async

添加尺码表模板

OpenAPI: open.item.size.chart.template.add (POST) Java: OpenItemSizeChartTemplateAddRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateAddRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
size_chart	AddSizeChartParam	尺码表模板数据。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateAddResponse	ItemSizeChartTemplateAddResponse	添加结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

delete_size_chart_template(access_token: str, size_chart_id: int, uid: Optional[int] = None) -> ItemSizeChartTemplateDeleteResponse async

删除尺码表模板

OpenAPI: open.item.size.chart.template.delete (GET) Java: OpenItemSizeChartTemplateDeleteRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateDeleteRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
size_chart_id	int	尺码表模板ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateDeleteResponse	ItemSizeChartTemplateDeleteResponse	删除结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

edit_size_chart_template(access_token: str, size_chart: SizeChartParam, uid: Optional[int] = None) -> ItemSizeChartTemplateEditResponse async

编辑尺码表模板

OpenAPI: open.item.size.chart.template.edit (GET) Java: OpenItemSizeChartTemplateEditRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateEditRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
size_chart	SizeChartParam	尺码表模板数据。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateEditResponse	ItemSizeChartTemplateEditResponse	编辑结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_size_chart_template(access_token: str, size_chart_id: int, uid: Optional[int] = None) -> ItemSizeChartTemplateGetResponse async

获取尺码表模板

OpenAPI: open.item.size.chart.template.get (GET) Java: OpenItemSizeChartTemplateGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
size_chart_id	int	尺码表模板ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateGetResponse	ItemSizeChartTemplateGetResponse	模板详情。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_size_chart_template_list(access_token: str, template_type_prop_value_id: Optional[int] = None, page_num: Optional[int] = 1, page_size: Optional[int] = 20, uid: Optional[int] = None) -> ItemSizeChartTemplateListGetResponse async

获取尺码表模板列表

OpenAPI: open.item.size.chart.template.list.get (GET) Java: OpenItemSizeChartTemplateListGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateListGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
template_type_prop_value_id	Optional[int]	模板类型属性值ID（可选）。	None
page_num	Optional[int]	页码（可选）。	1
page_size	Optional[int]	页面大小（可选）。	20
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateListGetResponse	ItemSizeChartTemplateListGetResponse	模板分页数据。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_size_chart_template_meta(access_token: str, category_id: int, uid: Optional[int] = None) -> ItemSizeChartTemplateMetaGetResponse async

获取尺码表模板元数据

OpenAPI: open.item.size.chart.template.meta.get (GET) Java: OpenItemSizeChartTemplateMetaGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateMetaGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	类目ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateMetaGetResponse	ItemSizeChartTemplateMetaGetResponse	元数据内容。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_deleted_items(access_token: str, item_id: Optional[int] = None, uid: Optional[int] = None) -> ItemDeletedGetResponse async

获取已删除商品

OpenAPI: open.item.deleted.get (GET) Java: OpenItemDeletedGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDeletedGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
item_id	Optional[int]	商品ID（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemDeletedGetResponse	ItemDeletedGetResponse	已删除商品数据。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_material_detail(access_token: str, material_id: int, material_upload_type: Optional[int] = None, uid: Optional[int] = None) -> ItemMaterialDetailGetResponse async

获取素材详情

OpenAPI: open.item.material.detail.get (GET) Java: OpenItemMaterialDetailGetRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMaterialDetailGetRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
material_id	int	素材ID。	必需
material_upload_type	Optional[int]	素材上传类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemMaterialDetailGetResponse	ItemMaterialDetailGetResponse	素材详情。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

verify_upload_token(access_token: str, token: str, material_upload_type: Optional[int] = None, uid: Optional[int] = None) -> ItemMaterialUploadTokenVerifyResponse async

验证上传令牌

OpenAPI: open.item.material.upload.token.verify (POST) Java: OpenItemMaterialUploadTokenVerifyRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMaterialUploadTokenVerifyRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
token	str	上传令牌。	必需
material_upload_type	Optional[int]	素材上传类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemMaterialUploadTokenVerifyResponse	ItemMaterialUploadTokenVerifyResponse	验证结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

apply_item_standard(access_token: str, category_id: int, key_prop_list: Optional[List[KeyPropOpenApiDTO]] = None, spu_prop_list: Optional[List[SPUPropOpenApiDTO]] = None, standard_images: Optional[List[str]] = None, uid: Optional[int] = None) -> ItemStandardApplyResponse async

申请商品标准

OpenAPI: open.item.standard.apply (POST) Java: OpenItemStandardApplyRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemStandardApplyRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	类目ID。	必需
key_prop_list	Optional[List[KeyPropOpenApiDTO]]	关键属性列表（可选）。	None
spu_prop_list	Optional[List[SPUPropOpenApiDTO]]	SPU属性列表（可选）。	None
standard_images	Optional[List[str]]	标准图片URL列表（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemStandardApplyResponse	ItemStandardApplyResponse	申请结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

query_standard_apply(access_token: str, category_id: Optional[List[int]] = None, standard_status: Optional[int] = None, standard_name: Optional[str] = None, apply_type: Optional[int] = None, standard_audit_status: Optional[int] = None, limit: Optional[int] = None, cursor: Optional[int] = None, uid: Optional[int] = None) -> ItemStandardApplyQueryResponse async

查询标准申请状态

OpenAPI: open.item.standard.apply.query (GET) Java: OpenItemStandardApplyQueryRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemStandardApplyQueryRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	Optional[List[int]]	类目ID列表（可选）。	None
standard_status	Optional[int]	标准状态（可选）。	None
standard_name	Optional[str]	标准名称（可选）。	None
apply_type	Optional[int]	申请类型（可选）。	None
standard_audit_status	Optional[int]	标准审核状态（可选）。	None
limit	Optional[int]	限制数量（可选）。	None
cursor	Optional[int]	游标（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemStandardApplyQueryResponse	ItemStandardApplyQueryResponse	申请状态数据。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

correct_item_standard(access_token: str, category_id: int, standard_id: int, key_prop_list: Optional[List[KeyPropOpenApiDTO]] = None, spu_prop_list: Optional[List[SPUPropOpenApiDTO]] = None, modify_reason: Optional[str] = None, modify_image_url: Optional[str] = None, standard_images: Optional[List[str]] = None, uid: Optional[int] = None) -> ItemStandardCorrectResponse async

纠正商品标准

OpenAPI: open.item.standard.correct (POST) Java: OpenItemStandardCorrectRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemStandardCorrectRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	类目ID。	必需
standard_id	int	标准ID。	必需
key_prop_list	Optional[List[KeyPropOpenApiDTO]]	关键属性列表（可选）。	None
spu_prop_list	Optional[List[SPUPropOpenApiDTO]]	SPU属性列表（可选）。	None
modify_reason	Optional[str]	修改原因（可选）。	None
modify_image_url	Optional[str]	修改图片URL（可选）。	None
standard_images	Optional[List[str]]	标准图片URL列表（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemStandardCorrectResponse	ItemStandardCorrectResponse	提交纠正结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

edit_video_caption(access_token: str, video_id: str, caption: str, video_type: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoCaptionEditResponse async

编辑视频字幕

OpenAPI: open.item.video.caption.edit (POST) Java: OpenItemVideoCaptionEditRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoCaptionEditRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
video_id	str	视频ID。	必需
caption	str	字幕内容。	必需
video_type	Optional[int]	视频类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemVideoCaptionEditResponse	ItemVideoCaptionEditResponse	编辑提交结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_video_count(access_token: str, video_type: Optional[int] = None, aspect_ratio: Optional[int] = None, audit_status: Optional[int] = None, create_time_start: Optional[int] = None, create_time_end: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoCountResponse async

获取视频数量

OpenAPI: open.item.video.count (POST) Java: OpenItemVideoCountRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoCountRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
video_type	Optional[int]	视频类型（可选）。	None
aspect_ratio	Optional[int]	视频宽高比（可选）。	None
audit_status	Optional[int]	审核状态（可选）。	None
create_time_start	Optional[int]	创建开始时间（毫秒，可选）。	None
create_time_end	Optional[int]	创建结束时间（毫秒，可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemVideoCountResponse	ItemVideoCountResponse	数量聚合结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_video_info(access_token: str, video_id: str, video_type: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoInfoResponse async

获取视频信息

OpenAPI: open.item.video.info (GET) Java: OpenItemVideoInfoRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoInfoRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
video_id	str	视频ID。	必需
video_type	Optional[int]	视频类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemVideoInfoResponse	ItemVideoInfoResponse	视频详情。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

delete(access_token: str, item_id: int, uid: Optional[int] = None) -> ItemDeleteResponse async

删除商品

OpenAPI: open.item.delete (POST) Java: OpenItemDeleteRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDeleteRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
item_id	int	商品ID（kwaiItemId）。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemDeleteResponse	ItemDeleteResponse	删除结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

update_stock(access_token: str, item_id: int, sku_id: int, stock: int, change_type: Optional[int] = None, uid: Optional[int] = None) -> ItemUpdateStockResponse async

更新商品SKU库存

OpenAPI: open.item.sku.stock.update (POST) Java: OpenItemSkuStockUpdateRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSkuStockUpdateRequest.java

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
item_id	int	商品ID。	必需
sku_id	int	SKU ID。	必需
stock	int	库存数量。	必需
change_type	Optional[int]	变更类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemUpdateStockResponse	ItemUpdateStockResponse	库存更新结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

同步商品服务

kwaixiaodian.client.services.item.SyncItemService(client: SyncBaseClient)

同步商品服务

提供商品创建、更新、查询、库存管理等功能的同步版本。

初始化商品服务

参数：

名称	类型	描述	默认
client	SyncBaseClient	同步基础客户端实例	必需

方法：

名称	描述
list	获取商品列表（同步）
get	获取商品详情（同步）
get_saleprop_rule	获取销售属性规则（同步）
update_stock	更新商品SKU库存（同步）
delete	删除商品（同步）
upload_image	商品图片上传（同步）
issue_upload_token	素材上传 token 签发（同步）
get_video_list	获取视频列表（同步）
delete_video	删除视频（同步）
edit_autopass	商品自动通过编辑（同步）
update_detail_images	更新商品详情图片（同步）
get_detail_page_link	获取商品详情页链接（同步）
get_diagnosis	获取商品诊断信息（同步）
apply_main_pic_video	申请商品主图视频（同步）
delete_main_pic_video	删除商品主图视频（同步）
update_shelf_status	更新商品上下架状态（同步）
precheck_new_item	新建商品预检（同步）
new	新建商品（同步）
edit	编辑商品（同步）
get_size_chart_group_list	获取尺码表分组列表（同步）
add_size_chart_template	添加尺码表模板（同步）
delete_size_chart_template	删除尺码表模板（同步）
edit_size_chart_template	编辑尺码表模板（同步）
get_size_chart_template	获取尺码表模板（同步）
get_size_chart_template_list	获取尺码表模板列表（同步）
get_size_chart_template_meta	获取尺码表模板元数据（同步）
get_deleted_items	获取已删除商品（同步）
get_material_detail	获取素材详情（同步）
verify_upload_token	验证上传令牌（同步）
apply_item_standard	申请商品标准（同步）
query_standard_apply	查询标准申请状态（同步）
correct_item_standard	纠正商品标准（同步）
edit_video_caption	编辑视频字幕（同步）
get_video_count	获取视频数量（同步）
get_video_info	获取视频信息（同步）

Functions

list(access_token: str, kwai_item_id: Optional[int] = None, rel_item_id: Optional[int] = None, item_status: Optional[int] = None, item_type: Optional[int] = None, page_number: int = 1, page_size: int = 20, on_offline_status: Optional[int] = None, uid: Optional[int] = None) -> ItemListResponse

获取商品列表（同步）

OpenAPI: open.item.list.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemListGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemListGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
kwai_item_id	Optional[int]	快手商品ID（可选）	None
rel_item_id	Optional[int]	关联商品ID（可选）	None
item_status	Optional[int]	商品状态（可选）	None
item_type	Optional[int]	商品类型（可选）	None
page_number	int	页码，默认 1	1
page_size	int	页大小，默认 20	20
on_offline_status	Optional[int]	上下线状态（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemListResponse	ItemListResponse	商品列表

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

get(access_token: str, item_id: int, uid: Optional[int] = None) -> ItemGetResponse

获取商品详情（同步）

OpenAPI: open.item.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID（kwaiItemId）	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemGetResponse	ItemGetResponse	商品详情

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

get_saleprop_rule(access_token: str, category_id: int, spu_id: Optional[int] = None, item_id: Optional[int] = None, uid: Optional[int] = None) -> ItemSalePropRuleResponse

获取销售属性规则（同步）

OpenAPI: open.item.saleprop.rule (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSalepropRuleRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSalepropRuleRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
category_id	int	类目ID	必需
spu_id	Optional[int]	SPU ID（可选）	None
item_id	Optional[int]	商品ID（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemSalePropRuleResponse	ItemSalePropRuleResponse	规则配置

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

update_stock(access_token: str, item_id: int, sku_id: int, stock: int, change_type: Optional[int] = None, uid: Optional[int] = None) -> ItemUpdateStockResponse

更新商品SKU库存（同步）

OpenAPI: open.item.sku.stock.update (POST) Java: OpenItemSkuStockUpdateRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSkuStockUpdateRequest.java

delete(access_token: str, item_id: int, uid: Optional[int] = None) -> ItemDeleteResponse

删除商品（同步）

OpenAPI: open.item.delete (POST) Java: OpenItemDeleteRequest Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDeleteRequest.java

upload_image(access_token: str, upload_type: int, img_url: Optional[str] = None, img_bytes: Optional[bytes] = None, uid: Optional[int] = None) -> ItemImageUploadResponse

商品图片上传（同步）

OpenAPI: open.item.image.upload (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemImageUploadRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemImageUploadRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
upload_type	int	上传类型（1: URL, 2: 文件）	必需
img_url	Optional[str]	图片URL（URL上传时使用）	None
img_bytes	Optional[bytes]	图片字节数据（文件上传时使用）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemImageUploadResponse	ItemImageUploadResponse	图片上传结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

issue_upload_token(access_token: str, material_upload_type: int, file_name: str, file_length: int, uid: Optional[int] = None) -> ItemMaterialUploadTokenIssueResponse

素材上传 token 签发（同步）

OpenAPI: open.item.material.upload.token.issue (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemMaterialUploadTokenIssueRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMaterialUploadTokenIssueRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
material_upload_type	int	素材上传类型	必需
file_name	str	文件名	必需
file_length	int	文件长度	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemMaterialUploadTokenIssueResponse	ItemMaterialUploadTokenIssueResponse	签发结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

get_video_list(access_token: str, video_type: Optional[int] = None, aspect_ratio: Optional[int] = None, audit_status: Optional[int] = None, create_time_start: Optional[int] = None, create_time_end: Optional[int] = None, page_index: Optional[int] = None, page_size: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoListResponse

获取视频列表（同步）

OpenAPI: open.item.video.list (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemVideoListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoListRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
video_type	Optional[int]	视频类型（可选）	None
aspect_ratio	Optional[int]	视频宽高比（可选）	None
audit_status	Optional[int]	审核状态（可选）	None
create_time_start	Optional[int]	创建开始时间（毫秒，可选）	None
create_time_end	Optional[int]	创建结束时间（毫秒，可选）	None
page_index	Optional[int]	页码（可选）	None
page_size	Optional[int]	页面大小（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemVideoListResponse	ItemVideoListResponse	视频分页列表

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

delete_video(access_token: str, video_ids: List[str], video_type: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoDeleteResponse

删除视频（同步）

OpenAPI: open.item.video.delete (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemVideoDeleteRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoDeleteRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
video_ids	List[str]	视频ID列表	必需
video_type	Optional[int]	视频类型（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemVideoDeleteResponse	ItemVideoDeleteResponse	删除结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

edit_autopass(access_token: str, item_id: int, purchase_limit: Optional[bool] = None, limit_count: Optional[int] = None, item_remark: Optional[str] = None, sku_list: Optional[List[OpenApiAutoPassSkuDTO]] = None, service_rule: Optional[ServiceRule] = None, express_template_id: Optional[int] = None, sale_time_flag: Optional[bool] = None, time_of_sale: Optional[int] = None, pay_way: Optional[int] = None, uid: Optional[int] = None) -> ItemAutopassEditResponse

商品自动通过编辑（同步）

OpenAPI: open.item.autopass.edit (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemAutopassEditRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemAutopassEditRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
purchase_limit	Optional[bool]	购买限制（可选）	None
limit_count	Optional[int]	限制数量（可选）	None
item_remark	Optional[str]	商品备注（可选）	None
sku_list	Optional[List[OpenApiAutoPassSkuDTO]]	SKU 列表（可选）	None
service_rule	Optional[ServiceRule]	服务规则（可选）	None
express_template_id	Optional[int]	运费模板ID（可选）	None
sale_time_flag	Optional[bool]	定时上架标记（可选）	None
time_of_sale	Optional[int]	上架时间戳（可选）	None
pay_way	Optional[int]	支付方式（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemAutopassEditResponse	ItemAutopassEditResponse	编辑结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

update_detail_images(access_token: str, kwai_item_id: int, detail_image_urls: List[str], uid: Optional[int] = None) -> ItemDetailImagesUpdateResponse

更新商品详情图片（同步）

OpenAPI: open.item.detail.images.update (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemDetailImagesUpdateRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDetailImagesUpdateRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
kwai_item_id	int	快手商品ID	必需
detail_image_urls	List[str]	详情图片URL列表	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemDetailImagesUpdateResponse	ItemDetailImagesUpdateResponse	更新结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

get_detail_page_link(access_token: str, item_id: int, type: int, item_product_client_info: Optional[Dict[str, Any]] = None, uid: Optional[int] = None) -> ItemDetailPageLinkResponse

获取商品详情页链接（同步）

OpenAPI: open.item.detail.page.link (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemDetailPageLinkRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDetailPageLinkRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
type	int	链接类型	必需
item_product_client_info	Optional[Dict[str, Any]]	客户端信息（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemDetailPageLinkResponse	ItemDetailPageLinkResponse	详情链接

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

get_diagnosis(access_token: str, item_id: int, uid: Optional[int] = None) -> ItemDiagnosisGetResponse

获取商品诊断信息（同步）

OpenAPI: open.item.diagnosis.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemDiagnosisGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDiagnosisGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemDiagnosisGetResponse	ItemDiagnosisGetResponse	诊断详情

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

apply_main_pic_video(access_token: str, item_id: int, video_id: str, video_type: int, uid: Optional[int] = None) -> ItemMainPicVideoApplyResponse

申请商品主图视频（同步）

OpenAPI: open.item.main.pic.video.apply (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemMainPicVideoApplyRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMainPicVideoApplyRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
video_id	str	视频ID	必需
video_type	int	视频类型	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemMainPicVideoApplyResponse	ItemMainPicVideoApplyResponse	申请结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

delete_main_pic_video(access_token: str, item_id: int, uid: Optional[int] = None) -> ItemMainPicVideoDeleteResponse

删除商品主图视频（同步）

OpenAPI: open.item.main.pic.video.delete (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemMainPicVideoDeleteRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMainPicVideoDeleteRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemMainPicVideoDeleteResponse	ItemMainPicVideoDeleteResponse	删除结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

update_shelf_status(access_token: str, kwai_item_id: int, shelf_status: int, uid: Optional[int] = None) -> ItemShelfStatusUpdateResponse

更新商品上下架状态（同步）

OpenAPI: open.item.shelf.status.update (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemShelfStatusUpdateRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemShelfStatusUpdateRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
kwai_item_id	int	快手商品ID	必需
shelf_status	int	上下架状态	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemShelfStatusUpdateResponse	ItemShelfStatusUpdateResponse	更新结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

precheck_new_item(access_token: str, leaf_category_id: int, uid: Optional[int] = None) -> ItemNewPrecheckResponse

新建商品预检（同步）

OpenAPI: open.item.new.precheck (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemNewPrecheckRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemNewPrecheckRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
leaf_category_id	int	叶子类目ID	必需
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemNewPrecheckResponse	ItemNewPrecheckResponse	预检结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

new(access_token: str, title: Optional[str] = None, rel_item_id: Optional[int] = None, category_id: Optional[int] = None, image_urls: Optional[List[str]] = None, sku_list: Optional[List[OpenApiAddSkuDTO]] = None, purchase_limit: Optional[bool] = None, limit_count: Optional[int] = None, item_prop_values: Optional[List[AddItemPropValue]] = None, details: Optional[str] = None, detail_image_urls: Optional[List[str]] = None, stock_partner: Optional[bool] = None, item_remark: Optional[str] = None, service_rule: Optional[ServiceRule] = None, express_template_id: Optional[int] = None, sale_time_flag: Optional[bool] = None, time_of_sale: Optional[int] = None, pay_way: Optional[int] = None, multiple_stock: Optional[bool] = None, poi_ids: Optional[List[int]] = None, white_base_image_url: Optional[str] = None, transparent_image_url: Optional[str] = None, short_title: Optional[str] = None, selling_point: Optional[str] = None, instructions: Optional[str] = None, save_shelf_item_qualification_data: Optional[List[QualificationDataDTO]] = None, off_shore_mode: Optional[int] = None, spu_id: Optional[int] = None, item_video_id: Optional[str] = None, three_quarters_image_urls: Optional[List[str]] = None, item_video: Optional[ItemVideoProto] = None, size_chart_template_id: Optional[int] = None, uid: Optional[int] = None) -> ItemNewResponse

新建商品（同步）

OpenAPI: open.item.new (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemNewRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemNewRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
title	Optional[str]	商品标题（可选）	None
rel_item_id	Optional[int]	关联商品ID（可选）	None
category_id	Optional[int]	分类ID（可选）	None
image_urls	Optional[List[str]]	图片URL列表（可选）	None
sku_list	Optional[List[OpenApiAddSkuDTO]]	SKU 列表（可选）	None
purchase_limit	Optional[bool]	购买限制（可选）	None
limit_count	Optional[int]	限制数量（可选）	None
item_prop_values	Optional[List[AddItemPropValue]]	属性列表（可选）	None
details	Optional[str]	详情描述（可选）	None
detail_image_urls	Optional[List[str]]	详情图片（可选）	None
stock_partner	Optional[bool]	库存合作（可选）	None
item_remark	Optional[str]	备注（可选）	None
service_rule	Optional[ServiceRule]	服务规则（可选）	None
express_template_id	Optional[int]	运费模板ID（可选）	None
sale_time_flag	Optional[bool]	定时上架标记（可选）	None
time_of_sale	Optional[int]	上架时间戳（可选）	None
pay_way	Optional[int]	支付方式（可选）	None
multiple_stock	Optional[bool]	多库存开关（可选）	None
poi_ids	Optional[List[int]]	门店ID列表（可选）	None
white_base_image_url	Optional[str]	白底图（可选）	None
transparent_image_url	Optional[str]	透明图（可选）	None
short_title	Optional[str]	短标题（可选）	None
selling_point	Optional[str]	卖点（可选）	None
instructions	Optional[str]	使用说明（可选）	None
save_shelf_item_qualification_data	Optional[List[QualificationDataDTO]]	资质数据（可选）	None
off_shore_mode	Optional[int]	跨境模式（可选）	None
spu_id	Optional[int]	SPU ID（可选）	None
item_video_id	Optional[str]	视频ID（可选）	None
three_quarters_image_urls	Optional[List[str]]	3/4图（可选）	None
item_video	Optional[ItemVideoProto]	视频对象（可选）	None
size_chart_template_id	Optional[int]	尺码表模板ID（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemNewResponse	ItemNewResponse	新建结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

edit(access_token: str, item_id: int, title: Optional[str] = None, category_id: Optional[int] = None, image_urls: Optional[List[str]] = None, sku_list: Optional[List[OpenApiUpdateSkuDTO]] = None, item_video_id: Optional[str] = None, purchase_limit: Optional[bool] = None, limit_count: Optional[int] = None, item_prop_values: Optional[List[ItemPropValue]] = None, details: Optional[str] = None, detail_image_urls: Optional[List[str]] = None, update_detail_image_urls: Optional[bool] = None, item_remark: Optional[str] = None, service_rule: Optional[ServiceRule] = None, express_template_id: Optional[int] = None, sale_time_flag: Optional[bool] = None, time_of_sale: Optional[int] = None, pay_way: Optional[int] = None, update_item_prop_values: Optional[bool] = None, poi_ids: Optional[List[int]] = None, white_base_image_url: Optional[str] = None, transparent_image_url: Optional[str] = None, short_title: Optional[str] = None, selling_point: Optional[str] = None, instructions: Optional[str] = None, save_shelf_item_qualification_data: Optional[List[QualificationDataDTO]] = None, update_item_qualification: Optional[bool] = None, spu_id: Optional[int] = None, update_three_quarters_image_urls: Optional[bool] = None, three_quarters_image_urls: Optional[List[str]] = None, item_video: Optional[ItemVideoProto] = None, size_chart_template_id: Optional[int] = None, uid: Optional[int] = None) -> ItemEditResponse

编辑商品（同步）

OpenAPI: open.item.edit (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemEditRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemEditRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌	必需
item_id	int	商品ID	必需
title	Optional[str]	商品标题（可选）	None
category_id	Optional[int]	分类ID（可选）	None
image_urls	Optional[List[str]]	图片URL列表（可选）	None
sku_list	Optional[List[OpenApiUpdateSkuDTO]]	SKU 列表（可选）	None
item_video_id	Optional[str]	视频ID（可选）	None
purchase_limit	Optional[bool]	购买限制（可选）	None
limit_count	Optional[int]	限制数量（可选）	None
item_prop_values	Optional[List[ItemPropValue]]	属性列表（可选）	None
details	Optional[str]	详情描述（可选）	None
detail_image_urls	Optional[List[str]]	详情图片（可选）	None
update_detail_image_urls	Optional[bool]	是否更新详情图（可选）	None
item_remark	Optional[str]	备注（可选）	None
service_rule	Optional[ServiceRule]	服务规则（可选）	None
express_template_id	Optional[int]	运费模板ID（可选）	None
sale_time_flag	Optional[bool]	定时上架标记（可选）	None
time_of_sale	Optional[int]	上架时间戳（可选）	None
pay_way	Optional[int]	支付方式（可选）	None
update_item_prop_values	Optional[bool]	是否更新属性（可选）	None
poi_ids	Optional[List[int]]	门店ID列表（可选）	None
white_base_image_url	Optional[str]	白底图（可选）	None
transparent_image_url	Optional[str]	透明图（可选）	None
short_title	Optional[str]	短标题（可选）	None
selling_point	Optional[str]	卖点（可选）	None
instructions	Optional[str]	使用说明（可选）	None
save_shelf_item_qualification_data	Optional[List[QualificationDataDTO]]	资质数据（可选）	None
update_item_qualification	Optional[bool]	是否更新资质（可选）	None
spu_id	Optional[int]	SPU ID（可选）	None
update_three_quarters_image_urls	Optional[bool]	是否更新3/4图（可选）	None
three_quarters_image_urls	Optional[List[str]]	3/4图（可选）	None
item_video	Optional[ItemVideoProto]	视频对象（可选）	None
size_chart_template_id	Optional[int]	尺码表模板ID（可选）	None
uid	Optional[int]	用户ID（可选）	None

返回：

名称	类型	描述
ItemEditResponse	ItemEditResponse	编辑结果

引发：

类型	描述
KwaixiaodianAPIError	当开放平台返回错误码或解析失败时抛出

get_size_chart_group_list(access_token: str, uid: Optional[int] = None) -> ItemSizeChartGroupListGetResponse

获取尺码表分组列表（同步）

OpenAPI: open.item.size.chart.group.list.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSizeChartGroupListGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartGroupListGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartGroupListGetResponse	ItemSizeChartGroupListGetResponse	尺码表分组列表。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

add_size_chart_template(access_token: str, size_chart: AddSizeChartParam, uid: Optional[int] = None) -> ItemSizeChartTemplateAddResponse

添加尺码表模板（同步）

OpenAPI: open.item.size.chart.template.add (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSizeChartTemplateAddRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateAddRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
size_chart	AddSizeChartParam	尺码表模板数据。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateAddResponse	ItemSizeChartTemplateAddResponse	添加结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

delete_size_chart_template(access_token: str, size_chart_id: int, uid: Optional[int] = None) -> ItemSizeChartTemplateDeleteResponse

删除尺码表模板（同步）

OpenAPI: open.item.size.chart.template.delete (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSizeChartTemplateDeleteRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateDeleteRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
size_chart_id	int	尺码表模板ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateDeleteResponse	ItemSizeChartTemplateDeleteResponse	删除结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

edit_size_chart_template(access_token: str, size_chart: SizeChartParam, uid: Optional[int] = None) -> ItemSizeChartTemplateEditResponse

编辑尺码表模板（同步）

OpenAPI: open.item.size.chart.template.edit (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSizeChartTemplateEditRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateEditRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
size_chart	SizeChartParam	尺码表模板数据。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateEditResponse	ItemSizeChartTemplateEditResponse	编辑结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_size_chart_template(access_token: str, size_chart_id: int, uid: Optional[int] = None) -> ItemSizeChartTemplateGetResponse

获取尺码表模板（同步）

OpenAPI: open.item.size.chart.template.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSizeChartTemplateGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
size_chart_id	int	尺码表模板ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateGetResponse	ItemSizeChartTemplateGetResponse	模板详情。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_size_chart_template_list(access_token: str, template_type_prop_value_id: Optional[int] = None, page_num: Optional[int] = 1, page_size: Optional[int] = 20, uid: Optional[int] = None) -> ItemSizeChartTemplateListGetResponse

获取尺码表模板列表（同步）

OpenAPI: open.item.size.chart.template.list.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSizeChartTemplateListGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateListGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
template_type_prop_value_id	Optional[int]	模板类型属性值ID（可选）。	None
page_num	Optional[int]	页码（可选，默认 1）。	1
page_size	Optional[int]	页面大小（可选，默认 20）。	20
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateListGetResponse	ItemSizeChartTemplateListGetResponse	模板分页数据。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_size_chart_template_meta(access_token: str, category_id: int, uid: Optional[int] = None) -> ItemSizeChartTemplateMetaGetResponse

获取尺码表模板元数据（同步）

OpenAPI: open.item.size.chart.template.meta.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemSizeChartTemplateMetaGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemSizeChartTemplateMetaGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	类目ID。	必需
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemSizeChartTemplateMetaGetResponse	ItemSizeChartTemplateMetaGetResponse	元数据内容。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_deleted_items(access_token: str, item_id: Optional[int] = None, uid: Optional[int] = None) -> ItemDeletedGetResponse

获取已删除商品（同步）

OpenAPI: open.item.deleted.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemDeletedGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemDeletedGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
item_id	Optional[int]	商品ID（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemDeletedGetResponse	ItemDeletedGetResponse	已删除商品数据。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_material_detail(access_token: str, material_id: int, material_upload_type: Optional[int] = None, uid: Optional[int] = None) -> ItemMaterialDetailGetResponse

获取素材详情（同步）

OpenAPI: open.item.material.detail.get (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemMaterialDetailGetRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMaterialDetailGetRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
material_id	int	素材ID。	必需
material_upload_type	Optional[int]	素材上传类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemMaterialDetailGetResponse	ItemMaterialDetailGetResponse	素材详情。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

verify_upload_token(access_token: str, token: str, material_upload_type: Optional[int] = None, uid: Optional[int] = None) -> ItemMaterialUploadTokenVerifyResponse

验证上传令牌（同步）

OpenAPI: open.item.material.upload.token.verify (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemMaterialUploadTokenVerifyRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemMaterialUploadTokenVerifyRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
token	str	上传令牌。	必需
material_upload_type	Optional[int]	素材上传类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemMaterialUploadTokenVerifyResponse	ItemMaterialUploadTokenVerifyResponse	验证结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

apply_item_standard(access_token: str, category_id: int, key_prop_list: Optional[List[KeyPropOpenApiDTO]] = None, spu_prop_list: Optional[List[SPUPropOpenApiDTO]] = None, standard_images: Optional[List[str]] = None, uid: Optional[int] = None) -> ItemStandardApplyResponse

申请商品标准（同步）

OpenAPI: open.item.standard.apply (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemStandardApplyRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemStandardApplyRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	类目ID。	必需
key_prop_list	Optional[List[KeyPropOpenApiDTO]]	关键属性列表（可选）。	None
spu_prop_list	Optional[List[SPUPropOpenApiDTO]]	SPU属性列表（可选）。	None
standard_images	Optional[List[str]]	标准图片URL列表（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemStandardApplyResponse	ItemStandardApplyResponse	申请结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

query_standard_apply(access_token: str, category_id: Optional[List[int]] = None, standard_status: Optional[int] = None, standard_name: Optional[str] = None, apply_type: Optional[int] = None, standard_audit_status: Optional[int] = None, limit: Optional[int] = None, cursor: Optional[int] = None, uid: Optional[int] = None) -> ItemStandardApplyQueryResponse

查询标准申请状态（同步）

OpenAPI: open.item.standard.apply.query (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemStandardApplyQueryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemStandardApplyQueryRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	Optional[List[int]]	类目ID列表（可选）。	None
standard_status	Optional[int]	标准状态（可选）。	None
standard_name	Optional[str]	标准名称（可选）。	None
apply_type	Optional[int]	申请类型（可选）。	None
standard_audit_status	Optional[int]	标准审核状态（可选）。	None
limit	Optional[int]	限制数量（可选）。	None
cursor	Optional[int]	游标（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemStandardApplyQueryResponse	ItemStandardApplyQueryResponse	申请状态数据。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

correct_item_standard(access_token: str, category_id: int, standard_id: int, key_prop_list: Optional[List[KeyPropOpenApiDTO]] = None, spu_prop_list: Optional[List[SPUPropOpenApiDTO]] = None, modify_reason: Optional[str] = None, modify_image_url: Optional[str] = None, standard_images: Optional[List[str]] = None, uid: Optional[int] = None) -> ItemStandardCorrectResponse

纠正商品标准（同步）

OpenAPI: open.item.standard.correct (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemStandardCorrectRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemStandardCorrectRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
category_id	int	类目ID。	必需
standard_id	int	标准ID。	必需
key_prop_list	Optional[List[KeyPropOpenApiDTO]]	关键属性列表（可选）。	None
spu_prop_list	Optional[List[SPUPropOpenApiDTO]]	SPU属性列表（可选）。	None
modify_reason	Optional[str]	修改原因（可选）。	None
modify_image_url	Optional[str]	修改图片URL（可选）。	None
standard_images	Optional[List[str]]	标准图片URL列表（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemStandardCorrectResponse	ItemStandardCorrectResponse	提交纠正结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

edit_video_caption(access_token: str, video_id: str, caption: str, video_type: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoCaptionEditResponse

编辑视频字幕（同步）

OpenAPI: open.item.video.caption.edit (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemVideoCaptionEditRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoCaptionEditRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
video_id	str	视频ID。	必需
caption	str	字幕内容。	必需
video_type	Optional[int]	视频类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemVideoCaptionEditResponse	ItemVideoCaptionEditResponse	编辑提交结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_video_count(access_token: str, video_type: Optional[int] = None, aspect_ratio: Optional[int] = None, audit_status: Optional[int] = None, create_time_start: Optional[int] = None, create_time_end: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoCountResponse

获取视频数量（同步）

OpenAPI: open.item.video.count (POST) Java: com.kuaishou.merchant.open.api.request.item.OpenItemVideoCountRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoCountRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
video_type	Optional[int]	视频类型（可选）。	None
aspect_ratio	Optional[int]	视频宽高比（可选）。	None
audit_status	Optional[int]	审核状态（可选）。	None
create_time_start	Optional[int]	创建开始时间（毫秒，可选）。	None
create_time_end	Optional[int]	创建结束时间（毫秒，可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemVideoCountResponse	ItemVideoCountResponse	数量聚合结果。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

get_video_info(access_token: str, video_id: str, video_type: Optional[int] = None, uid: Optional[int] = None) -> ItemVideoInfoResponse

获取视频信息（同步）

OpenAPI: open.item.video.info (GET) Java: com.kuaishou.merchant.open.api.request.item.OpenItemVideoInfoRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/item/OpenItemVideoInfoRequest.java)

参数：

名称	类型	描述	默认
access_token	str	访问令牌。	必需
video_id	str	视频ID。	必需
video_type	Optional[int]	视频类型（可选）。	None
uid	Optional[int]	可选用户ID（最后一个可选参数）。	None

返回：

名称	类型	描述
ItemVideoInfoResponse	ItemVideoInfoResponse	视频详情。

引发：

类型	描述
KwaixiaodianAPIError	平台返回错误或响应解析失败。

商品数据模型

kwaixiaodian.models.item

商品相关数据模型

类：

名称	描述
ItemSpec	商品规格
ItemSku	商品SKU
ItemCategory	商品类目
Item	商品信息
ItemListRequest	商品列表查询请求（对齐 Java: open.item.list.get）
ItemListResponse	商品列表响应
ItemGetRequest	商品详情查询请求
ItemGetResponse	商品详情响应
ItemUpdateStockRequest	商品SKU库存更新请求
ItemUpdateStockResponse	商品库存更新响应
ItemDeleteRequest	商品删除请求
ItemDeleteResponse	商品删除响应
ItemCategoryRequest	获取商品分类请求
ItemCategoryResponse	获取商品分类响应
CategoryConfig	分类配置信息
ItemCategoryConfigRequest	获取分类配置请求
ItemCategoryConfigResponse	获取分类配置响应
ItemOptionalCategoryRequest	获取可选分类请求
ItemOptionalCategoryResponse	获取可选分类响应
SuggestedCategory	推荐分类
ItemSuggestedCategoryRequest	获取推荐分类请求
ItemSuggestedCategoryResponse	获取推荐分类响应
PropStandard	属性标准
ItemCategoryPropStandardRequest	获取分类属性标准请求
ItemCategoryPropStandardResponse	获取分类属性标准响应
PropValue	属性值
ItemCategoryPropValueSearchRequest	搜索分类属性值请求
ItemCategoryPropValueSearchResponse	搜索分类属性值响应
StandardCheckResult	标准检查结果
ItemCategoryStandardCheckRequest	检查分类标准请求
ItemCategoryStandardCheckResponse	检查分类标准响应
CategoryStandard	分类标准
StandardKeyProp	标准关键属性（Java: StandardKeyProp）
ItemCategoryStandardSearchRequest	搜索分类标准请求（对齐 Java）
ItemCategoryStandardSearchResponse	搜索分类标准响应（data: StandardInfoForOpenApiDTO）
Brand	品牌信息
ItemBrandListRequest	获取品牌列表请求
ItemBrandListResponse	获取品牌列表响应
QualificationConfig	资质配置
ItemQualificationConfigRequest	获取资质配置请求
ItemQualificationConfigResponse	获取资质配置响应
SalePropRule	销售属性规则
ItemSalePropRuleRequest	获取销售属性规则请求（Java: OpenItemSalepropRuleRequest）
ItemSalePropRuleResponse	获取销售属性规则响应（data: OpenApiSalePropConfigModelProto）
ItemSkuListRequest	获取SKU列表请求
ItemSkuListResponse	获取SKU列表响应
ItemSkuPriceUpdateRequest	更新SKU价格请求
ItemSkuPriceUpdateResponse	更新SKU价格响应
SkuGoodsRelationParam	SKU与商品关系参数（Java: SkuGoodsRelationParam）
ItemSkuGoodsRelationAddRequest	添加SKU商品关系请求
ItemSkuGoodsRelationUpdateRequest	更新SKU商品关系请求
ItemSkuGoodsRelationGetRequest	获取SKU商品关系请求
ItemSkuGoodsRelationDeleteRequest	删除SKU商品关系请求
SkuGoodsRelationDTO	SKU商品关系（Java: SkuGoodsRelationDTO）
ItemSkuGoodsRelationResponse	SKU商品关系响应
ItemSkuGoodsRelationModifyResponse	SKU商品关系修改响应
SkuStockInfo	SKU库存信息（Java: SkuStockInfo）
ItemStockManageRequest	库存管理请求（对齐 Java: open.stock.manage）
ItemStockManageResponse	库存管理响应
ItemImageUploadRequest	商品图片上传请求
ItemImageUploadResponse	商品图片上传响应
ItemMaterialUploadTokenIssueRequest	申请上传凭证请求
UploadToken	上传凭证
ItemMaterialUploadTokenIssueResponse	申请上传凭证响应
ItemMaterialUploadTokenVerifyRequest	验证上传凭证请求
ItemMaterialUploadTokenVerifyResponse	验证上传凭证响应
ItemMaterialDetailGetRequest	获取素材详情请求
MaterialDetail	素材详情
ItemMaterialDetailGetResponse	获取素材详情响应
ItemVideoListRequest	获取视频列表请求
VideoInfo	视频信息
ItemVideoListResponse	获取视频列表响应
ItemVideoDeleteRequest	删除视频请求
ItemVideoDeleteResponse	删除视频响应
ItemAutopassEditRequest	商品自动通过编辑请求
ItemAutopassEditResponse	商品自动通过编辑响应
ItemDetailImagesUpdateRequest	商品详情图片更新请求
ItemDetailImagesUpdateResponse	商品详情图片更新响应
ItemDetailPageLinkRequest	商品详情页链接请求
ItemDetailPageLinkResponse	商品详情页链接响应
ItemDiagnosisGetRequest	商品诊断获取请求
ItemDiagnosisGetResponse	商品诊断获取响应
ItemMainPicVideoApplyRequest	商品主图视频申请请求
ItemMainPicVideoApplyResponse	商品主图视频申请响应
ItemMainPicVideoDeleteRequest	商品主图视频删除请求
ItemMainPicVideoDeleteResponse	商品主图视频删除响应
ItemShelfStatusUpdateRequest	商品上下架状态更新请求
ItemShelfStatusUpdateResponse	商品上下架状态更新响应
ItemNewPrecheckRequest	商品新建预检请求
ItemNewPrecheckResponse	商品新建预检响应
ItemSizeChartGroupListGetRequest	获取尺码表分组列表请求
ItemSizeChartGroupListGetResponse	获取尺码表分组列表响应
SizeChartUnit	尺码表单元定义（Java: SizeChartUnit）
SizeChartUnitList	尺码表行（Java: SizeChartUnitList）
SizeChartTable	尺码表数据（Java: SizeChartTable）
AddSizeChartParam	添加尺码表参数
ItemSizeChartTemplateAddRequest	添加尺码表模板请求
ItemSizeChartTemplateAddResponse	添加尺码表模板响应
ItemSizeChartTemplateDeleteRequest	删除尺码表模板请求
ItemSizeChartTemplateDeleteResponse	删除尺码表模板响应
SizeChartParam	尺码表参数
ItemSizeChartTemplateEditRequest	编辑尺码表模板请求
ItemSizeChartTemplateEditResponse	编辑尺码表模板响应
ItemSizeChartTemplateGetRequest	获取尺码表模板请求
ItemSizeChartTemplateGetResponse	获取尺码表模板响应
ItemSizeChartTemplateListGetRequest	获取尺码表模板列表请求
ItemSizeChartTemplateListGetResponse	获取尺码表模板列表响应
ItemSizeChartTemplateMetaGetRequest	获取尺码表模板元数据请求
ItemSizeChartTemplateMetaGetResponse	获取尺码表模板元数据响应
ItemDeletedGetRequest	获取已删除商品请求
ItemDeletedGetResponse	获取已删除商品响应
KeyPropOpenApiDTO	关键属性DTO
SPUPropOpenApiDTO	SPU属性DTO
ItemStandardApplyRequest	申请商品标准请求
ItemStandardApplyResponse	申请商品标准响应
ItemStandardApplyQueryRequest	查询标准申请状态请求
ItemStandardApplyQueryResponse	查询标准申请状态响应
ItemStandardCorrectRequest	纠正商品标准请求
ItemStandardCorrectResponse	纠正商品标准响应
ItemVideoCaptionEditRequest	编辑视频字幕请求
ItemVideoCaptionEditResponse	编辑视频字幕响应
ItemVideoCountRequest	获取视频数量请求
ItemVideoCountResponse	获取视频数量响应
ItemVideoInfoRequest	获取视频信息请求
ItemVideoInfoResponse	获取视频信息响应
OpenapiSkuPropMeasureValueProto	SKU规格度量值（Java: OpenapiSkuPropMeasureValueProto）
OpenapiSkuPropMeasureProto	SKU规格度量（Java: OpenapiSkuPropMeasureProto）
OpenApiAddSkuPropDTO	新增SKU属性（Java: OpenApiAddSkuPropDTO）
MealContentDTO	套餐内容（Java: MealContentDTO）
MealGroupDTO	套餐分组（Java: MealGroupDTO）
MealDetailDTO	套餐详情（Java: MealDetailDTO）
SkuCertificatePropParam	二手/认证属性（Java: SkuCertificatePropParam）
OpenApiAutoPassSkuDTO	自动通过编辑SKU（Java: OpenApiAutoPassSkuDTO）
OpenApiAddSkuDTO	新增SKU（Java: OpenApiAddSkuDTO）
OpenApiUpdateSkuDTO	编辑SKU（Java: OpenApiUpdateSkuDTO）
CategoryPropValueParam	类目属性值（Java: CategoryPropValueParam）
DateRangeParam	时间范围（Java: DateRangeParam）
ItemPropValue	编辑场景的商品属性（Java: ItemPropValue）
AddItemPropValue	新增场景的商品属性（Java: AddItemPropValue）
QualificationDataDTO	资质数据（Java: QualificationDataDTO）
OpenApiTimeRange	不可售时间段（Java: OpenApiTimeRange）
OpenApiUnavailableTimeRule	不可售时间规则（Java: OpenApiUnavailableTimeRule）
OpenApiServicePromise	服务承诺（Java: OpenApiServicePromise）
CustomerInfo	客户信息（Java: CustomerInfo）
ServiceRule	服务规则（Java: ServiceRule）
ItemVideoProto	商品视频（Java: ItemVideoProto）
ItemNewRequest	新建商品（对齐 Java: open.item.new）
ItemNewResponse	新建商品响应
ItemEditRequest	编辑商品（对齐 Java: open.item.edit）
ItemEditResponse	编辑商品响应

Classes

ItemSpec

Bases: BaseModel

商品规格

ItemSku

Bases: BaseModel

商品SKU

属性：

名称	类型	描述
price_yuan	float	价格（元）
original_price_yuan	Optional[float]	原价（元）
spec_text	str	规格文本描述

Attributes

price_yuan: float property

价格（元）

original_price_yuan: Optional[float] property

原价（元）

spec_text: str property

规格文本描述

ItemCategory

Bases: BaseModel

商品类目

Item

Bases: BaseModel

商品信息

属性：

名称	类型	描述
price_yuan	float	价格（元）
original_price_yuan	Optional[float]	原价（元）
is_multi_sku	bool	是否多SKU商品
is_in_stock	bool	是否有库存

Attributes

price_yuan: float property

价格（元）

original_price_yuan: Optional[float] property

原价（元）

is_multi_sku: bool property

是否多SKU商品

is_in_stock: bool property

是否有库存

ItemListRequest

Bases: BaseRequest

商品列表查询请求（对齐 Java: open.item.list.get）

ItemListResponse

Bases: BaseResponse[List[Item]]

商品列表响应

ItemGetRequest

Bases: BaseRequest

商品详情查询请求

ItemGetResponse

Bases: BaseResponse[Item]

商品详情响应

ItemUpdateStockRequest

Bases: BaseRequest

商品SKU库存更新请求

对应 Java: OpenItemSkuStockUpdateRequest -> open.item.sku.stock.update

ItemUpdateStockResponse

Bases: BaseResponse[Dict[str, Any]]

商品库存更新响应

ItemDeleteRequest

Bases: BaseRequest

商品删除请求

ItemDeleteResponse

Bases: BaseResponse[Dict[str, Any]]

商品删除响应

ItemCategoryRequest

Bases: BaseRequest

获取商品分类请求

ItemCategoryResponse

Bases: BaseResponse[List[ItemCategory]]

获取商品分类响应

CategoryConfig

Bases: BaseModel

分类配置信息

ItemCategoryConfigRequest

Bases: BaseRequest

获取分类配置请求

ItemCategoryConfigResponse

Bases: BaseResponse[List[CategoryConfig]]

获取分类配置响应

ItemOptionalCategoryRequest

Bases: BaseRequest

获取可选分类请求

ItemOptionalCategoryResponse

Bases: BaseResponse[List[ItemCategory]]

获取可选分类响应

SuggestedCategory

Bases: BaseModel

推荐分类

ItemSuggestedCategoryRequest

Bases: BaseRequest

获取推荐分类请求

ItemSuggestedCategoryResponse

Bases: BaseResponse[List[SuggestedCategory]]

获取推荐分类响应

PropStandard

Bases: BaseModel

属性标准

ItemCategoryPropStandardRequest

Bases: BaseRequest

获取分类属性标准请求

ItemCategoryPropStandardResponse

Bases: BaseResponse[List[PropStandard]]

获取分类属性标准响应

PropValue

Bases: BaseModel

属性值

ItemCategoryPropValueSearchRequest

Bases: BaseRequest

搜索分类属性值请求

ItemCategoryPropValueSearchResponse(**data)

Bases: PagedResponse[PropValue]

搜索分类属性值响应

StandardCheckResult

Bases: BaseModel

标准检查结果

ItemCategoryStandardCheckRequest

Bases: BaseRequest

检查分类标准请求

ItemCategoryStandardCheckResponse

Bases: BaseResponse[StandardCheckResult]

检查分类标准响应

CategoryStandard

Bases: BaseModel

分类标准

StandardKeyProp

Bases: BaseModel

标准关键属性（Java: StandardKeyProp）

ItemCategoryStandardSearchRequest

Bases: BaseRequest

搜索分类标准请求（对齐 Java）

ItemCategoryStandardSearchResponse

Bases: BaseResponse[Dict[str, Any]]

搜索分类标准响应（data: StandardInfoForOpenApiDTO）

Brand

Bases: BaseModel

品牌信息

ItemBrandListRequest

Bases: BaseRequest

获取品牌列表请求

ItemBrandListResponse(**data)

Bases: PagedResponse[Brand]

获取品牌列表响应

QualificationConfig

Bases: BaseModel

资质配置

ItemQualificationConfigRequest

Bases: BaseRequest

获取资质配置请求

ItemQualificationConfigResponse

Bases: BaseResponse[List[QualificationConfig]]

获取资质配置响应

SalePropRule

Bases: BaseModel

销售属性规则

ItemSalePropRuleRequest

Bases: BaseRequest

获取销售属性规则请求（Java: OpenItemSalepropRuleRequest）

ItemSalePropRuleResponse

Bases: BaseResponse[Dict[str, Any]]

获取销售属性规则响应（data: OpenApiSalePropConfigModelProto）

ItemSkuListRequest

Bases: BaseRequest

获取SKU列表请求

ItemSkuListResponse

Bases: BaseResponse[List[ItemSku]]

获取SKU列表响应

ItemSkuPriceUpdateRequest

Bases: BaseRequest

更新SKU价格请求

ItemSkuPriceUpdateResponse

Bases: BaseResponse[Dict[str, Any]]

更新SKU价格响应

SkuGoodsRelationParam

Bases: BaseModel

SKU与商品关系参数（Java: SkuGoodsRelationParam）

ItemSkuGoodsRelationAddRequest

Bases: BaseRequest

添加SKU商品关系请求

ItemSkuGoodsRelationUpdateRequest

Bases: BaseRequest

更新SKU商品关系请求

ItemSkuGoodsRelationGetRequest

Bases: BaseRequest

获取SKU商品关系请求

ItemSkuGoodsRelationDeleteRequest

Bases: BaseRequest

删除SKU商品关系请求

SkuGoodsRelationDTO

Bases: BaseModel

SKU商品关系（Java: SkuGoodsRelationDTO）

ItemSkuGoodsRelationResponse

Bases: BaseResponse[List[SkuGoodsRelationDTO]]

SKU商品关系响应

ItemSkuGoodsRelationModifyResponse

Bases: BaseResponse[Dict[str, Any]]

SKU商品关系修改响应

SkuStockInfo

Bases: BaseModel

SKU库存信息（Java: SkuStockInfo）

ItemStockManageRequest

Bases: BaseRequest

库存管理请求（对齐 Java: open.stock.manage）

ItemStockManageResponse

Bases: BaseResponse[Dict[str, Any]]

库存管理响应

ItemImageUploadRequest

Bases: BaseRequest

商品图片上传请求

ItemImageUploadResponse

Bases: BaseResponse[Dict[str, Any]]

商品图片上传响应

ItemMaterialUploadTokenIssueRequest

Bases: BaseRequest

申请上传凭证请求

UploadToken

Bases: BaseModel

上传凭证

ItemMaterialUploadTokenIssueResponse

Bases: BaseResponse[UploadToken]

申请上传凭证响应

ItemMaterialUploadTokenVerifyRequest

Bases: BaseRequest

验证上传凭证请求

ItemMaterialUploadTokenVerifyResponse

Bases: BaseResponse[Dict[str, Any]]

验证上传凭证响应

ItemMaterialDetailGetRequest

Bases: BaseRequest

获取素材详情请求

MaterialDetail

Bases: BaseModel

素材详情

ItemMaterialDetailGetResponse

Bases: BaseResponse[MaterialDetail]

获取素材详情响应

ItemVideoListRequest

Bases: BaseRequest

获取视频列表请求

VideoInfo

Bases: BaseModel

视频信息

ItemVideoListResponse(**data)

Bases: PagedResponse[VideoInfo]

获取视频列表响应

ItemVideoDeleteRequest

Bases: BaseRequest

删除视频请求

ItemVideoDeleteResponse

Bases: BaseResponse[Dict[str, Any]]

删除视频响应

ItemAutopassEditRequest

Bases: BaseRequest

商品自动通过编辑请求

ItemAutopassEditResponse

Bases: BaseResponse[Dict[str, Any]]

商品自动通过编辑响应

ItemDetailImagesUpdateRequest

Bases: BaseRequest

商品详情图片更新请求

ItemDetailImagesUpdateResponse

Bases: BaseResponse[Dict[str, Any]]

商品详情图片更新响应

ItemDetailPageLinkRequest

Bases: BaseRequest

商品详情页链接请求

ItemDetailPageLinkResponse

Bases: BaseResponse[Dict[str, Any]]

商品详情页链接响应

ItemDiagnosisGetRequest

Bases: BaseRequest

商品诊断获取请求

ItemDiagnosisGetResponse

Bases: BaseResponse[Dict[str, Any]]

商品诊断获取响应

ItemMainPicVideoApplyRequest

Bases: BaseRequest

商品主图视频申请请求

ItemMainPicVideoApplyResponse

Bases: BaseResponse[Dict[str, Any]]

商品主图视频申请响应

ItemMainPicVideoDeleteRequest

Bases: BaseRequest

商品主图视频删除请求

ItemMainPicVideoDeleteResponse

Bases: BaseResponse[Dict[str, Any]]

商品主图视频删除响应

ItemShelfStatusUpdateRequest

Bases: BaseRequest

商品上下架状态更新请求

ItemShelfStatusUpdateResponse

Bases: BaseResponse[Dict[str, Any]]

商品上下架状态更新响应

ItemNewPrecheckRequest

Bases: BaseRequest

商品新建预检请求

ItemNewPrecheckResponse

Bases: BaseResponse[Dict[str, Any]]

商品新建预检响应

ItemSizeChartGroupListGetRequest

Bases: BaseRequest

获取尺码表分组列表请求

ItemSizeChartGroupListGetResponse

Bases: BaseResponse[List[Dict[str, Any]]]

获取尺码表分组列表响应

SizeChartUnit

Bases: BaseModel

尺码表单元定义（Java: SizeChartUnit）

SizeChartUnitList

Bases: BaseModel

尺码表行（Java: SizeChartUnitList）

SizeChartTable

Bases: BaseModel

尺码表数据（Java: SizeChartTable）

AddSizeChartParam

Bases: BaseModel

添加尺码表参数

ItemSizeChartTemplateAddRequest

Bases: BaseRequest

添加尺码表模板请求

ItemSizeChartTemplateAddResponse

Bases: BaseResponse[Dict[str, Any]]

添加尺码表模板响应

ItemSizeChartTemplateDeleteRequest

Bases: BaseRequest

删除尺码表模板请求

ItemSizeChartTemplateDeleteResponse

Bases: BaseResponse[Dict[str, Any]]

删除尺码表模板响应

SizeChartParam

Bases: BaseModel

尺码表参数

ItemSizeChartTemplateEditRequest

Bases: BaseRequest

编辑尺码表模板请求

ItemSizeChartTemplateEditResponse

Bases: BaseResponse[Dict[str, Any]]

编辑尺码表模板响应

ItemSizeChartTemplateGetRequest

Bases: BaseRequest

获取尺码表模板请求

ItemSizeChartTemplateGetResponse

Bases: BaseResponse[Dict[str, Any]]

获取尺码表模板响应

ItemSizeChartTemplateListGetRequest

Bases: BaseRequest

获取尺码表模板列表请求

ItemSizeChartTemplateListGetResponse(**data)

Bases: PagedResponse[Dict[str, Any]]

获取尺码表模板列表响应

ItemSizeChartTemplateMetaGetRequest

Bases: BaseRequest

获取尺码表模板元数据请求

ItemSizeChartTemplateMetaGetResponse

Bases: BaseResponse[Dict[str, Any]]

获取尺码表模板元数据响应

ItemDeletedGetRequest

Bases: BaseRequest

获取已删除商品请求

ItemDeletedGetResponse

Bases: BaseResponse[Dict[str, Any]]

获取已删除商品响应

KeyPropOpenApiDTO

Bases: BaseModel

关键属性DTO

SPUPropOpenApiDTO

Bases: BaseModel

SPU属性DTO

ItemStandardApplyRequest

Bases: BaseRequest

申请商品标准请求

ItemStandardApplyResponse

Bases: BaseResponse[Dict[str, Any]]

申请商品标准响应

ItemStandardApplyQueryRequest

Bases: BaseRequest

查询标准申请状态请求

ItemStandardApplyQueryResponse

Bases: BaseResponse[List[Dict[str, Any]]]

查询标准申请状态响应

ItemStandardCorrectRequest

Bases: BaseRequest

纠正商品标准请求

ItemStandardCorrectResponse

Bases: BaseResponse[Dict[str, Any]]

纠正商品标准响应

ItemVideoCaptionEditRequest

Bases: BaseRequest

编辑视频字幕请求

ItemVideoCaptionEditResponse

Bases: BaseResponse[Dict[str, Any]]

编辑视频字幕响应

ItemVideoCountRequest

Bases: BaseRequest

获取视频数量请求

ItemVideoCountResponse

Bases: BaseResponse[Dict[str, Any]]

获取视频数量响应

ItemVideoInfoRequest

Bases: BaseRequest

获取视频信息请求

ItemVideoInfoResponse

Bases: BaseResponse[VideoInfo]

获取视频信息响应

OpenapiSkuPropMeasureValueProto

Bases: BaseModel

SKU规格度量值（Java: OpenapiSkuPropMeasureValueProto）

OpenapiSkuPropMeasureProto

Bases: BaseModel

SKU规格度量（Java: OpenapiSkuPropMeasureProto）

OpenApiAddSkuPropDTO

Bases: BaseModel

新增SKU属性（Java: OpenApiAddSkuPropDTO）

MealContentDTO

Bases: BaseModel

套餐内容（Java: MealContentDTO）

MealGroupDTO

Bases: BaseModel

套餐分组（Java: MealGroupDTO）

MealDetailDTO

Bases: BaseModel

套餐详情（Java: MealDetailDTO）

SkuCertificatePropParam

Bases: BaseModel

二手/认证属性（Java: SkuCertificatePropParam）

OpenApiAutoPassSkuDTO

Bases: BaseModel

自动通过编辑SKU（Java: OpenApiAutoPassSkuDTO）

OpenApiAddSkuDTO

Bases: BaseModel

新增SKU（Java: OpenApiAddSkuDTO）

OpenApiUpdateSkuDTO

Bases: BaseModel

编辑SKU（Java: OpenApiUpdateSkuDTO）

CategoryPropValueParam

Bases: BaseModel

类目属性值（Java: CategoryPropValueParam）

DateRangeParam

Bases: BaseModel

时间范围（Java: DateRangeParam）

ItemPropValue

Bases: BaseModel

编辑场景的商品属性（Java: ItemPropValue）

AddItemPropValue

Bases: BaseModel

新增场景的商品属性（Java: AddItemPropValue）

QualificationDataDTO

Bases: BaseModel

资质数据（Java: QualificationDataDTO）

OpenApiTimeRange

Bases: BaseModel

不可售时间段（Java: OpenApiTimeRange）

OpenApiUnavailableTimeRule

Bases: BaseModel

不可售时间规则（Java: OpenApiUnavailableTimeRule）

OpenApiServicePromise

Bases: BaseModel

服务承诺（Java: OpenApiServicePromise）

CustomerInfo

Bases: BaseModel

客户信息（Java: CustomerInfo）

ServiceRule

Bases: BaseModel

服务规则（Java: ServiceRule）

ItemVideoProto

Bases: BaseModel

商品视频（Java: ItemVideoProto）

ItemNewRequest

Bases: BaseRequest

新建商品（对齐 Java: open.item.new）

ItemNewResponse

Bases: BaseResponse[Dict[str, Any]]

新建商品响应

ItemEditRequest

Bases: BaseRequest

编辑商品（对齐 Java: open.item.edit）

ItemEditResponse

Bases: BaseResponse[Dict[str, Any]]

编辑商品响应