# 属性与发布队列 (https://sellersheetai.com/zh/docs/mcp-api/workflows/listings-attributes)

> 把表格里的单元格转成亚马逊格式的属性 JSON（也能反向转换），校验后从发布队列表格一次发布大量 Listing。



<Callout title="一句话">
  为一个或多个商品类型生成发布队列表格，填写单元格（或拉取亚马逊现有内容），然后提交。SellerSheet 把每个单元格转换成亚马逊要求的属性格式，也能反向转换。
</Callout>

## 一步一步 [#一步一步]

<Steps>
  <Step>
    ### 生成表格 [#生成表格]

    “为商品类型 LUGGAGE 准备一个发布队列模板。” `listings_prepare_publish_queue_template` 打包生成发布队列标签页所需的一切，可同时覆盖多个商品类型——各类型的列自动合并，必填列在前。
  </Step>

  <Step>
    ### 填写——或从线上内容开始 [#填写或从线上内容开始]

    `listings_fetch_attributes_by_skus` 拉取你自己的 Listing 并把属性展开成单元格；`listings_fetch_attributes_by_asins` 对任意 ASIN 的目录属性做同样的事，`listings_parse_asin_to_cells` 把单个 ASIN 映射到表格的列上。`listings_get_attribute_guide` 解释某个属性：格式、单位和允许的取值。
  </Step>

  <Step>
    ### 核对转换结果 [#核对转换结果]

    `listings_build_payload` 把单元格的值转成亚马逊的属性 JSON，让你看清将要提交的内容；`listings_parse_payload` 反向转换。
  </Step>

  <Step>
    ### 提交 [#提交]

    `listings_submit_items` 按 SKU 一步生成并提交；`listings_submit_feed` 通过亚马逊 Feeds API 提交整批，`listings_poll_feed_results` 读取亚马逊接受或拒绝的结果。
  </Step>
</Steps>

## 可以这样问 [#可以这样问]

> “为商品类型 LUGGAGE 准备一个发布队列模板。”

> “拉取这 50 个 ASIN 的当前属性，展开写进我的表格。”

> “把我改过的行提交到亚马逊。”

## 生成模板的两种调用方式 [#生成模板的两种调用方式]

同一个工具、同样的参数——通过 AI 客户端，或者从你自己的代码。

**MCP**——你说出商品类型；AI 调用 `listings_prepare_publish_queue_template`，再用表格工具把模板写进你的表格。

<ToolCall tool="listings_prepare_publish_queue_template" args="{ productTypes: [&#x22;LUGGAGE&#x22;] }" lang="zh" />

<Callout type="warn" title="需要写权限">
  提交商品或 Feed 会改动你的 Listing，所以该店铺需要写权限（见[掌控你的 AI](/zh/docs/mcp-api/control)）。模板、拉取、属性说明和 payload 预览只需读权限。提交的更新会用这一行替换 Listing 的属性，所以先拉取、再在其基础上修改。
</Callout>

## 本页用到的工具 [#本页用到的工具]

构建时从工具目录读取，每个工具带有自己的权限标签。

<ToolList domains="[&#x22;attributes&#x22;]" tools="[&#x22;listings_poll_feed_results&#x22;]" lang="zh" />

## 常见问题 [#常见问题]

### 提交之前能先检查吗？ [#提交之前能先检查吗]

可以——`listings_validate_rows` 先对这些行运行亚马逊的校验预览。见[创建 Listing](/zh/docs/mcp-api/workflows/listings-create)。

### 能在 Google 表格插件里做吗？ [#能在-google-表格插件里做吗]

可以——插件的商品目录面板在侧边栏运行同一个发布队列。见[插件按钮](/zh/help/sheets/buttons#sellers-catalogs)。

### 怎么知道哪些 Listing 需要处理？ [#怎么知道哪些-listing-需要处理]

从[查看与搜索 Listing](/zh/docs/mcp-api/workflows/listings-view)开始。
