說明
登入

取得公司地址資料

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

本頁內容

設定

欄位

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

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

查詢字串

以下示範如何查詢過去一天內更新的公司地址：

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

updated_at 變數是 Company locations query 可用的篩選條件，可多次使用或與其他變數搭配。使用 Scheduled time trigger 的工作流程可使用 scheduledAt Liquid 變數。date_minus Liquid 標籤是 Shopify Flow 的特殊標籤，可讓您從日期中減去時間。

查詢資料時，建議先瞭解下列事項：

  • List of available company location filters
  • 查詢必須遵循certain syntax
  • 查詢欄位的值不一定都會記載在文件中。有些情況可以在 API docs 中找到這些值。或者，您在管理介面套用篩選條件時，通常也能在網址中找到欄位值。例如，要找出部分「訂單」查詢的值，請在管理介面的「訂單」頁面套用篩選條件，然後查看網址。
  • 您可以使用 Shopify GraphiQL app 在商店中執行或測試查詢。
  • 請留意查詢失敗時的狀況。API 通常會傳回所有結果（而非不傳回任何結果）。

傳回的資料

所有「取得資料」動作都會傳回包含 0 到 100 個資源的清單。視您的使用情境而定，您可以用下列方式使用這些資料：

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

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

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

觸發條件

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

API 參考