帮助
登录

获取文章数据

在需要博客文章数据的工作流中，您可以使用获取文章数据操作从您的 Shopify 商店检索文章信息。

本页相关主题

配置

字段

获取文章数据操作包含以下字段：

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

查询字符串

下面是获取前一天发布的文章的查询示例：

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

published_at 变量是适用于文章查询的过滤器，可以多次使用或与其他变量结合使用。scheduledAt 动态占位符适用于使用预定时间触发器的工作流。date_minus Liquid 标记是一种特殊的 Flow 标记，支持从日期中减去时间。

在查询数据时，建议您了解以下信息：

  • 可用文章过滤器列表

  • 查询必须遵循特定语法

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

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

  • 请注意查询失败时的后果。通常，API 会返回所有结果（而不是无结果）。

返回的数据

所有获取数据操作都会返回包含 0 到 100 个资源的列表。根据用例的不同，您可以通过多种方式使用此数据：

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

要在该操作之后的步骤中访问返回的数据，请使用名为 Get article data 的变量（即文章列表）。您可以在条件和操作中使用此变量。例如，您可以在发送内部电子邮件操作中发送文章列表，如下所示：

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

触发器

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

API 参考

有关此操作中使用的 API 的详细信息，请参阅文章查询。