說明
登入

取得庫存商品資料

在需要庫存商品資料的工作流程中，您可以使用「取得庫存商品資料」動作從您的商店中擷取庫存商品資訊。庫存商品代表系統為產品子類選項所追蹤的實際庫存單位。

本頁面包含

設定

欄位

「取得庫存商品資料」動作包含以下欄位：

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

查詢字串

以下為取得追蹤中庫存商品的查詢範例：

tracked:true

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

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

  • 可用的庫存商品篩選條件清單

  • 查詢必須遵循特定語法

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

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

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

傳回的資料

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

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

若要在這個動作之後的步驟中存取傳回的資料，請使用名為 Get inventory item data 的變數，這是一份庫存商品清單。您可以在條件和動作中使用這個變數。例如，您可以在類似如下的 Send internal email 動作中傳送庫存商品清單：

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

觸發條件

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

API 參考資料

深入瞭解此動作使用的 API，請參閱庫存商品查詢。