メタフィールドの定義の構成要素

メタフィールドの定義では、メタフィールドがストアのどの部分に適用されるか、またメタフィールドにどのような値を設定できるかを指定します。以下のタスクを行う前に、メタフィールドの定義の構成要素を理解しておく必要があります。

• カスタム定義を作成する。
• 既存のメタフィールドを定義に移行する。

メタフィールドの定義には、以下の構成要素があります。

• 名前：Shopify 管理画面でメタフィールドを識別するために使用されます (例：Color)。
• ネームスペースとキー：メタフィールドの一意の ID です。ネームスペースを使用して類似のメタフィールドをグループ化できますが、各ネームスペースとキーは一意である必要があります。例：custom.color。
• 説明 (任意)：メタフィールドに入力する値など、説明的な情報を含めることができます。
• タイプ: メタフィールドに保存するデータの種類です。テキスト、ファイル、URL など、検索可能なカテゴリーやプリセットのリストからタイプを選択します。
• カテゴリー (標準商品メタフィールドの定義のみ)：標準商品メタフィールドが関連付けられている標準商品カテゴリーです。
• 検証 (任意)：文字数制限、最小値、最大値など、値の入力に関するルールです。
• オプション：メタフィールドを使用できる場所です。カスタムデータのオプションについて、詳しくはこちら。

たとえば、商品の有効期限に関するメタフィールドの定義では、キーが products.expiration_date、値が日付、説明が「日付を YYYY/MM/DD 形式で入力してください」となる場合があります。その検証では、2025/07/01～2030/12/31 の日付値のみを有効とするよう指定できます。

メタフィールドの定義の構成要素に関する詳細については、次の表を参照するか、メタフィールドに関する開発者ドキュメントを確認してください。