2月 21, 2026

下書き注文における追加のShopify Functions APIへの対応

2月 21, 2026

ドラフトオーダーでShopify Functions APIの追加サポート

Shopifyのドラフトオーダーにおいて、これまでほとんどのShopify Functionsが対応していましたが、新たに残りのAPIに対する完全なサポートが提供されるようになりました。これにより、開発者はより効率的なドラフトオーダープロセスを実現し、エラーの削減と全体的なユーザーエクスペリエンスの向上を図ることが可能になります。

技術的課題と現状分析

これまでのShopifyのドラフトオーダーは、多くのShopify Functionsをサポートしていましたが、一部のAPIについてはフルサポートが提供されていませんでした。これは、ドラフトオーダーのチェックアウトプロセスにおけるカスタマイズや検証の柔軟性を制限する問題となっていました。

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

この問題を解決するために、Shopifyは以下のAPIに対する完全なサポートをドラフトオーダーに導入しました：

配送カスタマイズAPI：ドラフトオーダーのチェックアウトで動作します。
決済カスタマイズAPI：ドラフトオーダーのチェックアウトで動作します。
カートとチェックアウト検証API：ドラフトオーダーの管理者とチェックアウトで動作します。

さらに、新たな引数bypassCartValidationsが追加されました。これをdraftOrderCompleteとprepareForBuyerCheckoutのミューテーションに渡すことで、ドラフトオーダーの完了または共有時にチェックアウトルールをバイパスすることが可能になります。

実装手順とコード例

新たに追加されたAPIと引数を使用するには、以下の手順を実行します：

ドラフトオーダーのチェックアウトプロセスにて、必要に応じて配送カスタマイズAPIや決済カスタマイズAPIを呼び出します。
カートとチェックアウトの検証を行いたい場合は、カートとチェックアウト検証APIを使用します。
チェックアウトルールをバイパスしたい場合は、draftOrderCompleteやprepareForBuyerCheckoutのミューテーションに「bypassCartValidations」を引数として渡します。

具体的なコード例は以下の通りです：


mutation {
  draftOrderComplete(id: "gid://shopify/DraftOrder/1", bypassCartValidations: true) {
    draftOrder {
      id
    }
    userErrors {
      field
      message
    }
  }
}