開発者向けの変更です。
2026年12月1日以降に作るカスタムアプリは、期限付きのオフラインアクセストークンを使う必要があります。
対象は2026年12月1日以降に作るアプリです
発表は2026年11月19日の developer changelog。
出典: Shopify developer changelog「Expiring offline access tokens required for new custom apps as of December 1, 2026」2026年11月19日
https://shopify.dev/changelog/posts/expiring-offline-access-tokens-required-for-new-custom-apps-as-of-december-1-2026
フラグは「Update」です。
タグは「Admin REST API」と「GraphQL Admin API」。
Starting December 1, 2026, every new custom app must request and use expiring offline access tokens for GraphQL Admin API and REST Admin API requests. This has been required for new public apps since April 1, 2026. This update extends the requirement to new partner-created custom apps and merchant-created apps.
(2026年12月1日から、新しいカスタムアプリは全て、GraphQL Admin API と REST Admin API の要求に期限付きのオフラインアクセストークンを求めて使う必要があります。新しい公開アプリには2026年4月1日から求めていました。今回、パートナーが新しく作るカスタムアプリと、店が作るアプリに広げます)
対象は次の2つです。
- 2026年12月1日以降に作るカスタムアプリ
- 2026年12月1日以降に店が作るアプリ
12月1日より前に作ったカスタムアプリと店が作ったアプリは今のオフライントークンを使い続けられます
対象外は、2026年12月1日より前に作ったカスタムアプリと店が作ったアプリ。
Existing custom apps and merchant-created apps that were set up before December 1, 2026 can keep using their existing offline tokens.
(2026年12月1日より前に設定したカスタムアプリと店が作ったアプリは、今のオフライントークンを使い続けられます)
公開アプリも、今回の対象外です。
新しい公開アプリには、2026年4月1日から同じ決まりがあります。
すでに期限付きトークンを求めているアプリは、手直しが要らない見込みと公式は書いています。
要求に expiring=1 を足し、リフレッシュトークンを保存します
対象は、token exchange か authorization code grant でトークンを取るアプリ。
公式の手順は次の3つです。
- オフラインアクセスのトークン要求に
expiring=1を含める - Shopify が返すリフレッシュトークンを保存する
- 今のトークンが切れたら、リフレッシュトークンで新しいアクセストークンを取る
Shopify のアプリのテンプレートやライブラリを使っているなら、新しい版かを見ます。
新しい版は、既定で期限付きトークンを求める作り。
client credentials grant のトークンはそのままで条件を満たします
client credentials grant で取るトークンは、もともと24時間で切れます。
Tokens that you obtain through the client credentials grant already expire after 24 hours, so this flow already meets the requirement.
(client credentials grant で取るトークンはもともと24時間で切れるので、この流れは条件を満たしています)
application-only access で取るトークンも、もともと条件を満たす扱い。
「手直しは要らない」と公式が書いているのは、client credentials grant のほうです。
理由は漏れたトークンを使える時間を縮めることです
期限の無いトークンは、漏れたあとも、アプリが外されるかシークレットを入れ替えるまで使えます。
A non-expiring token keeps working until the app is uninstalled or you rotate the app secret, which increases the risk from a leak.
(期限の無いトークンは、アプリが外されるか、アプリのシークレットを入れ替えるまで動き続けます。そのぶん、漏れたときの危険が大きくなります)
期限付きのトークンは、アプリがリフレッシュしない限り、決まった時間で使えなくなる仕組み。
店が自分で作るアプリも対象に入ります
店が作るアプリも、2026年12月1日以降に作るなら対象です。
開発会社に頼んで作るカスタムアプリも、12月1日以降に作るものが対象。
12月1日より前に作ったカスタムアプリと店が作ったアプリは、今のオフライントークンを使い続けられます。
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- 期限付きのオフライントークンが何時間で切れるかは書かれていません。24時間と書かれているのは client credentials grant のトークンです
- 12月1日以降に作ったアプリが期限の無いトークンを求めたとき、どんな応答が返るかは書かれていません
- 「作った日」をアプリの作成で数えるのか、設定で数えるのかは書かれていません。対象外の文は「set up before December 1, 2026」です
- 店の管理画面に、この決まりについての表示が出るかは書かれていません
- 🔴 リンク先の「Use expiring offline access tokens」は読んでいません。開発ストアでも試していません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは次の3つです。
- 12月1日以降に新しいカスタムアプリを作るなら、最初から
expiring=1でトークンを求める - リフレッシュトークンを保存し、切れたら取り直す処理を組む
- Shopify のテンプレートやライブラリの版を新しくしておく
店がやることは次の1つです。
- 12月1日以降に自分でアプリを作るときや、開発会社に新しいアプリを頼むときは、期限付きトークンで組むことを前提にする
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「Expiring offline access tokens required for new custom apps as of December 1, 2026」2026年11月19日
https://shopify.dev/changelog/posts/expiring-offline-access-tokens-required-for-new-custom-apps-as-of-december-1-2026
上記の Shopify 公式の情報だけを一次情報として使っています。

