說明
登入

取得公司資料

在使用公司資料的工作流程中，您可以使用「取得公司資料」動作，從商店擷取公司資訊。

本頁內容

設定

欄位

「取得公司資料」動作包含下列欄位，用於建立查詢：

「取得資料」動作中使用的欄位。
欄位說明
排序依據必填。決定搜尋查詢所傳回資料排序的參數。
結果數量上限必填。您所選搜尋查詢可傳回的結果數量上限。每次最多可傳回 100 筆。
查詢必填。可從常見查詢中選擇，或選取進階自行建立查詢。

查詢字串

以下範例可擷取過去一天內更新的公司：

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

updated_at 變數是 公司查詢 可用的篩選條件，可重複使用或與其他變數搭配。scheduledAt Liquid 變數適用於使用了 排程時間觸發條件 的工作流程。date_minus Liquid 標籤是 Flow 的特殊標籤，可用來從日期減去時間。

在查詢資料時，下列資訊很實用：

  • 可用的公司篩選條件清單
  • 查詢必須遵循特定語法
  • 查詢欄位的可用值不一定都有文件說明。有時可以在API 說明文件中找到這些值。或者，您也常可在管理介面套用篩選時，從網址找到欄位值。例如，若要找出部分訂單查詢的值，請在管理介面的「訂單」頁面套用篩選，然後查看網址。
  • 您可以使用 Shopify GraphiQL app 在商店中執行或測試查詢。
  • 請留意查詢失敗時會發生什麼情況。API 經常會傳回所有結果 (而非完全沒有結果)。

傳回的資料

所有「取得資料」動作都會傳回 0 到 100 筆資源的清單。依您的使用情境而定，您可以用不同方式運用這些資料：

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

若要在此動作後續步驟中存取回傳資料，請使用名為 取得公司資料 的變數，該變數是一份公司清單。您可以在條件與動作中使用此變數。例如，您可以在 寄送內部電子郵件 動作中這樣寄送公司清單：

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

觸發條件

您可以在任何工作流程中使用此動作，包括 排程時間 觸發條件。在使用 排程時間 觸發條件的工作流程中，系統會在您指定的時間啟動工作流程，而非因事件而啟動。由於並非由商店或 app 的特定事件觸發，工作流程不會自動包含任何資料。

API 參考資料