ディスカウントデータを取得する

ディスカウントデータが必要なワークフローでは、[ディスカウントデータを取得] アクションを使用して、ストアからディスカウント情報を取得できます。

このページの内容

設定

フィールド

[ディスカウントデータを取得] アクションには、クエリの作成に使用される以下のフィールドが含まれています。

[データを取得] アクションで使用されるフィールド。
フィールド	説明
データの並べ替え順	必須。検索クエリによって返されたデータを並べ替えるためのパラメーターです。
結果の最大数	必須。選択した検索クエリで返される結果の最大件数です。一度に最大 100 件を返すことができます。
クエリ	必須。一般的なクエリから選択するか、[高度な設定] を選択して独自のクエリを作成します。

クエリ文字列

以下は、コードを使用する有効なディスカウントを取得するためのクエリの例です。

method:code AND status:active

method 変数と status 変数は、ディスカウントノードクエリで利用できるフィルターで、複数回使用したり、他の変数と組み合わせたりすることができます。

データをクエリする際は、以下の点を知っておくと役立ちます。

利用可能なディスカウントフィルターの一覧。
クエリは特定の構文に従う必要があります
クエリフィールドの値は、常にドキュメントに記載されているとは限りません。場合によっては、API ドキュメントで値が見つかることがあります。あるいは、管理画面パネルで絞り込みを行った際に、URLでフィールド値を見つけられることがよくあります。たとえば、注文のクエリ値を見つけるには、管理画面パネルの [注文管理] ページを絞り込み、URLを確認します。
Shopify GraphiQL アプリを使用すると、ストアでクエリを実行したり、テストしたりすることができます。
クエリが失敗した場合の動作にご注意ください。多くの場合、APIは、結果を何も返さないのではなく、すべての結果を返します。

返されたデータ

すべての[データを取得] アクションは、0～100件のリソースのリストを返します。ユースケースに応じて、このデータをさまざまな方法で使用できます。

それぞれにタグ付けするなど、リストの各アイテムを個別に処理する必要がある場合は、[繰り返し (For each)] アクションを使用できます。
返された結果の数をカウントするなど、データを集計する必要がある場合は、[カウント] アクションまたは [合計] アクションを使用できます。
すべてのアイテムを含むメールを送信するなど、リストを出力する必要がある場合は、後続のアクションで返されたデータを直接使用できます。

このアクションに続くステップで返されたデータにアクセスするには、ディスカウントのリストである [ディスカウントデータを取得] という名前の変数を使用します。この変数は、条件とアクションの両方で使用できます。たとえば、以下のように、[社内メールを送信] アクションで自動アプリディスカウントのリストを送信できます。

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

トリガー

このアクションは、[スケジュールされた時間] トリガーを含む、すべてのワークフローで使用できます。[スケジュールされた時間] トリガーを使用するワークフローでは、ワークフローはイベントの結果としてではなく、指定した時間に開始します。ストアやアプリからのワークフローを開始する特定のイベントがないため、データは自動的に含まれません。

API の詳細

テンプレート

コードを使用する有効なディスカウントの週次サマリーをメールで送信

コードを使用する有効なディスカウントのサマリーをメールで送信します。このワークフローは、毎週月曜日の午前9時にスケジュールどおりに実行されます。タイミング、サマリーの受信方法、含めるディスカウントの種類、モードなどを変更するようにワークフローをカスタマイズできます。テンプレートを表示