Admin API / Dev Dashboard / 任意設定

Admin API トークン有効期限
「本番強制の前に」自分で ON にして試せる

Dev Dashboard のアプリ設定から、期限付きトークン必須モードを先行で有効化できるようになった。既存公開アプリへの強制は 2027 年 4 月 1 日。それまでに移行が正しくできているかを安全に検証できる。

このページの構成
  1. そもそも何が変わるのか(30秒で理解)
  2. 仕組み図解 : ON にした後のリクエストの扱い
  3. 拒否されるトークン/通るトークン
  4. 対象アプリと 2027/4/1 期限の関係
  5. タイムライン
  6. 先行検証の手順(3ステップ)
  7. 技術者が押さえるべき5つのポイント
  8. 業務に活かせる3つのユースケース
  9. 提案で使える1行サマリ

1そもそも何が変わるのか

既存の公開アプリは 2027 年 4 月 1 日から「期限付き Admin API トークン」が強制される。
今回、その強制モードを Dev Dashboard のアプリ設定で任意に先行 ON できるようになり、本番の締切前に移行の正しさを確かめられる。
ぶっつけ本番

これまで : 締切日まで本番挙動が分からない

移行ガイドに沿って実装しても、実際に「期限なしトークンが拒否される」状態での動作は強制開始まで確認できなかった。

これから : 自分のタイミングで強制を試せる

Settings の「Admin API token expiry」カードで Turn on。問題があれば OFF に戻せる。

2仕組み図解 : ON にした後のリクエストの扱い

Dev Dashboard Settings > Admin API token expiry アプリ単位で ON 最大30分 インストール済みの全ストア GraphQL / REST Admin API ストア単位の切替は記載なし トークン 判定 通る 要件を満たす期限付きトークン 失敗する ・期限なし offline トークン ・残り 24h 超の delegate  トークン
設定は アプリ単位で ON にし、そのアプリがインストールされている すべてのストアに適用される。反映までは 最大 30 分かかる。
ON にしても 既存トークンの移行や失効は行われない(要件を満たさないトークンでのリクエストが失敗するようになるだけ)。

3拒否されるトークン/通るトークン

ON 時にリクエストが失敗するもの

失敗

期限なし(non-expiring)の offline access token

従来型の「無期限で使い続けられる」オフライントークン。

失敗 >24h

有効期限まで 24 時間超が残る delegate access token

delegate トークンは残り有効期間が 24 時間以内である必要がある。

対象は GraphQL と REST の両方の Admin API。失敗時のエラーコード・レスポンス形式の詳細は本記事に記載なし。

4対象アプリと 2027/4/1 期限の関係

アプリ種別この設定を使えるか2027/4/1 の強制
既存の公開アプリ(public app) 使える 対象 期限は設定の ON/OFF に関係なく有効
カスタムアプリ 使える 挙動テスト用途 対象外
マーチャントが自ストア用に作ったアプリ 使える 挙動テスト用途 対象外
設定を ON にしていないアプリ — 影響なし(ON にしたアプリだけに効く)
設定は 任意。ON にしなくてもよいが、公開アプリは移行ガイドに書かれた 既存の移行期限を守る必要がある。

5タイムライン

今 2026/11/16 先行 ON が可能に 任意で ON → 検証 → 必要なら OFF に戻せる期間 2027/4/1 既存公開アプリへの強制開始

6先行検証の手順(3ステップ)

1

移行を完了してログを確認

移行ガイドに沿って実装後、GraphQL / REST ログで該当リクエストを確認。Dev Dashboard は直近 14 日の問題候補をハイライト(検出は最大 1 日遅れ)。

2

Settings で Turn on

Dev Dashboard でアプリを開き Settings > Admin API token expiry カードの「Turn on」。要件を満たさないリクエストは失敗することを確認して確定。

3

30 分待って挙動を確認

反映まで最大 30 分。その後ワークフローとログで拒否されたリクエストを確認。バックグラウンドジョブも含めて。

問題が出たら設定を OFF に戻せる。ただし OFF にしても公開アプリの 2027/4/1 の強制期限は変わらない。

7技術者が押さえるべき5つのポイント

1. 影響範囲は「全インストール先ストア」

アプリ単位の設定で、インストールされている全ストアに一斉適用。記事上はストアを絞って試す手段の記載なし。本番アプリで ON にする前に影響範囲を把握すること。

≤24h

2. delegate トークンにも条件あり

offline の期限なしトークンだけでなく、残り 24 時間超の delegate access token も拒否対象。delegate の発行時に有効期間を指定している実装は要確認。

3. 反映ラグ 30 分 / 検出ラグ 1 日

強制は最大 30 分後に効き始め、Dev Dashboard の問題ハイライトは直近 14 日分・最大 1 日遅れ。ON 直後の「問題なし」で即判断しない。

4. バックグラウンドジョブを見落とさない

記事が明示的に「バックグラウンドジョブからのリクエストも含めて確認」と指示。cron・Webhook 後処理・バッチ同期など、オフライントークンを使う経路が主な確認対象。

ON OFF

5. ON は非破壊・OFF は可逆、ただし期限は動かない

ON にしても既存トークンの移行・失効は起きないため、OFF に戻せば元の挙動に戻る前提で試せる。一方で公開アプリの 2027/4/1 期限はこの設定と無関係に到来する。

8業務に活かせる3つのユースケース

2027/4/1 前
USE CASE 1

公開アプリの「期限前リハーサル」

課題
公開アプリを運用しているが、期限付きトークン移行が本当に完了しているか、強制開始日まで確証が持てない。
打ち手
移行ガイドで実装 → ログと Dev Dashboard のハイライトを確認 → Settings で Turn on → 30 分後から拒否リクエストを監視。
効果
2027/4/1 当日の障害リスクを前倒しで潰せる。問題があれば OFF に戻して修正できる。
技術メモ
全インストール先ストアに効くため、実施は影響の少ない時間帯を選び、OFF 手順を事前に共有しておく。
cron batch
USE CASE 2

在庫・受注連携などバックグラウンド処理の洗い出し

課題
画面操作は動くが、夜間バッチや定期同期など人目に触れないジョブがどのトークンを使っているか把握しきれていない。
打ち手
検証用アプリで設定を ON にし、一定期間ジョブを回してログ上の拒否リクエストを抽出、該当経路のトークン取得処理を修正。
効果
「たまにしか動かない処理」の移行漏れを本番強制前に発見できる。
技術メモ
Dev Dashboard の検出は直近 14 日分・最大 1 日遅れ。週次・月次ジョブは実行周期を考慮して観測期間を取る。
Custom App
USE CASE 3

カスタムアプリでも期限付きトークン前提の実装を検証

課題
クライアント専用のカスタムアプリ/マーチャント作成アプリは期限の対象外だが、期限付きトークンでの挙動も確かめておきたい。
打ち手
カスタムアプリでも同じ設定を ON にし、期限付きトークンで動作するかをテスト。問題があれば OFF。
効果
強制対象外のアプリでも、期限付きトークンでの動作を確認したうえで実装方針を判断できる。
技術メモ
カスタムアプリ・マーチャント作成アプリに 2027/4/1 の期限は適用されない(設定はあくまでテスト用途)。今後の強制予定は記載なし。

9提案で使える1行サマリ

「Admin API の期限付きトークン強制を、2027/4/1 の本番強制より前に Dev Dashboard で任意 ON して試せる。
既存トークンは壊さず・いつでも OFF 可能。バックグラウンドジョブまで含めた移行検証を今のうちに。」