2月 21, 2026

Nodeクエリに対するFulfillment Holdアクセスの更新について

2月 21, 2026

NodeクエリにおけるFulfillment Holdアクセスのアップデート

ShopifyのAdmin APIバージョン2025-01から、nodeまたはnodes GraphQLクエリを使用してfulfillment holdsを取得するアプリは、アクセス可能なfulfillment orderに属するものだけを取得できるようになります。これは、開発者がデータの取得範囲を制御し、セキュリティを強化するための重要なアップデートです。

1. 技術的課題の定義と現状分析

現行システムでは、fulfillment holdsへのアクセス制限が十分に設定されていないアプリが存在します。これにより、アプリがアクセスを許可されていないfulfillment holdsを取得するリスクがありました。新しいAPIバージョンでは、各アプリが特定のアクセススコープを持つことで、この問題を解決します。

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

このアップデートでは、アプリが持つアクセススコープに応じて、fulfillment holdsへのアクセスが制限されます。以下に各スコープの詳細を示します。

read_merchant_managed_fulfillment_ordersスコープを持つアプリは、マーチャント管理の場所に割り当てられたfulfillment ordersのholdsにアクセスできます。
read_assigned_fulfillment_ordersスコープを持つアプリは、アプリに属する場所に割り当てられたfulfillment ordersのholdsにアクセスできます。
read_third_party_fulfillment_ordersスコープを持つアプリは、サードパーティの場所に割り当てられたfulfillment ordersのholdsにアクセスできます。
read_marketplace_fulfillment_ordersスコープを持つアプリは、マーケットプレイスのオーダーに属するfulfillment ordersのholdsにアクセスできます。

3. 実装手順とコード例

この変更を適用するには、あなたのアプリが適切なアクセススコープを持っていることを確認する必要があります。それには、以下のようなコードを利用できます。

const scopes = ['read_merchant_managed_fulfillment_orders', 
'read_assigned_fulfillment_orders', 
'read_third_party_fulfillment_orders', 
'read_marketplace_fulfillment_orders']

ShopifyToken.getAccessToken(shop, code, function(err, token) {
  if (err) {
    // Handle errors here
  } else if (scopes.every(scope => token.scope.includes(scope))) {
    // Proceed with fetching fulfillment holds
  } else {
    // Handle insufficient scopes here
  }
});