帮助
登录

获取库存商品数据

在需要库存商品数据的工作流中，您可以使用获取库存商品数据操作从商店中检索库存商品信息。库存商品代表产品多属性跟踪的实际库存单位。

本页内容

配置

字段

获取库存商品数据操作包含以下字段：

获取数据操作中使用的字段。
字段描述
数据排序方式必填。用于对搜索查询返回的数据进行排序的参数。
最大结果数必填。您选择的搜索查询可返回的最大结果数量。一次最多可返回 100 个结果。
查询必填。请从常用查询中进行选择，或选择高级来创建您的专属查询。

查询字符串

以下是用于获取受跟踪库存商品的查询示例：

tracked:true

tracked 变量是 Inventory items 查询中提供的一种筛选条件，可多次使用或与其他变量结合使用。

在查询数据时，了解以下内容会很有帮助：

  • 可用库存商品筛选条件列表

  • 查询必须遵循特定的语法

  • 查询字段值并不总是记录在案。在某些情况下，可以通过查看 API 文档来找到这些值。或者，在进行筛选时，您通常可以在后台的 URL 中找到字段值。例如，要查找某些订单查询值，请在后台筛选“订单”页面，然后检查 URL。

  • 您可以使用 Shopify GraphiQL 应用在您的商店中运行或测试查询。

  • 请注意查询失败时的后果。通常，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 触发器的工作流中，工作流会在您指定的时间启动，而不是由于某个事件而启动。由于您的商店或应用中没有启动该工作流的具体事件，因此不会自动包含任何数据。

API 参考

参阅 Inventory items query，详细了解此行动中使用的 API。