metaobject

query

需要 unauthenticated_read_metaobjects 权限点。

接口访问需要令牌，具体如何获取令牌参考：身份认证。

查询单个元对象详情。

Arguments

id ● String

元对象 ID。

handle ● MetaobjectHandleInput

元对象的标识。

Return

fields ● [MetaobjectField!]!non-null

元字段列表。

handle ● String!non-null

元对象的唯一标识符。

id ● ID!non-null

元对象 ID。

type ● String!non-null

元对象的类型。

updatedAt ● Date!non-null

元对象更新的日期和时间。
格式：ISO 8601。

createdAt ● Date!non-null

元对象的创建日期和时间。
格式：ISO 8601。

错误码

关于更多通用错误码说明，参考：状态码和错误码。

Example

查询一个元对象

Code

query GetMetaobject($id: String!) {
  metaobject(id: $id) {
    id
    type
    handle
    fields {
      key
      type
      value
    }
    createdAt
    updatedAt
  }
}

Response

{
	"data": {
		"metaobject": {
			"createdAt": "2026-04-08T02:40:00Z",
			"fields": [
				{
					"key": "fabric_name",
					"type": "single_line_text_field",
					"value": "100% Organic Cotton"
				},
				{
					"value": "40",
					"key": "washing_temperature",
					"type": "number_integer"
				},
				{
					"key": "is_machine_washable",
					"type": "boolean",
					"value": "true"
				},
				{
					"key": "care_instructions",
					"type": "multi_line_text_field",
					"value": "Machine wash warm. Do not bleach. Line dry in shade."
				}
			],
			"handle": "cotton_basic_care",
			"id": "9876543210",
			"type": "material_care_guide",
			"updatedAt": "2026-04-08T03:20:00Z"
		}
	}
}

这篇文章对你有帮助吗？

SHOPLINE

条款协议