GiftCardオブジェクトにlineItemフィールド追加

8月 02, 2026

API CHANGE

GiftCardオブジェクトに
lineItemフィールド追加

ギフトカードの購入元明細をGraphQLで直接取得できるように

2026年7月1日、ShopifyはAdmin GraphQL APIのGiftCardオブジェクトに新しいフィールドlineItemを追加しました。これにより、特定のギフトカードがどの注文の明細から発行されたかを、単一のGraphQLクエリで直接たどれるようになります。ギフトカード管理・分析・サポート業務の効率化が期待できます。

WHAT CHANGED

01変更内容：追加されたフィールドの構造

これまでGiftCardオブジェクトから購入元の注文明細を取得するには、注文側からギフトカードを逆引きするか、複数クエリを組み合わせる必要がありました。今回の変更により、GiftCardから直接lineItemを解決できるようになります。

USE CASES

02業務に活かせる具体ユースケース

課題: カスタマーサポートが「このギフトカードはどの注文で購入されたか」を調べるのに、注文管理画面とギフトカード管理画面を行き来して確認する手間があった。
打ち手: GiftCard.lineItemを使い、サポートツール内でギフトカードコードを入力するだけで購入元注文・商品名・数量を即座に表示するルックアップ機能を実装する。
効果: 調査工数を削減し、問い合わせ対応時間を短縮。ギフトカードの不正利用疑義にも素早く対応できる。
技術メモ: Admin GraphQL APIでギフトカードのlineItem { id title quantity order { id name } }を一度に取得可能（APIバージョンは元記事に記載なし、公式ドキュメントで確認を）。

課題: ギフトカードの販売実績レポートを作成する際、どの商品・バリアントとして販売されたかをギフトカードオブジェクトから直接取れず、注文データとの突合に時間がかかっていた。
打ち手: バックエンドのレポート処理でGiftCard.lineItem.variantやlineItem.productを参照し、ギフトカードSKUごとの販売集計を単一クエリで実現する。
効果: データ連携の複雑さを低減し、レポート生成バッチの実装・保守コストを削減できる。
技術メモ: lineItemフィールドが返す型はLineItemオブジェクト。lineItemがnullになるケース（直接発行されたギフトカードなど）のnullハンドリングを必ず実装すること。

課題: ギフトカードを購入した顧客への特典付与や再購入促進施策で、「いつ・何を買った際にギフトカードを取得したか」という文脈情報がアプリ側で取れなかった。
打ち手: マーケティングオートメーション連携アプリでGiftCard.lineItem.order.createdAtや注文タグ情報を活用し、ギフトカード発行コンテキストに応じたパーソナライズキャンペーンを設計する。
効果: 購入コンテキストを活かしたターゲティングで、ギフトカード利用率・再購入率の向上が期待できる。
技術メモ: ネストが深くなるためクエリコストに注意。Shopify GraphQLのコスト計算（クエリコンプレキシティ）を事前にテスト環境で確認すること。

DEVELOPER NOTES

03技術者目線のポイント

項目	詳細
対象API	Shopify Admin GraphQL API（REST APIへの影響は記載なし）
追加フィールド	`GiftCard`オブジェクトに`lineItem: LineItem`フィールドが追加
対応APIバージョン	元記事に記載なし。公式リファレンスで最新バージョンを確認すること
nullabilityの扱い	注文経由でないギフトカード（管理画面から直接発行など）は`lineItem`がnullを返す可能性あり。必ずnullチェックを実装すること
既存クエリへの影響	追加フィールドのため、既存クエリの破壊的変更はなし。オプトイン形式で利用可能
クエリコスト	ネストしたオブジェクト取得はAPIコンプレキシティに加算される。大量データ取得時はページネーションや分割取得を検討すること