更新内容
截至2025-10,通过新增的admin_filterable功能,Shopify 管理后台中的元对象字段现在支持搜索和筛选,使元对象字段与用于元字段定义的现有能力框架保持一致,并允许商家按字段值筛选元对象列表以及基于字段条件创建保存视图。
实现
- 创建或更新字段定义:当创建或更新通过管理后台 GraphQL API 进行的元对象字段定义时,您现在可以指定能力:
mutation { metaobjectDefinitionCreate(definition: { name: "Product Metadata" type: "product_metadata" fieldDefinitions: [ { key: "brand" name: "Brand" type: "single_
line_text_field" capabilities: { adminFilterable: { enabled: true } } } ] }) { metaobjectDefinition { id fieldDefinitions { key capabilities { adminFilterable { enabled } } } } } }
- 查询能力状态:在查询元对象字段时,检查admin_filterable能力的状态:
query { metaobjectDefinition(id: "gid://shopify/MetaobjectDefinition/123") { fieldDefinitions { key name capabilities { adminFilterable { enabled } } } } }