用途：为 Shopify 资源（商品、变体、订单、客户、集合、页面）附加结构化自定义数据，无需自建数据库；Metafield 定义负责类型校验，并让数据可在 Liquid 模板编辑器和 Storefront API 中使用。Metaobject 可进一步创建可复用的独立自定义数据结构。
主要能力：支持文本、数字、日期、布尔、URL、JSON、颜色、重量、体积、尺寸、评分、文件引用、商品/变体/集合/页面引用、metaobject 引用及 list 类型；可通过 Admin API 创建定义、写入值，在 Liquid 中通过 product.metafields.namespace.key 读取，在 Storefront API 中按 namespace 与 key 显式查询。
使用方式：先用 metafieldDefinitionCreate 创建定义（如 namespace 为 custom、key 为 care_instructions、type 为 multi_line_text_field、ownerType 为 PRODUCT），再用 metafieldsSet 写入值；批量写入每批最多 25 条。Liquid 中可用 metafield_tag 过滤器渲染富文本与文件引用。Metaobject 通过 metaobjectDefinitionCreate 与 metaobjectCreate 创建条目。
适用场景：商品附加属性（护理说明、尺寸、认证）、客户级数据（会员等级、订阅状态、B2B 账号）、主题内容管理区块（FAQ、尺码指南）、结账订单级自定义数据、可复用结构化内容条目。
限制与注意：写入前必须先创建定义，否则数据以原始 JSON 呈现；默认不公开，需设 visibleToStorefrontApi: true 才能在主题或无头前端读取；值需为与类型匹配的 JSON 序列化字符串；建议用 custom 命名空间存放商家数据，应用数据用应用句柄前缀避免冲突。