用途:本技能围绕 Shopify GraphQL Admin API 的查询成本系统,帮助开发者理解成本计算规则,降低查询成本,减少被限流(THROTTLED)的情况,并在需要大批量数据时选择合适的批量操作。
主要能力:解释请求成本与实际成本的区别(requestedQueryCost 与 actualQueryCost);读取响应中 extensions.cost 的成本与限流状态(maximumAvailable、currentlyAvailable、restoreRate);预测查询成本;通过减少 first 参数、只选必要字段、避免深层嵌套来降低成本;在需要 250 条以上数据时改用 bulkOperationRunQuery 批量导出。
必要用法:每次 GraphQL 响应都可在 extensions.cost 查看成本;添加请求头 X-GraphQL-Cost-Include-Fields: true 可获得逐字段成本明细。成本规则包括:单对象字段 1 点;连接字段按 first 或 last 乘以子字段成本并加 2;嵌套连接成本相乘。
适用场景:出现 THROTTLED、MAX_COST_EXCEEDED、QUERY_TOO_COMPLEX 等错误时;需要优化商品、变体、元字段等深层查询时;需要导出完整商品目录等大规模数据时。
限制:资料仅覆盖标准计划下 1000 点上限、每秒 50 点恢复等示例数据;批量操作每个应用每个店铺同时只能运行一个。其他计费、平台或具体实现细节暂未提供。