Admin GraphQL API / 2026-04

割引(Discounts)に
「タグ」を付けられるように

API バージョン 2026-04 から、すべての割引タイプに tags フィールドが追加。Admin API でタグの追加・更新・削除ができ、割引をラベル付け・グループ化・整理できるようになった。

このページの構成
  1. そもそも何が変わるのか(30秒で理解)
  2. 仕組み図解 : 割引にタグが付く
  3. できること/記事に書かれていないこと
  4. 従来 vs これから の比較
  5. 利用条件
  6. 技術者が押さえるべき5つのポイント
  7. 業務に活かせる3つのユースケース
  8. 提案で使える1行サマリ

1そもそも何が変わるのか

これまで割引(Discounts)には「タグ」という概念が無く、整理はコード名や命名規則に頼るしかなかった。
API バージョン 2026-04 から、商品や注文と同じように割引にもタグを付けられるようになり、ラベル付け・グループ化・整理が API でできる。

従来 : タグなし

割引を分類する手段が無く、「SUMMER_2025_VIP」のようなコード名や独自の命名規則で人力管理。横断のグループ化は困難。

これから : tags フィールド

全割引タイプに tags が付き、Admin API で追加・更新・削除が可能。タグ単位で割引を束ねて扱える。

2仕組み図解 : 割引にタグが付く

Admin API add / update / remove tags 2026-04〜 割引(全タイプ) 自動割引 割引コード 送料無料 など tags フィールドを保持 タグで整理された割引 summer-sale vip 2026-q2 free-shipping campaign-x ラベル付け・グループ化・整理
記事が明言しているのは 「tags フィールドが全割引タイプに追加された」Admin API で add / update / remove できる」の 2 点。タグ図中の具体的な文字列(summer-sale など)は理解を助けるための例で、記事に列挙されているものではない。

3できること/記事に書かれていないこと

記事が明言していること

できる

全割引タイプにタグ

tags フィールドが「すべての割引タイプ」に追加された。タイプを問わず統一的にラベル付けできる。

できる

API で追加・更新・削除

タグの追加(add)・更新(update)・削除(remove)が Admin API 経由で実行できる。

できる

ラベル付け・グループ化・整理

割引を効率的に label / group / organize する用途として提供される。

記事に記載がないこと(=確認が必要)

記載なし

管理画面 UI 対応

Shopify 管理画面の割引画面でタグを表示・編集できるかは記載なし。本記事は Admin API 観点の告知。

記載なし

タグでの検索・絞り込み

タグを使った query / フィルタリングの可否や構文は記載なし。「整理できる」とあるのみ。

記載なし

上限・命名規則・mutation 名

タグ数の上限、利用可能文字、具体的な mutation 名やフィールドの型は記載なし。Admin API ドキュメントで要確認。

4従来 vs これから の比較

項目従来(〜2026-04 より前)これから(API 2026-04〜)
割引の分類 命名頼み コード名・独自規則で人力管理 tags 構造化されたラベルで分類
グループ化 横断のまとめが困難 タグ単位で束ねて扱える
API での操作 tags フィールドが存在しない add / update / remove
対象範囲 すべての割引タイプ
UI・検索対応 記載なし ドキュメント要確認

5利用条件

API バージョン 2026-04 以上

tags フィールドは 2026-04 から利用可能。古いバージョンを叩いているとフィールド自体が存在しないため、まず利用 API バージョンの引き上げが前提。

すべての割引タイプが対象

自動割引・割引コード・送料無料など、割引タイプを問わず tags が使える。特定タイプだけ非対応といった限定の記載はない。

対応プランや地域の制限、管理画面 UI での提供有無は記事に記載なし。導入前に Admin API ドキュメントと自社の API バージョンを確認すること。

6技術者が押さえるべき5つのポイント

2026-04

1. 入口は API バージョン

tags が見えるかどうかは利用 API バージョン次第。アプリ/インテグレーションのバージョンを 2026-04 以上に上げてからスキーマを確認する。

2. 全タイプ共通フィールド

tags は全割引タイプに共通で追加された。タイプごとに分岐せず、同じ tags 操作ロジックを横断的に再利用できる。

3. add / update / remove の3操作

追加・更新・削除がそろう。タグ管理を CRUD として設計でき、外部システムからの同期処理に組み込みやすい。

query?

4. 検索・フィルタは未確認

「整理できる」とはあるが、タグでの絞り込み query 対応は記載なし。タグ駆動の一覧取得を前提に設計するなら、まずドキュメントで対応可否を検証する。

5. 命名規約は「自分たちで」決める

タグはフリーテキストのラベル。Shopify 側で意味づけはされないため、キャンペーン ID / シーズン / 担当 / ステータスなどのタグ命名規約をチーム横断で先に定義しておかないと、すぐに無秩序化する。上限・利用可能文字は記載なしのため、ドキュメントで確認のうえ規約に織り込む。

7業務に活かせる3つのユースケース

USE CASE 1

大量の割引コードをキャンペーン別・シーズン別に棚卸し

課題
長年運用したストアで割引コードが数百件たまり、どれがどのキャンペーンのものか分からず、終了済みの整理も手探り。
打ち手
Admin API で既存割引に campaign:◯◯ season:2026-q2 などのタグを一括付与。以後は発行時に必ずタグを付ける運用に。
効果
キャンペーン単位で割引を束ねて俯瞰でき、棚卸し・廃止判断のリードタイムを短縮。属人化していた管理が標準化される。
技術メモ
add / update / remove がそろうため、移行スクリプトで既存全件にバックフィル → 以降は発行フローに組み込む二段構えが組みやすい。
外部 割引
USE CASE 2

外部キャンペーン管理ツールとの突合キーとしてタグを利用

課題
キャンペーン管理は別の SaaS / 社内 DB で行っており、Shopify 側の割引とどの行が対応するかを紐づける標準フィールドが無かった。
打ち手
外部側の管理 ID を ext-id:◯◯ のタグとして割引に書き込み、API 同期で双方向に突合・更新する。
効果
外部システムを正本にしたまま Shopify 割引を機械的に照合でき、二重管理や貼り違いを防止。レポート集計の名寄せも安定する。
技術メモ
突合キーをタグに載せる前提のため、命名衝突を避ける接頭辞(ext-id: 等)を規約化。タグでの検索可否は記載なしなので、フィルタ取得が必要なら事前にドキュメント検証を。
USE CASE 3

ライフサイクル管理(要レビュー/終了予定の自動仕分け)

課題
期限切れ間近・要見直しの割引を見落とし、古いオファーが残ったり、逆に必要な割引を消してしまう事故が起きる。
打ち手
定期バッチで条件に該当する割引へ status:to-review expiring-soon 等のタグを付与・除去し、運用ステータスをタグで可視化する。
効果
「いま手を打つべき割引」がタグで一目に。レビューフローを定例化でき、放置・誤削除のリスクを下げられる。
技術メモ
状態遷移に合わせて update / remove でタグを付け替えるステートマシン的運用が相性良い。実際の絞り込み手段(API or 管理画面)は記載なしのため要確認。

8提案で使える1行サマリ

「API 2026-04 から、すべての割引タイプにタグが付き、Admin API で追加・更新・削除できる
キャンペーン・シーズン・外部 ID・運用ステータスをタグで構造化すれば、
増えすぎた割引の整理・棚卸し・外部連携が API ベースで標準化できる。」