概要

Shopifyは2026年1月より、新規のカスタムアプリ作成を Dev Dashboard に一本化しました。旧来のShopify管理画面から直接アクセストークンを発行する「レガシーカスタムアプリ」方式は廃止され、すべてのアプリがOAuthフローを通じてトークンを取得する仕組みになっています。本記事では、Dev Dashboardを使って一からOAuthアプリを作成し、OrderオブジェクトへのAPIアクセスを許可するまでの手順を、CData Shopify Driverとの連携を念頭に置いて解説します。

前提条件

• Shopifyアカウントがあり、開発用ストア（Dev Store）が作成済みであること

• Dev Dashboard へのアクセス権限があること（アプリ開発権限を持つユーザー）

• CData Driver for Shopify がインストール済みであること

設定手順

1. Dev Dashboardでアプリを作成する

1. Dev Dashboard にアクセスし、左パネルの Apps を選択します。

2. 右上の Create app ボタンをクリックします。

3. Start from Dev Dashboard を選択します。

4. アプリ名（例: TestApp）を入力し、Create をクリックします。

2. バージョンを作成してスコープを設定する

アプリを作成した直後はインストール不可の状態です。バージョン（Version） を1つ以上作成することで、ストアへのインストールが可能になります。

アプリの Versions タブを開き、Scopesにこのアプリのスコープを入力します。ドライバーからの利用に必要なスコープはこちらをご覧ください。

Redirect URLs に、ドライバーのデフォルトコールバックURL「http://localhost:33333」を入力します。これ以外のリダイレクトURLを設定した場合はドライバーからの接続時にCallbackURLプロパティを設定してください。

内容を確認したらReleaseボタンをクリックします。

3. アプリをストアにインストールする

1. アプリのホーム画面に戻ります。

2. ページ右上の Install app をクリックします。

3. インストール先のストアを選択します（または新規作成）。

4. 内容を確認し、Install を押して完了です。

4. Client IDとClient Secretを取得する

ドライバーから接続するアクセストークンを取得します。

1. アプリの Settings タブを開きます。

2. Client ID と Client secret をコピーします。

ここで取得したClient IDとClient Secretはドライバーからの接続時にOAuthClientIDプロパティ、OAuthClientSecretプロパティにそれぞれ指定しますので取扱いに注意して控えておきます。

Orderオブジェクトへのアクセス：スコープ詳細と注意点

Ordersオブジェクトへアクセスできるようにするためには以下の追加の設定を行います。

基本スコープ（read_orders / write_orders）

バージョン作成時に設定する read_orders または write_orders スコープで、直近60日分 の注文データにアクセスできます。これはマーチャントのインストール同意のみで取得可能なスコープです。

全期間注文履歴へのアクセス（read_all_orders）

60日以上前の注文を取得したい場合は、追加で read_all_orders スコープが必要です。このスコープはShopifyによる事前承認が必要です。

申請手順:

1. Partner Dashboard にログインします。

2. 対象アプリを選択し、API access をクリックします。

3. Access requests セクションにある Read all orders scope カードで Request access をクリックします。

4. アプリの概要とこのスコープが必要な理由を記述して申請します。

5. Shopifyが承認すると、read_all_orders を read_orders または write_orders と併用できるようになります。

Protected Customer Data（保護された顧客データ）

注文に含まれる顧客の個人情報（氏名・住所・メールアドレスなど）にアクセスするには、別途 Protected Customer Data の承認申請が必要です。開発用ストア（Dev Store）ではテスト目的でアクセスできますが、本番ストアへのデプロイ前に必ず申請・承認を受けてください。

CData Driver for Shopifyとの接続設定

CData Driver for Shopifyを使えば、Shopifyのデータ（注文・商品・顧客など）をSQLで操作できます。上記で取得したOAuth認証情報をCData Driver の接続文字列に設定します。

接続後は、以下のようなSQLでOrderデータを照会できます。

SELECT Id, Name, CustomerId, CreatedAt
FROM Orders
WHERE CreatedAt >= '2025-01-01'
ORDER BY CreatedAt DESC
LIMIT 50;

まとめ

本記事では、ShopifyのDev DashboardでOAuthアプリを一から作成し、CData ShopifyドライバーでOrderオブジェクトへのアクセスを設定する流れを解説しました。旧来のレガシーカスタムアプリ（Shopify管理画面から直接トークン発行）は2026年1月以降に廃止されており、新規アプリはすべてDev Dashboard経由のOAuthフローが必要です。CData Shopifyドライバーと組み合わせることで、SQLによるデータ取得・分析が容易になります。

関連リンク

• Shopify Dev Dashboard 公式ドキュメント

• Get API access tokens for Dev Dashboard apps

• Shopify API access scopes

• CData Driver for Shopify 製品ページ

• CData Connect Cloud - Shopify コネクタ