开发Shopify预购商品优惠扩展时遇ApiAccessDeniedError求助

开发首个Shopify预购商品优惠扩展时，遇到ApiAccessDeniedError错误。已按照官方教程配置shopify.app.toml文件：

[capabilities]
api_access = true

但仍收到错误提示：

ApiAccessDeniedError：扩展不允许使用Storefront API；必须在[capabilities]下指定使用Storefront API的权限："api_access = true"

以下是排查解决步骤：

• 确认配置文件位置：确保shopify.app.toml在扩展项目的根目录，而非主Shopify应用的配置文件，新手容易混淆两者路径
• 重新推送扩展配置：修改配置后，执行命令shopify extension push，将更新后的配置同步到Shopify后台，配置不会自动生效
• 检查API调用范围：核实你的Storefront API请求是否涉及未授权的字段或操作，部分特殊接口需要额外权限
• 验证后台权限状态：登录Shopify合作伙伴后台，进入对应扩展的详情页面，确认权限配置已同步显示api_access = true
• 清理本地缓存：删除扩展项目下的.local目录，重启本地开发服务，避免旧配置缓存导致的问题

内容的提问来源于stack exchange，提问作者Naimul Islam Arif