2月 21, 2026

`productSet`と`customerSet`のミューテーションが、アップサートとカスタムIDをサポートするようになりました

2月 21, 2026

`productSet`と`customerSet`のミューテーションがupsertsとカスタムIDをサポートするようになりました

ShopifyのAPI開発を担当する方々にとって、データの更新と新規作成を効率的に行う方法は重要な課題の一つです。GraphQL Admin APIの`productSet`と`customerSet`ミューテーションによるデータ操作は、その一環となる機能です。

しかし、これまでのバージョンでは、既存のレコードが存在するかどうかを確認するための追加のクエリが必要であり、それがパフォーマンスやコストに影響を与えていました。また、`customerSet`ミューテーションはAPIの`unstable`バージョンでのみリリースされていました。

新バージョンの技術的ソリューション

2025-04バージョンでは、これらの課題が解決されます。`productSet`と`customerSet`ミューテーションは、`identifier`を使用してレコードをアップサート(存在すれば更新、存在しなければ作成)できるようになりました。

`identifier`が提供されると、これらのミューテーションは既存のレコードをチェックし、存在すれば`input`で提供されるデータで更新します。存在しない場合は新しいレコードを作成します。

これにより、開発者は追加のクエリを行うことなく、同じ形状の入力でレコードを作成し、その後更新するための直感的で冪等性のあるメカニズムを得ることができます。`productSet`は`handle`、`id`、`customId`を、`customerSet`は`phone`、`email`、`customId`を識別子として使用できます。

これは、`productSet`の既存の振る舞いを拡張したものであり、`input`に`id`が提供されている場合にレコードを更新し、それ以外の場合は新しいレコードを作成します。

実装手順とコード例

以下に具体的なコード例を示します。まず、`productSet`ミューテーションの場合は以下のようになります。

mutation {
  productSet(input: { id: "gid://shopify/Product/1234567890", title: "New Product Title" }) {
    product {
      id
      title
    }
  }
}

`customerSet`ミューテーションの場合は以下のようになります。

mutation {
  customerSet(input: { email: "test@example.com", firstName: "FirstName", lastName: "LastName" }) {
    customer {
      id
      email
      firstName
      lastName
    }
  }
}