Shopify 批量操作 access denied：启用步骤与 31 天失效规则

2026-11-06 起，批量操作按类型准入

Shopify 于 2026 年 11 月 6 日宣布，应用通过 GraphQL Admin API 发起 bulk query（批量查询）或 bulk mutation（批量变更）前，需要先启用相应访问。这项要求适用于所有 GraphQL Admin API 版本；升级或降级版本不能替代这一步。

两类操作各自检查对应的访问权：`bulkOperationRunQuery` 需要 bulk query access，`bulkOperationRunMutation` 需要 bulk mutation access。若 app 启动的类型尚未获准，Shopify 会返回 access denied 错误。公告没有给出更精确的生效时刻或时区，因此不能从发布日期推算某个小时的切换点。

先确认 app 类型与当前授权状态

这项变更针对运行 bulk operations 的 public apps，以及由 Partner 创建的 custom apps。商家在 Shopify admin 或 Dev Dashboard 自行创建的 app，按 Shopify 当前公告暂不需要执行这项启用步骤；不要把 Partner 创建的 custom app 与商家自行创建的 app 混为一类。

如果 app 之前已经运行过批量操作，Shopify 表示已为它启用相应访问。仍应在 Partner Dashboard 核对 app 和操作类型的当前状态。要分别看 query 与 mutation：一类已有访问，不代表另一类也自动启用。

过去 31 天未启动的类型，需要重新启用

Shopify 的 31 天规则按操作类型判断：如果 app 在过去 31 天内没有启动 bulk query 或 bulk mutation，就会失去对应类型的访问。失效范围是未启动的那一类；这条规则没有说另一种类型的访问也会同时失效。

举一个假设场景：同一个 app 每周运行 bulk query，却已超过 31 天没有启动 bulk mutation。重新准备批量变更时，应单独检查 mutation 访问；最近的查询活动不能替它保留另一种类型的访问。文档按“启动”操作描述这项规则，不要把它改写成必须在 31 天内完成整个任务。

在 Partner Dashboard 启用对应访问

第一步，在 Partner Dashboard 进入 Apps，选择实际发起请求的 app；然后在侧边栏打开 API access requests。先确认 app 身份，避免检查了另一套集成的设置。

第二步，找到 Run bulk operations。只运行批量查询时点击 Allow bulk queries；运行批量变更时点击 Allow bulk mutations；两者都使用则分别启用。页面若已显示某项启用，无需重复请求。

第三步，确认需要的类型已启用，再按应用原有的权限与业务核对流程处理任务。Shopify 表示，这项访问适用于安装了该 app 的所有商店，不要求更改 app 配置、发布新版本或让商家重新安装。

Bulk 访问不替代普通数据权限

Bulk operation 的准入与查询可读取的数据范围是两层要求。Shopify 文档明确说明，bulk query 中的查询需要与普通 query 相同的 permissions；开启 Allow bulk queries 本身不会授予查询原本没有的数据权限，也不会代替 app 所需的 API access scopes。

若仍遇到权限错误，先分别核对 app、操作类型和普通查询所需的数据授权，再保存准确时间、操作名称及脱敏错误供团队排查。不要仅凭 access denied 就批量重放变更任务，或把启用 bulk access 当作已成功处理商店数据的证明。公告没有宣布新的费用或提供地区、计划清单，不能据此承诺免费或所有账号都符合其他功能的资格。