カスタムデータの概要
カスタムデータは、メタフィールドとメタオブジェクトを使用して、Shopifyのデータモデルを拡張し、独自のデータモデルを作成するのに役立ちます。
メタフィールドのタイプ
以下のタイプのメタフィールドを作成できます。
- 定義があるメタフィールド: 標準定義またはカスタム定義のいずれかを使用できます。
- 標準: この定義は自動的に設定され、Shopify全体で普遍的に互換性があるように設計されています。標準メタフィールドの定義は、すべての Shopify ストアで使用されている標準に準拠しているため、アプリ、テーマ、ストアの他の部分でサポートされています。標準的な商品のメタフィールドに商品カテゴリーを追加すると、そのメタフィールドは特定の商品カテゴリーの商品にのみ表示されるようになります。標準メタフィールドの定義に関する詳細情報をご覧ください。
- カスタム: この定義はストアに固有のものです。標準定義がないメタフィールドや、既存の構造化されていないメタフィールドを定義に移行する場合に、カスタム定義を使用します。
- 構造化されていないメタフィールド: 定義のないメタフィールドです。定義のないメタフィールドは編集できます。定義のないメタフィールドの編集に関する詳細情報をご覧ください。
- アプリ所有のメタフィールド: この定義は、Shopify App Store のアプリを使用して作成されます。
メタフィールドの定義
メタフィールドの定義には、以下の要素が含まれています。
- 名前: 管理画面でメタフィールドを識別するために使用されます (例:
Color)。 - ネームスペースとキー: メタフィールドの一意のIDです。ネームスペースを使用して類似のメタフィールドをグループ化できますが、各ネームスペースとキーは一意である必要があります。たとえば、
custom.colorのようになります。 - 説明 (任意): メタフィールドに入力する値など、説明的な情報を含めることができます。
- タイプ: メタフィールドに保存するデータの種類です。テキスト、ファイル、URL などのカテゴリーとプリセットの検索可能なリストからタイプを選択します。
- カテゴリー (標準的な商品のメタフィールド定義のみ): 標準的な商品のメタフィールドが関連付けられている、標準的な商品カテゴリーです。
- 検証 (任意): 文字数制限や最小値、最大値など、値の入力に関するルールです。
- オプション: メタフィールドを使用できる場所です。カスタムデータのオプションに関する詳細情報をご覧ください。
商品のお手入れ方法を追加したり、商品ページにポップアップを追加したりして、メタフィールドの使用を練習できます。
読み取り専用のアプリのメタフィールドを見つける
特定のリソースで、アプリが所有するメタフィールドのリストにアクセスできます。
手順:
- 管理画面で、メタフィールドがあるリソースに移動します。たとえば、商品ページに移動できます。
- [メタフィールド] セクションで、[すべて表示] をクリックします。
- [その他の操作] > [読み取り専用のアプリのメタフィールドを表示する] をクリックします。
メタオブジェクトのタイプ
メタオブジェクトには、主に 2 種類のコンポーネントがあります。
- 定義 - オブジェクトの構造を定義するフィールドのグループです。これは Shopify 管理画面の 「設定」 > 「カスタムデータ」 で管理します。
- エントリー - メタオブジェクトのコンテンツまたはデータです。エントリーは Shopify 管理画面の 「コンテンツ」 > 「メタオブジェクト」 で作成、管理します。
メタオブジェクト定義には、以下の種類があります。
- 標準：この定義は自動的に設定され、Shopify 全体で互換性を持つように設計されています。標準のメタオブジェクト定義はすべての Shopify ストアで使用されている標準規格に準拠しているため、アプリ、テーマ、ストアの他の部分でサポートされています。
- カスタム：この定義はストアに固有のものです。標準の定義でニーズが満たされない場合は、カスタムメタオブジェクトを作成します。
- アプリで作成されたメタオブジェクト：これらの定義は、アプリによって作成されます。
メタオブジェクトの構造
メタオブジェクト定義を作成する際には、以下の情報を指定します。
- 名前：Shopify 管理画面でメタオブジェクトを識別するために使用します (例：
Authors)。 - タイプ: メタオブジェクトの一意の ID であり、名前から自動的に生成されます。保存する前にタイプ ID を編集できます。
- フィールド: メタオブジェクトに保存するコンテンツを定義します。
- 各フィールドには、名前（必須）、説明、タイプがあります。テキスト、ファイル、URL などのカテゴリーとプリセットの検索可能なリストからフィールドタイプを選択します。
- オプション: 文字数制限、最小値と最大値、プリセット値などの検証ルールを追加できます。
- 表示名は 1 つのフィールド名に割り当てられ、個別のメタオブジェクトエントリーを識別するために使用されます。表示名が割り当てられているフィールドは、いつでも変更できます。表示名は、メタオブジェクトエントリーの最初のテキストフィールドに自動的に割り当てられます。メタオブジェクト定義にテキストフィールドがない場合は、自動生成されます。
- たとえば、テキスト用のフィールドを追加して表示名として指定したり、画像用のフィールドや色用のフィールドを追加したりすることができます。
- オプション：メタオブジェクトが使用可能な場所です。カスタムデータのオプションについて、詳しくはこちら。
商品のハイライトを追加して、メタオブジェクトの使用方法を練習できます。
アプリで作成されたメタオブジェクトを見つける
メタオブジェクト定義を絞り込むことで、Shopify 管理画面でアプリ管理のメタオブジェクトにアクセスできます。
手順:
Shopify 管理画面から、「コンテンツ」 > 「メタオブジェクト」 に移動します。
カスタムをクリックしてビューメニューを開き、絞り込むすべてのビューを選択します。
以下のいずれかの操作を行います。
アイコンをクリックして、表示オプションパネルを開きます。
並べ替えメニューをクリックし、追加者で並べ替えます。メタオブジェクトは、追加したユーザーまたはアプリのアルファベット順に並べ替えられます。- 検索バーをクリックしてから追加者をクリックし、アプリの名前を選択すると、そのアプリによって追加されたメタオブジェクトが表示されます。