ShopifyQL 现已作为 shopifyqlQuery 在 GraphQL Admin API 中提供

开发者现在可以利用 ShopifyQL，通过 GraphQL Admin API 从所有商家分析数据（包括销售、客户和产品数据）中提取有价值的洞察。这一增强功能使得更复杂的数据分析和报告成为可能。

如需了解 ShopifyQL 语言的全面指南，请访问ShopifyQL 语法文档。

shopifyqlQuery字段现在可在 GraphQL Admin API 的QueryRoot中使用。有关使用此新查询字段的更多信息，请参阅我们的详细文档。

例如，以下查询演示了如何检索按月份分组的总销售额数据，时间范围从当前年初开始：

{ shopifyqlQuery(query: "FROM sales SHOW total_sales GROUP BY month SINCE startOfYear(0y) ORDER BY month") { tableData { columns { name dataType displayName } rows } parseErrors } }

响应包含表格数据，其中列出了每月的总销售额，并提供了列名和行值等详细信息。

{ "data": { "shopifyqlQuery": { "tableData": { "columns": [ { "name": "month", "dataType": "MONTH_TIMESTAMP", "displayName": "Month" }, { "name": "total_sales", "dataType": "MONEY", "displayName": "Total sales" } ], "rows": [ { "month": "2025-01-01", "total_sales": "5542.954" }, { "month": "2025-02-01", "total_sales": "1610.094" } ] }, "parseErrors": [] } } }

执行过程中遇到的任何解析错误都将列在parseErrors下。