查询店铺元字段列表

GET 
/openapi/2026-07/metafields-shop

获取店铺所有元字段的列表。

请求

Query参数

namespace string

命名空间

key string

元字段键名

type string
元字段值类型：
• JSON: JSON 值
• string: 字符串值
limit int64

每页返回的最大数量；默认 50

cursor uint64

分页游标

fields string

指定响应中需要返回的字段列表（逗号分隔，例如 ID,value,key）

create_at_max string

筛选创建时间不晚于该时间点的元字段；ISO-8601 格式（例如 2023-01-01T00:00:00Z）

create_at_min string

筛选创建时间不早于该时间点的元字段；ISO-8601 格式（例如 2023-01-01T00:00:00Z）

update_at_max string

筛选最后更新时间不晚于该时间点的元字段；ISO-8601 格式（例如 2023-01-01T00:00:00Z）

update_at_min string

筛选最后更新时间不早于该时间点的元字段；ISO-8601 格式（例如 2023-01-01T00:00:00Z）

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

metafields object[]

元字段列表

Array [

idstring

元字段 ID

store_iduint32

所属店铺 ID

owner_resourcestring

所属资源类型：

• shop: 店铺
• product: 商品
• product_image: 商品图片
• product_variant: 商品款式
• order: 订单
• page: 自定义页面
• customer: 顾客
• collection: 商品专辑
• blog: 博客
• article: 文章
• app: 应用

owner_idstring

所属资源的 ID（如商品 ID）

namespacestring

命名空间

keystring

元字段键名

typestring

元字段值类型：

• date: 日期
• date_time: 日期和时间
• weight: 重量
• volume: 体积
• dimension: 外形尺寸
• integer: 整数
• number_decimal: 小数
• file_reference: 文件引用
• single_line_text_field: 单行文本
• multi_line_text_field: 多行文本
• json: JSON
• color: 颜色
• rating: 评分
• url: URL
• boolean: 布尔值（true 或 false）
• string: 字符串

valueGoogleProtobufValue

元字段值；其数据类型由 type 字段决定（例如 red）

descriptionstring

元字段描述（例如 商品颜色）

definition_iduint64

关联的元字段定义 ID（例如 123456）

created_atstring

创建时间（ISO-8601 格式）

updated_atstring

最后更新时间（ISO-8601 格式）

]

cursoruint64

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "metafields": [
      {
        "id": "string",
        "store_id": 0,
        "owner_resource": "string",
        "owner_id": "string",
        "namespace": "string",
        "key": "string",
        "type": "string",
        "description": "string",
        "definition_id": 0,
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": 0,
    "has_more": true
  }
}