API版本2026-10将退货政策配置文件添加到GraphQL管理API中。退货政策配置文件是一组退货规则，您可以将其与市场关联，它将取代商店的退货政策文本。您的应用现在可以以结构化数据（如退货窗口长度）的形式查询每个市场的退货规则。
新增内容
两个查询字段：
- returnPolicyProfile: 通过 ID 返回单个配置文件。
- returnPolicyProfiles：返回商店的配置文件。使用default参数按默认状态进行过滤。
您还可以在市场创建或更新时为其分配配置文件，或在更新时移除该分配。有关输入字段，请参阅marketCreate和marketUpdate参考文档。
访问范围
读取配置文件（包括Market上的returnPolicyProfile字段）需要read_legal_policies访问范围。在市场分配或移除配置文件属于市场编辑操作，需要write_markets。如果您的应用同时执行这两项操作，请请求这两个范围。
配置文件的运作方式
ReturnPolicyProfile是您配置退货规则的单位，市场会绑定到它。一个配置文件包含一组规则，任何市场都可以引用它。编辑配置文件将更改所有引用该配置文件的市场中的退货条款。
每个商店都有一个未命名的默认配置文件。它适用于所有未分配命名配置文件的地区。您可以添加命名配置文件，以划分需要不同条款的地区。
在使用“受管理地区”的商店中，Shopify 会为商店的欧盟地区配置一个配置文件，因为那里的法规对退货设定了最低标准。该配置文件是锁定的，其条款不得低于最低标准。您的应用可以读取它，但不能将其分配给其他地区。
需要考虑的行为
Market.returnPolicyProfile返回直接与该市场关联的配置文件，在没有关联时则为null。它不会解析市场层级结构。null结果表示没有为该市场直接分配配置文件。
returnRules和editRules字段可为空。值为null表示这些规则已关闭而非缺失。在returnRules为null的配置文件中，客户可以无限制地退货。
updatedAt字段是聚合自配置文件及其规则的，而不是直接写在配置文件行上，因此当政策的某一部分发生变化时它会更新。
当您在同一请求中更新地区、分配一个配置文件并移除另一个时，会返回用户错误。将 Shopify 配置的“受管理地区”配置文件分配给某个地区也会返回用户错误。
不包含的内容
GraphQL Admin API 中没有用于退货政策配置文件的变更操作。创建、更新和删除配置文件是在 Shopify 后台进行的，且配置文件为只读。
该怎么办
您无需更改应用。现有的读取政策文本的查询仍可正常工作。
如果您的应用从Shop.shopPolicies中的REFUND_POLICY读取退货条款，请将其移至returnPolicyProfiles查询。您必须使用退货政策配置文件来为每个市场表达不同的退货规则。
了解更多
- ReturnPolicyProfile 对象引用
- 在Shopify 管理后台中管理退货规则