预览 Shopify Flow 中使用的 API 数据

构建工作流时，您可能经常需要在条件和操作中使用商店的数据。Shopify Flow 可通过调用 GraphQL Admin API 来访问商店数据，这意味着您可以访问该 API 中的几乎所有字段。

构建工作流时，您通常会遇到基于 API 的字段名称和描述，但您可能需要了解该 API 输出的数据。例如，您可能希望知道通过草稿订单创建的订单所对应的应用名称。此外，您可能还需要确保您的工作流输出的是您预期的数据，或者以您预期的形式输出数据。

若要查看数据，您可以在 Shopify Flow 中使用多个选项。

本页相关主题

在 Shopify 后台中查找字段

大多数情况下，您可在 Shopify 后台中查找数据。例如，product.title 在产品页面上列出。

在实时工作流中使用字段

您可以通过使用日志输出操作来安全地使用工作流中的字段。运行工作流时，日志输出操作会将任何变量和文本的输出打印到“运行历史记录”页面。您还可以使用通知操作，例如发送内部电子邮件。

使用日志输出的步骤：

选择可手动触发的触发器。
向工作流添加日志输出操作，并将其连接到触发器。
在日志输出配置中，点击添加变量以将要检查的变量添加到输出部分。
完成后，点击开启工作流。
通过触发触发器或手动运行工作流来触发工作流。例如，您使用已创建订单触发器，然后创建一个测试订单。
工作流运行后，请查看活动日志以检查变量。

参阅资源 JSON 页面

您可以在 Shopify 后台中的大多数资源页面（例如订单、产品或客户页面）查看对应页面使用的数据。此类数据与 Shopify Flow 使用的命名和格式不完全相同，但值与 GraphQL Admin API 中的值匹配。若要查看数据，请将 .json 添加到 URL 中。

例如，在 Shopify 后台中转到订单页面并点击某个订单即可导航到相应订单。在浏览器地址栏中的页面地址中，将地址从：

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

更改为：

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

使用 GraphiQL 或第三方 API 工具

您可以使用 Postman 等第三方 API 工具或 Shopify 提供的免费工具 GraphiQL 来直接查询 API。此选项可提供最准确的结果，但要求熟悉创建 GraphQL 查询的流程。

对于 GraphiQL，Shopify 同时提供具有通用数据的基于 Web 的 GraphiQL Explorer 和 GraphiQL 应用。通过使用 GraphiQL，您可以生成一个 GraphQL 查询，该查询与 Shopify Flow 中显示的字段名称完全匹配。如果您使用该应用，相关值也与您的商店完全匹配。

通过使用此工具，您可以准确确定 Shopify Flow 使用的数据以及您的实际商店数据。例如，您创建以下查询：

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

在下面的结果中，变量 order / app / name 显示订单的应用名称。在此示例中，订单是通过草稿订单应用创建的，因此值为 Draft Orders。渠道信息仅适用于 Point of Sale 应用。

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }