---
title: "发布选项可选值"
method: GET
path: "/api/v2/channels/accounts/{accountId}/publish-options/{field}/values"
tags: ["渠道管理/账号"]
---

# 发布选项可选值

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

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

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

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

## Path parameters

- `accountId` string, required — 渠道账号 ID。必须是当前用户已授权的账号，且账号所属平台应与「平台发布选项」接口中查询的平台一致。
- `field` string, required — 发布选项字段。取值来自[「平台发布选项」](/api-reference/get-api-v2-channels-platforms-platform-publish-options)接口返回的 `data[n].field`，例如 `tid`、`categoryId`、`location_id`、`boardId`。

## Response `200`

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

- object
  - `data` PublishOptionValuesVo
    - `field` string, required — 发布选项字段
    - `valueType` 'list' | 'tree', required — 取值结构
    - `items` object[], required — 选项列表
  - `code` integer, required — 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required — 响应消息。
  - `requestId` string — 请求 ID。
  - `timestamp` integer — 错误响应时间戳，Unix 毫秒。

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/revisions/19d860d9260d/schema)