截至2025-04版本,GraphQL管理API的productSet和customerSet突变支持通过identifier进行记录的上插(创建或更新)。
当提供identifier时,这些突变更会使用它来检查是否存在现有记录。如果找到现有记录,则突变使用在input中提供的数据对其进行更新;否则,突变将创建一个新记录。
identifier为开发人员提供了一种简单、幂等的机制,用于以相同的输入形状创建并随后更新记录,而无需额外的查询来检查记录是否存在。对于标识符,productSet允许使用handle、id和customId。customerSet允许使用phone、email和customId。
这扩展了之前在productSet上的行为,该行为如果在input中提供了id则更新记录,否则创建新记录。customerSet突变此前仅发布给API的unstable版本。
阅读更多关于使用自定义ID的内容。

