說明
登入

擷取文章資料

在需要網誌文章資料的工作流程中，您可以使用「擷取文章資料」動作，從您的 Shopify 商店擷取文章資訊。

本頁面包含

設定

欄位

「擷取文章資料」動作包含下列欄位：

「擷取資料」動作中使用的欄位。
欄位說明
資料排序依據必填。做為搜尋查詢傳回之資料的排序依據參數。
結果數量上限必填。您選取的搜尋查詢可傳回的結果數量上限。一次最多可傳回 100 筆結果。
查詢必填。可從常用查詢中選擇，或選取「進階」來建立自己的查詢。

查詢字串

這是擷取過去一天內發布之文章的查詢範例：

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

published_at 變數是文章查詢中可用的篩選條件，可多次使用或與其他變數合併使用。scheduledAt Liquid 變數可用於採用「排程時間」觸發條件的工作流程。date_minus Liquid 標籤是特殊的 Flow 標籤，可讓您從某個日期減去時間。

查詢資料時，建議您瞭解以下事項：

  • 可用文章篩選條件清單

  • 查詢必須遵循特定語法

  • 說明文件不一定會提供查詢欄位值。在某些情況下，只要查看 API 文件即可找到這些值。此外，當您進行篩選時，通常也能在管理介面網址中找到欄位值。例如，若要尋找某些「訂單」查詢值，請篩選管理介面中的「訂單」頁面，然後查看網址。

  • 您可以使用 Shopify GraphiQL app，在您的商店中執行或測試查詢。

  • 請留意查詢失敗時會發生的情況。API 通常會傳回所有結果 (而非沒有任何結果)。

傳回的資料

所有「擷取資料」動作都會傳回 0 到 100 項資源的清單。視您的使用案例而定，您可能希望以各種方式使用這些資料：

  • 若您需要個別處理每個清單項目，例如為每個項目新增標籤，則可以使用「針對每個」動作。
  • 若您需要彙總資料，例如計算傳回的結果數量，則可以使用「計數」或「總和」動作。
  • 若您需要輸出清單，例如在寄送的電子郵件中包含所有項目，則可以直接在後續動作中使用傳回的資料。

若要在接續此動作的步驟中存取傳回的資料，請使用名為「Get article data」(擷取文章資料) 的變數，該變數為文章的清單。您可以在觸發條件與動作中皆使用此變數。例如，您可以在類似如下的「寄送內部電子郵件」動作中傳送文章清單：

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

觸發條件

您可以在任何工作流程中使用此動作，包含採用「排程時間」觸發條件的工作流程。若工作流程使用「排程時間」觸發條件，該工作流程會在您指定的時間啟動，而非因為某個事件才啟動。由於您的商店或 app 中沒有可啟動該工作流程的特定事件，因此系統不會自動包含任何資料。

API 參考資料

如需此動作中所用 API 的詳細資訊，請參閱文章查詢。