データ取得元 ショップファイ の中へ エクセル
ShopifyアカウントからリアルタイムのデータをExcelに取り込み、いつでも更新できます。ODBCドライバーもエクスポートもマクロも不要です。初回は約10分で完了し、無料プランで利用できます。
最終的に手に入るもの
Shopifyアカウントに対するSQLクエリのリアルタイム結果を表示するワークシート。データが変更されるたびに最新の行を取得するボタンが付いています。例:
| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | 顧客ID | ファーストネーム | 苗字 | 国 | 合計 |
| 2 | 1042 | マリア | アルバレス | アメリカ合衆国 | 1,284.50 |
| 3 | 1043 | ダニエル | オカフォー | アメリカ合衆国 | 612.00 |
| 4 | 1047 | プリヤ | ナイア | アメリカ合衆国 | 2,090.75 |
| 5 | 1051 | トーマス | ベルク | アメリカ合衆国 | 338.20 |
| 6 | 1056 | ルシア | フェレイラ | アメリカ合衆国 | 1,455.00 |
| 7 | 1060 | ケンジ | 佐藤 | アメリカ合衆国 | 874.10 |
| 8 |
ShopifyはAPIを通じてお客様のデータを管理しています。通常、データをExcelに取り込むには、ShopifyダッシュボードからCSVファイルをエクスポートする必要があり、毎回新しいデータが必要になります。Query Streamsを使えば、この手間は不要です。エージェントと呼ばれる小さなヘルパープログラムが、お客様のデータが格納されている場所でクエリを実行し、Excelアドインが必要な行を取得します。暗号化されたリンクを介して送信されるのは結果のみで、Excelは自宅のノートパソコン、遠く離れた同僚のパソコン、あるいはWeb上のExcelなど、どこにあっても利用できます。
必要なもの
常時稼働しているコンピュータ上のエージェント
バックグラウンドで動作し、Excelからの要求に応じてShopifyを呼び出す小さなプログラムです。必要なのはインターネット接続だけです。
Shopifyのログイン情報
Shopifyに一度ログインして、読み取りアクセスを許可してください。クエリ ストリームにパスワードを入力する必要はありません。
どのコンピュータにエージェントがインストールされますか? Shopifyアカウントにアクセスできる、常時稼働しているマシンであればどれでも構いません。 Excelはどこにでも配置できるウェブ版Excelも含みます。
接続方法は5つのステップです
-
アカウントを作成する
行く my.querystreams.com そしてサインアップします。 無料 これは計画です。試用版ではなく、正式な計画であり、Shopifyアカウントの接続方法やExcelからのクエリ実行方法などを網羅しています。
常時稼働している任意のコンピューターにエージェントをインストールしてください。



サインインして開く ダウンロードインターネットに接続された常時稼働のコンピュータまたはサーバーにエージェントをインストールしてください。インストールには1分ほどかかり、その後は自動的に起動します。
ドライバではなく、なぜ小さなプログラムを使うのか? エージェントは、Windows、Mac、Linux 用の単一のインストール(Windows では約 85 MB、Mac と Linux では 100 MB 強)で、バックグラウンドで静かに動作します。ブラウザと同様に、クエリ ストリームへの暗号化されたアウトバウンド接続を 1 回確立するため、ファイアウォールのポートを開放したり、VPN を設定したりする必要はありません。キーはマシン上に保持され、行データは必要に応じてインターネット経由でユーザーのいる場所まで送信されます。ユーザー側で必要なのはアドインだけです。
ダウンロードページには アクセスキーエージェントに求められたら貼り付け、バッジが読み取るまで待ちます。 クエリ ストリームに接続しましたエージェント本体で行う操作はそれだけです。
-
Shopifyアカウントを指定してください。
ブラウザに戻って、 データエージェント (下 データ 上部メニューにあります。エージェントがそこに表示されています。クリックしてください。 コネクタを追加する そして選択する ショップファイShopifyの認証情報が必要ですか?チュートリアルを開いて、以下の情報を入力してください。
Shopifyの認証情報を作成してください (約10分)
別のタブでShopifyを開いた状態で、この手順を実行してください。Query Streamsはここで作成したものを保持し、エージェントがそれを利用できるようにします。また、Shopifyからのみ読み取りを行います。
- 誰がこれをできるのか
- ストアオーナー、またはアプリ開発 > 開発権限を持つスタッフアカウント(コラボレーターアカウントは開発者ダッシュボードを使用できません)
- 推奨
- ストア独自のShopify組織内の開発者ダッシュボードアプリ(カスタムアプリ):クライアントID + クライアントシークレット、読み取り専用スコープ
始める前に
- Shopifyストアの管理者ログイン情報:ストアオーナー、または「アプリ開発」>「開発」権限を持つスタッフアカウント。ストアオーナーは自動的にこの権限を持っています。
- クエリ ストリーム ウィザードが別のタブで開きます。データ エージェント → コネクタの追加 → Shopify で、エージェントがオンラインになっていることを確認してください。
- コーディングは不要です。Shopifyでは、新しいアプリ用に既製のアクセストークンをコピーすることができなくなりました。Query Streamsは、アプリのクライアントIDとクライアントシークレットを、それ自体で有効期限の短いトークンに変換します。
手順
- ストアのアプリ設定を開きます
Shopifyの管理画面にログインします。左下の「設定」をクリックし、次に「アプリ」をクリックします。
一部のストアでは、このメニュー項目は「アプリと販売チャネル」と表示されます。接続したいストアの管理者を使用してください。
- 「アプリを開発」をクリックします。
アプリ設定ページで、「アプリを開発する」をクリックします。
アプリ開発ボタンが表示されない場合は、スタッフアカウントに「アプリ開発」>「開発」の権限がありません。ストアオーナーに権限の付与を依頼するか、以下の手順を実行してください。
- 開発者ダッシュボードを開く
開発者ダッシュボードで「アプリをビルド」をクリックします。開発者ダッシュボードが開きます(通常は新しいタブで開きます)。
dev.shopify.comに別途ログインするのではなく、ストアの管理画面から開いてください。アプリはストアと同じShopify組織に属している必要があります。そうでない場合、Query Streamsは接続できません。
- 「アプリを作成」をクリック
左側のメニューで「アプリ」が選択されていることを確認し、右上隅の「アプリを作成」をクリックします。
- 開発者ダッシュボードから「開始」を選択してください
開発者ダッシュボードから「開始」を選択してください(Shopify CLI で開始は選択しないでください)。
- アプリの名前
分かりやすい名前(例:Query Streams)を入力し、「作成」をクリックします。アプリの最初のバージョンのページが開きます。
その名前はあなた専用です。クエリストリーム自体には特定の名前は必要ありません。
- デフォルトのアプリURLを維持する
URLセクションでは、アプリURLをhttps://shopify.dev/apps/default-app-homeのままにしておきます(空欄の場合は入力してください)。Shopify管理画面にアプリを埋め込むオプションが表示されている場合は、オフのままにしておきます。
Query StreamsはShopifyの管理画面内では開かないため、Shopifyのデフォルトのアドレスが正しいアドレスです。
- Webhooks APIのバージョンを選択してください
Webhooks APIのバージョンでは、リストから最新バージョンを選択してください。
Query StreamsはWebhookを使用しないため、どのバージョンでも動作します。
- 読み取りスコープを追加する
「アクセス」セクションで「スコープ」を探します。このリストを貼り付けるか、「スコープの選択」をクリックして、それぞれにチェックを入れます:read_orders、read_draft_orders、read_customers、read_products、read_inventory、read_locations、read_discounts、read_gift_cards、read_shipping、read_merchant_managed_fulfillment_orders、read_assigned_fulfillment_orders、read_third_party_fulfillment_orders、read_content、read_themes、read_legal_policies、read_shopify_payments_accounts、read_shopify_payments_payouts、read_shopify_payments_disputes。「オプションのスコープ」は空欄のままにします。
read_ スコープのみを選択してください。クエリ ストリームはストア内の何も変更しません。read_all_orders は追加しないでください。Shopify はこれらのアプリに対して「無効なスコープが含まれています」というエラーで拒否します(制限事項を参照)。read_payouts と read_shopify_payments も有効な名前ではありません。Shopify Payments を使用しない場合でも、3 つの Shopify Payments スコープは保持してください。これらのテーブルは空のままです。
- クリックリリース
ページの一番下までスクロールして、「リリース」をクリックします。バージョン名とメッセージを任意で入力できるダイアログが開きます。
両方の欄は空欄のままで構いません。
- リリースを確認する
ダイアログで「リリース」をクリックします。アプリのバージョンページで、新しいバージョンに「アクティブ」バッジが表示されます。
- 「アプリをインストール」をクリック
アプリのホーム画面を開きます(アプリ名をクリックするか、アプリのメニューにある「ホーム」をクリックします)。「インストール」カードで「アプリをインストール」をクリックします。新しいタブが開きます。
同じ操作は、アプリ一覧の該当アプリの行にある「⋯」メニューからも行えます。
- お近くの店舗をお選びください
複数の店舗をお持ちの場合は、接続したい店舗を選択してください。
ステップ1で最初に管理画面を開いたストアを選択してください。
- 「インストール」をクリック
Shopifyは、アプリが閲覧できるストアデータの一覧を表示する「アプリのインストール」画面を表示します。内容を確認して「インストール」をクリックしてください。
開発者ダッシュボードに戻ると、「インストール」カードに1件のインストールが表示されているはずです。まだ0件と表示されている場合は、ページを更新してください。
- アプリの設定を開きます
開発者ダッシュボードでアプリを開き、「設定」(画面によっては「アプリ設定」)をクリックします。「認証情報」カードを探してください。
- クライアントIDをコピー
クライアントIDの横にあるコピー(クリップボード)アイコンをクリックします。クエリストリームウィザードのクライアントIDに貼り付けます。
それは32文字の英数字で構成され、例えばa8ed94aa0680bc6580eea34486dcaa6bのようになります。これは決して変わりません。
- クライアントシークレットをコピーする
「クライアントシークレット」(画面によっては「シークレット」と表示される場合があります)の横にある目のアイコンをクリックして表示し、次にコピーアイコンをクリックします。それをクエリストリームウィザードの「クライアントシークレット」に貼り付けます。
文字列は「shpss_」で始まります。Shopifyはこのページに繰り返し表示しているので、後で戻って確認できます。置き換えるつもりでない限り、「回転」をクリックしないでください。
- 店舗の住所をコピーしてください
Shopifyの管理画面で、「設定」→「ドメイン」に進み、末尾が.myshopify.comのアドレス(例:your-store.myshopify.com)をコピーします。それをクエリストリームウィザードの「ストアアドレス」に貼り付けます。
ご自身のドメイン(例:www.yourbrand.com)は使用できません。管理画面でブラウザのアドレスバーに表示されるアドレス(admin.shopify.com/store/your-store)もご利用いただけます。
- 接続テスト
クエリ ストリーム ウィザードで、[接続テスト] をクリックします。[接続済み] と表示されます。
メッセージが表示される場合は、「よくある問題」の項目を参照してください。
許可を与える
リソース アクセス 用途 注文内容 読む 注文、注文明細、取引、返金、履行、注文リスク、放棄されたチェックアウトの各テーブル(過去60日間、制限事項を参照) ドラフト命令を読む 読む draft_ordersテーブル read_customers 読む 顧客テーブルと顧客住所テーブル read_products 読む 製品、バリエーション、コレクション、スマートコレクション、カスタムコレクションのテーブル 在庫を読み取る 読む inventory_levelsテーブルとinventory_itemsテーブル read_locations 読む locationsテーブル、およびinventory_levelsテーブルのロケーションごとの行 割引を読む 読む price_rulesテーブルとdiscount_codesテーブル ギフトカードを読む 読む ギフトカードテーブル 配送情報を読む 読む shipping_zonesテーブルとcarrier_servicesテーブル 販売者管理のフルフィルメント注文を読み込む 読む fulfillment_ordersテーブル:自社拠点から処理する注文 割り当てられた履行注文を読み込む 読む fulfillment_ordersテーブル(3つのfulfillment-orderスコープのいずれか1つを有効にするとテーブルが有効になり、3つすべてを有効にすると完全なリストが表示されます) 第三者によるフルフィルメント注文を読み込む 読む fulfillment_ordersテーブル:サードパーティのフルフィルメントサービスによって処理された注文 コンテンツを読む 読む ブログ、記事、ページ表 テーマを読む 読む テーマ表 法的ポリシーを読む 読む ポリシー表 shopify_payments_accounts を読み込む 読む 支払いおよび紛争テーブルには、次の2つのテーブルと併せて必要です(Shopify Paymentsストアのみ)。 read_shopify_payments_payouts 読む 配当表 shopify_payments_disputes を読む 読む 紛争テーブル クエリ ストリームに貼り付ける
- 店舗住所
- ステップ18で表示される.myshopify.comのアドレス(またはブラウザのアドレスバーに表示されるadmin.shopify.com/store/…のアドレス)
- クライアントID
- ステップ16でコピーしたクライアントID
- クライアントシークレット
- ステップ17でコピーしたクライアントシークレット(shpss_で始まる)
よくある問題
接続テストの結果、「アプリとストアは同じShopify組織に属している必要があります」と表示されます。
なぜ: アプリは、ストアとは別の Shopify 組織で作成されました。たとえば、dev.shopify.com に別のアカウントでログインしたり、別の組織を選択したりした場合などです。ストアを所有しているだけでは十分ではありません。
修理: ストアの管理画面からやり直してください。設定 → アプリ → アプリ開発 → 開発者ダッシュボードでアプリを作成、そこでアプリを作成します(手順1~17)。複数の組織に所属している場合は、開発者ダッシュボードのアドレス(dev.shopify.com/dashboard/<org-id>)に組織IDが含まれています。アプリとストアは同じ組織に属している必要があります。
接続テストの結果、「クライアントIDまたはクライアントシークレットが間違っているか、アプリがこのストアにインストールされていません」と表示されます。
なぜ: 値が不完全にコピーされたか、スペースが含まれているか、クライアントIDとクライアントシークレットが入れ替わっているか、シークレットがローテーションされているか、アプリがこのストアにインストールされていない(またはアンインストールされている)可能性があります。
修理: アプリの設定ページにあるコピーアイコンを使って、両方の値を再度コピーしてください。シークレットは「shpss_」で始まります。アプリのインストールカードにストアが表示されていることを確認し、表示されていない場合は「アプリをインストール」をクリックしてください。誰かが「回転」をクリックした場合は、「新規」とマークされたシークレットを使用してください。その後、もう一度「接続テスト」をクリックしてください。
接続テストでストアアドレスが拒否された場合(「.myshopify.com アドレス(設定 → ドメイン)または admin.shopify.com/store/… URL を使用してください。カスタムドメインは API には使用できません。」)、または「ストアが見つかりません。ストアアドレスを確認してください。」というメッセージが表示されます。
なぜ: ご自身のドメイン名(例:www.yourbrand.com)が入力されたか、ストア名にスペルミスがあります。
修理: Shopify管理画面の「設定」→「ドメイン」から.myshopify.comのアドレスをコピーするか、ブラウザのアドレスバーからadmin.shopify.com/store/…のアドレスをコピーしてください。
接続テストの結果、「トークンは受け入れられましたが、スコープがありません」と表示されるか、一部のテーブルが無効になっており、指定されたスコープが欠落しています(たとえば、payouts には read_shopify_payments_payouts が必要です)。
なぜ: スコープがアプリのアクティブバージョンに含まれていないか、新しいバージョンがリリースされたものの、ストアがまだ承認していません。
修理: 開発者ダッシュボードでアプリを開き、[バージョン] → [バージョンの作成] を選択し、不足している read_ スコープを追加して [リリース] をクリックします。次にアプリを開き、[インストール] カードで、ストアにアプリをインストールして変更を承認します。弊社のテストでは、この操作を行うまでストアは古いスコープを保持していました。[接続テスト] をもう一度クリックします。
「リリース」をクリックすると、「無効なスコープが含まれています」と表示されます。
なぜ: read_all_orders が追加されました (Shopify の承認が必要であり、開発者ダッシュボードのアプリではリクエストできません)、または、read_payouts や read_shopify_payments などのスコープ名のスペルが間違っています。
修理: それを削除して、手順9で指定した名前を正確に使用してください。
約60日以上前の注文は表示されません。
なぜ: Shopify は read_all_orders 権限を持たないアプリに対しては、過去 60 日間の注文のみを提供します (制限事項を参照)。
修理: 本日、アプリおよびクエリストリームに変更はありません。既に読み込まれた注文はクエリストリームのキャッシュに保持されるため、接続した日から履歴が蓄積されます。
支払いと紛争に関するテーブルは空のままで、「このストアではShopify Paymentsが有効になっていないため、このテーブルに読み込むデータはありません。」というメッセージが表示されます。
なぜ: このストアは別の決済プロバイダーを通じて決済を受け付けているため、Shopifyは支払いや紛争に関する情報を共有する必要はありません。
修理: 修正する必要はありません。他のテーブルには影響はありません。
他の列が読み込まれる間、顧客名、メールアドレス、電話番号、住所は空欄のままです。
なぜ: Shopifyはこれらの項目を保護対象の顧客データとして扱います。ヘルプセンターによると、ベーシックプランのストアではこれらの項目を読み取るカスタムアプリを使用できず、グロウプラン以上が必要とのことです。
修理: ストアがどの Shopify プランを利用しているかを確認してください。Basic プランの場合、ストアが Grow 以上のプランに移行するまで、これらの列は空欄のままです。クエリ ストリームの設定でこれを変更することはありません。
「アプリを開発」ボタンが表示されない場合、または開発者ダッシュボードが開かない場合は、アプリ開発はできません。
なぜ: スタッフアカウントに「アプリ開発」>「開発」の権限が付与されていないか、または共同作業者アカウントでサインインしているため、開発者ダッシュボードを使用できません。
修理: 店舗オーナーにスタッフアカウントの「アプリ開発」>「開発」権限を付与してもらうか、またはオーナー自身に以下の手順を実行してもらうよう依頼してください。
知るべき限界
- 注文: Shopify は、アプリに過去 60 日以内に作成された注文のみを提供します。それより古い注文には、Shopify が承認する必要のある read_all_orders スコープが必要ですが、開発者ダッシュボードではこれらのアプリに対してこのスコープが拒否されます (「無効なスコープが含まれています: read_all_orders」、2026-09-29 にチェック)。これには、注文テーブルと、そこから構築されたテーブル (order_line_items、transactions、refunds、fulfillments、order_risks)、および abandoned_checkouts が含まれます。商品、顧客、在庫、および下書き注文には制限はありません。
- アクセストークンの有効期限は24時間です。エージェントはクライアントIDとクライアントシークレットに基づいて自動的に新しいトークンを要求します。トークンをコピーしたり更新したりする必要はありません。
- ShopifyはストアプランによってAPI読み取り回数を制限しています。標準プランでは1秒あたり100コストポイント、アドバンストプランでは200、Shopify Plusでは1,000、Shopify for Enterpriseでは2,000です。1回のリクエストで1,000ポイントを超えることはできません。大規模ストアの最初のフルロードには時間がかかる場合があります。Shopifyがスロットリングを行うと、エージェントは待機してから処理を続行します。
- 支払いと紛争に関する行が表示されるのは、ストアがShopify Paymentsを使用している場合のみです。
手順は2026年10月8日に確認済み。出典: shopify.dev/docs/apps/build/dev-dashboard/create-apps-usi…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/api/usage/access-scopes, shopify.dev/docs/apps/build/apis/graphql-admin/rate-limits, shopify.dev/docs/apps/launch/protected-customer-data, help.shopify.com/en/manual/apps/install-setup-apps, help.shopify.com/en/manual/apps/about-apps, help.shopify.com/en/manual/domains, changelog.shopify.com/posts/legacy-custom-apps-can-t-be-c…, kb.wolfandbadger.com/creating-your-custom-shopify-app-usi…, docs.mydbsync.com/cloud-workflow/connectors/shopify/steps…, help.sarasanalytics.com/pulse-shopify-/shopify-app-creati….
- 接続名
- 後で必ず思い出すような名前、例えば「販売データベース」など。
- ストアURL
- あなたのストアのShopifyアドレス(例:your-store.myshopify.com)。
- クライアントID
- Shopifyストア用に作成したカスタムアプリのクライアントID。
- クライアントシークレット
- その同じShopifyアプリのクライアントシークレット。
クリック 接続テスト読むと 接続済み、 クリック セーブ接続は数秒以内に担当エージェントに到達します。
テストは失敗しましたか? 通常は権限が不足しているか、間違った Shopify アカウントの認証情報です。上記の手順では、 よくある問題 そして、それらの解決策。
-
See your data in Query Builder オプション
You can look at your Shopify account before Excel is involved at all. Open クエリビルダー in the portal and pick the connection you just made. The スキーマ tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click 走る and the rows appear under 結果. Query Builder is on every plan, Free included.
On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.
-
Excelにクエリ ストリームを追加する
Excelで、 挿入 → アドインを取得、 検索する クエリストリーム、そしてクリック 追加または、直接開く Microsoft AppSource のクエリ ストリームリボンに「クエリ ストリーム」ボタンが表示されます。同じアカウントでサインインしてください。
WindowsおよびMac版のMicrosoft 365版Excel、およびWeb版Excelで動作します。
-
最初のテーブルを運び入れる
クエリ ストリーム ボタンをクリックし、 クエリをストリーミングするそして、先ほど接続した接続を選択してください。
実行したいクエリを入力してください。これは、いくつかの列を抽出します。 shopify.orders テーブル:
例:SQLSELECT name, financial_status, total_price, created_at FROM shopify.orders ORDER BY created_at DESC LIMIT 100;
下 目的地一覧表 選ぶ 新しいシートを作成します次に再生ボタン(▶矢印)を押します。行は1~2秒でExcelに反映されます。データが変更された場合はいつでももう一度押すと、シートがその場で更新されます。
SQLを知らない? Build it in クエリビルダー first and paste it here, or pick it from Saved Queries if you saved it.
それでおしまい。 データはシート内に保存され、ワンクリックで常に最新の状態に保たれます。お客様が要求した行以外は、ネットワークから外部に送信されることはありません。
良い次の動き
- クエリを保存します ポータルにインストールすれば、ExcelやGoogleスプレッドシートからワンクリックで再度実行できます。
- フィルターを追加する 例えば日付範囲などを指定することで、同じクエリで編集せずに「今月」という回答を得ることができます。
- 結果を共有する 同僚と共有する場合、同僚には行数が表示され、あなたの認証情報は表示されません。
人々が尋ねる質問
ExcelはShopifyアカウントと同じコンピューターにインストールする必要がありますか?
いいえ。Shopifyアカウントと同じ場所にエージェントがあれば十分です。Excelはインターネット接続があればどのコンピューターでも使用できます。Web版ExcelやMac版Excelも利用可能です。アカウントでアドインにサインインすれば、接続情報が表示されます。
私のデータはクエリストリームにコピーされますか?
いいえ。エージェントはデータが存在する場所でクエリを実行し、返された行のみを送信します。その間に同期や保存は一切行われません。
無料プランで本当にこれがカバーされるのですか?
はい。無料プランは継続して利用できるプランで、期限切れのトライアルではありません。プランに含まれる内容については、 価格ページ.
Mac版Excelでも動作しますか?
はい。Mac版とWindows版のMicrosoft 365版Excel、そしてWeb版Excelが利用可能です。
関連ガイド
すべてのガイド Shopify
あなたの設定とは少し違いますか?
- Excelワークブック自体をクエリしたいですか?Excel Folderはワークブックのフォルダをテーブルとして読み取ります→ Excel Folder
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

