エラーメッセージ「Throttled」の条件

Topic summary

GraphQL Admin APIで「Throttled」エラーが発生する条件についての質問。質問者は、このエラーがレート制限超過時のみ発生するのか、また「THROTTLED_DURING_CHECKOUT」との関連性について確認を求めている。

回答のポイント:

  • THROTTLED_DURING_CHECKOUTはStorefront APIのCheckoutErrorCodeであり、checkoutCreateなどのmutation実行時のレスポンスとして返される
  • 質問者が提示した"code": "THROTTLED"エラーとは異なるもの
  • 質問者のエラーはレート制限超過時に発生すると考えられる
  • 参考として、コミュニティフォーラムの投稿にレート制限超過時のレスポンス例が紹介されており、質問者のケースと非常に類似している

現状: 回答者は情報が限られているため確定的な回答は控えているが、レート制限超過が原因である可能性が高いと示唆している。

Summarized with AI on November 16. AI used: claude-sonnet-4-5-20250929.

GraphQL Admin APIで以下のエラーメッセージが存在しますが、この「Throttled」はレート制限超過時のみ発生いたしますでしょうか。

ドキュメントの「THROTTLED_DURING_CHECKOUT」が該当するかと思いますが発生条件がわからず、ご共有いただけますと幸いです。

https://shopify.dev/docs/api/storefront/2023-07/enums/CheckoutErrorCode#value-throttledduringcheckout

{
    "errors": [
        {
            "message": "Throttled",
            "extensions": {
                "code": "THROTTLED",
                "documentation": "https://shopify.dev/api/usage/rate-limits"
            }
        }
    ],
    "extensions": {
        "cost": {
            "requestedQueryCost": 752,
            "actualQueryCost": null,
            "throttleStatus": {
                "maximumAvailable": 1000.0,
                "currentlyAvailable": 666,
                "restoreRate": 50.0
            }
        }
    }
}

@otsunaccre

ドキュメントの「THROTTLED_DURING_CHECKOUT」が該当するかと思いますが発生条件がわからず

CheckoutErrorCodeは、

Storefront APIにて、例えば下記のようなmutationを実行した際の、

https://shopify.dev/docs/api/storefront/2023-07/mutations/checkoutcreate

checkoutUserErrors {
      # CheckoutUserError fields
    }

のレスポンスとして入ってくるもののようなので、

THROTTLED_DURING_CHECKOUTと、

{
            "message": "Throttled",
            "extensions": {
                "code": "THROTTLED",
                "documentation": "https://shopify.dev/api/usage/rate-limits"
            }
        }

には関連がないのではないかと思います。

この「Throttled」はレート制限超過時のみ発生いたしますでしょうか。

おそらく、そのはずです。

例えば、下記の投稿で、レート制限超過時のレスポンスのサンプルが紹介されています。

https://community.shopify.com/post/639510

細部は異なりますが、非常に近いと思いますし、

質問者様が掲載しているレスポンスにも、

https://shopify.dev/api/usage/rate-limits

がありますので、

少なくとも、質問者様の場合は、レート制限超過なのではないかと思います。

大した情報がなく恐縮です。

(キュー田辺)