商品バリエーションのデータを取得する
商品バリエーションのデータを使用するワークフローでは、「商品バリエーションのデータを取得する」アクションを使用して、ストアから商品バリエーションの情報を取得できます。
設定
フィールド
「商品バリエーションのデータを取得する」アクションには、クエリの作成に使用される以下のフィールドが含まれています。
| フィールド | 説明 |
|---|---|
| データの並べ替え順 | 必須。検索クエリによって返されるデータの並べ替え順の基準となるパラメーターです。 |
| 最大結果数 | 必須。選択した検索クエリで返すことができる結果の最大数です。一度に最大 100 件を返すことができます。 |
| クエリ | 必須。一般的なクエリから選択するか、[高度] を選択して独自のクエリを作成します。 |
クエリ文字列
以下は、過去1日以内に更新された商品バリエーションを取得するためのクエリの例です。
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at 変数は、商品バリエーションのクエリで利用可能なフィルターであり、複数回使用したり、他の変数と組み合わせたりすることができます。scheduledAt Liquid 変数は、「時間ベースのトリガー」を使用したワークフローで利用できます。`date_minus` Liquid タグは、日付から時間を減算できる特別な Flow タグです。
データをクエリする際には、以下の点を知っておくと役立ちます。
- 利用可能な商品バリエーションフィルターのリスト
- クエリは特定の構文に従う必要があります
- クエリフィールドの値は、必ずしも文書化されているわけではありません。場合によっては、API ドキュメントで値を見つけることができます。あるいは、管理画面で絞り込みを行う際に、URL 内でフィールド値を見つけられることがよくあります。たとえば、注文クエリの値を見つけるには、管理画面で注文管理ページを絞り込み、URL を確認します。
- Shopify GraphiQL アプリを使用して、ショップでクエリを実行またはテストできます。
- クエリが失敗した場合にどうなるかに注意してください。多くの場合、API は (結果なしではなく) すべての結果を返します。
返されるデータ
すべての「データを取得する」アクションは、0〜100 件のリソースのリストを返します。ユースケースに応じて、このデータをさまざまな方法で使用できます。
- それぞれにタグを追加するなど、リストの各アイテムを個別に処理する必要がある場合は、「項目ごと」のアクションを使用できます。
- 返された結果の数を数えるなど、データを集計する必要がある場合は、「カウント」または「合計」のアクションを使用できます。
- すべてのアイテムを記載したメールを送信するなど、リストを出力する必要がある場合は、後続のアクションで返されたデータを直接使用できます。
このアクションに続くステップで返されたデータにアクセスするには、「商品バリエーションのデータを取得する」という名前の変数を使用します。これは商品バリエーションのリストです。この変数は、条件とアクションの両方で使用できます。たとえば、次のように「内部メールを送信する」アクションで注文のリストを送信できます。
{% for single_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% endfor %}トリガー
このアクションは、「指定時刻」トリガーを含む、あらゆるワークフローで使用できます。「指定時刻」トリガーを使用するワークフローは、イベントの結果としてではなく、指定した時刻に開始されます。ストアやアプリでワークフローを開始させる特定のイベントがないため、データは自動的に含まれません。
API の詳細
テンプレート
新規注文に無料 (100% ディスカウント) のアイテムを追加
このテンプレートは、商品の在庫がある場合に、新規注文に 100% ディスカウントされた無料アイテムを追加します。在庫を確認し、100% のディスカウントを適用して、お客様に通知することなく注文を更新します。このオートメーションは、(1) 注文にサプライズの無料アイテムを同梱して顧客満足度を向上させる、(2) 新商品や知名度の低い商品を無料サンプルとして注文に追加して販売を促進する、(3) 無料アイテムの追加とディスカウントを自動化してプロモーションを効率化する、といった場合に役立ちます。テンプレートを表示
在庫が少ないバリエーションのリストを記載したサマリーメールを毎週送信
このワークフローは、(週に 1 回など) スケジュールに基づいて実行されます。在庫が少ない商品バリエーションのリストを取得し、その結果をカウントして、バリエーションの名前とそのバリエーションの管理ページへのリンクを記載したメールサマリーを送信します。テンプレートを表示