分销 卖家活动 子服务
卖家活动相关能力，包含活动申请/取消、可用与活动商品、推广效果与独家推广者信息等接口。
异步 卖家活动 服务
kwaixiaodian.client.services.distribution.seller.AsyncSellerActivityService(client: AsyncBaseClient)
异步卖家活动服务
提供卖家活动申请、推广效果查询、活动商品管理等功能。
参考
- 开发文档（限流）: docs/开发指南和规则协议/开发文档/API限流说明.md
- 开发文档（授权）: docs/开发指南和规则协议/开发文档/APP授权说明.md
- 规则协议（日志接入规范）: docs/开发指南和规则协议/规则协议/开放平台/开放平台日志接入规范.md
- 错误处理: docs/error-handling.md
初始化卖家活动服务
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
client
|
AsyncBaseClient
|
基础客户端实例 |
必需 |
方法：
| 名称 | 描述 |
|---|---|
get_seller_activity_apply_list |
获取卖家活动申请列表 |
get_seller_activity_promotion_effect_item |
获取卖家活动推广效果商品 |
get_seller_activity_usable_item |
获取卖家活动可用商品 |
cancel_seller_activity_apply |
取消卖家活动申请 |
get_seller_activity_open_info |
获取卖家活动开放信息 |
get_seller_activity_item_list |
获取卖家活动商品列表 |
get_seller_activity_open_list |
获取卖家活动开放列表 |
query_seller_activity_exclusive_promoter_info |
查询卖家活动独家推广者信息 |
apply_seller_activity |
申请卖家活动 |
get_seller_activity_promotion_effect_summary |
获取卖家活动推广效果汇总 |
query_seller_activity_promoter_adjust_history |
查询卖家活动推广者调整历史 |
Functions
get_seller_activity_apply_list(access_token: str, offset: Optional[int] = None, activity_type: Optional[int] = None, limit: Optional[int] = None, activity_id: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityApplyListResponse
async
获取卖家活动申请列表
OpenAPI: open.distribution.seller.activity.apply.list (GET)
Java: OpenDistributionSellerActivityApplyListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityApplyListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
activity_type
|
Optional[int]
|
活动类型（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityApplyListResponse |
SellerActivityApplyListResponse
|
申请列表及分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_promotion_effect_item(access_token: str, page_cursor: Optional[int] = None, item_id: Optional[int] = None, activity_id: Optional[int] = None, end_time: Optional[int] = None, item_title: Optional[str] = None, page_size: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityPromotionEffectItemResponse
async
获取卖家活动推广效果商品
OpenAPI: open.distribution.seller.activity.promotion.effect.item (GET)
Java: OpenDistributionSellerActivityPromotionEffectItemRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityPromotionEffectItemRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
page_cursor
|
Optional[int]
|
页游标（可选）。 |
None
|
item_id
|
Optional[int]
|
商品 ID（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
end_time
|
Optional[int]
|
结束时间（毫秒，可选）。 |
None
|
item_title
|
Optional[str]
|
商品标题（可选）。 |
None
|
page_size
|
Optional[int]
|
页面大小（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityPromotionEffectItemResponse |
SellerActivityPromotionEffectItemResponse
|
推广效果商品数据集合。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_usable_item(access_token: str, offset: Optional[int] = None, item_id: Optional[int] = None, activity_id: Optional[int] = None, limit: Optional[int] = None, item_title: Optional[str] = None, uid: Optional[int] = None) -> SellerActivityUsableItemResponse
async
获取卖家活动可用商品
OpenAPI: open.distribution.seller.activity.usable.item (GET)
Java: OpenDistributionSellerActivityUsableItemRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityUsableItemRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
item_id
|
Optional[int]
|
商品 ID（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
item_title
|
Optional[str]
|
商品标题（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityUsableItemResponse |
SellerActivityUsableItemResponse
|
可用商品列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
cancel_seller_activity_apply(access_token: str, item_id: Optional[int] = None, activity_id: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityApplyCancelResponse
async
取消卖家活动申请
OpenAPI: open.distribution.seller.activity.apply.cancel (GET)
Java: OpenDistributionSellerActivityApplyCancelRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityApplyCancelRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
item_id
|
Optional[int]
|
商品 ID（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityApplyCancelResponse |
SellerActivityApplyCancelResponse
|
取消结果信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_open_info(access_token: str, activity_id: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityOpenInfoResponse
async
获取卖家活动开放信息
OpenAPI: open.distribution.seller.activity.open.info (GET)
Java: OpenDistributionSellerActivityOpenInfoRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityOpenInfoRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityOpenInfoResponse |
SellerActivityOpenInfoResponse
|
活动开放信息详情。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_item_list(access_token: str, item_audit_status: Optional[int] = None, category_id: Optional[int] = None, offset: Optional[int] = None, item_id: Optional[int] = None, activity_id: Optional[int] = None, limit: Optional[int] = None, item_title: Optional[str] = None, uid: Optional[int] = None) -> SellerActivityItemListResponse
async
获取卖家活动商品列表
OpenAPI: open.distribution.seller.activity.item.list (GET)
Java: OpenDistributionSellerActivityItemListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityItemListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
item_audit_status
|
Optional[int]
|
商品审核状态（可选）。 |
None
|
category_id
|
Optional[int]
|
类目 ID（可选）。 |
None
|
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
item_id
|
Optional[int]
|
商品 ID（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
item_title
|
Optional[str]
|
商品标题（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityItemListResponse |
SellerActivityItemListResponse
|
商品列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_open_list(access_token: str, offset: Optional[int] = None, activity_type: Optional[int] = None, limit: Optional[int] = None, activity_id: Optional[int] = None, channel_id: Optional[List[int]] = None, activity_title: Optional[str] = None, uid: Optional[int] = None) -> SellerActivityOpenListResponse
async
获取卖家活动开放列表
OpenAPI: open.distribution.seller.activity.open.list (GET)
Java: OpenDistributionSellerActivityOpenListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityOpenListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
activity_type
|
Optional[int]
|
活动类型（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
channel_id
|
Optional[List[int]]
|
渠道 ID 列表（可选）。 |
None
|
activity_title
|
Optional[str]
|
活动标题（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityOpenListResponse |
SellerActivityOpenListResponse
|
活动开放列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
query_seller_activity_exclusive_promoter_info(access_token: str, uid: Optional[int] = None) -> SellerActivityQueryExclusivePromoterInfoResponse
async
查询卖家活动独家推广者信息
OpenAPI: open.distribution.seller.activity.queryExclusivePromoterInfo (GET)
Java: OpenDistributionSellerActivityQueryexclusivepromoterinfoRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityQueryexclusivepromoterinfoRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityQueryExclusivePromoterInfoResponse |
SellerActivityQueryExclusivePromoterInfoResponse
|
独家推广者相关信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
apply_seller_activity(access_token: str, activity_id: int, apply_reason: str, uid: Optional[int] = None) -> SellerActivityApplyResponse
async
申请卖家活动
OpenAPI: open.distribution.seller.activity.apply (POST)
Java: OpenDistributionSellerActivityApplyRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityApplyRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
apply_reason
|
str
|
申请理由。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityApplyResponse |
SellerActivityApplyResponse
|
申请结果信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_promotion_effect_summary(access_token: str, activity_id: int, end_time: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityPromotionEffectSummaryResponse
async
获取卖家活动推广效果汇总
OpenAPI: open.distribution.seller.activity.promotion.effect.summary (GET)
Java: OpenDistributionSellerActivityPromotionEffectSummaryRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityPromotionEffectSummaryRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
end_time
|
Optional[int]
|
结束时间（毫秒，选填）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityPromotionEffectSummaryResponse |
SellerActivityPromotionEffectSummaryResponse
|
推广效果汇总数据。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
query_seller_activity_promoter_adjust_history(access_token: str, activity_id: int, offset: Optional[int] = None, limit: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityQueryActivityPromoterAdjustHistoryResponse
async
查询卖家活动推广者调整历史
OpenAPI: open.distribution.seller.activity.queryActivityPromoterAdjustHistory (GET)
Java: OpenDistributionSellerActivityQueryactivitypromoteradjusthistoryRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityQueryactivitypromoteradjusthistoryRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityQueryActivityPromoterAdjustHistoryResponse |
SellerActivityQueryActivityPromoterAdjustHistoryResponse
|
调整历史记录与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
同步 卖家活动 服务
kwaixiaodian.client.services.distribution.seller.SyncSellerActivityService(client: SyncBaseClient)
同步卖家活动服务
提供卖家活动申请、推广效果查询、活动商品管理等功能。
参考
- 开发文档（限流）: docs/开发指南和规则协议/开发文档/API限流说明.md
- 开发文档（授权）: docs/开发指南和规则协议/开发文档/APP授权说明.md
- 规则协议（日志接入规范）: docs/开发指南和规则协议/规则协议/开放平台/开放平台日志接入规范.md
- 错误处理: docs/error-handling.md
初始化卖家活动服务
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
client
|
SyncBaseClient
|
同步基础客户端实例 |
必需 |
方法：
| 名称 | 描述 |
|---|---|
get_seller_activity_apply_list |
获取卖家活动申请列表（同步） |
get_seller_activity_promotion_effect_item |
获取卖家活动推广效果商品（同步） |
get_seller_activity_usable_item |
获取卖家活动可用商品（同步） |
cancel_seller_activity_apply |
取消卖家活动申请（同步） |
get_seller_activity_open_info |
获取卖家活动开放信息（同步） |
get_seller_activity_item_list |
获取卖家活动商品列表（同步） |
get_seller_activity_open_list |
获取卖家活动开放列表（同步） |
get_seller_activity_promotion_effect_summary |
获取卖家活动推广效果汇总（同步） |
query_seller_activity_promoter_adjust_history |
查询卖家活动推广者调整历史（同步） |
query_seller_activity_exclusive_promoter_info |
查询卖家活动独家推广者信息（同步） |
Functions
get_seller_activity_apply_list(access_token: str, offset: Optional[int] = None, activity_type: Optional[int] = None, limit: Optional[int] = None, activity_id: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityApplyListResponse
获取卖家活动申请列表（同步）
OpenAPI: open.distribution.seller.activity.apply.list (GET)
Java: OpenDistributionSellerActivityApplyListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityApplyListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
activity_type
|
Optional[int]
|
活动类型（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityApplyListResponse |
SellerActivityApplyListResponse
|
申请列表及分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_promotion_effect_item(access_token: str, page_cursor: Optional[int] = None, item_id: Optional[int] = None, activity_id: Optional[int] = None, end_time: Optional[int] = None, item_title: Optional[str] = None, page_size: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityPromotionEffectItemResponse
获取卖家活动推广效果商品（同步）
OpenAPI: open.distribution.seller.activity.promotion.effect.item (GET)
Java: OpenDistributionSellerActivityPromotionEffectItemRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityPromotionEffectItemRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
page_cursor
|
Optional[int]
|
页游标（可选）。 |
None
|
item_id
|
Optional[int]
|
商品 ID（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
end_time
|
Optional[int]
|
结束时间（毫秒，可选）。 |
None
|
item_title
|
Optional[str]
|
商品标题（可选）。 |
None
|
page_size
|
Optional[int]
|
页面大小（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityPromotionEffectItemResponse |
SellerActivityPromotionEffectItemResponse
|
推广效果商品数据集合。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_usable_item(access_token: str, offset: Optional[int] = None, item_id: Optional[int] = None, activity_id: Optional[int] = None, limit: Optional[int] = None, item_title: Optional[str] = None, uid: Optional[int] = None) -> SellerActivityUsableItemResponse
获取卖家活动可用商品（同步）
OpenAPI: open.distribution.seller.activity.usable.item (GET)
Java: OpenDistributionSellerActivityUsableItemRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityUsableItemRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
item_id
|
Optional[int]
|
商品 ID（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
item_title
|
Optional[str]
|
商品标题（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityUsableItemResponse |
SellerActivityUsableItemResponse
|
可用商品列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
cancel_seller_activity_apply(access_token: str, item_id: Optional[int] = None, activity_id: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityApplyCancelResponse
取消卖家活动申请（同步）
OpenAPI: open.distribution.seller.activity.apply.cancel (GET)
Java: OpenDistributionSellerActivityApplyCancelRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityApplyCancelRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
item_id
|
Optional[int]
|
商品 ID（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityApplyCancelResponse |
SellerActivityApplyCancelResponse
|
取消结果信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_open_info(access_token: str, activity_id: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityOpenInfoResponse
获取卖家活动开放信息（同步）
OpenAPI: open.distribution.seller.activity.open.info (GET)
Java: OpenDistributionSellerActivityOpenInfoRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityOpenInfoRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityOpenInfoResponse |
SellerActivityOpenInfoResponse
|
活动开放信息详情。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_item_list(access_token: str, item_audit_status: Optional[int] = None, category_id: Optional[int] = None, offset: Optional[int] = None, item_id: Optional[int] = None, activity_id: Optional[int] = None, limit: Optional[int] = None, item_title: Optional[str] = None, uid: Optional[int] = None) -> SellerActivityItemListResponse
获取卖家活动商品列表（同步）
OpenAPI: open.distribution.seller.activity.item.list (GET)
Java: OpenDistributionSellerActivityItemListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityItemListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
item_audit_status
|
Optional[int]
|
商品审核状态（可选）。 |
None
|
category_id
|
Optional[int]
|
类目 ID（可选）。 |
None
|
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
item_id
|
Optional[int]
|
商品 ID（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
item_title
|
Optional[str]
|
商品标题（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityItemListResponse |
SellerActivityItemListResponse
|
商品列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_open_list(access_token: str, offset: Optional[int] = None, activity_type: Optional[int] = None, limit: Optional[int] = None, activity_id: Optional[int] = None, channel_id: Optional[List[int]] = None, activity_title: Optional[str] = None, uid: Optional[int] = None) -> SellerActivityOpenListResponse
获取卖家活动开放列表（同步）
OpenAPI: open.distribution.seller.activity.open.list (GET)
Java: OpenDistributionSellerActivityOpenListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityOpenListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
activity_type
|
Optional[int]
|
活动类型（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
activity_id
|
Optional[int]
|
活动 ID（可选）。 |
None
|
channel_id
|
Optional[List[int]]
|
渠道 ID 列表（可选）。 |
None
|
activity_title
|
Optional[str]
|
活动标题（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityOpenListResponse |
SellerActivityOpenListResponse
|
活动开放列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_seller_activity_promotion_effect_summary(access_token: str, activity_id: int, end_time: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityPromotionEffectSummaryResponse
获取卖家活动推广效果汇总（同步）
OpenAPI: open.distribution.seller.activity.promotion.effect.summary (GET)
Java: OpenDistributionSellerActivityPromotionEffectSummaryRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityPromotionEffectSummaryRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
end_time
|
Optional[int]
|
结束时间（毫秒，选填）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityPromotionEffectSummaryResponse |
SellerActivityPromotionEffectSummaryResponse
|
推广效果汇总数据。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
query_seller_activity_promoter_adjust_history(access_token: str, activity_id: int, offset: Optional[int] = None, limit: Optional[int] = None, uid: Optional[int] = None) -> SellerActivityQueryActivityPromoterAdjustHistoryResponse
查询卖家活动推广者调整历史（同步）
OpenAPI: open.distribution.seller.activity.queryActivityPromoterAdjustHistory (GET)
Java: OpenDistributionSellerActivityQueryactivitypromoteradjusthistoryRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityQueryactivitypromoteradjusthistoryRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
offset
|
Optional[int]
|
偏移量（可选）。 |
None
|
limit
|
Optional[int]
|
数量限制（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityQueryActivityPromoterAdjustHistoryResponse |
SellerActivityQueryActivityPromoterAdjustHistoryResponse
|
推广者调整历史记录与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
query_seller_activity_exclusive_promoter_info(access_token: str, uid: Optional[int] = None) -> SellerActivityQueryExclusivePromoterInfoResponse
查询卖家活动独家推广者信息（同步）
OpenAPI: open.distribution.seller.activity.queryExclusivePromoterInfo (GET)
Java: OpenDistributionSellerActivityQueryexclusivepromoterinfoRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionSellerActivityQueryexclusivepromoterinfoRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerActivityQueryExclusivePromoterInfoResponse |
SellerActivityQueryExclusivePromoterInfoResponse
|
独家推广者配置与状态信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |