属性与发布队列
把表格里的单元格转成亚马逊格式的属性 JSON（也能反向转换），校验后从发布队列表格一次发布大量 Listing。
一句话
为一个或多个商品类型生成发布队列表格，填写单元格（或拉取亚马逊现有内容），然后提交。SellerSheet 把每个单元格转换成亚马逊要求的属性格式，也能反向转换。
一步一步
生成表格
“为商品类型 LUGGAGE 准备一个发布队列模板。” listings_prepare_publish_queue_template 打包生成发布队列标签页所需的一切，可同时覆盖多个商品类型——各类型的列自动合并，必填列在前。
填写——或从线上内容开始
listings_fetch_attributes_by_skus 拉取你自己的 Listing 并把属性展开成单元格；listings_fetch_attributes_by_asins 对任意 ASIN 的目录属性做同样的事，listings_parse_asin_to_cells 把单个 ASIN 映射到表格的列上。listings_get_attribute_guide 解释某个属性：格式、单位和允许的取值。
核对转换结果
listings_build_payload 把单元格的值转成亚马逊的属性 JSON，让你看清将要提交的内容；listings_parse_payload 反向转换。
提交
listings_submit_items 按 SKU 一步生成并提交；listings_submit_feed 通过亚马逊 Feeds API 提交整批，listings_poll_feed_results 读取亚马逊接受或拒绝的结果。
可以这样问
“为商品类型 LUGGAGE 准备一个发布队列模板。”
“拉取这 50 个 ASIN 的当前属性，展开写进我的表格。”
“把我改过的行提交到亚马逊。”
生成模板的两种调用方式
同一个工具、同样的参数——通过 AI 客户端，或者从你自己的代码。
MCP——你说出商品类型；AI 调用 listings_prepare_publish_queue_template，再用表格工具把模板写进你的表格。
在 AI 客户端中（MCP）
{
"name": "listings_prepare_publish_queue_template",
"arguments": {
"store": "myStore-US",
"productTypes": [
"LUGGAGE"
]
}
}在代码中（Tool API）
curl -X POST https://api.sellersheetai.com/api/v1/tools/listings_prepare_publish_queue_template \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","productTypes":["LUGGAGE"]}'需要写权限
提交商品或 Feed 会改动你的 Listing，所以该店铺需要写权限（见掌控你的 AI）。模板、拉取、属性说明和 payload 预览只需读权限。提交的更新会用这一行替换 Listing 的属性，所以先拉取、再在其基础上修改。
本页用到的工具
构建时从工具目录读取，每个工具带有自己的权限标签。
| 工具 | 权限 | 作用（英文） |
|---|---|---|
listings_poll_feed_results | write | Check the feeds behind the Submission Log's unfinished Submit Feed rows and get back the cells to write: Feed Status, Result, Issues, Raw Response. |
listings_build_payload | read | Build Amazon-shaped attribute JSON from a Publish Queue row's flat cells, per SKU, driven by the productType schema. |
listings_fetch_attributes_by_asins | read | Bulk fetch + flatten Amazon catalog attributes for N ASINs in ONE call. |
listings_fetch_attributes_by_skus | read | Bulk fetch + flatten Amazon listings attributes for N OWNED SKUs in ONE call. |
listings_get_attribute_guide | read | The row-4 guide (format, unit, allowed values, example) for each Publish Queue column of a productType — one per flat-file key, so item_weight has one for #1.value and one for #1.u |
listings_parse_asin_to_cells | read | Convenience: fetch an ASIN's catalog attributes from Amazon and return flat, operator-readable cell values. |
listings_parse_payload | read | Turn Amazon attribute JSON you already hold (from listings_getListingsItem or catalogItems_getCatalogItem) into Publish Queue cells keyed by Amazon's flat-file keys — the inverse o |
listings_prepare_publish_queue_template | read | Everything needed to seed a Publish Queue tab for N productTypes in one call: one bundle for a single productType, or ONE merged bundle keyed by the joined names ("TOWEL,HEADPHONES |
listings_submit_feed | destructive | Bulk publish through Amazon's Feeds API (JSON_LISTINGS_FEED) — the sidebar's "Submit Listing" parity, for 10+ SKUs up to ~25,000 per call; for interactive edits of ≤20 SKUs with pe |
listings_submit_items | destructive | Build Amazon-shaped payloads from Publish Queue cells AND submit them per SKU through the listings-items API in one call — the same input shape as listings_build_payload, then one |
常见问题
提交之前能先检查吗？
可以——listings_validate_rows 先对这些行运行亚马逊的校验预览。见创建 Listing。
能在 Google 表格插件里做吗？
可以——插件的商品目录面板在侧边栏运行同一个发布队列。见插件按钮。
怎么知道哪些 Listing 需要处理？
从查看与搜索 Listing开始。