获取订阅结算尝试数据

在需要订阅结算尝试数据的工作流中，您可以使用获取订阅结算尝试数据操作检索商店中的订单信息。

配置

字段

获取订阅结算尝试数据操作包含以下字段，这些字段可用于构建查询：

“获取数据”操作中使用的字段。

字段	描述
数据排序依据	必填。搜索查询返回的数据在排序时所依据的参数。
最大结果数	必填。您选择的搜索查询可返回的最大结果数。一次最多可返回 100 个结果。
查询	必填。从常见查询中选择，或选择高级以创建自己的查询。

查询字符串

下方的示例查询用于获取过去三天内创建的订阅结算尝试：

created_at:>'{{ createdAt | date_minus: "3 day" }}'

created_at 变量是在订阅结算尝试查询中可用的筛选条件，并且可用于选择订阅结算尝试的特定错误消息。

查询数据时，了解以下内容将有所帮助：

• 可用订阅结算尝试筛选条件的列表 - 查询必须遵循特定语法
• 可在 QueryRoot 对象的开发人员文档中找到所有查询的查询字段名称。
• 查询字段值并不总是有相应记录。在某些情况下，可以通过查看 API 文档来找到值。或者，在筛选时，您通常可以在后台的 URL 中找到字段值。例如，若要查找一些“订单”查询值，请筛选后台中的“订单”页面，然后检查 URL。
• 您可以使用 Shopify GraphiQL 应用在商店中运行或测试查询。
• 请注意查询失败时发生的情况。通常，API 将返回所有结果（而不是没有任何结果）。

返回的数据

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

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

若要访问此操作后的步骤中返回的数据，请使用名为获取订阅结算尝试数据的变量，这将获取订阅结算尝试列表。您可在条件和操作中使用此变量。例如，您可在类似下方的发送内部电子邮件操作中发送订阅结算尝试列表：

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

备注

如果在一个工作流中多次使用了获取数据操作，则系统会向变量名称中添加一个数字。例如，在使用了两次获取订单数据操作的工作流中，返回数据的第一个变量为 getOrderData，第二个变量为 getOrderData1。无法自定义此名称。

示例

例如，工作流被安排在每周日上午 9：00 运行。获取订阅结算尝试数据操作用于收集过去一周内创建的订阅结算尝试的数据。如果有错误消息，请通过电子邮件发送结算尝试。

API 参考

• 订阅结算尝试资源
• 订阅结算尝试查询筛选条件