SuperAPI AI 工具集

shopify-metafields

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

Shopify Metafields 用于在商品、订单、客户、店铺等 Shopify 资源上存储默认架构中不包含的附加数据,例如商品的洗涤说明。

概念上包含四部分:Namespace(命名空间,用于分组,如 my_app、global)、Key(具体字段名,如 washing_instructions)、Type(数据类型,如 single_line_text_field、number_integer、json)、Owner(承载数据的资源,如 Product ID、Shop ID)。

定义方面,建议尽量使用 Metafield Definitions(固定元字段),以便集成到后台管理界面并保证标准处理。创建路径为 Settings > Custom Data > [Resource] > Add definition,访问方式为 namespace.key。

在 Liquid 中可显示元字段,例如用 {{ product.metafields.my_app.washing_instructions }} 输出文本;文件或图片类型的元字段可通过 .value 取得后再配合 image_url 过滤输出;也可用 != blank 判断是否存在。

通过 API 读取可使用 GraphQL 查询,在 product 节点中指定 metafield(namespace, key) 获取 value 与 type。写入或更新使用 metafieldsSet mutation,传入 ownerId、namespace、key、type、value 等组成的 MetafieldsSetInput 数组,并检查返回的 userErrors。

私有元字段(Private Metafields)可用于对其他应用和店面隐藏数据,注意其无法通过 Liquid 直接访问,需使用 privateMetafield 相关查询与变更,并需要 read_private_metafields / write_private_metafields 权限范围;资料指出该方式现已较少使用,应用专属数据更推荐 app_data 元字段。

限制:私有元字段不能直接在 Liquid 中读取;使用前需确认权限范围。关于价格、平台支持范围等资料未提供的内容暂未说明。