說明
登入

取得目錄資料

在需要目錄資料的工作流程中，您可以使用 取得目錄資料動作從您的商店擷取 B2B 目錄資訊。目錄是為特定 B2B 顧客或公司地址提供自訂定價的商品群組。

頁面導覽

設定

欄位

取得目錄資料動作包含下列欄位：

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

查詢字串

以下為取得所有有效目錄的查詢範例：

status:ACTIVE

status 變數是 Catalogs 查詢中可用的篩選條件，可重複使用或與其他變數結合使用。

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

  • 可用的目錄篩選條件清單

  • 查詢必須遵循特定語法

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

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

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

傳回的資料

所有「取得資料」動作皆會傳回包含 0 到 100 個資源的清單。視使用案例而定，您可以透過各種方式使用此資料：

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

若要在此動作之後的步驟中存取傳回的資料，請使用名為「取得目錄資料」的變數，這是一份目錄清單。您可以在條件和動作中使用此變數。例如，您可以在類似如下的「傳送內部電子郵件」動作中傳送目錄清單：

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

觸發條件

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

API 參考資料

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