マーケットデータを取得

マーケットデータを必要とするワークフローでは、マーケットデータを取得アクションを使用して、Shopifyストアからマーケット情報を取得できます。マーケットとは、販売の対象となる地域やロケーションのグループのことです。

設定

フィールド

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

クエリ文字列

アクティブなすべてのマーケットを取得するためのクエリの例は、以下のとおりです。

status:ACTIVE

status 変数は、マーケットクエリで利用できる絞り込みであり、複数回使用したり、他の変数と組み合わせたりすることができます。

データをクエリする際には、以下の点を知っておくと便利です。

• 利用可能なマーケットの絞り込みリスト

• クエリは特定の構文に従う必要があります

• クエリフィールドの値は、常にドキュメント化されているとは限りません。場合によっては、API ドキュメントを確認することで値を見つけることができます。また、管理画面で絞り込みを行う際に、URL 内でフィールド値を見つけられることもよくあります。たとえば、一部の注文クエリの値を見つけるには、管理画面の [注文管理] ページで絞り込みを行い、URL を確認します。

• Shopify GraphiQL アプリを使用すると、ストアでクエリを実行またはテストできます。

• クエリが失敗した場合の挙動に注意してください。多くの場合、API は (結果なしではなく) すべての結果を返します。

返されるデータ

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

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

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

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

トリガー

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

API リファレンス

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