分销 投资活动 子服务
投资活动相关能力，包含活动开放管理、商品管理、推广者调整与效果统计等接口。
异步 投资活动 服务
kwaixiaodian.client.services.distribution.investment.AsyncInvestmentService(client: AsyncBaseClient)
异步投资活动服务
提供投资活动管理、商品管理、推广者调整等功能。
参考
- 开发文档（限流）: docs/开发指南和规则协议/开发文档/API限流说明.md
- 开发文档（授权）: docs/开发指南和规则协议/开发文档/APP授权说明.md
- 规则协议（日志接入规范）: docs/开发指南和规则协议/规则协议/开放平台/开放平台日志接入规范.md
- 错误处理: docs/error-handling.md
初始化投资活动服务
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
client
|
AsyncBaseClient
|
基础客户端实例 |
必需 |
方法：
| 名称 | 描述 |
|---|---|
adjust_investment_activity_promoter |
调整投资活动推广者 |
get_investment_sample_promoter_data |
获取投资样本推广者数据 |
create_investment_activity_item_token |
创建投资活动商品令牌 |
audit_investment_activity_open_item |
审核投资活动开放商品 |
delete_investment_activity_open |
删除投资活动开放 |
get_investment_activity_open_info |
获取投资活动开放信息 |
create_investment_activity_open |
创建投资活动开放 |
get_investment_activity_open_list |
获取投资活动开放列表 |
get_investment_activity_item_detail |
获取投资活动商品详情 |
get_investment_activity_open_item_list |
获取投资活动开放商品列表 |
close_investment_activity_open |
关闭投资活动开放 |
get_investment_activity_open_promotion_effect |
获取投资活动开放推广效果 |
get_investment_activity_invalid_item_list |
获取投资活动无效商品列表 |
query_investment_activity_exclusive_promoter_info |
查询投资活动独家推广者信息 |
get_investment_my_create_activity_list |
获取投资我的创建活动列表 |
Functions
adjust_investment_activity_promoter(access_token: str, promoter_id: List[int], activity_id: int, operator_type: int, uid: Optional[int] = None) -> InvestmentActivityAdjustPromoterResponse
async
调整投资活动推广者
OpenAPI: open.distribution.investment.activity.adjustActivityPromoter (POST)
Java: OpenDistributionInvestmentActivityAdjustactivitypromoterRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityAdjustactivitypromoterRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
promoter_id
|
List[int]
|
推广者 ID 列表。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
operator_type
|
int
|
操作类型。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityAdjustPromoterResponse |
InvestmentActivityAdjustPromoterResponse
|
调整结果。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_sample_promoter_data(access_token: str, promoter_id: int, item_id: int, uid: Optional[int] = None) -> InvestmentSamplePromoterDataResponse
async
获取投资样本推广者数据
OpenAPI: open.distribution.investment.sample.promoter.data (GET)
Java: OpenDistributionInvestmentSamplePromoterDataRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentSamplePromoterDataRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
promoter_id
|
int
|
推广者 ID。 |
必需 |
item_id
|
int
|
商品 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentSamplePromoterDataResponse |
InvestmentSamplePromoterDataResponse
|
推广者在样本下的表现数据。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
create_investment_activity_item_token(access_token: str, uid: Optional[int] = None) -> InvestmentActivityItemTokenCreateResponse
async
创建投资活动商品令牌
OpenAPI: open.distribution.investment.activity.item.token.create (GET)
Java: OpenDistributionInvestmentActivityItemTokenCreateRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityItemTokenCreateRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityItemTokenCreateResponse |
InvestmentActivityItemTokenCreateResponse
|
令牌创建结果。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
audit_investment_activity_open_item(access_token: str, uid: Optional[int] = None) -> InvestmentActivityOpenItemAuditResponse
async
审核投资活动开放商品
OpenAPI: open.distribution.investment.activity.open.item.audit (GET)
Java: OpenDistributionInvestmentActivityOpenItemAuditRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenItemAuditRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenItemAuditResponse |
InvestmentActivityOpenItemAuditResponse
|
审核结果。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
delete_investment_activity_open(access_token: str, uid: Optional[int] = None) -> InvestmentActivityOpenDeleteResponse
async
删除投资活动开放
OpenAPI: open.distribution.investment.activity.open.delete (GET)
Java: OpenDistributionInvestmentActivityOpenDeleteRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenDeleteRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenDeleteResponse |
InvestmentActivityOpenDeleteResponse
|
删除结果。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_open_info(access_token: str, activity_id: int, uid: Optional[int] = None) -> InvestmentActivityOpenInfoResponse
async
获取投资活动开放信息
OpenAPI: open.distribution.investment.activity.open.info (GET)
Java: OpenDistributionInvestmentActivityOpenInfoRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenInfoRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenInfoResponse |
InvestmentActivityOpenInfoResponse
|
活动开放信息详情。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
create_investment_activity_open(access_token: str, activity_name: str, activity_desc: str, begin_time: int, end_time: int, uid: Optional[int] = None) -> InvestmentActivityOpenCreateResponse
async
创建投资活动开放
OpenAPI: open.distribution.investment.activity.open.create (POST)
Java: OpenDistributionInvestmentActivityOpenCreateRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenCreateRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_name
|
str
|
活动名称。 |
必需 |
activity_desc
|
str
|
活动描述。 |
必需 |
begin_time
|
int
|
开始时间（毫秒）。 |
必需 |
end_time
|
int
|
结束时间（毫秒）。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenCreateResponse |
InvestmentActivityOpenCreateResponse
|
创建结果与活动标识信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_open_list(access_token: str, page: Optional[int] = None, page_size: Optional[int] = None, activity_status: Optional[int] = None, uid: Optional[int] = None) -> InvestmentActivityOpenListResponse
async
获取投资活动开放列表
OpenAPI: open.distribution.investment.activity.open.list (GET)
Java: OpenDistributionInvestmentActivityOpenListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
page
|
Optional[int]
|
页码（可选）。 |
None
|
page_size
|
Optional[int]
|
页大小（可选）。 |
None
|
activity_status
|
Optional[int]
|
活动状态（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenListResponse |
InvestmentActivityOpenListResponse
|
活动开放列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_item_detail(access_token: str, activity_id: int, item_id: int, uid: Optional[int] = None) -> InvestmentActivityItemDetailResponse
async
获取投资活动商品详情
OpenAPI: open.distribution.investment.activity.item.detail (GET)
Java: OpenDistributionInvestmentActivityItemDetailRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityItemDetailRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
item_id
|
int
|
商品 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityItemDetailResponse |
InvestmentActivityItemDetailResponse
|
商品在活动中的详细信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_open_item_list(access_token: str, activity_id: int, page: Optional[int] = None, page_size: Optional[int] = None, uid: Optional[int] = None) -> InvestmentActivityOpenItemListResponse
async
获取投资活动开放商品列表
OpenAPI: open.distribution.investment.activity.open.item.list (GET)
Java: OpenDistributionInvestmentActivityOpenItemListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenItemListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
page
|
Optional[int]
|
页码（可选）。 |
None
|
page_size
|
Optional[int]
|
页大小（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenItemListResponse |
InvestmentActivityOpenItemListResponse
|
开放商品列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
close_investment_activity_open(access_token: str, activity_id: int, uid: Optional[int] = None) -> InvestmentActivityOpenCloseResponse
async
关闭投资活动开放
OpenAPI: open.distribution.investment.activity.open.close (GET)
Java: OpenDistributionInvestmentActivityOpenCloseRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenCloseRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenCloseResponse |
InvestmentActivityOpenCloseResponse
|
关闭结果信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_open_promotion_effect(access_token: str, activity_id: int, begin_time: Optional[int] = None, end_time: Optional[int] = None, uid: Optional[int] = None) -> InvestmentActivityOpenPromotionEffectResponse
async
获取投资活动开放推广效果
OpenAPI: open.distribution.investment.activity.open.promotion.effect (GET)
Java: OpenDistributionInvestmentActivityOpenPromotionEffectRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenPromotionEffectRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
begin_time
|
Optional[int]
|
开始时间（毫秒，选填）。 |
None
|
end_time
|
Optional[int]
|
结束时间（毫秒，选填）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenPromotionEffectResponse |
InvestmentActivityOpenPromotionEffectResponse
|
推广效果统计数据。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_invalid_item_list(access_token: str, activity_id: int, page: Optional[int] = None, page_size: Optional[int] = None, uid: Optional[int] = None) -> InvestmentActivityInvalidItemListResponse
async
获取投资活动无效商品列表
OpenAPI: open.distribution.investment.activity.invalid.item.list (POST)
Java: OpenDistributionInvestmentActivityInvalidItemListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityInvalidItemListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
page
|
Optional[int]
|
页码（可选）。 |
None
|
page_size
|
Optional[int]
|
页大小（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityInvalidItemListResponse |
InvestmentActivityInvalidItemListResponse
|
无效商品列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
query_investment_activity_exclusive_promoter_info(access_token: str, activity_id: int, uid: Optional[int] = None) -> InvestmentActivityQueryExclusivePromoterInfoResponse
async
查询投资活动独家推广者信息
OpenAPI: open.distribution.investment.activity.queryExclusivePromoterInfo (GET)
Java: OpenDistributionInvestmentActivityQueryexclusivepromoterinfoRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityQueryexclusivepromoterinfoRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityQueryExclusivePromoterInfoResponse |
InvestmentActivityQueryExclusivePromoterInfoResponse
|
独家推广者配置与状态信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_my_create_activity_list(access_token: str, page: Optional[int] = None, page_size: Optional[int] = None, activity_status: Optional[int] = None, uid: Optional[int] = None) -> InvestmentMyCreateActivityListResponse
async
获取投资我的创建活动列表
OpenAPI: open.distribution.investment.my.create.activity.list (GET)
Java: OpenDistributionInvestmentMyCreateActivityListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentMyCreateActivityListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
page
|
Optional[int]
|
页码（可选）。 |
None
|
page_size
|
Optional[int]
|
页大小（可选）。 |
None
|
activity_status
|
Optional[int]
|
活动状态（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentMyCreateActivityListResponse |
InvestmentMyCreateActivityListResponse
|
我创建的活动列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
同步 投资活动 服务
kwaixiaodian.client.services.distribution.investment.SyncInvestmentService(client: SyncBaseClient)
同步投资活动服务
提供投资活动管理、商品管理、推广者调整等功能。
参考
- 开发文档（限流）: docs/开发指南和规则协议/开发文档/API限流说明.md
- 开发文档（授权）: docs/开发指南和规则协议/开发文档/APP授权说明.md
- 规则协议（日志接入规范）: docs/开发指南和规则协议/规则协议/开放平台/开放平台日志接入规范.md
- 错误处理: docs/error-handling.md
初始化投资活动服务
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
client
|
SyncBaseClient
|
同步基础客户端实例 |
必需 |
方法：
| 名称 | 描述 |
|---|---|
adjust_investment_activity_promoter |
调整投资活动推广者（同步） |
get_investment_sample_promoter_data |
获取投资样本推广者数据（同步） |
create_investment_activity_item_token |
创建投资活动商品令牌（同步） |
audit_investment_activity_open_item |
审核投资活动开放商品（同步） |
delete_investment_activity_open |
删除投资活动开放（同步） |
create_investment_activity_open |
创建投资活动开放（同步） |
get_investment_activity_open_info |
获取投资活动开放信息（同步） |
get_investment_activity_open_list |
获取投资活动开放列表（同步） |
get_investment_activity_item_detail |
获取投资活动商品详情（同步） |
get_investment_activity_open_item_list |
获取投资活动开放商品列表（同步） |
close_investment_activity_open |
关闭投资活动开放（同步） |
get_investment_activity_open_promotion_effect |
获取投资活动开放推广效果（同步） |
get_investment_activity_invalid_item_list |
获取投资活动无效商品列表（同步） |
query_investment_activity_exclusive_promoter_info |
查询投资活动独家推广者信息（同步） |
get_investment_my_create_activity_list |
获取投资我的创建活动列表（同步） |
Functions
adjust_investment_activity_promoter(access_token: str, promoter_id: List[int], activity_id: int, operator_type: int, uid: Optional[int] = None) -> InvestmentActivityAdjustPromoterResponse
调整投资活动推广者（同步）
OpenAPI: open.distribution.investment.activity.adjustActivityPromoter (POST)
Java: OpenDistributionInvestmentActivityAdjustactivitypromoterRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityAdjustactivitypromoterRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
promoter_id
|
List[int]
|
推广者 ID 列表。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
operator_type
|
int
|
操作类型。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityAdjustPromoterResponse |
InvestmentActivityAdjustPromoterResponse
|
调整结果。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_sample_promoter_data(access_token: str, promoter_id: int, item_id: int, uid: Optional[int] = None) -> InvestmentSamplePromoterDataResponse
获取投资样本推广者数据（同步）
OpenAPI: open.distribution.investment.sample.promoter.data (GET)
Java: OpenDistributionInvestmentSamplePromoterDataRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentSamplePromoterDataRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
promoter_id
|
int
|
推广者 ID。 |
必需 |
item_id
|
int
|
商品 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentSamplePromoterDataResponse |
InvestmentSamplePromoterDataResponse
|
推广者在样本下的表现数据。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
create_investment_activity_item_token(access_token: str, uid: Optional[int] = None) -> InvestmentActivityItemTokenCreateResponse
创建投资活动商品令牌（同步）
OpenAPI: open.distribution.investment.activity.item.token.create (GET)
Java: OpenDistributionInvestmentActivityItemTokenCreateRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityItemTokenCreateRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityItemTokenCreateResponse |
InvestmentActivityItemTokenCreateResponse
|
令牌创建结果。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
audit_investment_activity_open_item(access_token: str, uid: Optional[int] = None) -> InvestmentActivityOpenItemAuditResponse
审核投资活动开放商品（同步）
OpenAPI: open.distribution.investment.activity.open.item.audit (GET)
Java: OpenDistributionInvestmentActivityOpenItemAuditRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenItemAuditRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenItemAuditResponse |
InvestmentActivityOpenItemAuditResponse
|
审核结果。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
delete_investment_activity_open(access_token: str, uid: Optional[int] = None) -> InvestmentActivityOpenDeleteResponse
删除投资活动开放（同步）
OpenAPI: open.distribution.investment.activity.open.delete (GET)
Java: OpenDistributionInvestmentActivityOpenDeleteRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenDeleteRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenDeleteResponse |
InvestmentActivityOpenDeleteResponse
|
删除结果。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
create_investment_activity_open(access_token: str, activity_name: str, activity_desc: str, begin_time: int, end_time: int, uid: Optional[int] = None) -> InvestmentActivityOpenCreateResponse
创建投资活动开放（同步）
OpenAPI: open.distribution.investment.activity.open.create (POST)
Java: OpenDistributionInvestmentActivityOpenCreateRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenCreateRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_name
|
str
|
活动名称。 |
必需 |
activity_desc
|
str
|
活动描述。 |
必需 |
begin_time
|
int
|
开始时间（毫秒）。 |
必需 |
end_time
|
int
|
结束时间（毫秒）。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenCreateResponse |
InvestmentActivityOpenCreateResponse
|
创建结果与活动标识信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_open_info(access_token: str, activity_id: int, uid: Optional[int] = None) -> InvestmentActivityOpenInfoResponse
获取投资活动开放信息（同步）
OpenAPI: open.distribution.investment.activity.open.info (GET)
Java: OpenDistributionInvestmentActivityOpenInfoRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenInfoRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenInfoResponse |
InvestmentActivityOpenInfoResponse
|
活动开放信息详情。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_open_list(access_token: str, page: Optional[int] = None, page_size: Optional[int] = None, activity_status: Optional[int] = None, uid: Optional[int] = None) -> InvestmentActivityOpenListResponse
获取投资活动开放列表（同步）
OpenAPI: open.distribution.investment.activity.open.list (GET)
Java: OpenDistributionInvestmentActivityOpenListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
page
|
Optional[int]
|
页码（可选）。 |
None
|
page_size
|
Optional[int]
|
页大小（可选）。 |
None
|
activity_status
|
Optional[int]
|
活动状态（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenListResponse |
InvestmentActivityOpenListResponse
|
活动开放列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_item_detail(access_token: str, activity_id: int, item_id: int, uid: Optional[int] = None) -> InvestmentActivityItemDetailResponse
获取投资活动商品详情（同步）
OpenAPI: open.distribution.investment.activity.item.detail (GET)
Java: OpenDistributionInvestmentActivityItemDetailRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityItemDetailRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
item_id
|
int
|
商品 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityItemDetailResponse |
InvestmentActivityItemDetailResponse
|
商品详情数据。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_open_item_list(access_token: str, activity_id: int, page: Optional[int] = None, page_size: Optional[int] = None, uid: Optional[int] = None) -> InvestmentActivityOpenItemListResponse
获取投资活动开放商品列表（同步）
OpenAPI: open.distribution.investment.activity.open.item.list (GET)
Java: OpenDistributionInvestmentActivityOpenItemListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenItemListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
page
|
Optional[int]
|
页码（可选）。 |
None
|
page_size
|
Optional[int]
|
页大小（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenItemListResponse |
InvestmentActivityOpenItemListResponse
|
开放商品列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
close_investment_activity_open(access_token: str, activity_id: int, uid: Optional[int] = None) -> InvestmentActivityOpenCloseResponse
关闭投资活动开放（同步）
OpenAPI: open.distribution.investment.activity.open.close (GET)
Java: OpenDistributionInvestmentActivityOpenCloseRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenCloseRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenCloseResponse |
InvestmentActivityOpenCloseResponse
|
关闭结果信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_open_promotion_effect(access_token: str, activity_id: int, begin_time: Optional[int] = None, end_time: Optional[int] = None, uid: Optional[int] = None) -> InvestmentActivityOpenPromotionEffectResponse
获取投资活动开放推广效果（同步）
OpenAPI: open.distribution.investment.activity.open.promotion.effect (GET)
Java: OpenDistributionInvestmentActivityOpenPromotionEffectRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityOpenPromotionEffectRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
begin_time
|
Optional[int]
|
开始时间（毫秒，选填）。 |
None
|
end_time
|
Optional[int]
|
结束时间（毫秒，选填）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityOpenPromotionEffectResponse |
InvestmentActivityOpenPromotionEffectResponse
|
推广效果统计数据。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_activity_invalid_item_list(access_token: str, activity_id: int, page: Optional[int] = None, page_size: Optional[int] = None, uid: Optional[int] = None) -> InvestmentActivityInvalidItemListResponse
获取投资活动无效商品列表（同步）
OpenAPI: open.distribution.investment.activity.invalid.item.list (POST)
Java: OpenDistributionInvestmentActivityInvalidItemListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityInvalidItemListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
page
|
Optional[int]
|
页码（可选）。 |
None
|
page_size
|
Optional[int]
|
页大小（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityInvalidItemListResponse |
InvestmentActivityInvalidItemListResponse
|
无效商品列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
query_investment_activity_exclusive_promoter_info(access_token: str, activity_id: int, uid: Optional[int] = None) -> InvestmentActivityQueryExclusivePromoterInfoResponse
查询投资活动独家推广者信息（同步）
OpenAPI: open.distribution.investment.activity.queryExclusivePromoterInfo (GET)
Java: OpenDistributionInvestmentActivityQueryexclusivepromoterinfoRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentActivityQueryexclusivepromoterinfoRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
activity_id
|
int
|
活动 ID。 |
必需 |
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentActivityQueryExclusivePromoterInfoResponse |
InvestmentActivityQueryExclusivePromoterInfoResponse
|
独家推广者配置与状态信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |
get_investment_my_create_activity_list(access_token: str, page: Optional[int] = None, page_size: Optional[int] = None, activity_status: Optional[int] = None, uid: Optional[int] = None) -> InvestmentMyCreateActivityListResponse
获取投资我的创建活动列表（同步）
OpenAPI: open.distribution.investment.my.create.activity.list (GET)
Java: OpenDistributionInvestmentMyCreateActivityListRequest
Path: java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/distribution/OpenDistributionInvestmentMyCreateActivityListRequest.java
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌。 |
必需 |
page
|
Optional[int]
|
页码（可选）。 |
None
|
page_size
|
Optional[int]
|
页大小（可选）。 |
None
|
activity_status
|
Optional[int]
|
活动状态（可选）。 |
None
|
uid
|
Optional[int]
|
可选用户ID（最后一个可选参数）。 |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvestmentMyCreateActivityListResponse |
InvestmentMyCreateActivityListResponse
|
我创建的活动列表与分页信息。 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
平台返回错误或解析失败。 |