将应用访问权限范围从写入降级为只读

从 Admin GraphQL API 版本 2027-01 开始，使用 Shopify 托管安装（Shopify-managed installation）的应用可以调用 appDowngradeAccessScopes，以用对应的读取权限替换可选的写入权限。现有应用无需采取任何操作。

变更内容

该变更仅影响调用应用自身的安装配置。请求的权限必须在 optional_scopes 中声明，且必须为具有对应读取权限的写入权限。必需的权限无法降级。当前未授予的写入权限将被忽略。如果任何请求的权限验证失败，请求将被拒绝，且安装的权限保持不变。

当读取权限仅通过写入权限授予时，使用 appRevokeAccessScopes 撤销写入权限也会同时移除其读取访问权限。如果您的应用仍需要该读取访问权限，请使用 appDowngradeAccessScopes。

受影响对象

此变更适用于使用 Shopify 托管安装并声明了具有对应读取权限的可选写入权限的应用。该变更自 Admin GraphQL API 版本 2027-01 起可用。

操作指南

如果您的应用不再需要写入访问权限，请调用 appDowngradeAccessScopes 并指定您希望降级的可选写入权限。例如，当您的应用不再需要创建或更新产品时，可将 write_products 降级为 read_products：

mutation { appDowngradeAccessScopes(scopes: ["write_products"]) { downgraded { handle } userErrors { field message } } }

downgraded 字段返回成功更改的写入权限。请检查 userErrors 以查看是否有任何验证失败的情况。

相关文档

• appDowngradeAccessScopes 参考
• API 访问范围