在 shopify.app.toml 中，可配置 Shopify 的元对象定义的分析查询能力。

应用现在可以在capabilities.analytics_queryable中为metaobject定义设置shopify.app.toml，这使得这些定义上兼容的字段可在Shopify分析和ShopifyQL中进行查询。此功能适用于在应用配置中声明metaobject定义的应用。无需采取任何操作，因为除非添加该键，否则该功能默认处于关闭状态。

变更内容

在 shopify.app.toml 的 [metaobjects.app. ] 下声明的元对象定义现在支持 capabilities.analytics_queryable。当将其设置为 true 时，定义中任何具有分析兼容类型的字段（例如 single_ line_text_field、number_integer、date 或 product_reference）均可作为维度和筛选器在分析 报告和 ShopifyQL 中使用。只要产品、产品变体、客户或订单的元字段引用了该元对象，此功能即可生效。其他类型的字段将被忽略。 [metaobjects.app. ] 在 shopify.app.toml 现在支持 capabilities.analytics_queryable。当将其设置为 true时，定义中任何具有分析兼容类型的字段（例如 single_line_text_field、 number_integer、 date或 product_reference）均可作为维度和筛选器在分析报告和 ShopifyQL中使用。只要产品、产品变体、客户或订单的元字段引用了该元对象，此功能即可生效。其他类型的字段将被忽略。

此前，应用只能通过 GraphQL Admin API 设置此功能，且仅适用于未在 TOML 中管理的定义。由于通过 API 读取声明式定义是只读的，因此无法使其可查询。

受影响范围

此功能适用于在shopify.app.toml中声明metaobject定义的应用。现有定义不会发生变化。如果某个定义未包含该键，则该功能保持关闭状态。

以下情况不适用：

• 通过GraphQL管理API创建的metaobject定义。对于这些定义，请在API版本2027-01或更高版本中使用metaobjectDefinitionCreate或metaobjectDefinitionUpdate突变来设置analyticsQueryable。
• 由商家拥有的元对象定义。商家可在 Shopify 管理后台自行开启或关闭这些定义的分析功能。

操作指南

无需执行任何操作。若要在分析功能中查询已声明的元对象定义：

1. 在shopify.app.toml的定义中添加capabilities.analytics_queryable = true，并确保其至少有一个字段具有分析兼容类型。
2. 将应用配置部署到开发商店。
3. 确认在GraphQL管理API版本2027-01或更高版本中，定义的capabilities.analyticsQueryable.enabled字段为true，并且其字段出现在引用它的产品、变体、客户或订单元字段的分析报告中。

[metaobjects.app.designer] name = "Designer" capabilities.analytics_queryable = true [metaobjects.app.designer.fields.country] name = "Country" type = "single_line_text_field"

此示例使designer metaobject的country字段可查询。请替换为您自己的定义和字段。如果定义的字段中没有一个是兼容类型，发布将验证失败，因此在部署前请添加或更改一个字段。

相关文档

• 使您的元对象在分析功能中可查询
• 元对象 TOML 参考
• metaobjectDefinitionCreate 变异