📘 公式リファレンス📦 リファレンス/オブジェクト中級

market オブジェクト

Shopify Markets で設定されたマーケット（販売地域グループ）の情報を取得するオブジェクト。マーケット ID、ハンドル、メタフィールドを参照できる。

用途

Shopify Markets を使用して複数地域向けにストアを運用するとき、現在のアクセス元マーケットを判定し、通貨表示や配送方法、コンテンツを出し分ける。

設置場所

Liquid テンプレート内で `{{ localization.market.id }}`、`{{ localization.market.handle }}`、`{{ localization.market.metafields }}` の形で参照する。country オブジェクト経由では `{{ country.market.handle }}` でも取得可能。

注意点

market オブジェクトは localization オブジェクトまたは country オブジェクトの子プロパティとしてのみアクセス可能で、直接的にはグローバルスコープで利用できない。Shopify Markets が管理画面で有効化されていないと値が返らないため、マーケット設定の確認が前提となる。メタフィールドを参照する場合は管理画面で事前に作成・割り当てておく必要がある。

タグ:marketlocalizationregionshopify-marketsmetafield

仕様

78 行 / json

{
  "access": {
    "global": false,
    "parents": [
      {
        "object": "localization",
        "property": "market"
      },
      {
        "object": "country",
        "property": "market"
      }
    ],
    "template": []
  },
  "deprecated": false,
  "deprecation_reason": "",
  "description": "To learn more about markets, refer to [Shopify Markets](/docs/apps/markets).\nTo make sure that visitors interact with the optimal version of a store using Shopify Markets,\nrefer to [Detect and set a visitor's optimal localization](/docs/themes/markets/localization-discovery).",
  "properties": [
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "string",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The ID of the market.",
      "name": "id"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "string",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The [handle](/docs/api/liquid/basics#handles) of the market.",
      "name": "handle"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "&gt; Tip:\n&gt; To learn about how to create metafields, refer to [Create and manage\n&gt; metafields](/apps/metafields/manage) or visit the [Shopify Help\n&gt; Center](https://help.shopify.com/manual/metafields).",
      "examples": [],
      "return_type": [
        {
          "type": "array",
          "name": "",
          "description": "",
          "array_value": "metafield"
        }
      ],
      "summary": "The [metafields](/docs/api/liquid/objects/metafield) applied to the market.",
      "name": "metafields"
    }
  ],
  "summary": "A group of one or more regions of the world that a merchant is targeting for sales.",
  "name": "market",
  "examples": [],
  "json_data": {
    "path": "/",
    "handle": "localization.market",
    "data_from_file": ""
  },
  "return_type": []
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/objects.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

このコードは Shopify 著作の MIT ライセンスソースです。原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

market オブジェクト

仕様

出典・ライセンス

関連項目

content_for_header オブジェクト

metaobjects オブジェクト

additional_checkout_buttons オブジェクト

canonical_url オブジェクト

content_for_index オブジェクト

content_for_additional_checkout_buttons オブジェクト