商品のバリエーションが3万ある店で、基幹システムの在庫を毎晩Shopifyへ反映しています。以前は1時間で終わっていたのに、最近は朝になっても終わらず、開店時間に在庫が古いままの商品が残ります。外注先に聞くと「Shopifyの制限なので仕方ない」「プランを上げてください」「Bulk操作に作り直せば速くなります」と答えがばらばらで、見積もりの金額も大きく違います。どれが本当に効くのかが分からないまま、判断を迫られている状況です。こんなことはないでしょうか。
この記事では、Shopifyの公式な開発者向け資料で2026年11月16日に確認した制限の数字を使い、在庫と価格の一括更新が遅くなる理由を、更新の送り方ごとに計算で比べます。そのうえで、Bulk操作を選ぶ分かれ目、版(APIのバージョン)で変わる在庫更新の約束、見積もりで確認する項目を、記入例つきで示します。コードは載せず、発注側が外注先と話すための材料に絞ります。
この記事で分かること
結論から言うと、夜間の一括更新が遅い原因は、プランより更新の送り方にあることが多くあります。2026年11月16日に確認した公式資料の数字で計算すると、3万バリエーションを1件ずつ送ればStandardで下限50分、250件ずつなら12秒、Bulk操作ならAPIの制限の対象外です。
- GraphQL Admin APIの制限(プラン別のポイント、1回の入力の上限、取得件数の上限)と確認した日付
- 1件ずつ、250件ずつ、Bulk操作の3方式で、3万バリエーションの更新にかかる時間の計算
- 外注先に確認する項目と、版の更新で変わる在庫更新の約束
1. 夜間の同期が終わらない場面
典型的な構成は次のとおりです。基幹システムが夜間に、全商品の在庫と価格をまとめた表を出します。連携のプログラムが、その表を1行ずつ読み、Shopifyの管理用のAPIへ更新を送ります。商品が増えるたびに時間が延び、ある日から朝に食い込みます。
遅れの原因は、大きく3つに分けられます。
| 原因 | 症状 | 見分け方 |
|---|---|---|
| 送り方が1件ずつ | 件数に比例して時間が延びる | 1回の更新で扱う件数を外注先に聞く |
| 制限に当たって待っている | エラーのあとに待ちが入る | 連携の記録に制限超過のエラーが残るか |
| 取得でつまずいている | 更新前の現在庫の取得に時間がかかる、または途中で止まる | 現在庫を何件ずつ、何ページ取っているか |
多くの場合、原因は複数が重なっています。そのため、更新の方式を変えると、プランを変えなくても改善することがあります。次の章で、Shopifyが公表している制限を確認します。
2. Shopifyの一括更新の制限は、どんな数字なのか
制限は呼び出し回数ではなく、プランごとに回復するポイントで測られます。
2026年11月16日に、開発者向け資料で確認した内容を表にします。
| 項目 | 確認した内容 |
|---|---|
| GraphQL Admin APIの制限 | 呼び出しの回数ではなく、計算されたコスト(ポイント)で制限される |
| プランごとの回復の速さ | Standardは毎秒100ポイント、Advanced Shopifyは200、Shopify Plusは1000、Shopify for enterpriseは2000 |
| 変更操作(ミューテーション)の既定のコスト | 1回あたり10ポイント。ただし、項目ごとに別のコストが設定される場合があると書かれている |
| 1つのクエリの上限 | 1,000ポイント。プランにかかわらず |
| 配列で渡せる件数 | 1回の入力で250件まで。超えるとエラー |
| 取得できる件数 | 1ページ最大250件。ページ送りは25,000件で頭打ち |
| 制限の仕組み | 水が漏れるバケツのたとえ(leaky bucket)。平均が回復の速さ以下なら、短い急増は通る |
読み取り方を3つ書きます。
1つ目は、制限が「呼び出しの回数」ではなく「ポイント」で測られることです。1回の呼び出しで多くの件数を扱えば、ポイントの使い方が効率的になります。
2つ目は、プランによる差です。Standardの毎秒100ポイントと、Shopify Plusの毎秒1000ポイントは、回復の速さが10倍違います。ただし、これは「その店とそのアプリの組み合わせごと」の制限で、別のアプリや別のストアの呼び出しには影響しない、と資料に書かれています。
3つ目は、変更操作の既定のコストです。既定は10ポイントですが、資料は「個別の項目に別のコストを設定することがある」と書いています。実際のコストは、応答に含まれるコスト情報(requestedQueryCostとactualQueryCost)で確認できます。外注先に、実測した数字を出してもらうのが確実です。
また、これらの数字は、記事を書いた時点の資料に基づきます。Shopifyは、プラットフォームの安定のために、制限を一時的に下げることがあるとも書いています。数字を契約書に書くのではなく、「応答のコスト情報を記録し、上限に近づいたら待つ」という作りにしてもらうことが大切です。
なお、管理画面にも一括で直す入口があります。商品を選んで「一括編集」を開くと、バリエーションごとの価格と在庫を、表計算のように並べて直せます。開発ストアで試した結果は、後ろの「検証したこと」にまとめています。

3. 3万バリエーションの更新は、方式でどれだけ変わるのか
1件ずつと250件ずつでは、計算上の待ち時間が約250分の1になります。
3万バリエーションの在庫を更新する場面で、更新の送り方による時間の違いを計算します。変更操作のコストは、既定の10ポイントとして計算しています。実際のコストは異なる場合があるため、あくまで比較のための目安です。
| 方式 | 呼び出し回数 | 合計ポイント | Standard(毎秒100) | Advanced(毎秒200) | Plus(毎秒1000) |
|---|---|---|---|---|---|
| ア. 1件ずつ更新 | 30,000回 | 300,000 | 3,000秒(50分) | 1,500秒(25分) | 300秒(5分) |
| イ. 250件ずつ更新 | 120回 | 1,200 | 12秒 | 6秒 | 1.2秒 |
| ウ. Bulk操作 | 作成の呼び出しのみ | 作成の1回分 | 制限の対象外 | 制限の対象外 | 制限の対象外 |
計算の根拠を書きます。アは30,000×10=300,000ポイントです。Standardでは300,000÷100=3,000秒で、60で割ると50分です。Advancedは300,000÷200=1,500秒(25分)、Plusは300,000÷1,000=300秒(5分)です。イは、30,000÷250=120回で、120×10=1,200ポイントです。Standardでは1,200÷100=12秒になります。
この表は、制限による待ち時間の下限です。実際には、1回の通信にかかる時間や、Shopify側の処理時間が加わります。それでも、方式による差が桁で違うことは、はっきり読み取れます。
ウのBulk操作は、資料によると、中身の実行がAPIの制限の対象外です。更新用の操作を作る呼び出し(bulkOperationRunMutation)も制限の対象外と書かれており、取得用の操作を作る呼び出しは、ふつうのミューテーションとして1回分のコストがかかります。そのため、件数が多い更新ほど、効果が出ます。
注意点があります。イのように件数を束ねる場合、1回でも失敗すると、250件分の扱いをどうするかを決めておく必要があります。失敗した束だけを再送するのか、1件ずつに分けて再送するのかは、設計の項目です。
4. Bulk操作には、どんな条件と制約があるのか
更新は24時間以内に終えること、JSONLファイルは100MBまでであることが主な条件です。
Bulk操作には、取得用(bulkOperationRunQuery)と、更新用(bulkOperationRunMutation)があります。確認した条件を整理します。
| 項目 | 取得(query) | 更新(mutation) |
|---|---|---|
| 完了までの期限 | 10日 | 24時間 |
| 入力 | クエリ文字列 | JSONLファイル(最大100MB) |
| 結果 | JSONLファイルのURL | JSONLファイルのURL |
| 同時に動かせる数 | 2026-01以降は同じ種類を5つまで。それ以前は1つ | 同左 |
| 完了の知らせ | bulk_operations/finishのWebhook、または状況の確認 | 同左 |
読み取り方を書きます。
期限が違う。 更新は24時間以内に終わる必要があります。夜間に始めて朝までなら足りますが、入力が大きすぎる場合は分割します。
同時実行の数が版で変わる。 2026-01以降は、1つのアプリが同じ種類の操作を、1店舗あたり5つまで同時に動かせます。それ以前の版では1つでした。古い版のままの連携では、前の操作が終わるのを待つ作りになります。
完了の知らせは確実とは限らない。 資料は、Webhookの配信は必ず届くとは限らないため、状況の確認も併用する必要があるかもしれない、と書いています。外注先の設計で、知らせが来ない場合の確認の手順があるかを確かめます。
アプリの種類で準備が変わる。 パートナーが作った公開アプリやカスタムアプリは、Bulk操作を使うために、管理画面で許可の申請が要ります。31日間Bulk操作を使わないと、再び有効にする必要があります。店の管理画面や開発ダッシュボードで作ったアプリは、現時点では不要と書かれています。
1回の更新で、どこまでの形を渡せるかを確かめる。 更新用に渡せるミューテーションは、再帰を避けるための2つを除くほとんどですが、1つの接続フィールドまでという制限があります。在庫や価格の更新で、使いたい形がそのまま通るかは、試して確かめる必要があります。
5. 版で変わる在庫更新の約束
在庫を絶対値で設定するinventorySetQuantitiesについて、確認した資料には、版による違いが書かれています。
| 版 | 確認した内容 |
|---|---|
| 2026-01 | 重複を防ぐキー(idempotency key)を付けることが、任意になった |
| 2026-04 | 重複を防ぐキーが必須になった。各数量にchangeFromQuantity(更新前に想定している数量)を付ける必要があり、実際の数量と食い違うと、更新されずにCHANGE_FROM_QUANTITY_STALEのエラーになる。確認を省くには、その数量にnullを明示して渡す |
| 2026-04より前 | compareQuantityの食い違いでエラーになる。確認を省くにはignoreCompareQuantityを使う |
この変更は、発注側にとって2つの意味があります。
1つ目は、重複送信への強さです。通信が途切れて結果が分からないときに、同じキーで再送すれば1回分として扱われます。夜間の同期が途中で止まって再実行するとき、二重に引かれる心配が減ります。
2つ目は、更新前の数量の確認です。changeFromQuantityを付けて送ると、その間に店頭や別の経路で在庫が動いていた場合、更新が止まります。これは安全な動きですが、基幹を唯一の正とする店が、毎晩の全件上書きをするなら、確認を省く指定を使うかどうかを決める必要があります。資料は、確認を省くと、複数の更新が同時に走ったときに在庫の数がずれるおそれがある、と警告しています。
ここは版の違いで挙動が変わるため、現在の連携がどの版を使っているかを、必ず外注先に確認します。古い版を使い続けている連携は、版の更新のたびに、この手の変更に対応する作業が発生します。
6. 方式を選ぶ判断表
更新の方式は、件数と実行の頻度で決めます。
| 状況 | 向く方式 | 理由 |
|---|---|---|
| 1回の更新が数百件以下で、1日に数回 | 250件ずつの更新 | 件数が少なく、実装が単純で済む |
| 数千から数万件を夜間にまとめて更新 | Bulk操作の更新 | 制限の対象外で、結果をファイルで確認できる |
| 注文のたびの在庫の差し引き | 1件ずつ、または少数ずつ | 即時性が必要で、件数が少ない |
| 全商品の現在庫を取得してから比べる | Bulk操作の取得 | ページ送りは25,000件で頭打ちのため |
特に、取得の面は見落とされがちです。3万バリエーションの現在庫を、250件ずつ取得すると、30,000÷250=120ページです。ページ送りは25,000件で頭打ちと資料に書かれているため、それを超える件数を普通のページ送りで読むことはできません。件数が増えている店では、Bulk操作の取得か、絞り込みを入れる設計が必要です。
7. 見積もりで確認する項目
外注先に、書面で次を確認します。
| 確認項目 | 聞き方の例 | 記入例 |
|---|---|---|
| 更新の方式 | 1回の更新で何件を扱うか | 250件ずつ。夜間の全件はBulk操作 |
| 使う版 | どのAPIの版か。更新の時期はいつか | 2026-10。年に数回の更新を保守に含める |
| 実測の記録 | 応答のコスト情報を記録するか | 毎晩のコストの合計と最大値を記録 |
| 制限に達したとき | 待ってから再試行するか | 1秒待って再試行。上限回数あり |
| 途中停止からの再開 | 同じ更新を二重に送らない作りか | 更新ごとに重複防止のキーを付ける |
| 失敗した行の扱い | 失敗の記録と再送の手順 | 失敗した行だけをCSVで出し、翌朝に再送 |
| 取得の方法 | 全件の取得にBulk操作を使うか | 件数が25,000を超えるためBulk操作 |
| 完了の確認 | Webhookが届かないときの確認手順 | 状況の確認を5分おきに併用 |
この表を埋めるときの記入例の数字は、自店の件数に置き換えます。たとえば、バリエーションが3万、夜間の更新が1回、Standardプランなら、アの方式では計算上の下限が50分ですが、イの方式では12秒です。この違いを、外注先の見積もりに書かれた方式と照らし合わせます。
8. よくある失敗
失敗1 プランの変更で解決しようとする。 プランを上げると回復の速さは上がりますが、1件ずつ送る方式のままだと、効果が小さい場合があります。まず方式を見直します。
失敗2 制限の数字を固定値として設計する。 資料は、制限が一時的に下がることがあると書いています。数字ではなく、応答のコスト情報を見て待つ設計にします。
失敗3 取得のページ送りが25,000件で止まるのに気づかない。 商品が増えて、ある日から現在庫の比較が不完全になります。取得にBulk操作を使うか、絞り込みを入れます。
失敗4 版の更新を後回しにする。 在庫更新の約束は、2026-04で変わりました。古い版のまま、版の更新を保守の範囲外にしていると、更新のたびに緊急の改修になります。
失敗5 再実行で二重に反映される。 途中で止まった同期を再実行するとき、同じ更新を重ねて送る作りだと、在庫がずれます。重複を防ぐキーの設計を、見積もりの項目に入れます。
9. 記録1日分の読み方
最初の一歩で出してもらう記録は、次のように読みます。数字は記入例で、自店の記録に置き換えます。
| 記録の項目 | 記入例 | 読み方 |
|---|---|---|
| 更新した件数 | 30,000 | 第3章の計算の「件数」にそのまま使う |
| 1回で送る件数 | 1 | 1件ずつ。250件までの束にできる余地がある |
| 開始から終了まで | 320分 | 5時間20分。夜間に収まらない |
| 計算上の下限(Standard) | 50分 | 30,000×10÷100=3,000秒 |
| 下限との差 | 270分 | 320−50。通信と処理の時間、待ち、再試行が含まれる |
| 制限超過のエラーの回数 | 0 | 制限での待ちは少ない。送り方と通信回数が主因の可能性 |
この例では、制限超過のエラーがほとんど出ていないのに320分かかっています。制限ではなく、1件ずつ送る回数の多さが主因と読めるため、プランの変更ではなく、束ねる方式への変更が先です。逆に、制限超過のエラーが多く、1回の件数がすでに250件なら、Bulk操作かプランの検討に進みます。同じ「遅い」でも、記録の数字で、打つ手が変わります。
10. 最初の一歩
最初の一歩は、現在の夜間同期の記録を1日分、外注先に出してもらうことです。見るのは、更新の件数、1回で送る件数、開始と終了の時刻、制限超過のエラーの回数の4つです。この記録があれば、遅い理由が、送り方か、制限か、取得かを、今日の数字で見分けられます。
そのうえで、第3章の計算表の「件数」と「プラン」を自店の数字に置き換えると、方式を変えた場合の下限が分かります。
検証したこと
2026年11月17日に、Shopifyの開発ストア(Basicプランの開発ストア、日本語の管理画面、Chrome)で、管理画面からの一括更新を確かめました。この記事の中心であるAPIの制限やBulk操作は、鍵やアクセストークンを発行する操作になるため、測っていません。
- 手順1: 検証用の商品(4つのバリエーションを持つ)を選び、「一括編集」を開きました。商品名の行の下に、バリエーションが1行ずつ並び、基本価格と販売可能数量の列に直接入力できます。
- 手順2: 価格を12,000円と13,000円、在庫を10、10、5、5と入力しました。入力した在庫は「0→10」のように変更前後が表示されました(1枚目の画像)。保存すると「変更を保存しました」と出て、商品一覧には「30点の在庫」と表示されました。10+10+5+5=30で、入力の合計と合っています。所要時間は記録していません。
- 手順3: 商品一覧の「インポート」を開くと、CSVによる一括インポートの欄があり、受け付ける形式は.csv、.txt、.xlsと書かれていました。サンプルCSVのダウンロード案内もあります(2枚目)。

うまくいかなかった所・未検証のこと:
- CSVは、取り込みも書き出しも実行していません。インポートは画面を開いて読んだだけで、ファイルは入れていません。「エクスポート」は、1回目の操作で画面が開かず、中身を確認できていません。
- 今回直したのは4バリエーションです。数千件を管理画面で直したときの速さや、取り込みにかかる時間は測っていません。
- APIのコスト(毎秒のポイント)、制限超過のエラー、Bulk操作の期限や件数、重複防止のキー、版による違いは、すべて未検証です。公式資料の記載のままで、この記事の計算表も資料の数字からの計算です。
まとめ
- GraphQL Admin APIの制限はポイントで測られ、Standardは毎秒100、Advanced Shopifyは200、Shopify Plusは1000です。2026年11月16日に確認した資料に基づきます。
- 3万バリエーションを1件ずつ更新すると、計算上Standardで50分です。250件ずつなら12秒、Bulk操作なら制限の対象外です。
- 取得はページ送りが25,000件で頭打ちになるため、件数が多い店はBulk操作か絞り込みを使います。
- 在庫更新は2026-04で約束が変わりました。使っている版と、重複防止のキーを、外注先に確認します。
更新が遅い理由の切り分けや、方式の見積もり比較で迷うときは、連携の記録1日分を見ながら、一緒に整理できます。
よくある質問
Shopifyの在庫更新でレート制限に当たったら、どうなりますか。
GraphQL Admin APIでは、制限を超えるとエラーになります。開発者向け資料は、再試行までの待ち時間の目安を1秒としています(エラーの名前は、今回確認した資料のページでは確かめていません)。エラーを無視して送り続けるのではなく、待ってから再試行する作りかどうかを、外注先に確認します。
プランを上げると一括更新は速くなりますか。
確認した資料では、GraphQL Admin APIの制限は、Standardが毎秒100ポイント、Advanced Shopifyが200、Shopify Plusが1000と、プランで変わります。ただし、更新の送り方を変えるだけで時間が大きく縮む場合もあるため、プランの変更より先に更新方式を見直すのが先です。
Bulk操作は、どんな更新にも使えますか。
資料では、bulkOperationRunMutationにはほとんどのミューテーションを渡せますが、1つの接続フィールドに限られ、JSONLファイルは100MBまでで、24時間以内に終わる必要があります。商品の取得にはbulkOperationRunQueryがあり、こちらは10日以内に完了する必要があります。
更新が途中で止まったとき、同じ在庫更新を送り直しても二重になりませんか。
在庫を絶対値で設定するinventorySetQuantitiesには、2026-04以降、重複防止のキー(idempotency key)が必須と書かれています。同じキーで再送すれば、1回分として扱われます。キーの付け方は、外注先と事前に決めておきます。
参照元・出典
- Shopify API limits(Shopify developer docs)(確認日: 2026-11-16)
- GraphQL Admin API rate limits(Shopify developer docs)(確認日: 2026-11-16)
- Perform bulk operations with the GraphQL Admin API(bulk query)(確認日: 2026-11-16)
- Bulk import data with the GraphQL Admin API(bulk mutation)(確認日: 2026-11-16)
- inventorySetQuantities(GraphQL Admin API)(確認日: 2026-11-16)
- Paginating results with GraphQL(Shopify developer docs)(確認日: 2026-11-16)
- Idempotent requests(Shopify developer docs)(確認日: 2026-11-16)
FREE CONSULTATION
「うちの場合はどうか」から
記事の考え方を、そのままご自身の事業に当ててみたい方へ。アイデア段階でも、機能リストがある段階でも構いません。 2営業日以内に、担当者からメールでご返信します。営業のお電話はしません。相談は無料です。
運営:株式会社miitaso(会社概要)
RELATED