获取产品数据
在使用产品数据的工作流中,获取产品数据操作可用于检索您商店中的产品信息。
配置
字段
获取产品数据操作包含以下字段,这些字段可用于构建查询:
字段 | 描述 |
---|---|
数据排序依据 | 必填。搜索查询返回的数据在排序时所依据的参数。 |
最大结果数 | 必填。您选择的搜索查询可返回的最大结果数。一次最多可返回 100 个结果。 |
查询 | 必填。从常见查询中选择,或选择高级以创建自己的查询。 |
查询字符串
下方的示例查询用于获取过去一天内更新的产品:
updated_at
变量是在产品查询中可用的筛选条件,可多次使用或与其他变量组合使用。scheduledAt
Liquid 变量适用于使用“已安排时间”触发器的工作流。date_minus
Liquid 标记是特殊的 Flow 标记,可用于提取日期中的时间。
查询数据时,了解以下内容将有所帮助:
- 可用产品筛选条件的列表 - 查询必须遵循特定语法
- 可在 QueryRoot 对象的开发人 员文档中找到所有查询的查询字段名称。
- 查询字段值并不总是有相应记录。在某些情况下,可以通过查看 API 文档来找到值。或者,在筛选时,您通常可以在后台的 URL 中找到字段值。例如,若要查找一些“订单”查询值,请筛选后台中的“订单”页面,然后检查 URL。
- 您可以使用 Shopify GraphiQL 应用在商店中运行或测试查询。
- 请注意查询失败时发生的情况。通常,API 将返回所有结果(而不是没有任何结果)。
返回的数据
所有获取数据操作都将返回包含 0 到 100 个资源的列表。根据您的用例,您可能需要以多种方式使用此数据:
- 如果您需要单独处理每个列表项,例如为每个项目添加标签,则您可以使用针对每项操作。
- 如果您需要聚合数据,例如计算返回的结果数,则您可以使用计数或求和操作。
- 如果您需要输出该列表,例如发送包含所有项目的电子邮件,则可以直接使用在后续操作中返回的数据。
若要访问此操作后的步骤中返回的数据,请使用名为获取产品数据的变量,这将获取产品列表。您可在条件和操作中使用此变量。例如,您可在类似下方的发送内部电子邮件操作中发送产品列表:
触发器
您可以在任何工作流中使用此操作,包括已安排时间触发器。在使用已安排时间触发器的工作流中,工作流在您指定的时间启动,而不是因事件而启动。由于您的商店或应用中没有可启动工作流的特定事件,因此不会自动包含任何数据。
API 详细信息
模板
在未来向产品系列中添加具有标签的产品
在未来的某个时间,获取具有特定标签的所有产品并将其添加到产品系列中。查看模板
删除非活跃产品
删除一年未更新的无库存产品。查看模板
在未来发布具有特定标签的产品
在未来的日期,获取具有特定标签的产品并进行发布。使用“已安排时间”触发器和“获取产品数据”操作。查看模板
在创建产品 90 天后删除“新”产品标签
每天运行,获取在 90 天前创建但仍具有“新”标签的产品(最多 100 件)。随后,该工作流将删除每件产品的此类标签。查看模板
安排在指定日期和时间从在线商店中删除 产品。
在未来的某个日期,按标签、ID 或 SKU 从在线商店中删除产品。使用“已安排时间”触发器、“获取产品数据”操作、“针对每项”循环。查看模板
发送包含缺货产品的每日电子邮件摘要
每天运行,获取库存为 0 的所有产品并发送电子邮件摘要。使用“获取产品数据”、“已安排时间”触发器。查看模板
在为多属性添加重复 SKU 时发送电子邮件通知
在添加新多属性时,检查是否有任何其他多属性使用相同的 SKU。如果有,则发送包含相关产品和多属性链接的内部电子邮件。查看模板
使用产品元字段跟踪在售产品多属性
如果产品至少有一个多属性正在销售,则设置该产品的元字段。这对于跟踪哪些产品目前正在销售非常有用。查看模板