---
title: "ProductVariant"
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/objects/product-variant'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/objects/product-variant.md'
---
# ProductVariant

代表一种产品变体类型

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

## Type Signature

`ProductVariant`

## Fields

* `availableForSale`

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

  可供出售的变体的可用性

* `barcode`

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

  与产品关联的条形码的值

* `compareAtPrice`

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

  该变体的原始价格，使用商店的默认货币

* `createdAt`

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

  创建变体的日期和时间

* `defaultCursor`

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

  返回下一个变体的默认光标，按变体 ID 升序排序

* `displayName`

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

  变体的显示名称，源自产品标题和变体标题

* `id`

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

  产品变体的ID，通用的唯一标识符

* `image`

  [Image](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/image.md)

  变体图片

* `inventoryItem`

  [InventoryItem!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-item.md)

  产品库存项目，用于查询库存信息

* `inventoryPolicy`

  [ProductVariantInventoryPolicy](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/enums/product-variant-inventory-policy.md)

  库存耗尽时是否可以订购产品变体

* `inventoryQuantity`

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

  产品变体的可销售总数量

* `price`

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

  以默认商店货币表示的产品变体的价格

* `product`

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

  该变体所属的产品

* `productId`

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

  该变体所属的产品ID

* `selectedOptions`

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

  应用于变体的产品选项列表

* `sku`

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

  产品变体的 SKU，区分大小写的字符串

* `taxable`

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

  该变体在出售时是否需征税

* `title`

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

  产品变体的标题

* `updatedAt`

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

  上次修改产品变型的日期和时间

* `weight`

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

  产品变型的重量（以 weight_unit 定义的单位表示）

* `weightUnit`

  [WeightUnit](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/enums/weight-unit.md)

  变体重量的测量单位。如果未指定 `weight_unit`，则将应用商店的默认测量单位

## Schema Definition

```graphql
type ProductVariant { 
	availableForSale: Boolean!
	barcode: String
	compareAtPrice: Money
	createdAt: Date!
	defaultCursor: String!
	displayName: String!
	id: ID!
	image: Image
	inventoryItem: InventoryItem!
	inventoryPolicy: ProductVariantInventoryPolicy
	inventoryQuantity: Int
	price: Money
	product: Product
	productId: ID!
	selectedOptions: [SelectedOption!]
	sku: String
	taxable: Boolean!
	title: String!
	updatedAt: Date!
	weight: Float
	weightUnit: WeightUnit 
}
```

## Field from

* [Query](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/queries/product-variant.md).productVariant

  按 ID 返回 ProductVariant 资源。

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

  ProductVariant 的节点

* [ProductVariantsBulkUpdatePayload](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/objects/product-variants-bulk-update-payload.md).productVariants

  更新的变体列表

* [ProductVariantsBulkCreatePayload](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/objects/product-variants-bulk-create-payload.md).productVariants

  新创建的变体

## 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)。