SuperAPI AI 工具集

shopify-metafields-metaobjects

编程与开发

查看项目

更新于 10-15 23:29

技能介绍

用途:在 Shopify 中管理自定义数据。Metafields 将键值数据附加到既有资源(商品、变体、订单、客户);Metaobjects 定义带自定义 schema 的全新内容类型,可满足多数自定义数据需求而无需外部数据库。

前提:需完成 shopify-install-auth 设置,并具备 read_metaobjects、write_metaobjects、read_metaobject_definitions、write_metaobject_definitions 权限;各资源的元字段还需对应读写权限,如商品元字段需 read_products/write_products。

主要能力:

  1. 定义元字段:用 metafieldDefinitionCreate,指定 namespace、key、type、ownerType,pin 可设为 true 以在后台界面显示。
  2. 批量设值:用 metafieldsSet,每次最多 25 个元字段。
  3. 创建元对象定义:用 METAOBJECT_DEFINITION_CREATE 定义内容类型、字段与访问权限(如 storefront: PUBLIC_READ)。
  4. 创建元对象实例:用 METAOBJECT_CREATE 写入带类型字段的实例,可通过 Storefront 与 Admin API 查询。

错误处理:TAKEN 表示同 owner 类型下命名空间加键已存在,可改用 metafieldDefinitionUpdate 或换 key;INVALID_TYPE 需核对类型注册表;INVALID_VALUE 需按声明类型转换值;TOO_LONG 表示超出类型限制(文本类型为 512KB),需截断或改用 multi_line_text_field。注意 Shopify 即使校验失败也可能返回 200,务必检查 userErrors。

限制:各类型取值范围与格式受 Shopify 类型注册表约束;批量调用每次上限 25 个。详细类型、TOML 配置与批量操作参见资料链接,本资料未提供更多内容。