---
title: "CheckoutLineItemProperty"
description: "商品行维度的自定义属性。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-line-item-property'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-line-item-property.md'
---
# CheckoutLineItemProperty

商品行维度的自定义属性。

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

## Fields

* `name`

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

  自定义属性名称。示例：`Attribute name`。

* `value`

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

  自定义属性值。示例：`Attribute value`。

* `urls`

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

  URL 资源列表。
  - 如果 `type` 是 `picture`，可通过 `urls` 获取缩略图。
  - 如果 `type` 是 `link`，则超链接取 `urls` 的第一个元素。
  
  例子：`https://openapi.myshopline.com`

* `type`

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

  定制信息类型。有效枚举值：
  - `text`：字符类型 。
  - `picture`：图片类型。  
  - `link`：链接类型。

* `show`

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

  定制信息是否可见。
  - `true`：代表定制信息可见。
  - `false`：代表定制信息不可见。
  
    
  默认值：`false`。

* `extInfo`

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

  扩展字段，用于存放不参与展示的扩展信息。

* `additional`

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

  定制商品附加字段。比如当 `name` 为 文字，`additional` 可以附加文字的字号、字体、颜色等。
  例子: `Additional fields`。

* `roleVisibility`

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

  定制信息可见对象。
  有效枚举值：
  - `customer`：仅对买家可见。
  - `merchant`：仅对商家可见。
  - `all`：对买家、商家都可见。
  - `none`：对买家、商家都不可见。

## Field from

* [CheckoutLineItem](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-line-item.md).properties