2月 21, 2026

顧客アカウントAPIスキーマの改善点

2月 21, 2026

Shopify顧客アカウントAPIスキーマの強化

Shopify開発者の皆さん、APIバージョン2024-01のリリース候補に伴い、顧客アカウントAPIのスキーマが大幅に進化しました。これにより、一部の破壊的変更が生じていますが、開発者体験の線形化を図るためこのアップデートは必要となります。

技術的課題の定義と現状分析

これまでの顧客アカウントAPIでは、特定のURIへのログアウト後のリダイレクトやマーケティングサブスクリプションの変更といった機能が不足していました。これは複数ドメインを持つカスタムストアフロントでの運用において、顧客体験の向上と効率的な運用管理を阻む要因となっていました。

具体的な技術的ソリューションの提案

このAPIスキーマの改善により、post_logout_redirect_uriクエリパラメータを利用してログアウト後の特定のURIへのリダイレクトが可能となりました。これにより、複数ドメインを持つカスタムストアフロントでの運用がよりスムーズになります。さらに、customerEmailMarketingSubscribeとcustomerEmailMarketingUnsubscribeにより、マーケティングサブスクリプションの変更も可能となります。

実装手順とコード例

リダイレクトのためのクエリパラメータpost_logout_redirect_uriの設定方法は以下の通りです。

// ログアウトリンクの作成
<a href="/logout?post_logout_redirect_uri=https://example.com">ログアウト</a>

また、マーケティングサブスクリプションの変更は以下のように行います。

// マーケティングサブスクリプションの登録
mutation {
  customerEmailMarketingSubscribe(input: {
    email: "customer@example.com"
  }) {
    userErrors {
      field
      message
    }
  }
}
// マーケティングサブスクリプションの解除
mutation {
  customerEmailMarketingUnsubscribe(input: {
    email: "customer@example.com"
  }) {
    userErrors {
      field
      message
    }
  }
}