Settings を「ピンポイントで開ける」新 intent 7 種が追加 通知・決済・配送・事業情報まで対象拡大

図解 ： More admin intents now support Settings（Settings を開く新 intent 7 種） Admin API / Intents Settings を「ピンポイントで開ける」新 intent 7 種が追加 通知・決済・配送・事業情報まで対象拡大 アプリから API を 1 回呼ぶだけで、Shopify 管理画面の Settings の該当セクションをオーバーレイで開き、編集すべきフィールドまで自動スクロールする。3 月の初回リリースの拡張版。 このページの構成 30秒で理解 ： 何が増えたのか 追加された7つの intent 一覧 仕組み図解 ： API 1 回でオーバーレイ起動 3月リリースとの位置関係 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 30秒で理解 ： 何が増えたのか アプリから「マーチャントに、この設定項目を編集してほしい」を API 1 回で誘導できる Settings intent に、 通知 / 決済 / ギフトカード / 配送 / 事業情報 の 7 種類 が新たに加わった。 これまで ： マーチャント丸投げ 「設定 ＞ ○○ ＞ △△ を開いて編集してください」と文章で案内 → 迷子になる、設定漏れが起きる。 これから ： アプリが直接連れて行く アプリ側で intent を呼ぶだけで、対象 Settings がオーバーレイで開き、編集すべきカードまで自動スクロール。 2 追加された7つの intent 一覧 Notifications（通知） Notifications edit:settings/NotificationsSenderEmail 通知メールの送信元アドレス設定を開く。 Notifications edit:settings/NotificationsStaff スタッフ宛の通知設定を開く。 Payments and gift cards（決済・ギフトカード） Payments edit:settings/PaymentCaptureMethod 決済のキャプチャ方式（自動／手動など）の設定を開く。 Gift cards edit:settings/GiftCardExpiration ギフトカードの有効期限設定を開く。 Delivery（配送） Delivery create:shopify/DeliveryProfile 配送プロファイル（Delivery Profile）の新規作成画面を開く。 Delivery edit:shopify/DeliveryProfile 既存の配送プロファイルの編集画面を開く。 Business（事業情報） Business edit:settings/BusinessDetails 事業者情報（ビジネス詳細）の編集画面を開く。 3 仕組み図解 ： API 1 回でオーバーレイ起動 Settings がアプリの画面の上に contextual overlay （コンテキスト保持型の重ね表示）として開き、編集完了後はアプリの作業に戻れる ＝ 「Settings に飛ばされて作業が分断される」体験を回避できる。 4 3月リリースとの位置関係 項目 初回リリース（2026年3月） 今回（2026年5月） 位置づけ Settings intent の初回投入 拡張 対象 Settings カテゴリの追加 追加 intent 数 記載なし 7 種 対象カテゴリ 記載なし Notifications／Payments／Gift cards／Delivery／Business 挙動パターン page stack 上で対象カードまでスクロール 同じ挙動を踏襲 ※ 初回リリースで具体的にどの intent が出ていたかは本記事には記載なし。詳細は「Read up on admin intents」「supported Shopify resources」を参照。 5 技術者が押さえるべき5つのポイント 1. intent は「動詞:対象」の命名規約 edit: と create: の 2 動詞、対象に settings/... と shopify/... の 2 系統。Delivery Profile だけ shopify/ 名前空間に属する点に注意。 2. オーバーレイなのでアプリ文脈が消えない page stack の重ね表示。マーチャントは Settings 編集を終えたあと、アプリでの作業を続行できる。設定誘導 → 戻る のシームレス化が狙い。 3. 「該当カードまで自動スクロール」が肝 Settings ページを開くだけでなく、編集すべき特定カードに直接スクロール。マーチャントの「どこを直すんだっけ」の探索時間をゼロにする設計。 4. 呼び出し方の具体は本記事に無い 「With a single API call」とだけ記載。具体的なエンドポイント・SDK 関数・パラメータ仕様は本記事には記載なし。詳細は「Read up on admin intents」ドキュメントを必ず参照。 5. Delivery Profile だけ create / edit の両動詞対応 他は edit: のみだが、配送プロファイルは create:shopify/DeliveryProfile も用意される。 「無ければ作らせる、あれば編集させる」を 2 段で分岐できる のがアプリ実装上の意味。 6 業務に活かせる3つのユースケース USE CASE 1 通知系アプリの「送信元未設定で届かない」事故を撲滅 課題 注文通知や顧客向けメール系アプリで、Sender Email が未設定／無効な状態で通知が送られない／なりすまし扱いされる事故が発生する。 打ち手 アプリ初回起動時／通知失敗検知時に edit:settings/NotificationsSenderEmail を発行し、送信元メールアドレス設定までマーチャントを直接連れて行く。 効果 サポート問い合わせ（「通知が届かない」系）の削減と、オンボーディング離脱率の改善。 技術メモ スタッフ通知漏れには edit:settings/NotificationsStaff をペアで使うと運用設定の網羅性が上がる。 USE CASE 2 配送ルール提案アプリで「プロファイル新規作成」までワンクリック誘導 課題 越境 EC や 3PL 連携アプリが「この商品群は別の配送プロファイルにしましょう」と提案しても、マーチャントが Delivery Profile の作成画面まで辿り着けず塩漬けになる。 打ち手 提案 UI に CTA を置き、押されたら create:shopify/DeliveryProfile （新規時）／ edit:shopify/DeliveryProfile （既存時）を発行。マーチャントは即その場で編集できる。 効果 提案の実行率（adoption rate）改善 ＝ アプリの定着率と価値訴求が上がる。 技術メモ create / edit の両動詞があるのは Delivery Profile だけ。 「プロファイル ID を持っているか」で intent を出し分け ればよい。 USE CASE 3 会計／請求書アプリで「事業者情報の不備」を検知→その場で修正導線 課題 請求書・領収書・税申告系アプリでは、ストアの Business Details（社名・住所・登録番号など）が不備だと出力が違法 or 顧客に不信感を与える。 打ち手 アプリ側でバリデーション → 不備があれば edit:settings/BusinessDetails で該当カードまで直接スクロールさせ、その場で修正させる。 効果 マーチャントの設定漏れ起因のサポート・差し戻しを削減。決済キャプチャ運用の見直しにも edit:settings/PaymentCaptureMethod が同じ形で使える。 技術メモ ギフトカード販売アプリでは edit:settings/GiftCardExpiration で有効期限ポリシーの整合性チェック導線も同じパターンで組める。 7 提案で使える1行サマリ 「アプリから API を 1 回呼ぶだけで、Shopify の Settings の 該当フィールドまでマーチャントを直接連れて行ける 新 intent が 7 種追加。 通知・決済・ギフトカード・配送・事業情報を扱うアプリは、 『設定漏れ事故』と『オンボ離脱』を構造的に減らせる 大きな改善ポイント。」 source ： shopify.dev / changelog / more-admin-intents-now-support-settings generated 2026-05-23