2月 21, 2026

特定の市場コンテキストに特化した翻訳可能なコンテンツが公開されました

2月 21, 2026

特定の市場コンテキストに特化した翻訳可能なコンテンツが公開されました

APIバージョン2024-10から、特定のマーケットに特化した翻訳可能なコンテンツを取得するためのmarketId引数が利用可能になりました。具体的には、ONLINE_STORE_THEME_JSON_TEMPLATEとONLINE_STORE_THEME_SECTION_GROUPという翻訳可能なリソースタイプと組み合わせて、特定のマーケットのためのテーマテンプレートやテーマセクショングループ内の追加セクションとブロックで翻訳可能なコンテンツを取得できます。

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

従来、Shopifyでは一般的なテーマテンプレートを使用してウェブサイトをカスタマイズしていましたが、特定のマーケット向けにカスタマイズした翻訳可能なコンテンツを取得する方法が限られていました。これにより、特定のマーケットに対応するためのテーマカスタマイズに時間と手間がかかっていました。

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

この問題を解決するために、APIバージョン2024-10ではmarketId引数を用いて特定のマーケットに特化した翻訳可能なコンテンツを取得する機能が導入されました。これにより、特定のマーケット向けのテーマテンプレートやテーマセクショングループ内の追加セクションとブロックの翻訳可能なコンテンツを効率的に取得できるようになります。

3. 実装手順とコード例

以下に示すコード例を使用して、特定のマーケット向けの翻訳可能なコンテンツを取得することが可能です。


// API version 2024-10
const response = await shopify.request({
  endpoint: 'graphql',
  method: 'POST',
  data: {
    query: `
      {
        translatableResources(marketId: "YOUR_MARKET_ID") {
          edges {
            node {
              id
              translatableContent {
                key
                value
              }
            }
          }
        }
      }
    `,
  },
});

このコードはGraphQL APIを用いて、指定したマーケットIDに対応する翻訳可能なリソースを取得します。