ShopifyQLクエリに警告フィールド parseWarnings 追加

API バージョン

利用開始は 2026-10 以降。それ以前の API バージョンを指定したリクエストでは parseWarnings フィールドは返らない（選択セットに含めるとエラーになる可能性あり）。

フィールドの性質

parseWarnings は 常に存在する（null にはならない）。警告なし時は空リスト []、警告あり時はメッセージの配列を返す。null チェックは不要。

tableData との関係

parseWarnings は tableData と同時に返される。クエリが失敗して parseErrors のみ返る場合は parseWarnings は存在しない（成功時のみ）。

クエリ記述例

query {
  shopifyqlQuery(
    query: "FROM sales SHOW total_sales SINCE -7d"
  ) {
    tableData {
      columns { name }
      rows
    }
    parseWarnings
    parseErrors
  }
}

移行・対応手順

① API バージョンを 2026-10 以上に更新 → ② shopifyqlQuery の選択セットに parseWarnings を追加 → ③ レスポンス処理ロジックに警告チェックを実装。parseErrors チェックと同様のパターンで対応可。