AIaitoearn
渠道管理/账号

发布选项可选值

Changed on

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

所有平台侧额外参数的查询都使用本接口。典型场景包括 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

Request

Path parameters

accountIdstring required

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

fieldstring required

发布选项字段。取值来自「平台发布选项」接口返回的 data[n].field，例如 tid、categoryId、location_id、boardId。

Response

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

codeinteger

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

messagestring

响应消息。

requestIdstring

请求 ID。

timestampinteger

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

Changes

  • 7cc8f21c4c96Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property became optional for the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      removed the list enum value from the / response property for the response status

    • info

      removed the tree enum value from the / response property for the response status