Shopify Admin API、メタオブジェクトを分析クエリ対象にできる新機能
ShopifyAdmin APIメタオブジェクト分析GraphQL
Shopify が GraphQL Admin API 2027-01 以降で、メタオブジェクト定義を分析クエリの対象にできる analyticsQueryable 機能を追加した。メタフィールド定義と同様の扱いになり、分析対応型のフィールドを1つ以上持つ定義のみが対象となる。
何が発表されたか
- 2026年10月20日、Shopify 開発者チェンジログに メタオブジェクトの
analyticsQueryablecapability が追加された。 - 対象は GraphQL Admin API
2027-01以降。それより前のバージョンでは新フィールド・入力・enum 値・エラーコードは露出しない。 - これにより、メタオブジェクト定義を分析クエリの対象にできるかどうかをアプリ側で制御でき、メタフィールド定義と同じ扱いに揃う。
- 対象となるのは、分析互換の型のフィールドを少なくとも1つ持つ定義のみ。
- 参照できるのは
MetaobjectCapabilities.analyticsQueryableの2フィールド:eligible(この定義が機能を使えるか)enabled(現在有効かどうか)
- 定義の作成・更新時に
analyticsQueryable.enabledを設定できる。対象外の定義に対してはCAPABILITY_NOT_ELIGIBLEのユーザーエラーが返るため、Shopify は事前にeligibleを確認することを推奨している。
実務への影響
- メタオブジェクトは、商品に紐づかない構造化データ(制作実績、産地情報、サイズガイド、キャンペーン設定など)の受け皿として受託案件でも定番になってきた。これまでは**分析側から見えない「ブラックボックス」**になりがちで、「どのサイズガイドを見た人が買ったか」のような問いに答えにくかった。
- 今回の機能で、メタオブジェクトの値を軸にした集計をストア分析に載せられる見込みが立つ。コンテンツ設計の段階から「後で分析したい軸はメタオブジェクトのフィールドとして型付きで持つ」という設計判断がしやすくなる。
- 実装上の注意は2点。API バージョンを 2027-01 以降に上げる必要があること、そしてすべての定義が対象になるわけではないこと。既存定義をそのまま有効化しようとすると
CAPABILITY_NOT_ELIGIBLEで弾かれるため、フィールド型の見直しが先に来るケースがある。
利用条件
GraphQL Admin API 2027-01 以降。追加費用の記載はない。
