PARTNERS API
Partners APIで
テーマ購入者のメール取得が可能に
ThemeSaleオブジェクトに merchantEmail フィールドが追加され、テーマ開発者とマーチャントの直接連携が実現
Shopify Partners APIのThemeSaleオブジェクトに、テーマを購入したマーチャントのメールアドレス (merchantEmail) が取得できるフィールドが追加されました。テーマ開発者はこの情報を活用してサポート提供やアップデート共有が可能になります。なお、利用にあたってはパートナープログラム規約および各国のプライバシー・マーケティング法令への準拠が必須です。2026年10月28日より利用可能です。
1Before / After:何が変わったか
2業務に活かせるユースケース
- 課題
- テーマ購入後にバグや重大な不具合が発覚しても、購入済みマーチャントへ一括連絡する手段がなかった
- 打ち手
- Partners APIで
ThemeSaleのmerchantEmailを取得し、影響を受けるバージョンを使用しているマーチャントへ修正案内メールを送信する - 効果
- サポート対応の遅延を防ぎ、マーチャントの信頼損失を最小化できる
- 技術メモ
- 送信前に法令・スパム規制の確認が必須。プログラム規約に基づきマーケティング目的の無断利用は禁止
- 課題
- テーマのメジャーアップデートをリリースした際、既存購入者への告知がShopifyのレビューページ経由に限られていた
- 打ち手
- 購入者リストを
merchantEmailで構築し、新機能ハイライトや移行ガイドをメールで届けるアップデート通知フローを整備する - 効果
- アップデート適用率と購入者満足度が向上し、低評価レビューを未然に防げる
- 技術メモ
- 取得したメールをCRMへ連携する場合、受信者からの同意取得とオプトアウト機能の実装を検討すること
- 課題
- テーマを複数マーチャントへ販売しているが、どのマーチャントが誰かを把握しておらず、長期関係構築ができていない
- 打ち手
- 定期的に
ThemeSaleを照会してmerchantEmailを収集・管理し、オンボーディングや活用サポートのコミュニティ招待に活用する - 効果
- テーマ継続利用率・LTVの向上や、フィードバック収集による製品改善サイクルの加速が期待できる
- 技術メモ
- データ保存期間・利用目的をプライバシーポリシーに明記し、GDPRやAPPI等の適用法令を確認すること
3技術者向けポイント
| 観点 | 詳細 | ステータス |
|---|---|---|
| 対象オブジェクト | Partners API の ThemeSale オブジェクト |
追加済み |
| 追加フィールド |
merchantEmail:テーマを購入したマーチャントのメールアドレス |
利用可能 |
| APIの種類 | Shopify Partners API (GraphQL)。Admin APIやStorefront APIではない点に注意 | Partners専用 |
| 対象APIバージョン | 元記事に記載なし。shopify.devの公式ドキュメントで最新バージョンを確認すること | 要確認 |
| 法令・規約遵守 | パートナープログラム規約により、プライバシー法・マーケティング関連法への準拠が義務。取得したメールの目的外利用・無断マーケティングは禁止 | 必須対応 |
4実装イメージ:GraphQLクエリ例
ThemeSaleへのクエリ (概念例)
query {
transactions(first: 50, types: [THEME_SALE]) {
edges {
node {
... on ThemeSale {
id
merchantEmail # 新規追加フィールド
createdAt
theme {
name
}
}
}
}
}
}
※ 実際のクエリ構造は公式ドキュメントで必ず確認してください。フィールド名・ネスト構造は変更される場合があります。
Partners APIのThemeSaleオブジェクトにmerchatEmailフィールドが追加されたことで、テーマ開発者は購入マーチャントへ直接サポートや更新通知を届けられる基盤が整い、長期的な関係構築とテーマ品質向上の好循環が実現できます。
Source: https://shopify.dev/changelog/merchant-email-now-available-on-the-themesale-object-in-the-partners-api | 公開日: 2026年10月28日






Share:
Shopify App Store: アプリ価格の現地通貨表示が開始