3月 05, 2026

Orderオブジェクトに新たに追加されたMerchant of Recordアプリケーションフィールド

3月 05, 2026

Orderオブジェクトに「Merchant of Recordアプリケーションフィールド」が新しく追加

Shopifyのバージョン2022-10において、GraphQL Admin APIとREST Admin APIでOrderオブジェクトに新しいフィールドが追加されました。それは、注文に対してMerchant of Recordを担当するアプリケーションに関する情報を提供するものです。しかし、この情報はサポートされているアプリケーションでのみ利用できます。

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

以前のバージョンでは、ショップオーナーは商品の注文について、どのアプリケーションがMerchant of Recordを担当しているかを特定することが難しかったです。これは、開発者が注文に関連するすべての情報を取得するために必要なフィールドをAPIから得られなかったためです。これにより、注文管理の効率が大きく低下する可能性がありました。

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

この問題を解決するために、Shopifyは新たに`merchantOfRecordApp`フィールドをGraphQL Admin APIに、そして`merchant_of_record_app_id`フィールドをREST Admin APIに追加しました。これにより、開発者は注文に関連するアプリケーション情報をより容易に取得することができます。

実装手順とコード例

具体的な実装手順は次のとおりです。まず、注文情報を取得するためにAPIを呼び出します。その際に、新しく追加されたフィールド`merchantOfRecordApp`または`merchant_of_record_app_id`をリクエストパラメータに含めます。


// GraphQL Admin APIの例
query {
  order(id: "gid://shopify/Order/1") {
    id
    merchantOfRecordApp {
      id
      name
    }
  }
}

// REST Admin APIの例
GET /admin/api/2022-10/orders.json?fields=id,merchant_of_record_app_id