我们引入了新的 GraphQL 查询,以帮助您在 Admin API 中检索和管理批量操作。
更新内容
以下是更新的概览:
新的批量操作检索查询
我们添加了两个新查询以访问您的批量操作:
- bulkOperations: 一个基于连接的查询,返回所有批量操作的分页列表,并提供筛选和排序选项。
- bulkOperation: 一个单对象查询,通过其 ID 检索特定的批量操作。
增强的筛选和搜索功能
bulkOperations连接现在支持灵活查询,具有以下功能:
- 状态过滤:按状态(例如已取消、已完成、运行中)定位操作。
- 类型过滤:按类型(查询或变更)过滤操作。
- 日期过滤:搜索在特定日期之前或之后创建的操作。
- 排序选项:按created_at、completed_at或status以升序或降序对操作进行排序。
- 搜索语法:使用field:value模式进行精确过滤。
您需要做什么
根据您的要求,请执行以下步骤:
列出并筛选批量操作
利用带有搜索语法的bulkOperations连接查询:
query { bulkOperations( first: 10 query: "status:completed operation_type:query created_at:>2025-10-10" sortKey: CREATED_AT reverse: true ) { edges { node { id status query createdAt completedAt url } } pageInfo { hasNextPage hasPreviousPage } } }检索特定的批量操作
使用bulkOperation查询:
query { bulkOperation(id: "gid://shopify/BulkOperation/123456789") { id status query createdAt completedAt url errorCode } }如果您正在使用现有的批量操作流程
无需更改。currentBulkOperation仍可使用,但正在被弃用。
我们做出此更改的原因
以前,您只能通过currentBulkOperation访问最新的批量操作。这些新查询提供:
- 完全查看您的所有批量操作,而不仅仅是当前操作。
- 通过按状态或日期筛选操作来增强调试能力。
- 高效的分页机制,用于管理大量操作。
- 简化大规模批量操作的监控、调试和管理。
了解更多
- 批量操作查询指南

