**版本：202607**

# 查询元字段列表

**GET** `/openapi/2026-07/metafields/:owner_resource/:owner_id`

分页返回指定资源的元字段列表。

## 请求

**Path参数**

- `owner_resource` string (required)

  所属资源类型：

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

  所属资源的 ID

**Query参数**

- `namespace` string

  命名空间
- `key` string

  元字段键名
- `type` string

  元字段值类型：

  *   `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）
- `page_size` int64

  每页返回的最大数量
- `cursor` uint64

  分页游标
- `create_at_min` string

  筛选创建时间不早于该时间点的元字段；ISO-8601 格式（例如 `2022-12-02T09:46:30Z`）
- `create_at_max` string

  筛选创建时间不晚于该时间点的元字段；ISO-8601 格式（例如 `2022-12-02T09:46:30Z`）
- `update_at_min` string

  筛选最后更新时间不早于该时间点的元字段；ISO-8601 格式（例如 `2022-12-02T09:46:30Z`）
- `update_at_max` string

  筛选最后更新时间不晚于该时间点的元字段；ISO-8601 格式（例如 `2022-12-02T09:46:30Z`）
- `definition_ids` uint64[]

  元字段定义 ID 列表。 示例：?definition\_ids=1001&definition\_ids=1002

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `metafields` object[]

    元字段列表

    *   Array \[

    - `id` string

      元字段 ID
    - `store_id` uint32

      所属店铺 ID
    - `owner_resource` string

      所属资源类型：

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

      所属资源的 ID（如商品 ID）
    - `namespace` string

      命名空间
    - `key` string

      元字段键名
    - `type` string

      元字段值类型：

      *   `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`: 字符串
    - `value` GoogleProtobufValue

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

      元字段描述（例如 `商品颜色`）
    - `definition_id` uint64

      关联的元字段定义 ID（例如 `123456`）
    - `created_at` string

      创建时间（ISO-8601 格式）
    - `updated_at` string

      最后更新时间（ISO-8601 格式）
    *   \]
  - `next_cursor` uint64

    下一页游标
  - `total_count` int32

    元字段总数
  - `has_more` boolean

    是否有更多记录

```json
{
  "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"
      }
    ],
    "next_cursor": 0,
    "total_count": 0,
    "has_more": true
  }
}
```