--- title: "Product" description: "商品信息。" doc_type: graphql doc_category: storefront doc_version: v20270301 source_url: html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product' md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product.md' --- # Product 商品信息。 - **API Version:** v20270301 - **API Type:** Storefront - **API Protocol:** GraphQL - **Operation Type:** Object ## Fields * `featuredImage` [Image](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/image.md) 商品的封面图。 * `options` [[ProductOption]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-option.md) 商品规格列表。 * `onlineStoreUrl` [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商品在线商店的访问链接。若该商品尚未发布至在线商店销售渠道，则返回 `null`。 * `descriptionHtml` [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商品的描述。 * `handle` [String!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商品的语义化的唯一标识，默认基于 `title` 生成。 * `title` [String!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商品的标题。 * `~~brand~~` [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商品的品牌或厂商。 [Deprecated] * `~~status~~` [ProductStatus](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/enums/product-status.md) 商品的状态。 [Deprecated] * `templatePath` [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商品的主题模板。 * `totalInventory` [Int](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/int.md) 库存总数。 * `totalVariants` [Int](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/int.md) 商品款式数量。 * `~~variants~~` [[ProductVariant]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-variant.md) 商品款式列表。 [Deprecated] * `~~images~~` [[Image]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/image.md) 商品图片列表。 [Deprecated] * `createdAt` [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md) 商品的创建日期和时间。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。 * `updatedAt` [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md) 商品最近一次更新的日期和时间。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。 * `collections` [CollectionConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/collection-connection.md) 商品关联的分类列表。 * `priceRange` [ProductPriceRange](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-price-range.md) 商品所有款式的售价区间。 * `compareAtPriceRange` [ProductPriceRange](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-price-range.md) 商品所有款式的原价区间。 * `vendor` [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商品的品牌或厂商。 * `availableForSale` [Boolean](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/boolean.md) 表明是否至少有一个商品款式可售。 - `true`: 有商品款式可售。 - `false`: 无商品款式可售。 * `variantsV2` [ProductVariantConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-variant-connection.md) 商品款式列表。 * `imagesV2` [ImageConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/image-connection.md) 与商品相关的图片列表。 * `media` [MediaConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/media-connection.md) 商品的媒体列表。 * `isGiftCard` [Boolean](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/boolean.md) 是否为礼品卡商品。 - `true`: 该商品是礼品卡商品 - `false`: 该商品不是礼品卡商品 * `productType` [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商家自定义的商品类型。 * `publishedAt` [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md) 商品发布到在线商店的日期和时间。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。 * `metafield` [Metafield](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/metafield.md) 商品款式关联的元字段。 * `metafields` [[Metafield]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/metafield.md) 商品款式关联的一组元字段。 * `tags` [StringConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/string-connection.md) 商品的标签。 * `subtitle` [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md) 商品的摘要。 * `taxonomyCollection` [TaxonomyCollection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/taxonomy-collection.md) 分类树节点信息。 * `selectedOrFirstAvailableVariant` [ProductVariant](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-variant.md) 商品当前选中的款式。若无选中项，则返回首个可售的款式。若所有款式均不可售，则返回第一个款式。 * `standardCategory` [TaxonomyCategory](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/taxonomy-category.md) 商品对应的 SHOPLINE 标准商品类型信息。 * `requiresSellingPlan` [Boolean](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/boolean.md) 是否仅允许通过销售计划购买。 - `true`：仅允许通过销售计划购买。 - `false`：允许不通过销售计划购买。 * `sellingPlanGroups` [SellingPlanGroupConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/selling-plan-group-connection.md) 商品关联的销售计划组列表。 * `combinedListing` [CombinedListing](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/combined-listing.md) 组合商品（Combined Listing）关联信息对象。包含组合商品中父商品与子商品的关联标识信息。仅当该商品属于组合商品时返回有效数据，否则返回空对象。 ## Field from * [ProductEdge](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-edge.md).node * [ProductConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-connection.md).nodes * [SearchResultItemEdge](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/search-result-item-edge.md).node * [SearchResultItemConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/search-result-item-connection.md).nodes * [PredictiveSearchResult](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/predictive-search-result.md).products * [ProductVariant](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/objects/product-variant.md).parentProduct * [Query](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/queries/proxy-node-product.md).proxyNodeProduct * [Query](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/queries/product.md).product * [Query](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/products/queries/product-recommendations.md).productRecommendations