Dev Dashboard のアプリ設定から、期限付きトークン必須モードを先行で有効化できるようになった。既存公開アプリへの強制は 2027 年 4 月 1 日。それまでに移行が正しくできているかを安全に検証できる。
移行ガイドに沿って実装しても、実際に「期限なしトークンが拒否される」状態での動作は強制開始まで確認できなかった。
Settings の「Admin API token expiry」カードで Turn on。問題があれば OFF に戻せる。
従来型の「無期限で使い続けられる」オフライントークン。
delegate トークンは残り有効期間が 24 時間以内である必要がある。
| アプリ種別 | この設定を使えるか | 2027/4/1 の強制 |
|---|---|---|
| 既存の公開アプリ(public app) | 使える | 対象 期限は設定の ON/OFF に関係なく有効 |
| カスタムアプリ | 使える 挙動テスト用途 | 対象外 |
| マーチャントが自ストア用に作ったアプリ | 使える 挙動テスト用途 | 対象外 |
| 設定を ON にしていないアプリ | — | 影響なし(ON にしたアプリだけに効く) |
移行ガイドに沿って実装後、GraphQL / REST ログで該当リクエストを確認。Dev Dashboard は直近 14 日の問題候補をハイライト(検出は最大 1 日遅れ)。
Dev Dashboard でアプリを開き Settings > Admin API token expiry カードの「Turn on」。要件を満たさないリクエストは失敗することを確認して確定。
反映まで最大 30 分。その後ワークフローとログで拒否されたリクエストを確認。バックグラウンドジョブも含めて。
アプリ単位の設定で、インストールされている全ストアに一斉適用。記事上はストアを絞って試す手段の記載なし。本番アプリで ON にする前に影響範囲を把握すること。
offline の期限なしトークンだけでなく、残り 24 時間超の delegate access token も拒否対象。delegate の発行時に有効期間を指定している実装は要確認。
強制は最大 30 分後に効き始め、Dev Dashboard の問題ハイライトは直近 14 日分・最大 1 日遅れ。ON 直後の「問題なし」で即判断しない。
記事が明示的に「バックグラウンドジョブからのリクエストも含めて確認」と指示。cron・Webhook 後処理・バッチ同期など、オフライントークンを使う経路が主な確認対象。
ON にしても既存トークンの移行・失効は起きないため、OFF に戻せば元の挙動に戻る前提で試せる。一方で公開アプリの 2027/4/1 期限はこの設定と無関係に到来する。