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

# 发布选项可选值

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

## Request

- Base URL: `https://aitoearn.cn`
- URL: `https://aitoearn.cn/api/v2/channels/accounts/{accountId}/publish-options/{field}/values`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/aitoearn/apis/aitoearn-api/docs/api/v2/channels/accounts/:accountId/publish-options/:field/values/get.ts> (a function with typed inputs; its response is checked against the schema)

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

所有平台侧额外参数的查询都使用本接口。典型场景包括 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` object
    - `field` string
    - `valueType` string
    - `items` object[]
      - `value` string
      - `label` string
      - `description` string
      - `disabled` boolean
      - `children` object[]
        - `value` string
        - `label` string
        - `description` string
        - `extra` object
          - `parent` number
      - `extra` object
        - `parent` number
  - `code` integer: 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string: 响应消息。
  - `requestId` string: 请求 ID。
  - `timestamp` integer: 错误响应时间戳，Unix 毫秒。

## Changes

- **2026-11-03** `7cc8f21c4c96`: 5 breaking, 8 info
  - the response property `code` became optional for the status `200`
  - the response property `data/field` became optional for the status `200`
  - the response property `data/items` became optional for the status `200`
  - the response property `data/valueType` became optional for the status `200`
  - …9 more

[Operation history](https://skmtc.dev/aitoearn/apis/aitoearn-api/changes/api/v2/channels/accounts/:accountId/publish-options/:field/values/get.md)

---

[API](https://skmtc.dev/aitoearn/apis/aitoearn-api.md) - [All operations](https://skmtc.dev/aitoearn/apis/aitoearn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aitoearn/apis/aitoearn-api/revisions/7cc8f21c4c96?raw)