說明
登入

取得地點資料

在需要地點資料的工作流程中，您可以使用 取得地點資料 動作，從您的 Shopify 商店擷取地點資訊。Locations 指您用來儲存庫存、銷售商品，或處理訂單出貨與運送的任何場所。

本頁內容

設定

欄位

取得地點資料 動作包含下列欄位。

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

查詢字串

以下範例會查詢已啟用到店取貨的地點：

pickup_in_store:enabled

pickup_in_store 變數是 Locations query 可用的篩選條件，可重複使用，或與其他變數搭配。

查詢資料時，建議先瞭解：

  • 可用地點篩選條件清單

  • 查詢必須遵循 特定語法

  • 查詢欄位的值不一定都有文件記載。有些情況下，您可以從 API 文件 找到這些值。或者，您常可在管理介面篩選時從網址中找到欄位值。舉例來說，若要找出部分訂單查詢的值，請在管理介面的「訂單」頁面套用篩選條件，然後查看網址。

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

  • 請留意查詢失敗時會發生什麼情況。API 通常會傳回所有結果 (而非零筆)。

傳回的資料

所有 取得資料 動作都會傳回 0 到 100 個資源的清單。依您的使用情境，您可以用以下幾種方式運用這些資料：

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

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

觸發條件

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

API 參考資料

如需此動作所用 API 的詳細資訊，請參閱 Locations query。