• HOME
  • 【Shopify】メタフィールドのコンテンツタイプまとめ
Kyan

【Shopify】メタフィールドのコンテンツタイプまとめ

記事をシェアする

メタフィールドを使用することで、商品やコレクション、顧客情報に様々な情報を追加することができます。
今回は、現状(2022年10月現在)使用できるメタフィールドのコンテンツタイプをまとめました。

メタフィールドのコンテンツタイプ

メタフィールドは、設定する際に指定したコンテンツタイプがサポートしている値のみ情報として追加することができます。
コンテンツタイプはいくつか種類があるので、以下にまとめます。

使用例:商品の色を設定し、テキストの色などに使用する。
API名:color
説明:#RRGGBB形式のRGB値で設定。
値の設定例:#fff123

日付

使用例:賞味期限や、配達日を商品ページに追加。
API名:date
説明:タイムゾーンなしの、ISO 8601形式の日付値で設定。
値の設定例:2022-02-02

カレンダーから日付を選択して値を設定します。
また、メタフィールドの設定画面で最小日付と最大日付の設定も可能です。(任意)

日付と時刻

使用例:イベントの開始日時や、商品の発売日などを追加。
API名:date_time
説明:ISO 8601形式の日付値と、UTC時間の時間値で設定。
値の設定例:2022-01-01T12:30:00

カレンダーで日付、セレクトボックスから時間を設定します。
また、メタフィールドの設定画面で最小の日付と時刻、最大の日付と時刻の設定も可能です。(任意)

寸法

使用例:商品のサイズ(縦幅、横幅、高さ)を追加。
API名:dimension
説明:整数と小数の両方をサポート。値はmm, cm, m, in, フィート, ヤードの設定が可能。
値の設定例:{ "value": 25.0, "unit": "cm" }

最小寸法と最大寸法の設定が可能です。

重量

使用例:商品の重量や原材料などの重量を追加
API名:weight
説明:整数と小数の両方をサポート。値はキログラム, グラム, ポンド, オンスの設定が可能。
値の設定例:{ "value": 2.5, "unit": "kg" }

最小重量と最大重量の設定が可能です。

使用例:飲料の容積や、水筒の容積容量を追加
API名:volume
説明:整数と小数の両方をサポート。値はml, cl, 長さ, ㎥, 液量オンス, パイント, クォート, ガロンの設定が可能。
値の設定例:{ "value": 20.0, "unit": "ml" }

最小数量と最大数量の設定が可能です。

整数

使用例:書籍のページ数を追加
API名:number_integer
説明:整数値で設定。-4,611,686,018,427,387,904から4,611,686,018,427,387,903の範囲内を入力できます。
値の設定例:10

最小値と最大値の設定が可能です。

小数

使用例:宝石のカラット重量を追加
API名:number_decimal
説明:小数値で設定。+/-9999999999999.999999999の範囲内とし、整数は最大13桁まで、小数は最大9桁まで入力できます。
値の設定例:10.4

最小値と最大値、最高精度の設定が可能です。
最高精度とは、最大小数点以下何位まで追加できるようにするかを設定する項目です。(最大9桁)

評価

使用例:商品の評価を追加
API名:rating
説明:定義の設定方法に応じて、指定された記数法に沿って追加。
値の設定例:{ "value": "3.5", "scalemin": "1.0", "scalemax": "5.0" }

設定画面で最小評価指標と最大評価指標を設定して、その範囲内で数値を入力します。
なお、最小評価指標と最大評価指標は必ず設定が必要です。

商品の参照

使用例:該当商品の関連商品を追加
API名:product_reference
説明:単一または複数の商品へのリンク
値の設定例:gid://shopify/Product/1

商品リストから任意の商品をクリックして設定します。

商品バリエーションの参照

使用例:商品ページで同じ色の商品を表示
API名:variation_reference
説明:単一の商品バリエーションへのリンク
値の設定例:gid://shopify/ProductVariant/1

商品バリエーションリストから任意の商品バリエーションをクリックして設定します。

ファイル参照

使用例:商品取扱説明書のPDFを追加
API名:file_reference
説明:特定の種類のファイルを受け入れる(画像、ビデオ)、すべてのファイルタイプを受け入れるから選択
→画像:20MB以内のPEG、PNG、WEBP、HEIC、GIF
→ビデオ:長さが10分未満かつ1GB未満のMOVもしくはMP4
→すべてのファイルタイプ:20MB未満
値の設定例:gid://shopify/MediaImage/123

ページ参照

使用例:オンラインストアの商品に関するポリシーページなどのリンクを追加
API名:page_reference
説明:既存のページ(固定ページ)にリンク
値の設定例:gid://shopify/OnlineStorePage/1

コレクション参照

使用例:商品の属するブランドコレクションのリンクを追加
API名:collection_reference
説明:既存のコレクションにリンク
値の設定例:gid://shopify/Collection/1

URL

使用例:特定のウェブサイトでホストされている書籍レビューまたは商品ビデオへのリンクを追加
API名:url
説明:HTTP、HTTPS、mailto:のURL。URLを特定のドメインのものに制限することも可能。
値の設定例:https://www.shopify.com

単一行のテキスト

使用例:配送メモ、告知などを追加
API名:single_line_text_field
説明:単一行のプレーンテキスト。定義作成時に、指定するプリセットの選択肢に限定することも可能。
値の設定例:この商品は配送に少々お時間をいただきます。

複数行のテキスト

使用例:配送メモ、告知などを追加
API名:multi_line_text_field
説明:複数行のプレーンテキスト。改行を含めることが可能。
値の設定例:
10月の配送予定日は以下の通りです。
10月7日
10月14日
10月21日
10月28日

trueまたはfalse

使用例:アイテムに刻印できるかどうかなど、オプションの利用可否を追加
API名:boolean
説明:条件がtrueまたはfalseかを選択するチェックボックスを作成。
値の設定例:true

JSON

使用例:原材料の表など、それぞれの列で異なる商品を扱う仕様表を追加
API名:json
説明:構造化データソースが必要な高度なユースケースで未処理のJSONデータをサポート。
値の設定例:{ "ingredient": "flour", "amount": 0.3 }

Money

使用例:仕入れ費用や倉庫への配送費用など、商品にかかる費用の詳細
API名:money
説明:整数と小数の両方をサポート。通貨コードはストア通貨と一致しているもののみ利用可能。
値の設定例:{ "amount": "5.99", "currency_code": "CAD" }

メタフィールドリスト

メタフィールドリストでは、1つのメタフィールドに複数の値や情報を追加することができます。
例えば、ブログのメタフィールドに商品の参照リストを作成して関連商品として表示することもできるようになります。

使用できるコンテンツタイプは以下の通りです。

コンテンツタイプ

  • テキストフィールド
  • 番号
  • URL
  • 重量
  • 寸法
  • rating
  • date
  • 日時
  • 商品の参照
  • 商品バリエーションの参照
  • ファイル参照
  • ページ参照
  • コレクション参照



■パートナー募集について
運営元であるkraftでは一緒に活動するパートナーを募集しています。
個々が協力していくことによってクオリティの高い制作をおこなっていくことができると考えています。
ご興味のある方は、こちらよりご連絡いただけますと幸いです。(※運営元の事業サイトに飛びます)

具体的な内容については以下URLをご確認ください。
パートナー募集の詳細について

記事をシェアする