从 API 版本 2026-10 开始， shopifyqlQuery GraphQL Admin API 中的 shopifyql Query 查询返回一个新的 parseWarnings 字段，该字段位于 ShopifyqlQueryResponse上。此字段会显示非致命问题（例如使用了计划弃用的字段），以便您能够主动检测并解决这些问题。
变更内容
shopifyqlQuery现在会在您的结果旁返回一个parseWarnings字段。该字段始终存在：当成功的查询存在非致命问题时，它会返回警告消息列表；若无此类问题，则返回空列表。
与解释查询为何无法运行的parseErrors不同，parseWarnings仅在成功运行的查询中返回，并与tableData一同出现。警告不会阻止执行，但会突出显示您可能需要修复的潜在问题。
为何重要
警告有助于您在问题导致失败之前识别并解决它们，例如即将弃用或其他可能影响未来 API 版本中查询的更改。通过监控parseWarnings，您可以在 API 演进过程中保持 ShopifyQL 查询的兼容性。
操作指南
将parseWarnings添加到您的shopifyqlQuery选择集中，并在成功查询后像检查parseErrors一样检查它：
query { shopifyqlQuery(query: "FROM sales SHOW total_sales SINCE -7d") { tableData { columns { name } rows } parseWarnings parseErrors } }在此示例中，parseWarnings将包含与该查询相关的任何非致命警告，如果没有则为空列表。
了解更多
- shopifyqlQuery 查询参考
- ShopifyqlQueryResponse 对象
- ShopifyQL 查询语言
- API 版本控制