帮助
登录

获取地点数据

在需要地点数据的工作流中，您可以使用获取地点数据操作从您的 Shopify 商店检索地点信息。地点是您存储库存、销售产品、运输或为订单发货的任何地方。

本页内容

配置

字段

获取地点数据操作包含以下字段。

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

查询字符串

这是一个用于获取启用了到店取货的地点的示例查询：

pickup_in_store:enabled

pickup_in_store 变量是 Locations query 中可用的筛选条件，可多次使用或与其他变量结合使用。

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

  • 可用地点筛选条件列表

  • 查询必须遵循特定语法

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

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

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

返回的数据

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

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

若要在该操作的后续步骤中访问返回的数据，请使用名为 Get location data 的变量，它是一个地点列表。您可以在条件和操作中同时使用此变量。例如，您可以在发送内部电子邮件操作中发送地点列表，如下所示：

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

触发器

您可以在任何工作流中使用此操作，包括计划时间触发器。在使用计划时间触发器的工作流中，工作流在您指定的时间（而不是在某个事件发生后）开始。由于没有可启动工作流的来自您的商店或应用的特定事件，因此不会自动包含任何数据。

API 参考

有关此操作中使用的 API 的详细信息，请参阅 Locations query。