Admin API 版本 2024-10 的应用可以使用新的 optional_scopes 应用配置来:
- 将必需的作用域与可选的作用域分开
- 按商店为基础请求唯一的访问作用域集合
- 撤销授予应用从商店获得的可选作用域
- 在应用运行时,在上下文中请求和撤销作用域
同时利用 Shopify managed install.
声明可选作用域
在您的 应用配置 中,指定您的应用可能请求的可选作用域,除了您应用的必需 scopes 之外:
[access_scopes] scopes = "read_products" optional_scopes = [ "write_products", "read_discounts", "read_themes" ]在运行时请求、撤销和查询可选作用域
通过可选作用域,应用可以从服务器端 API 或客户端 App Bridge API 提示商户授予其应用访问权限,以获得更集成的体验。有关详细信息,请参阅我们关于 如何动态请求访问作用域 的文档。
已授予的可选作用域可以被应用从商店中动态撤销。我们的 API 为此提供了一个 revoke 方法,我们还提供了一个 GraphQL appRevokeAccessScopes 变更。
使用可选作用域时,应用可能需要知道当前商店上授予了哪些作用域。我们提供了一个列出商店上已授予作用域的 query 方法。应用还可以手动查询 AppInstallation 对象上的 accessScopes 字段。
了解更多
要了解有关可选作用域的更多信息,请参阅我们关于 如何管理访问作用域 的文档。另请参阅我们的客户端 App Bridge 作用域 API 和我们的服务器端 Remix 作用域 API。

