---
title: "productVariantsBulkUpdate"
description: "批量更新产品变体。"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/mutations/product-variants-bulk-update'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/mutations/product-variants-bulk-update.md'
---
# productVariantsBulkUpdate

批量更新产品变体。

- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`ProductVariantsBulkUpdatePayload`

## Arguments

* `productId`

  [ID!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  与要更新的变体关联的产品 ID

* `variants`

  [[ProductVariantsBulkInput!]!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/inputs/product-variants-bulk-input.md)

  一系列要更新的产品变体

## Returns

* `product`

  [Product](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/objects/product.md)

  更新后的产品对象

* `productVariants`

  [[ProductVariant!]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/objects/product-variant.md)

  更新的变体列表

* `userErrors`

  [[UserError]!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/user-error.md)

  执行突变时发生的错误列表

## Code Example

```graphql
mutation productVariantsBulkUpdate($productId: ID! $variants: [ProductVariantsBulkInput!]! ) {
	productVariantsBulkUpdate(productId: $productId, variants: $variants ) 
		 {
			# ProductVariantsBulkUpdatePayload fields
		}
		
	}

```

## Variables

```json
{
  "productId": {},
  "variants": {
    "barcode": "",
    "compareAtPrice": "{}",
    "harmonizedSystemCode": "",
    "id": "",
    "inventoryItem": {
      "cost": {},
      "tracked": {}
    },
    "inventoryPolicy": {},
    "inventoryQuantities": {
      "availableQuantity": {},
      "locationId": ""
    },
    "mediaId": {},
    "mediaSrc": {},
    "options": "",
    "price": {},
    "requiresShipping": false,
    "sku": "",
    "taxable": false,
    "weight": {},
    "weightUnit": {}
  }
}
```

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes)。