- JSON representation
- PurchaseItemExtension
- MerchantUnitMeasure
- ItemOption
- ProductDetails
- ReservationItemExtension
- StaffFacilitator
One line item contains one vertical. An order or cart can have multiple line items of same vertical. Sub-line items/add-ons etc should be defined in vertical protos depending on their use cases. Note: 1. All strings at all levels must be less than 1000 chars unless otherwise specified. 2. All repeated fields at all levels must be less than 50 in count unless otherwise specified. 3. All timestamps at all levels, if specified, must be valid timestamps.
JSON representation | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
Fields | ||
---|---|---|
id |
Required: Merchant assigned identifier for line item. Used for identifying existing line item in applying partial updates. Max allowed length is 64 chars. |
|
name |
name of line item as displayed on the receipt. Max allowed length is 100 chars. |
|
userVisibleStateLabel |
Deprecated. Use vertical level status instead. For example, for purchases, use PurchaseOrderExtension.status. User visible label for the state of this line item. |
|
provider |
The provider of the particular line item, if different from the overall order. Example: Expedia Order with line item provider ANA. |
|
priceAttributes[] |
Line item level price and adjustments. |
|
followUpActions[] |
Follow up actions at line item. |
|
recipients[] |
Line item level customers, this could be different from Order level buyer. Example: User X made restaurant reservation under name of user Y. |
|
image |
Small image associated with this item, if any. |
|
description |
Line item description. |
|
notes[] |
Additional notes applicable to this particular line item, for example cancellation policy. |
|
disclosures[] |
Disclosures associated with this line item. |
|
vertical |
Deprecated: Use verticals instead. Required: Semantic Contents of line item based on its type/vertical. Every vertical should include its own fulfillment details. Must be either one of the following values: An object containing fields of an arbitrary type. An additional field |
|
Union field verticals . Required: Semantic Contents of line item based on its type/vertical. Every vertical should include its own fulfillment details. verticals can be only one of the following: |
||
purchase |
Purchase orders like goods, food etc. |
|
reservation |
Reservation orders like restaurant, haircut etc. |
PurchaseItemExtension
Line item contents of Purchase Vertical.
JSON representation | |
---|---|
{ "status": enum ( |
Fields | |
---|---|
status |
Required: Line item level status. |
userVisibleStatusLabel |
Required: User visible label/string for the status. Max allowed length is 50 chars. |
type |
Required: type of purchase. |
productId |
Product or offer id associated with this line item. |
quantity |
Quantity of the item. |
unitMeasure |
Unit measure. Specifies the size of the item in chosen units. The size, together with the active price is used to determine the unit price. |
returnsInfo |
Returns info for this line item. If unset, this line item inherits order level returns info. |
fulfillmentInfo |
Fulfillment info for this line item. If unset, this line item inherits order level fulfillment info. |
itemOptions[] |
Additional add-ons or sub-items. |
extension |
Any extra fields exchanged between merchant and google. An object containing fields of an arbitrary type. An additional field |
productDetails |
Details about the product. |
MerchantUnitMeasure
Merchant unit pricing measure.
JSON representation | |
---|---|
{
"measure": number,
"unit": enum ( |
Fields | |
---|---|
measure |
Value: Example 1.2. |
unit |
Unit: Example POUND, GRAM. |
ItemOption
Represents add-ons or sub-items.
JSON representation | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
Fields | |
---|---|
id |
For options that are items, unique item id. |
name |
Option name. |
prices[] |
Option total price. |
note |
Note related to the option. |
quantity |
For options that are items, quantity. |
productId |
Product or offer id associated with this option. |
subOptions[] |
To define other nested sub options. |
ProductDetails
Details about the product.
JSON representation | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
Fields | |
---|---|
productId |
Product or offer id associated with this line item. |
gtin |
Global Trade Item Number of the product. Useful if offerId is not present in Merchant Center. Optional. |
plu |
Price look-up codes, commonly called PLU codes, PLU numbers, PLUs, produce codes, or produce labels, are a system of numbers that uniquely identify bulk produce sold in grocery stores and supermarkets. |
productType |
Product category defined by the merchant. E.g. "Home > Grocery > Dairy & Eggs > Milk > Whole Milk" |
productAttributes |
Merchant-provided details about the product, e.g. { "allergen": "peanut" }. Useful if offerId is not present in Merchant Center. Optional. An object containing a list of |
ReservationItemExtension
Line item contents for reservation orders like restaurant, haircut etc. Next id: 15.
JSON representation | |
---|---|
{ "status": enum ( |
Fields | |
---|---|
status |
Required: Reservation status. |
userVisibleStatusLabel |
Required: User visible label/string for the status. Max allowed length is 50 chars. |
type |
type of reservation. May be unset if none of the type options is applicable. |
reservationTime |
time when the service/event is scheduled to occur. Can be a time range, a date, or an exact date time. |
userAcceptableTimeRange |
time range that is acceptable to the user. |
confirmationCode |
Confirmation code for this reservation. |
partySize |
The number of people. |
staffFacilitators[] |
Staff facilitators who will be servicing the reservation. Ex. The hairstylist. |
location |
Location of the service/event. |
extension |
Any extra fields exchanged between merchant and google. An object containing fields of an arbitrary type. An additional field |
StaffFacilitator
Information about service person.
JSON representation | |
---|---|
{
"name": string,
"image": {
object ( |
Fields | |
---|---|
name |
The staff facilitator's name. Ex. "John Smith" |
image |
Performer's images. |