- JSON 表示法
- PurchaseItemExtension
- MerchantUnitMeasure
- ItemOption
- ProductDetails
- ReservationItemExtension
- StaffFacilitator
一个订单项包含一个行业。一个订单或购物车可以有多个属于同一行业的订单项。子订单项/插件等应在垂直 proto 中定义,具体取决于它们的用例。注意:1. 除非另有说明,否则所有级别的所有字符串均不得超过 1000 个字符。2. 除非另有说明,否则所有级别的所有重复字段的计数都必须少于 50。3. 所有级别的所有时间戳(如果指定)都必须是有效的时间戳。
JSON 表示法 | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
字段 | ||
---|---|---|
id |
必需:商家为订单项分配的标识符。用于在应用部分更新时识别现有订单项。允许的长度上限为 64 个字符。 |
|
name |
与收据上显示的订单项名称一致允许的长度上限为 100 个字符。 |
|
userVisibleStateLabel |
已弃用。请改用行业级别状态。例如,对于购买,请使用 PurchaseOrderExtension.status。此订单项状态的用户可见标签。 |
|
provider |
特定订单项的提供商(如果不同于整个订单)。示例:采用订单项提供商 ANA 的 Expedia 订单。 |
|
priceAttributes[] |
订单项级价格和调整项。 |
|
followUpActions[] |
订单项的跟进操作。 |
|
recipients[] |
订单项级客户,可能不同于订单级买方。示例:用户 X 以用户 Y 的名义预订了餐厅。 |
|
image |
与此项相关的小图片(如果有)。 |
|
description |
订单项说明。 |
|
notes[] |
适用于此特定订单项的补充说明,例如取消政策。 |
|
disclosures[] |
与此订单项关联的披露信息。 |
|
vertical |
已弃用:请改用行业。必需:基于类型/行业的订单项语义内容。每个类别都应包含自己的执行方式详细信息。必须是以下任一值: 可以包含任意类型字段的对象。附加字段 |
|
联合字段 verticals 。必需:基于类型/行业的订单项语义内容。每个类别都应包含自己的执行方式详细信息。verticals 只能是下列其中一项: |
||
purchase |
采购订单,例如商品、食品等 |
|
reservation |
预订餐厅、理发等 |
PurchaseItemExtension
购买行业的订单项内容。
JSON 表示法 | |
---|---|
{ "status": enum ( |
字段 | |
---|---|
status |
必需:订单项级状态。 |
userVisibleStatusLabel |
必需:用户可见的状态标签/字符串。允许的长度上限为 50 个字符。 |
type |
必填:购买交易的类型。 |
productId |
与此订单项关联的产品或优惠 ID。 |
quantity |
商品的数量。 |
unitMeasure |
计量单位。指定商品的尺寸(以所选单位表示)。尺寸与有效价格一起用于确定单价。 |
returnsInfo |
返回此订单项的信息。如果未设置,此订单项将沿用订单级返回信息。 |
fulfillmentInfo |
此订单项的履单信息。如果未设置,此订单项将沿用订单级履单信息。 |
itemOptions[] |
其他插件或子作品。 |
extension |
商家与 Google 之间交换的任何额外字段。 可以包含任意类型字段的对象。附加字段 |
productDetails |
商品的详细信息。 |
MerchantUnitMeasure
商家价格计量单位。
JSON 表示法 | |
---|---|
{
"measure": number,
"unit": enum ( |
字段 | |
---|---|
measure |
值:示例 1.2. |
unit |
单位:示例 POUND、GRAM。 |
ItemOption
表示插件或子作品。
JSON 表示法 | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
字段 | |
---|---|
id |
对于属于商品的选项,请确保商品 ID 的唯一性。 |
name |
选项名称。 |
prices[] |
选项总价。 |
note |
与选项相关的备注。 |
quantity |
对于商品选项,请选择数量。 |
productId |
与此选项相关联的产品或优惠 ID。 |
subOptions[] |
定义其他嵌套子选项。 |
ProductDetails
商品的详细信息。
JSON 表示法 | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
字段 | |
---|---|
productId |
与此订单项关联的产品或优惠 ID。 |
gtin |
商品的全球贸易项目代码。如果 Merchant Center 中不存在 OfferId,那么此属性非常有用。可选。 |
plu |
价格查询代码,通常称为 PLU 代码、PLU 代码、PLU、农产品代码或农产品标签,是对杂货店和超市中销售的批量农产品进行唯一标识的编号系统。 |
productType |
商家定义的商品类别。例如“首页 > 杂货 > 乳制品和鸡蛋 > 牛奶 > 全脂牛奶” |
productAttributes |
商家提供的商品详细信息,例如 { "allergen": "peanut" }。如果 Merchant Center 中没有 offerId,则该代码非常有用。可选。 包含一系列 |
ReservationItemExtension
预订订单(例如餐厅、理发等)的订单项内容。下一个 ID:15。
JSON 表示法 | |
---|---|
{ "status": enum ( |
字段 | |
---|---|
status |
必需:预留状态。 |
userVisibleStatusLabel |
必需:用户可见的状态标签/字符串。允许的长度上限为 50 个字符。 |
type |
预留类型。如果所有类型选项均不适用,则可以取消设置。 |
reservationTime |
服务/事件的预定发生时间。可以是时间范围、日期或确切日期和时间。 |
userAcceptableTimeRange |
可接受的时间范围。 |
confirmationCode |
此预留的确认码。 |
partySize |
人数。 |
staffFacilitators[] |
接待员,为预订提供服务。例如:发型师。 |
location |
服务/事件的地点。 |
extension |
商家与 Google 之间交换的任何额外字段。 可以包含任意类型字段的对象。附加字段 |
StaffFacilitator
服务人员的相关信息。
JSON 表示法 | |
---|---|
{
"name": string,
"image": {
object ( |
字段 | |
---|---|
name |
教职员工的姓名。例如:“张三” |
image |
表演者的图片。 |