メタフィールド定義

メタフィールドを使用すると、Shopifyの製品、注文、顧客、その他のリソースに対してカスタムデータを保存できます。サイズガイド、仕様、SEOデータ、内部メモなどの追加情報を追加するのに便利です。

Shopifyでのメタフィールドについて詳しくはこちら →

DataEaseを使用すると、ファイル内の動的カラムを使用してメタフィールドをインポート、エクスポート、更新することが簡単にできます。

📊 DataEaseでのメタフィールドの動作

DataEaseからデータをエクスポートすると、メタフィールドは動的カラムとして表示されます。これは、各メタフィールドがファイル内で特定の命名形式を使用して独自のカラムを持つことを意味します：

metafield {namespace}.{name} [{type}]

例:

metafield global.description_tag [single_line_text_field]

この構造は、どのメタフィールドを指しているのか、どの形式であるのかをDataEase（およびShopify）に伝えます。

🧠 メタフィールドのインポートロジック

メタフィールドがインポートファイルにない場合、変更されません。
メタフィールドがファイルにあるが空の場合、Shopifyから削除されます。
メタフィールドに値がある場合、作成または更新されます。

これにより、変更したくないデータを上書きせずにメタフィールドを簡単に管理できます。

🧩 サポートされているメタフィールドタイプ

Shopifyは幅広いメタフィールドタイプをサポートしています。完全なリストはこちらで確認できます：

インポート時にはこれらのタイプをカラムヘッダーに使用してください。例えば：

metafield specs.material [multi_line_text_field]
metafield shipping.weight [number_decimal]

📏 メタフィールドの制限

メタフィールドを操作する前に、Shopifyの制限を把握しておいてください：

🔢 リソースごとの制限

250 定義がリソースタイプごとに可能
20 固定された定義がリソースタイプごとに可能

📦 タイプごとの文字数制限

タイプ	文字数制限
boolean	65,000
color	65,000
date	65,000
date_time	65,000
dimension	65,000
id	2,048
json	2,000,000
link	65,000
money	65,000
multi_line_text_field	65,000
number_decimal	65,000
number_integer	65,000
rating	65,000
rich_text_field	65,000
single_line_text_field	65,000
url	2,048
volume	65,000
weight	65,000

メタフィールドの完全な制限を確認する →

🔐 所有者タイプとアクセス（Admin API 2026-07）

インベントリ移動（TRANSFER） — インベントリ移動のメタフィールド定義をエクスポート、インポート、ストア間でコピーできます。インポートにはinventory transfers権限（read_inventory_transfers, write_inventory_transfers）が必要で、アプリは2026年9月27日以降この権限をリクエストします。ストアオーナーがDataEaseを開いて更新された権限を承認するまで、TRANSFER行は承認を促すエラーで失敗します。それ以外の行は通常どおりインポートされます。
自分自身の名前空間（例: custom）における管理者アクセス（accessAdmin） — Shopifyはそこに1つの値しか許可しないため、DataEaseはそのような定義に対してaccessAdminを送信せず、Shopify側で自動的に適用されます。ファイル内のPUBLIC_READ / PUBLIC_READ_WRITEの値はもうShopifyのエラーを引き起こしません。
アプリ名前空間（$app, app--…）における管理者アクセス — MERCHANT_READとMERCHANT_READ_WRITEはそのまま送信されます。古いファイルからのレガシーなPUBLIC_READ / PUBLIC_READ_WRITEの値はMERCHANT_READ / MERCHANT_READ_WRITEとして送信されます。

🧰 使用例

製品にカスタムSEOタグを追加する：

DataEaseで製品をエクスポート
新しいカラムを追加：metafield global.title_tag [single_line_text_field]
カラムにSEOタイトルを入力
更新されたファイルをインポート - メタフィールドがライブになります！

✅ ベストプラクティス

各メタフィールドに対して正しい形式を角括弧で使用してください。
重要なデータを上書きしないように、変更したくないフィールドのカラムを削除してください。
変更を加える前に、現在のメタフィールドをバックアップするためにエクスポートを使用してください。

メタフィールドは、Shopifyストアの機能を拡張するための強力な方法です。DataEaseを使用すれば、コードを書くことなく効率的に一括で管理できます。

追加フィールド

このエンティティに対してDataEaseがサポートするその他のカラム：

accessAdmin — メタフィールド定義の管理者アクセスレベル。アプリ名前空間にのみ適用されます（上記の所有者タイプとアクセスを参照）。
accessCustomer — メタフィールド定義の顧客アクセスレベル。
accessStoreFront — メタフィールド定義のストアフロントアクセスレベル。
capabilitiesAdminFilterableEnabled — メタフィールドの管理者フィルタリングが有効かどうかを示します。
capabilitiesAdminFilterableEligible — 管理者フィルタリング機能の適格性ステータス。
capabilitiesAdminFilterableStatus — 管理者フィルタリング機能の現在のステータス。
capabilitiesSmartCollectionConditionEnabled — メタフィールドのスマートコレクション条件が有効かどうかを示します。
capabilitiesSmartCollectionConditionEligible — スマートコレクション条件機能の適格性ステータス。
capabilitiesUniqueValuesEnabled — メタフィールドのユニーク値が有効かどうかを示します。
capabilitiesUniqueValuesEligible — ユニーク値機能の適格性ステータス。
constraintsKey — メタフィールドキーに適用される制約。
constraintsValues — メタフィールド値に適用される制約。
metafieldsCount — 定義に関連付けられたメタフィールドの数。
pinnedPosition — 管理者でメタフィールドが固定されているかどうかを示します。
metafieldsValidationStatus — メタフィールドの検証ステータス。
category — メタフィールド定義のカテゴリ。
description — メタフィールド定義の説明。
key — メタフィールド定義のキー。
name — メタフィールド定義の名前。
namespace — メタフィールド定義の名前空間。
ownerType — メタフィールド定義に関連付けられた所有者のタイプ（例: PRODUCT, CUSTOMER, TRANSFER）。
type — メタフィールド定義のデータタイプ。
validations — メタフィールド定義の検証のJSON配列。
deleteAssociatedMetafields — 関連するメタフィールドを削除するかどうかを示します。