获取折扣数据

在需要折扣数据的工作流中,您可以使用获取折扣数据操作从您的商店中检索折扣信息。

配置

字段

获取折扣数据操作包含以下用于构建查询的字段:

“获取数据”操作中使用的字段。
字段描述
数据排序依据必填。用于对搜索查询所返回的数据进行排序的参数。
最大结果数必填。您选择的搜索查询可以返回的最大结果数。一次最多可以返回 100 个结果。
查询必填。从常用查询中进行选择,或选择高级以创建自定义查询。

查询字符串

以下是获取使用折扣码的有效折扣的查询示例:

method:code AND status:active

methodstatus 变量是折扣节点查询上可用的筛选条件,可多次使用或与其他变量结合使用。

在查询数据时,了解以下信息会很有帮助:

  • 可用折扣筛选条件列表
  • 查询必须遵循特定语法
  • 查询字段值并非总是有相关文档记录。在某些情况下,可以通过查看 API 文档 来找到这些值。或者,当您在后台中进行筛选时,通常可以在 URL 中找到字段值。例如,若要查找某些订单查询值,请在后台中筛选“订单”页面,然后检查 URL。
  • 您可以使用 Shopify GraphiQL 应用 在您的商店中运行或测试查询。
  • 请注意查询失败时会发生什么情况。API 通常会返回所有结果(而不是不返回任何结果)。

返回的数据

所有 Get data 操作都会返回一个包含 0 到 100 个资源的列表。根据您的用例,您可能希望通过各种方式使用这些数据:

  • 如果您需要单独处理每个列表项(例如为每个列表项添加标记),则可以使用 For each 操作。
  • 如果您需要聚合数据(例如计算返回了多少结果),则可以使用 CountSum 操作。
  • 如果您需要输出列表(例如发送一封包含所有商品的电子邮件),则可以在后续操作中直接使用返回的数据。

若要在此操作之后的步骤中访问返回的数据,请使用名为 Get discount data 的变量,它是一个折扣列表。您可以在条件和操作中均使用此变量。例如,您可以像下面这样在 Send internal email 操作中发送自动应用折扣列表:

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

触发器

您可以在任何工作流(包括 Scheduled time 触发器)中使用此操作。在使用 Scheduled time 触发器的工作流中,工作流在您指定的时间(而不是由于某个事件)启动。由于没有来自您的商店或应用的特定事件来启动工作流,因此系统不会自动包含任何数据。

API 详细信息

模板

发送使用折扣码的有效折扣的每周摘要

发送使用折扣码的有效折扣的摘要。该工作流按计划在每周一上午 9 点运行。可以对该工作流进行自定义,以更改时间、摘要接收方式、要包括的折扣类型和模式。查看模板