渠道管理/账号

发布选项可选值

接口说明:查询某个已授权渠道账号在指定发布选项字段下的可选值,用于在创建发布任务前让用户选择平台要求的额外参数。

所有平台侧额外参数的查询都使用本接口。典型场景包括 B 站分区 tid、YouTube 分类 categoryId、Threads 地点 location_id、Pinterest Board boardId

调用流程:先调用「平台发布选项」接口(GET /api/v2/channels/platforms/{platform}/publish-options)查询该平台有哪些额外参数;将返回项中的 field 放到本接口路径参数 field。如果返回项包含 filterSchema,按该 schema 将过滤条件作为本接口 query 参数传入,例如 Threads 地点可传 keyword 或经纬度。

get/api/v2/channels/accounts/{accountId}/publish-options/{field}/values

Path parameters

accountIdstring required

渠道账号 ID。必须是当前用户已授权的账号,且账号所属平台应与「平台发布选项」接口中查询的平台一致。

渠道账号 ID。必须是当前用户已授权的账号,且账号所属平台应与「平台发布选项」接口中查询的平台一致。

fieldstring required

发布选项字段。取值来自「平台发布选项」接口返回的 data[n].field,例如 tidcategoryIdlocation_idboardId

发布选项字段。取值来自「平台发布选项」接口返回的 data[n].field,例如 tidcategoryIdlocation_idboardId

Response

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

codeinteger required

业务状态码。0 表示成功,非 0 表示业务错误。

messagestring required

响应消息。

requestIdstring

请求 ID。

timestampinteger

错误响应时间戳,Unix 毫秒。