記事のサマリー(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で重複を除去すること。