販売計画グループのデータを取得する

販売計画グループのデータを必要とするワークフローでは、「販売計画グループのデータを取得」アクションを使用して、ストアから注文情報を取得できます。

構成

フィールド

「販売計画グループのデータを取得」アクションには、クエリを構築するために使用される以下のフィールドが含まれています。

クエリ文字列

これは、過去1日間に更新された販売計画グループを取得するためのクエリの例です。

name='Subscribe & Save'

category 変数は、販売計画グループクエリで利用できるフィルターで、特定のカテゴリーの販売計画グループを選択するために使用できます。

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

• 利用可能な販売計画グループフィルターのリスト
• クエリは特定の構文に従う必要があります
• クエリフィールドの値は、必ずしもマニュアルに記載されているわけではありません。場合によっては、APIドキュメントで値が見つかることがあります。あるいは、管理画面で絞り込みを行った際に、URLでフィールドの値を確認できる場合も多くあります。たとえば、注文クエリの値を見つけるには、管理画面の注文管理ページで絞り込みを行い、URLを確認します。
• Shopify GraphiQLアプリを使用して、ストアでクエリを実行またはテストできます。
• クエリが失敗した場合に何が起こるかに注意してください。多くの場合、APIは (結果なしではなく) すべての結果を返します。

返されるデータ

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

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

このアクションに続く手順で返されたデータにアクセスするには、[販売計画グループのデータを取得] という名前の変数を使用します。これは販売計画グループのリストです。この変数は、条件とアクションの両方で使用できます。たとえば、次のように[社内メールを送信する] アクションで販売計画グループのリストを送信できます。

{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
  {{getSellingPlanGroupData_item.name}}
{% endfor %}

例

たとえば、ワークフローが毎週日曜日の午前 9 時に実行されるようにスケジュールされているとします。「販売計画グループのデータを取得」アクションを使用して、先週作成された販売計画グループのデータを収集します。販売計画グループに関連付けられた商品がベストセラーである場合、販売計画グループの position を増やすことができます。

APIリファレンス

• 販売計画グループリソース
• 販売計画グループのクエリフィルター