解決できる課題 事業紹介トップ 経営データ分析基盤 AI導入・業務改善 AI 業務アプリ 基幹システムのWeb化・段階移行 複雑な SaaS を専用 UI に Shopify Plus 移行・拡張 生成AI 活用(Multi AI) SEO / AIO / 広告運用 顧問・アドバイザリ インフラ構築 PHP脆弱性対策・更新 WordPressからEmDashへの移行 自社メディア投資・開発
AI導入 AI導入・業務改善 ChatGPTの社内導入 OpenAI Codex導入 AI運用・定着 Claude / MCP 総合 Claude Cowork Claude Code 導入支援 Claude Code 使いこなし支援 Claude Design MCP 開発・サーバー構築
EC構築・移行 Shopify Plus トップ EC-CUBEからShopifyへの移行 大手カートからの移行 Shopify 通常プラン EC サイト構築
実績
業界ニュース 業界ニュース トップ AI ニュース └ Claude └ ChatGPT・Codex └ Gemini └ その他 Shopify ニュース SaaS ニュース お知らせ(自社発信)
会社情報 相談する
2026.10.22

Shopify GraphQL Admin API、>フィルタの秒単位の挙動がAPIバージョン2026-10で変更

記事のサマリー(TL;DR)

  • Shopify GraphQL Admin APIのAPIバージョン2026-10から、タイムスタンプフィルタに対する排他的下限(>)の指定が、その秒全体を除外するように変更されました。例えば created_at:>'2026-09-15T12:00:02Z' は、12:00:02.500 に作成された注文をもう返しません。
  • この変更は、>の値に小数秒が含まれない場合にのみ影響し、>=、<、<=、日付のみの値(例:created_at:>2026-09-15)、小数秒付きの値(例:created_at:>'2026-09-15T12:00:02.250Z')はどのバージョンでも変わりません。
  • APIバージョン2026-07以前を使用しているアプリは変更の必要はありません。2026-10へ移行する前に、GraphQL Admin APIのクエリ引数内でタイムスタンプフィルタに小数秒なしの>境界を渡しているアプリ(例:ordersクエリのcreated_at)は、既存のフィルタを確認する必要があります。

背景にある条件と対応方法

この変更は、GraphQL Admin APIのクエリ引数においてタイムスタンプフィルタに小数秒を含まない>境界を送信しているアプリに影響します。例としては、ordersクエリのcreated_atが挙げられています。

2026-07以前のAPIバージョンを使用しているアプリは、何も変更する必要はないとされています。2026-10へアプリを移行する前に、以下の点を確認するよう案内されています。

  • 以前のレスポンスから取得したタイムスタンプを>境界として渡しているクエリを特定すること。例えば、アプリが最後に確認したレコードより新しいレコードを取得する場合などです。
  • 同じ秒内に作成された後続レコードを取りこぼしてはならない場合は、そのタイムスタンプに対して>=を使用し、idによって重複を除去することが案内されています。

案内されているクエリ例は以下の通りです。

query OrdersSinceLastSync {
  orders(first: 50, sortKey: CREATED_AT, query: "created_at:>='2026-09-15T12:00:02Z'") {
    nodes {
      id
      createdAt
    }
  }
}

詳細

変更内容

GraphQL Admin APIはcreatedAtなどのタイムスタンプを秒単位で返しますが、内部的には一部のリソースが小数秒付きでタイムスタンプを保持しています。

2026-10より前は、created_at:>'2026-09-15T12:00:02Z'は12:00:02.000000と比較されていました。このため、その秒の後半に作成されたレコードも返され、レスポンス上ではそれらのレコードがcreatedAt: "2026-09-15T12:00:02Z"として表示されていました。さらに、同じレコードがcreated_at:<='2026-09-15T12:00:02Z'にも一致していました。

2026-10以降は、>の値に小数秒が含まれない場合、フィルタはその秒の終わり(12:00:02.999999)の後から開始されます。あるレコードが>Tに一致するのは、APIがそのレコードについて返すタイムスタンプがTより後である場合に限られるため、>Tと<=Tは重複しなくなります。

以下のフィルタは、どのバージョンでも変更されません。

  • >=、<、<=
  • 日付のみの値(例:created_at:>2026-09-15)
  • 小数秒付きの値(例:created_at:>'2026-09-15T12:00:02.250Z')

影響を受けるアプリ

GraphQL Admin APIのコネクションのクエリ引数において、タイムスタンプフィルタに小数秒なしの>境界を送信しているアプリが対象です。例として、ordersクエリのcreated_atが挙げられています。

対応方法

APIバージョン2026-07以前のアプリは、何も変更する必要はありません。2026-10へ移行する前に、アプリの>フィルタを確認することが案内されています。

  • 以前のレスポンスから取得したタイムスタンプを>境界として渡しているクエリを特定すること(例:アプリが最後に確認したレコードより新しいレコードを取得する場合)。
  • 同じ秒内に作成された後続レコードを取りこぼしてはならない場合は、そのタイムスタンプに>=を使用し、idで重複を除去すること。