GraphQL Admin API 中的新 shippingLabelPurchase 变更
GraphQL Admin API 现在包含 shippingLabelPurchase 变更,允许应用为符合条件的履行订单购买 Shopify Shipping 标签。
应用可以提供履约订单、发货日期和时间、包裹详情、总重量、客户通知偏好以及可选的首选承运商/服务选择。如果未提供首选费率,Shopify 将选择可用的最低费率。
标签购买是异步运行的。该变更返回一个 ShippingLabelPurchaseResult,应用可以轮询它以跟踪请求状态:
- PENDING_PURCHASE:购买仍在处理中。
- PURCHASED:标签已成功购买,购买的标签可在 shippingLabels 上获取。
- PURCHASE_FAILED:购买失败,详细信息可在 errors 上获取。
要求
该变更需要 write_orders 访问范围以及具有 buy_shipping_labels 权限的用户。商店还必须在通过 API 购买标签之前接受 Shopify Shipping 的服务条款。
相关文档
- shippingLabelPurchase 突变
- ShippingLabelPurchaseInput
- ShippingLabelPurchaseResult
- ShippingLabelPurchaseResultStatus

