渠道管理/账号
创建发布选项值
接口说明:为某个已授权渠道账号创建平台发布时需要的额外参数值,创建成功后返回可直接用于发布任务的选项 item。
所有平台侧“需要先创建再选择”的额外参数都通过本接口处理。例如 Pinterest 需要先创建 Board,再把返回的 Board 作为发布目标 boardId 使用。
调用流程:先调用「平台发布选项」接口(GET /api/v2/channels/platforms/{platform}/publish-options)查询该平台有哪些额外参数;只有返回项包含 createSchema 的字段才支持创建。将返回项中的 field 放到本接口路径参数 field,并按该 createSchema 组织 JSON 请求体。不需要创建的字段,请调用「发布选项可选值」接口查询后选择。
post/api/v2/channels/accounts/{accountId}/publish-options/{field}/values
Path parameters
accountIdstring required
渠道账号 ID。必须是当前用户已授权的账号,且账号所属平台应与「平台发布选项」接口中查询的平台一致。
渠道账号 ID。必须是当前用户已授权的账号,且账号所属平台应与「平台发布选项」接口中查询的平台一致。
fieldstring required
要创建取值的发布选项字段。取值来自「平台发布选项」接口返回的 data[n].field,并且该返回项必须包含 createSchema。
要创建取值的发布选项字段。取值来自「平台发布选项」接口返回的 data[n].field,并且该返回项必须包含 createSchema。
Request body
object required
创建发布选项值所需的 JSON 参数。具体字段不是固定结构,必须以「平台发布选项」接口返回项中的 createSchema 为准。
Response
请求已被服务处理。业务是否成功以响应体 code === 0 为准。