ヘルプ
ログイン

下書き注文のデータを取得する

下書き注文のデータを使用するワークフローでは、[下書き注文のデータを取得する] アクションを使用して、ストアから下書き注文の情報を取得できます。

このページの内容

設定

フィールド

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

「データを取得する」アクションで使用されるフィールド。
フィールド説明
データの並べ替え順必須。検索クエリによって返されるデータを並べ替えるためのパラメーターです。
最大結果件数必須。選択した検索クエリによって返される結果の最大件数です。一度に最大 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 each アクションを使用できます。
  • 返された結果の件数をカウントするなど、データを集計する必要がある場合は、Count アクションまたは Sum アクションを使用できます。
  • すべてのアイテムを記載したメールを送信するなど、リストを出力する必要がある場合は、後続のアクションで返されたデータを直接使用できます。

このアクションに続くステップで返されたデータにアクセスするには、Get draft order data という名前の変数を使用します。これは下書き注文のリストです。この変数は、条件とアクションの両方で使用できます。たとえば、次のように [内部メールを送信する] アクションで下書き注文のリストを送信できます。

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

トリガー

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

API の詳細

テンプレート

すべての未処理の下書き注文に関する日次通知を送信する

毎日、未処理の下書き注文を取得して数を数え、Slack メッセージを送信します。[時間になったら] トリガー、[下書き注文を取得する] アクション、[カウント] アクションを使用します。テンプレートを表示する