PARTNERS API

Partners APIで
テーマ購入者のメール取得が可能に

ThemeSaleオブジェクトに merchantEmail フィールドが追加され、テーマ開発者とマーチャントの直接連携が実現

ThemeSaleid / themecreatedAt / ...+ merchantEmailNEW フィールド追加テーマ開発者が可能にサポート連絡アップデート通知

Shopify Partners APIのThemeSaleオブジェクトに、テーマを購入したマーチャントのメールアドレス (merchantEmail) が取得できるフィールドが追加されました。テーマ開発者はこの情報を活用してサポート提供やアップデート共有が可能になります。なお、利用にあたってはパートナープログラム規約および各国のプライバシー・マーケティング法令への準拠が必須です。2026年10月28日より利用可能です。

1Before / After:何が変わったか

BEFOREThemeSaleオブジェクトで取得可能な情報・ id・ theme・ createdAt✗ merchantEmail は取得不可AFTERThemeSaleオブジェクトで取得可能な情報・ id・ theme・ createdAt✓ merchantEmail が新たに取得可能

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日