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

図解 ： 割引（Discounts）に「タグ」を付けられるように（Add Tags to Discounts） Admin GraphQL API / 2026-04 割引（Discounts）に 「タグ」を付けられるように API バージョン 2026-04 から、すべての割引タイプに tags フィールドが追加。Admin API でタグの追加・更新・削除ができ、割引をラベル付け・グループ化・整理できるようになった。 このページの構成 そもそも何が変わるのか（30秒で理解） 仕組み図解 ： 割引にタグが付く できること／記事に書かれていないこと 従来 vs これから の比較 利用条件 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 そもそも何が変わるのか これまで割引（Discounts）には「タグ」という概念が無く、整理はコード名や命名規則に頼るしかなかった。 API バージョン 2026-04 から、商品や注文と同じように割引にもタグを付けられる ようになり、ラベル付け・グループ化・整理が API でできる。 従来 ： タグなし 割引を分類する手段が無く、「SUMMER_2025_VIP」のようなコード名や独自の命名規則で人力管理。横断のグループ化は困難。 これから ： tags フィールド 全割引タイプに tags が付き、Admin API で追加・更新・削除が可能。タグ単位で割引を束ねて扱える。 2 仕組み図解 ： 割引にタグが付く 記事が明言しているのは 「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つのポイント 1. 入口は API バージョン tags が見えるかどうかは利用 API バージョン次第。アプリ／インテグレーションのバージョンを 2026-04 以上に上げてからスキーマを確認する。 2. 全タイプ共通フィールド tags は全割引タイプに共通で追加された。タイプごとに分岐せず、同じ tags 操作ロジックを横断的に再利用できる。 3. add / update / remove の3操作 追加・更新・削除がそろう。タグ管理を CRUD として設計でき、外部システムからの同期処理に組み込みやすい。 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 ベースで標準化できる。」 source ： shopify.dev/changelog/add-tags-to-discounts Developer Changelog ／ 公開日 2026-04-01