說明
登入

擷取市場資料

在需要市場資料的工作流程中，您可以使用「擷取市場資料」動作，從您的 Shopify 商店擷取市場資訊。市場是您的銷售目標地區或地點群組。

本頁面包含

設定

欄位

「擷取市場資料」動作包含下列欄位：

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

查詢字串

以下是取得所有有效市場的查詢範例：

status:ACTIVE

status 變數是市場查詢中可使用的篩選條件，您可以多次使用，或與其他變數結合使用。

查詢資料時，建議您先瞭解以下資訊：

  • 可用市場篩選條件清單

  • 查詢必須遵循特定語法

  • 查詢欄位值不一定都有文件說明。在某些情況下，您可以透過查看 API 文件來尋找這些值。或者，當您套用篩選條件時，通常可以在管理介面的網址中找到欄位值。例如，若要尋找某些訂單查詢值，請在管理介面中篩選「訂單」頁面，然後查看網址。

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

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

傳回的資料

所有 取得資料 動作都會傳回包含 0 到 100 項資源的清單。根據您的使用案例，您可能會想要以各種方式使用這些資料：

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

若要在接續此動作的步驟中存取傳回的資料，請使用名為 取得市場資料 的變數，該變數為市場清單。您可以在條件與動作中使用此變數。例如，您可以在 傳送內部電子郵件 動作中傳送市場清單，如下所示：

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

觸發條件

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

API 參考資料

若要進一步瞭解此動作中使用的 API，請參閱市場查詢。