Intents APIでShopifyファイルピッカーを呼び出す

8月 04, 2026

API CHANGE

Intents APIで
Shopifyファイルピッカーを
ネイティブ呼び出し

カスタムUI不要・1 APIコールでファイル選択ダイアログを起動

2026年6月17日より、ShopifyのIntents APIに新しいintent pick:shopify/File が追加されました。アプリはこの1回のAPI呼び出しだけで、マーチャントのShopifyファイルライブラリをネイティブのUIで開かせることができます。独自のファイルピッカーUIを実装する必要がなくなり、選択結果はファイルIDの配列として即座に取得できます。

OVERVIEW

01Before / After — 何が変わったか

HOW IT WORKS

02仕組みと呼び出しフロー

USE CASES

03業務に活かせる具体ユースケース

課題: 商品説明アプリが画像や動画をマーチャントに選ばせたいが、独自ピッカーUIの実装工数が大きく後回しになっていた
打ち手: pick:shopify/File を呼び出し、メディアタイプをフィルタして画像・動画のみ表示。マーチャントは見慣れたShopify標準UIで迷わず選択できる
効果: フロントエンド実装工数を大幅削減し、UXもShopify標準に統一されるため離脱リスクが下がる
技術メモ: App Home (iframe) / UI Extension どちらからも呼び出し可能。戻り値 response.data.ids を既存のFiles APIと組み合わせてファイルURLを取得

課題: バナー生成アプリでマーチャントに複数画像をまとめて選ばせる場面で、独自UIを用意できずに単一選択のみ対応していた
打ち手: Intents APIの複数選択オプションを有効にして pick:shopify/File を呼び出し、バッチ処理に必要なファイルIDを一度に収集する
効果: 操作ステップが減り、マーチャントの作業時間を短縮。複数ファイルIDをまとめて後続処理に渡せる
技術メモ: response.data.ids は配列で返るため、複数選択・単一選択いずれも同じコードパスで処理可能

課題: メールテンプレートアプリで「以前選んだファイル」を再利用させたいが、どのファイルが選ばれているかをUIに反映する手段がなかった
打ち手: 事前選択オプションを使い、保存済みのファイルIDをintent呼び出し時に渡すことで、ピッカーが開いた時点から該当ファイルがハイライトされた状態にする
効果: マーチャントが毎回同じファイルを探す手間がなくなり、繰り返し作業の効率が向上する
技術メモ: 事前選択の具体的なパラメータ名は公式ドキュメントで確認すること（元記事には記載なし）

DEVELOPER NOTES

04技術者目線のポイント

項目	内容
新intent名	`pick:shopify/File`
呼び出し元	App Home (iframe) および App Home (UI Extension) の両方に対応
戻り値	`response.data.ids`（選択されたファイルIDの配列）。`response.code === 'ok'` で正常完了を確認してから参照する
オプション機能	メディアタイプフィルタ／複数選択の有効化／ファイルの事前選択。具体的なパラメータは公式ドキュメントを参照（元記事には詳細記載なし）
参照ドキュメント	App Home (iframe) Intents docs / App Home (UI extension) Intents docs（元記事リンク先）