2月 21, 2026

`productDelete` ミューテーションに `synchronous` パラメータを追加し、非同期削除の追跡のために `ProductDeleteOperation` オブジェクトを導入しました

2月 21, 2026

`productDelete` ミューテーションに `synchronous` パラメータを追加し、非同期削除の追跡用に `ProductDeleteOperation` オブジェクトを導入

1. 技術的課題の定義

Admin GraphQL APIのバージョン2024-10リリースでは、商品削除APIにおいて、非同期処理の必要性に対応するための変更が実施されます。これにより、開発者は商品の削除操作を同期的に行うか、非同期的に行うかを選択できるようになります。

2. 現状の技術スタックと問題分析

現行のAdmin GraphQL APIでは、productDeleteAsync ミューテーションを使用して非同期的な商品削除を行うことができます。しかし、このミューテーションは2024-10バージョンリリースで削除されることが予定されています。これにより、開発者は新たな方法を用いて非同期商品削除を実装する必要性が生じます。

3. 技術的ソリューションの提案

この問題を解決するために、Shopifyは二つの新しい機能を導入します。一つ目は、`productDelete` ミューテーションに `synchronous` パラメータを追加します。これにより、開発者は商品削除を同期的に行うか非同期的に行うかを選択することが可能になります。非同期削除を行うためには `synchronous` パラメータを `false` に設定します。二つ目は、非同期削除の追跡のために `ProductDeleteOperation` オブジェクトを導入します。非同期削除を行った場合、`productDelete` ミューテーションはこのオブジェクトを返します。

4. 実装手順とコード例

`productDelete` ミューテーションを使用して商品を非同期に削除するための基本的な手順は以下の通りです。

`productDelete` ミューテーションを呼び出し、`synchronous` パラメータを `false` に設定します。
ミューテーションが成功すると、`ProductDeleteOperation` オブジェクトが返されます。このオブジェクトから操作IDを取得します。
非同期削除の状態を追跡するために、操作IDを使用して `ProductOperation` クエリを実行します。

以下に具体的なコード例を示します。

mutation {
  productDelete(input: { id: "gid://shopify/Product/12345", synchronous: false }) {
    productDeleteOperation {
      id
      status
      createdAt
    }
  }
}

上記の例では、商品IDが12345の商品を非同期に削除しています。削除操作が成功すると、操作ID、状態、作成日時が含まれる `ProductDeleteOperation` オブジェクトが返されます。

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

非同期削除を使用することで、大量の商品を効率的に削除することが可能になります。また、非同期処理により、システムのパフォーマンスに影響を与えることなく、削除操作をバックグラウンドで行うことができます。これにより、ユーザーエクスペリエンスの向上が期待できます。

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

非同期削除を行う際、削除操作の状態を定期的に確認することが重要です。削除操作が完了したかどうかを確認するためには、操作IDを使用して `ProductOperation` クエリを実行します。また、非同期削除が成功したかどうかを確認するためには、`ProductDeleteOperation` オブジェクトの `status` フィールドを確認します。