获取产品目录数据

在需要产品目录数据的工作流中，您可以使用获取产品目录数据操作从您的商店检索 B2B 产品目录信息。产品目录是指向特定 B2B 客户或公司地点提供定制化定价的产品组。

本页面的内容

获取产品目录数据操作包含以下字段：

在“获取数据”操作中使用的字段。
字段	描述
数据排序方式	必填。作为搜索查询返回的数据排序依据的参数。
最大结果数	必填。您选择的搜索查询可返回的最大结果数量。一次最多可返回 100 个结果。
查询	必填。请从常用查询中进行选择，或选择高级来创建您的专属查询。

以下是用于获取所有活跃目录的查询示例：

status:ACTIVE

status 变量是 Catalogs 查询中提供的一种筛选条件，可多次使用或与其他变量结合使用。

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

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

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

要在执行此操作后的步骤中访问返回的数据，请使用名为 Get catalog data 的变量（即目录列表）。您可以在条件和操作中使用此变量。例如，您可以在类似如下的发送内部电子邮件操作中发送目录列表：

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

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

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