跳到主要内容

类型

每个元字段都有一个类型，用于定义其可存储的信息类型。元字段类型具有内置的验证功能和 Liquid 支持。

工作原理​

对于元字段定义，该类型将在拥有该元字段定义的资源的每个实例中强制执行。例如，如果您创建了一个名为"shipping"的元字段定义，类型为 multi_line_text_field，所有者类型为 PRODUCT，则每个商品资源的元字段类型都将是 multi_line_text_field。

{
  "product": {
    "metafields": {
      "namespace": "custom",
      "key": "shipping",
      "type": "multi_line_text_field",
      "value": "All health potions are made to order, so it might take up to 2 weeks before your order can be shipped.\n\nThanks for your patience!"
    }
  }
}

支持的类型​

元字段可以使用以下表格中包含的任意类型：

类型 描述 示例值 值类型
boolean true 或 false 值。 true boolean
color 颜色的十六进制代码。 #FFA500 string
date ISO 8601 格式的日期，不预设时区。 2030-12-31 string
date_time ISO 8601 格式的日期和时间，不预设时区。 2023-07-31 12:20:20 string
dimension 长度数值及单位。有效单位值：mm、cm、m、in、ft、yd。 {
    "unit": "MILLIMETERS",
    "value": 98.2
} 		JSON object
json 可序列化为 JSON 的值，可以是对象、数组、字符串、数字、布尔值或 null 值。 {
    "temperature": 700,
    "unit": "degrees",
    "scale": "Fahrenheit"
} 		JSON object
multi_line_text_field 多行文本字段。 All health potions are made to order, so it might take up to 2 weeks before your order can be shipped.

Thanks for your patience! 		string
number_decimal 带小数点的数字。 8.4 number
number_integer 整数。 3 number
rating 按指定刻度衡量的评分。 {
    "scale_max": "10.0",
    "scale_min": "0.0",
    "value": 4.5
} 		JSON object
single_line_text_field 单行文本字段。 Take with a meal. string
url 使用允许协议的 URL：https、http。 https://www.shoplazza.com/ string
volume 体积数值及单位。有效单位值：ml、cl、L、m3、fl oz、pt、qt、gal、imp fl oz、imp pt、imp qt、imp gal。 {
    "unit": "MILLILITERS",
    "value": 250
} 		JSON object
weight 重量数值及单位。有效单位值：kg、g、lb、oz {
    "unit": "GRAMS",
    "value": 50
} 		JSON object

引用类型​

引用类型元字段允许您存储对 Shoplazza 资源的引用。

类型

描述

示例值

值类型

collection_reference

对在线商店中某个分类的引用。

collection object

JSON object

file_reference

对在线商店中某个文件的引用。默认值为 Image。

{
"mediaContentType": "IMAGE",
"image": image object
}

JSON object

product_reference

对在线商店中某个商品的引用。

product object

JSON object