2月 21, 2026

2024-10バージョンのGraphQL APIのProductSetミューテーションにおけるメディアへの重大な変更点

2月 21, 2026

2024-10バージョンのGraphQL APIのProductSet mutationにおけるメディアに関する変更点

ShopifyのGraphQL APIバージョン2024-10では、ProductSet mutationに関するメディア機能が拡張され、これに伴いいくつかの重要な変更が行われました。既存のメディアと新規ファイルの作成を同時に扱えるようになる新フィールドタイプの導入や、既存フィールドの置き換えなど、細かな変更点があります。

技術的課題

これまでのバージョンでは、既存のメディアと新規のファイルを同時に扱うことはできませんでした。また、ProductSetやProductVariantSetに関するメディアIDの扱いに制約があり、新規ファイルの関連付けが直感的でなかった点も課題でした。

新たなソリューション

これらの課題を解決するための新機能が導入されました。具体的には以下の通りです。

新フィールドタイプ「FileSetInput」の導入: これはFileCreateInputの派生型で、「id」フィールドが追加されています。これにより、既存のメディアと新規のファイルを同時に扱うことが可能になりました。
「ProductSet.mediaIds」フィールドの削除と「files」フィールドの導入: これにより、指定した商品に新規ファイルを関連付けることが可能になりました。新フィールド「files」は新たに導入された「FileSetInput」タイプを利用します。
「ProductSetVariantInput.mediaId」フィールドの削除と「file」フィールドの導入: これにより、バリアントにファイルを関連付けることができるようになりました。新フィールド「file」でも「FileSetInput」タイプが利用されます。

実装手順とコード例

詳細な情報と例については、ShopifyのproductSet documentationをご覧ください。

パフォーマンス・コスト分析

これらの変更により、開発者は既存のメディアと新規ファイルを同時に扱いやすくなり、ProductSetやProductVariantSetとの関連付けも直感的に行えるようになります。これにより、開発時間やコストを削減し、パフォーマンスを向上させることが期待できます。

実装時の注意点・ベストプラクティス

新たに導入された「FileSetInput」タイプを活用し、メディアと新規ファイルの扱いを最適化することが推奨されます。また、「ProductSet.mediaIds」や「ProductSetVariantInput.mediaId」フィールドの使用は避け、代わりに新フィールド「files」や「file」を利用するようにしてください。