カスタムメタフィールド定義の作成
Shopifyストアに追加したい特殊な情報に対応する標準メタフィールド定義がない場合は、カスタムメタフィールド定義を作成できます。また、既存のメタフィールドを定義に移行する際にもカスタム定義を作成します。
メタフィールドのカスタム定義を作成する際には、以下の情報を指定します。
- 名前: 管理画面でメタフィールドを識別するために使用します (例:
Color)。 - タイプ: メタフィールドに保存するデータの種類です。単一行テキスト、ファイル、URL など、検索可能なカテゴリーやプリセットのリストからタイプを選択します。
- ネームスペースとキー: メタフィールドの固有 ID で、名前から自動的に生成されます。ネームスペースを使用して類似したメタフィールドをグループ化できますが、ネームスペースとキーの組み合わせはそれぞれ固有である必要があります。例として
custom.colorが挙げられます。 - 説明 (オプション): メタフィールドに入力する値など、説明情報を追加できます。
- 検証 (オプション): 文字数制限や最小値と最大値など、値の入力に関するルールです。
始める前に
カスタムメタフィールド定義を作成する前に、以下の情報を確認して、定義の設定方法を理解してください。
カスタム定義を作成する
- 管理画面から、メタフィールドを追加するリソースに移動します。たとえば、商品に移動して商品を開くか、お客様に移動してお客様を開きます。
- メタフィールドセクションで、定義を追加をクリックします。
- [名前] フィールドに、定義の名前を入力します。一致する標準定義がフィールドの下に提案として表示された場合は、それをクリックして代わりにその標準定義を使用できます。
- オプション: [ネームスペースとキー] フィールドで、自動的に生成されたメタフィールドの ID を編集します。
- [タイプを選択] をクリックし、リストからメタフィールドに最も適したタイプを検索または選択します。タイプは、[単一行テキスト] や [ファイル] > [画像] などのプリセットを持つカテゴリーに整理されています。使用可能なタイプの詳細については、メタフィールドのコンテンツのタイプと値を参照してください。
- オプション: メタフィールドで値のリストを許可するには、[1 つの値] をクリックし、[値のリスト] を選択します。
- オプション: メタフィールドの値の説明を入力するには、[説明を追加] をクリックします。
- オプション: 定義の下に [検証] セクションが表示された場合は、検証ルールを設定して、メタフィールドで許容される値の範囲を制限します。利用可能な検証オプションは、選択したタイプによって異なります。
- 任意：カスタムストアフロントでこのメタフィールドの値を表示できるようにするには、[ストアフロント] を選択します。
- オプション: この定義がスマートコレクションに表示されるようにするには、スマートコレクションを選択します。このオプションは、商品とバリエーションのメタフィールドでのみ利用できます。
- オプション: Shopify の管理画面の対応するページにメタフィールドが自動的に表示されないように、メタフィールドのピン留めを外すには、[定義がピン留めされました] をクリックします。
- [保存] をクリックします。
メタフィールド定義を追加した後の次のステップ
メタフィールドの定義を追加した後、以下の操作を行うことができます。
- メタフィールドの表示順を決定するために、メタフィールド定義をピン留め、またはピン留め解除する。
- ストアの各セクションにメタフィールドの値を追加する。
- オンラインストアに表示するために、メタフィールドをテーマに連携させる。
Storefront APIでカスタムメタフィールドを使用する
メタフィールドをカスタムストアフロントで表示できるようにする場合、メタフィールド定義の作成時または編集時にStorefront APIへのアクセスを許可できます。Shopify以外で運営しているウェブサイト、テレビゲーム、その他のカスタムショッピング体験を通じてShopify商品を販売している場合は、Storefront APIへのアクセスを許可することをおすすめします。
デフォルトでは、カスタムメタフィールドの値にカスタムストアフロントからアクセスすることはできません。Storefront APIでのメタフィールドの使用について詳しくはこちらをご覧ください。