用途:该技能查询匹配标签、供应商、集合或状态条件的 Shopify 商品,并将其批量切换到目标状态(DRAFT、ACTIVE 或 ARCHIVED)。典型场景包括季节性上架(DRAFT→ACTIVE)、季末下架(ACTIVE→ARCHIVED)以及上线前预置(先建为 DRAFT,到日期再激活)。
前置条件:已认证的 Shopify CLI 会话,命令为 shopify store auth --store <domain> --scopes read_products,write_products;所需 API 权限为 read_products、write_products。
参数:store(必填,店铺域名)、filter(必填,商品筛选查询,如 tag:summer-2026、vendor:Nike、status:draft)、target_status(必填,ACTIVE/DRAFT/ARCHIVED)、dry_run(可选,默认 true,仅预览不执行变更)、format(可选,默认 human,可选 json)。
主要能力与流程:先通过 products 查询按 filter 分页拉取商品(first:250,跟随游标直到 hasNextPage 为 false),跳过已处于目标状态的商品,再对剩余商品调用 productUpdate 变更 status。实现基于 api_version 2025-01 的 GraphQL 操作。
安全注意:ARCHIVED 商品会从所有销售渠道隐藏且无法购买;ACTIVE 商品会立即对顾客可见。建议先用 dry_run: true 复核商品清单,尤其是 ARCHIVED 批量切换难以回退。
输出与错误处理:生成 lifecycle_update_<YYYY-MM-DD>.csv,列为 product_id、title、previous_status、new_status、vendor、tags;human 与 json 两种结果摘要格式。遇 THROTTLED 等待 2 秒并最多重试 3 次;userErrors 记录并跳过继续;无匹配商品时以 0 匹配退出并建议放宽筛选。
最佳实践:运行前用标签标记季节批次(如 launch:2026-05)以提高筛选精度;大批量(500+)商品受速率限制影响可能耗时数分钟;激活 DRAFT 前可先配合 product-data-completeness-score 检查必填字段。
限制:依赖 Shopify CLI 认证与 read_products、write_products 权限;筛选表达式语法、价格与收费信息、支持的具体店铺类型等资料暂未提供。