ヘルプ
ログイン

記事データを取得

ブログ記事のデータを必要とするワークフローでは、記事データを取得アクションを使用して、Shopifyストアから記事情報を取得できます。

このページの内容

設定

フィールド

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

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

クエリ文字列

以下は、過去 1 日間に公開された記事を取得するクエリの例です。

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

published_at 変数は Articles クエリで利用可能な絞り込みであり、複数回使用したり、他の変数と組み合わせたりすることができます。scheduledAt Liquid変数は、スケジュールされた時間トリガーを使用するワークフローで利用できます。date_minus Liquid タグは、日付から時間を差し引くことができる Flow 固有の特別なタグです。

データのクエリを実行する際、以下の情報を知っておくと便利です。

  • 利用可能な記事の絞り込みのリスト

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

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

  • Shopify GraphiQL アプリを使用して、ショップでクエリを実行またはテストできます。

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

返されたデータ

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

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

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

トリガー

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

API リファレンス

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