获取礼品卡数据

在需要礼品卡数据的工作流中，您可以使用获取礼品卡数据操作从您的商店中检索礼品卡信息。

需要注意的是，您的商店中既有用于生成礼品卡的礼品卡产品，也有礼品卡本身，后者是客户可用于进行购买的实际礼品卡。获取礼品卡数据操作可检索有关礼品卡本身的信息。若要获取有关礼品卡产品的信息，请使用获取产品数据或获取产品多属性数据操作。

配置

字段

获取礼品卡数据操作包含以下字段，这些字段用于构建查询：

查询字符串

以下是获取在过去一天内更新的礼品卡的查询示例：

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

created_at 变量是礼品卡查询中可用的筛选条件，可以多次使用或与其他变量结合使用。scheduledAt Liquid 变量可用于使用预定时间触发器的工作流。date_minus Liquid 标记是一种特殊的 Flow 标记，可用于从日期中减去时间。

查询数据时，了解以下信息会很有帮助：

• 可用礼品卡筛选条件列表

• 查询必须遵循特定语法

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

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

• 请注意查询失败时会发生什么情况。通常，API 会返回所有结果（而不是不返回结果）。

返回的数据

所有获取数据操作都会返回一个包含 0 到 100 个资源的列表。根据您的用例，您可能需要以各种方式使用这些数据：

• 如果您需要单独处理每个列表项（例如为每个列表项添加标记），则可以使用遍历操作。
• 如果您需要聚合数据（例如统计返回的结果数），则可以使用计数或求和操作。
• 如果您需要输出该列表（例如发送一封包含所有项目的电子邮件），则可以在后续操作中直接使用返回的数据。

若要在后续步骤中访问此操作返回的数据，请使用名为获取礼品卡数据的变量，该变量是一个礼品卡列表。您可以在条件和操作中使用此变量。例如，您可以按如下方式在发送内部电子邮件操作中发送礼品卡列表：

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

触发器

您可以在任何工作流中使用此操作，包括预定时间触发器。在使用预定时间触发器的工作流中，工作流将在您指定的时间启动，而不是因某个事件而启动。由于工作流不是由商店或应用中的特定事件启动的，因此不会自动包含任何数据。

API 详细信息

• 礼品卡资源
• 礼品卡查询筛选条件