3月 05, 2026

Storefront APIの@inContextディレクティブが言語サポートを強化

3月 05, 2026

Storefront APIの@inContextディレクティブが言語に対応

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

ShopifyのStorefront APIは、ストアフロントのデータを取得するための強力なツールです。しかし、これまでのバージョンでは、特定の国に基づいたリクエストしか行えませんでした。そのため、特定の言語設定でのデータ取得が必要な場合には、その機能が制限されていました。

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

2022-04バージョンから、Storefront APIの@inContextディレクティブがlanguage引数を受け付けるようになりました。これにより、ショップのマーケット設定で設定されている国で該当の言語が有効であれば、クエリは翻訳された値を返します。

3. 実装手順とコード例

利用可能な言語のリストは以下のクエリでアクセスできます。

query Localization @inContext(country: CA, language: FR) {
  localization {
    # for the current country
    availableLanguages {
      isoCode
      endonymName
    }
    # and for non-current countries
    availableCountries {
      isoCode
      name
      availableLanguages {
        isoCode
        endonymName
      }
    }
  }
}

もしサポートされていない言語や国が@inContext経由でリクエストされた場合、レスポンスはサポートされている値にフォールバックします。すべてのケースで、実際の国と言語のコンテキストはレスポンスエクステンションとして返されます。

{
  "data": {
    "productByHandle": {
      "title": "Cat bed",
      "variants": {
        "edges": [
          {
            "node": {
              "priceV2": {
                "amount": "100.0",
                "currencyCode": "CAD"
              }
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "context": {
      "country": "CA",
      "language": "EN"
    }
  }
}