在 Shopify Flow 中使用带参数的 API 字段创建变量
某些变量需要附加参数才能在 Shopify Flow 工作流中正常运行。此类附加参数(即参数)必须由您声明值之后,此变量才算完整并可供工作流使用。
例如,product.inCollection 字段用于确定产品是否位于指定产品系列中,并返回布尔值 true 或 false 结果。但是,此字段必须包含产品系列的 id 参数,否则变量将不知道要检查哪个特定产品系列。若要正确使用此字段,您必须将此参数作为该字段的一部分包含在内。例如,查询 product.inCollection(id: "gid://shopify/Collection/123456"),以便 Flow 能够确定该产品是否在 ID 为 123456 的产品系列中,然后按预期返回 true 或 false。在 Shopify Flow 中创建变量时,您无需搜索产品或产品系列 ID 等值。Flow 提供了用于选择所需值的资源选择器,并且会自动填写 ID。
为简化查询带参数字段的体验,您可以为在 Shopify Flow 中根据字段和参数创建的变量分配新的变量名称。例如,如果 ID 为 123456 的产品系列名称为 Summer Bestsellers,则您可以为 inCollection(id: "gid://shopify/Collection/123456") 变量分配一个更简单的名称:inSummerBestsellers。随后,在工作流的所有后续步骤中,您便可直接使用变量 product.inSummerBestsellers。
由于分配给参数的值不同,参数也会有所不同,因此您可以根据需要参数的单个字段创建多个新变量。例如,仅根据 product.inCollection 字段,您就可以创建 3 个唯一的变量:
product.inCollection(id: "gid://shopify/Collection/123456")可以是product.inSummerBestsellers。product.inCollection(id: "gid://shopify/Collection/654321")可以是product.inSwimwear。product.inCollection(id: "gid://shopify/Collection/112233")可以是product.inBeachAccessories。
Shopify Flow 中支持的 GraphQL Admin API 字段
Shopify Flow 支持 GraphQL Admin API 中以下带有必填参数的字段:
- channel.hasCollection
- collection.hasProduct
- collection.publishedOnChannel
- collection.publishedOnPublication
- companyLocation.inCatalog
- inventoryItem.inventoryLevel
- location.inventoryLevel
- metaobject.field
- market.assignedCustomization
- marketLocalizableResource.marketLocalizations
- product.inCollection
- product.publishedOnChannel
- product.publishedOnPublication
- product.restrictedForResource
- publication.hasCollection
- publishable.publishedOnChannel
- publishable.publishedOnPublication
- sellingPlanGroup.appliesToProduct
- sellingPlanGroup.appliesToProductVariant
- sellingPlanGroup.appliesToProductVariants
- 20 个
translations类型字段,例如 collection.translations 和 product.translations
Shopify Flow 中不支持的 GraphQL Admin API 字段
Shopify Flow 不支持以下字段:
- deliveryCarrierService.availableServicesForCountries
- inventoryLevel.quantities
- return.suggestedFinancialOutcome
- return.suggestedRefund
- shop.search
若要在工作流中使用这些不受支持的字段中的数据,您必须使用发送 HTTP 请求操作。
基于带参数的字段创建变量
对于需要参数的任何受支持字段,您都可以在 Shopify Flow 中为其创建变量。您只需在单个工作流中创建一次变量,因为该变量会始终可用作该工作流所有后续步骤中的选项。
您创建的变量不会与其他任何工作流共享,因此,若要在其他工作流中使用该变量,您必须在其他工作流中重新添加。
步骤:
- 在 Shopify Flow 工作流中,点击行动或条件中的添加变量。
- 选择需要参数的字段。这些字段会显示
+按钮。然后,点击 + 创建变量。 - 在 创建变量 对话框中,执行以下步骤:
- 根据您选择的字段,为所需参数设置一个值。
- 可选:在新变量名称字段中,自定义新变量的名称。此名称仅适用于当前工作流。
- 点击添加,刷新变量选择面板。
将新变量添加到工作流后,该变量仍可作为字段选项使用,您可以快速在后续步骤中引用它。选择添加变量时,它会嵌套显示在字段列表中的原始字段选项下方。
在 Shopify Flow 中通过元字段创建变量
元字段是一种具有需要参数的字段的变量。在 Shopify Flow 工作流中获取元字段数据与在其他变量中获取标准字段数据略有不同,因为元字段的 namespace 和 key 字段值由您创建和定义,所以它们在您的商店中始终是唯一的。
例如,无论您在哪个商店中进行操作,product.inCollection 字段始终需要 id 参数。但是,由于商店中创建的每个元字段的命名空间和键都由您来设置,因此所需参数都是自定义的。因此,如果某个产品元字段用于获取夏季服装产品的护理说明,其变量可能是 product.careGuideSummer.value;如果某个产品元字段用于记录产品适用年龄段的 ID,其变量可能是 product.ageGroup.value_item.taxonomyReference.id。字段名称和参数完全由您决定。
参阅Shopify Flow 中的元字段,详细了解。