Admin API / Intents

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

アプリから API を 1 回呼ぶだけで、Shopify 管理画面の Settings の該当セクションをオーバーレイで開き、編集すべきフィールドまで自動スクロールする。3 月の初回リリースの拡張版。

このページの構成
  1. 30秒で理解 : 何が増えたのか
  2. 追加された7つの intent 一覧
  3. 仕組み図解 : API 1 回でオーバーレイ起動
  4. 3月リリースとの位置関係
  5. 技術者が押さえるべき5つのポイント
  6. 業務に活かせる3つのユースケース
  7. 提案で使える1行サマリ

130秒で理解 : 何が増えたのか

アプリから「マーチャントに、この設定項目を編集してほしい」を 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 回でオーバーレイ起動

アプリ 「通知を設定してね」 intent 発行 edit:settings/... 1 回の API call Shopify Admin intent をルーティング 該当 Settings を特定 page stack に積む 対象カードへスクロール contextual overlay Settings overlay 編集すべきフィールド (直接スクロール済) マーチャント 迷わず編集
Settings がアプリの画面の上に contextual overlay(コンテキスト保持型の重ね表示)として開き、編集完了後はアプリの作業に戻れる = 「Settings に飛ばされて作業が分断される」体験を回避できる。

43月リリースとの位置関係

項目初回リリース(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つのポイント

intent

1. intent は「動詞:対象」の命名規約

edit:create: の 2 動詞、対象に settings/...shopify/... の 2 系統。Delivery Profile だけ shopify/ 名前空間に属する点に注意。

2. オーバーレイなのでアプリ文脈が消えない

page stack の重ね表示。マーチャントは Settings 編集を終えたあと、アプリでの作業を続行できる。設定誘導 → 戻る のシームレス化が狙い。

3. 「該当カードまで自動スクロール」が肝

Settings ページを開くだけでなく、編集すべき特定カードに直接スクロール。マーチャントの「どこを直すんだっけ」の探索時間をゼロにする設計。

API ?

4. 呼び出し方の具体は本記事に無い

「With a single API call」とだけ記載。具体的なエンドポイント・SDK 関数・パラメータ仕様は本記事には記載なし。詳細は「Read up on admin intents」ドキュメントを必ず参照。

edit create

5. Delivery Profile だけ create / edit の両動詞対応

他は edit: のみだが、配送プロファイルは create:shopify/DeliveryProfile も用意される。「無ければ作らせる、あれば編集させる」を 2 段で分岐できるのがアプリ実装上の意味。

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

USE CASE 1

通知系アプリの「送信元未設定で届かない」事故を撲滅

課題
注文通知や顧客向けメール系アプリで、Sender Email が未設定/無効な状態で通知が送られない/なりすまし扱いされる事故が発生する。
打ち手
アプリ初回起動時/通知失敗検知時に edit:settings/NotificationsSenderEmail を発行し、送信元メールアドレス設定までマーチャントを直接連れて行く。
効果
サポート問い合わせ(「通知が届かない」系)の削減と、オンボーディング離脱率の改善。
技術メモ
スタッフ通知漏れには edit:settings/NotificationsStaff をペアで使うと運用設定の網羅性が上がる。
JP US
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 種追加。
通知・決済・ギフトカード・配送・事業情報を扱うアプリは、『設定漏れ事故』と『オンボ離脱』を構造的に減らせる大きな改善ポイント。」