SuperAPI AI 工具集

metafield-bulk-update

通用与其它

查看项目

更新于 10-16 06:52

技能介绍

用途:该技能查询符合筛选条件的商品(或变体、客户),批量设置或删除 metafield 值,适用于材质成分、护理说明、产品规格等结构化数据更新。

主要能力:支持 resource_type 为 product、variant、customer;通过 filter(如 tag:summer-2026、vendor:Nike)筛选;指定 namespace、key、value、value_type 与 action(set 或 delete);dry_run 默认 true,可先预览受影响资源;输出 human 或 json 格式,并生成 CSV 文件 metafield_update_<YYYY-MM-DD>.csv,列为 resource_type, resource_id, title, namespace, key, old_value, new_value, action。

使用方式:需先完成 Shopify CLI 认证:shopify store auth --store <domain> --scopes read_products,write_products。API 作用域为 read_products、write_products。namespace 与 key 需已存在或在首次 set 时创建。核心 GraphQL 操作包括 products 查询、metafieldsSet 与 metafieldsDelete 变更,均针对 api_version 2025-01 校验。metafieldsSet 每次最多 25 个 metafield,技能会自动分批。

限制与安全:metafieldsSet 会覆盖已有值,不合并;metafieldsDelete 会永久删除。建议先用 dry_run: true 确认受影响商品列表及 namespace/key 正确。遇到 THROTTLED 可等待 2 秒重试最多 3 次;类型不匹配或删除时 namespace/key 不存在会记录并跳过。若筛选无匹配则退出并返回 0 条。运行前应确认 namespace/key 与店铺 metafield 定义一致,避免产生孤立 metafield。