EC・Shopify読了約15分

Shopifyの在庫・価格の一括更新が遅いとき|レート制限とBulk操作

3万件の更新は1件ずつで下限50分、250件ずつなら12秒。方式を計算で比べます。

記事の概要図

商品のバリエーションが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が公表している制限を確認します。

夜間同期の流れと、時間がかかる3か所の図

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は、プラットフォームの安定のために、制限を一時的に下げることがあるとも書いています。数字を契約書に書くのではなく、「応答のコスト情報を記録し、上限に近づいたら待つ」という作りにしてもらうことが大切です。

なお、管理画面にも一括で直す入口があります。商品を選んで「一括編集」を開くと、バリエーションごとの価格と在庫を、表計算のように並べて直せます。開発ストアで試した結果は、後ろの「検証したこと」にまとめています。

一括編集の画面で、4つのバリエーションの価格と在庫を入力した状態

3. 3万バリエーションの更新は、方式でどれだけ変わるのか

1件ずつと250件ずつでは、計算上の待ち時間が約250分の1になります。

3万バリエーションの在庫を更新する場面で、更新の送り方による時間の違いを計算します。変更操作のコストは、既定の10ポイントとして計算しています。実際のコストは異なる場合があるため、あくまで比較のための目安です。

ア. 1件ずつ更新30,000回300,0003,000秒(50分)1,500秒(25分)300秒(5分)
イ. 250件ずつ更新120回1,20012秒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側の処理時間が加わります。それでも、方式による差が桁で違うことは、はっきり読み取れます。

3方式の所要時間の比較図

ウのBulk操作は、資料によると、中身の実行がAPIの制限の対象外です。更新用の操作を作る呼び出し(bulkOperationRunMutation)も制限の対象外と書かれており、取得用の操作を作る呼び出しは、ふつうのミューテーションとして1回分のコストがかかります。そのため、件数が多い更新ほど、効果が出ます。

注意点があります。イのように件数を束ねる場合、1回でも失敗すると、250件分の扱いをどうするかを決めておく必要があります。失敗した束だけを再送するのか、1件ずつに分けて再送するのかは、設計の項目です。

4. Bulk操作には、どんな条件と制約があるのか

更新は24時間以内に終えること、JSONLファイルは100MBまでであることが主な条件です。

Bulk操作には、取得用(bulkOperationRunQuery)と、更新用(bulkOperationRunMutation)があります。確認した条件を整理します。

完了までの期限10日24時間
入力クエリ文字列JSONLファイル(最大100MB)
結果JSONLファイルのURLJSONLファイルの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回で送る件数11件ずつ。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の追加欄と受付形式

うまくいかなかった所・未検証のこと:

  • 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回分として扱われます。キーの付け方は、外注先と事前に決めておきます。

参照元・出典

FREE CONSULTATION

「うちの場合はどうか」から

記事の考え方を、そのままご自身の事業に当ててみたい方へ。アイデア段階でも、機能リストがある段階でも構いません。 2営業日以内に、担当者からメールでご返信します。営業のお電話はしません。相談は無料です。

運営:株式会社miitaso(会社概要)

RELATED