ロケーションデータを取得

ロケーションデータが必要なワークフローでは、[ロケーションデータを取得] アクションを使用して、Shopifyストアからロケーション情報を取得できます。ロケーションとは、在庫の保管、商品の販売、注文の配送やフルフィルメントを行うあらゆる場所を指します。

このページの内容

設定

フィールド

[ロケーションデータを取得] アクションには、以下のフィールドが含まれています。

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

クエリ文字列

店舗受取が有効になっているロケーションを取得するためのクエリの例を次に示します。

pickup_in_store:enabled

pickup_in_store 変数は、ロケーションクエリで利用できるフィルターで、複数回使用したり、他の変数と組み合わせたりすることができます。

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

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

返されるデータ

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

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

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

トリガー

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

APIリファレンス

このアクションで使用される API の詳細については、ロケーションクエリを参照してください。