客户账户 API 新增了对 Metafield 引用（Metafield references）的支持

我们已添加 metafield.reference 和 metafield.references 到 Customer Account API。这意味着引用型 Media 类型，包括 Media 类型，其中包括 MediaImage、 GenericFile、 Model3d和 视频，现在存在于当前支持 Customer Account API 上 metafields 的通用查询对象中。

Metaobjects 现在也可以通过 metafield.reference 在 Customer Account API 上进行查询。要启用对 metaobjects 的访问权限，请在 Admin 中编辑 metaobject 定义时切换 Customer Account API 访问开关。开启此值后，metaobjects 将对外暴露，并可供具有 customer_read_metaobjects 范围的应用程序访问。

通过 GraphQL Admin API 的新更改也可以实现此功能。我们已公开创建、更新和查询 CustomerAccess，可以设置为 READ 或 NONE。您可以在 MetaobjectAccess 对象上指定访问权限，当运行 通过 GraphQL Admin API 的新更改也可以实现此功能。我们已公开创建、更新和查询客户访问权限，该权限可设置为 READ 或 NONE。在运行 metaobjectDefinitionCreate 或 metaobjectDefinitionUpdate 变更时，您可以在 MetaobjectAccess 对象上指定访问权限。 或 通过 GraphQL Admin API 的新更改也可以实现此功能。我们已公开创建、更新和查询 Customer Access，其值可设置为 READ 或 NONE。在运行 metaobjectDefinitionCreate 或 metaobjectDefinitionUpdate 变更时，您可以在 MetaobjectAccess 对象上指定访问权限。 变更时。

以下是一些关于媒体类型和元对象的示例查询。

1. 通过客户查询媒体对象元字段引用（MediaImage）：

query { customer { metafield(namespace: "custom", key: "example") { namespace key jsonValue reference { __typename ... on MediaImage { image { url } } } } } } 2. 通过订单查询元对象元字段引用（注意，该元对象包含一个 MediaImage 引用）： order(id: "gid://shopify/Order/1") { metafield(namespace: "custom", key: "example") { __typename namespace key reference { __typename ... on Metaobject { id fields { type value key value reference { __typename ... on MediaImage { id image { altText url } } } } } } } }