Order

Order represents the content of a user's in-progress or completed order.

JSON representation 
{
  "items": [
    {
      object (OrderItem)
    }
  ],
  "metadata": {
    object (OrderMetadata)
  },
  "fulfillment": {
    object (OrderFulfillment)
  },
  "priceInfo": {
    object (OrderPriceInfo)
  },
  "externalOrderId": string
}
Fields
items[]

object (OrderItem)

Optional. The items in the order.
metadata

object (OrderMetadata)

Optional. Other metadata collected or inferred during the order.
fulfillment

object (OrderFulfillment)

Optional. The fulfillment information for the order.
priceInfo

object (OrderPriceInfo)

Optional. Price information for the order.
externalOrderId

string

Output only. The external identifier for this order. Populated only if a point-of-sale integration is enabled.

OrderItem

OrderItem specifies the state of an Item which is part of an Order.

JSON representation 
{
  "uid": string,
  "itemId": string,
  "displayName": string,
  "image": {
    object (Image)
  },
  "basePrice": {
    object (Money)
  },
  "integrationAttributes": {
    object (ItemIntegrationAttributes)
  },
  "modifierGroups": [
    {
      object (OrderModifierGroup)
    }
  ],
  "quantity": integer
}
Fields
uid

string

Optional. A system-assigned unique identifier for this item.
itemId

string

Required. Identifier for an Item in the Menu, unique within its Menu.
displayName

string

Output only. Human-readable name for this line item to be shown on user interfaces.
image

object (Image)

Output only. Image to display for this item in the UI.
basePrice

object (Money)

Output only. The base price of the item. This may be affected by the selected modifiers. This is the price per unit of the item.
integrationAttributes

object (ItemIntegrationAttributes)

Output only. Metadata associated with this entity used for downstream integrations.
modifierGroups[]

object (OrderModifierGroup)

Optional. ModifierGroups applied to this item.
quantity

integer

Optional. The quantity of this item in the order.

OrderModifierGroup

OrderModifierGroup specifies the state of a ModifierGroup which is part of an OrderItem.

JSON representation 
{
  "modifierGroupId": string,
  "displayName": string,
  "integrationAttributes": {
    object (ModifierGroupIntegrationAttributes)
  },
  "modifiers": [
    {
      object (OrderModifier)
    }
  ]
}
Fields
modifierGroupId

string

Required. Identifier for this modifier group, unique within its menu.
displayName

string

Output only. The modifier group name -- e.g. "Toppings (Sandwich)" or "Side for Medium Combo".
integrationAttributes

object (ModifierGroupIntegrationAttributes)

Output only. Metadata associated with this entity used for downstream integrations.
modifiers[]

object (OrderModifier)

Optional. The modifiers applied to this modifier group.

OrderModifier

OrderModifier specifies the state of a Modifier which is part of an OrderModifierGroup.

JSON representation 
{
  "uid": string,
  "modifierId": string,
  "displayName": string,
  "priceAdjustment": {
    object (Money)
  },
  "quantity": integer,
  "modifierAction": {
    object (OrderModifierAction)
  },
  "image": {
    object (Image)
  },
  "integrationAttributes": {
    object (ModifierIntegrationAttributes)
  },
  "modifierGroups": [
    {
      object (OrderModifierGroup)
    }
  ]
}
Fields
uid

string

Optional. A system-assigned unique identifier for this modifier.
modifierId

string

Required. Identifier for this modifier, unique within the menu.
displayName

string

Output only. The modifier display name to be shown on user interfaces.
priceAdjustment

object (Money)

Output only. The price adjustment associated with this modifier, if any. This is the price per unit of the modifier.
quantity

integer

Optional. The quantity of this modifier action applied.
modifierAction

object (OrderModifierAction)

Optional. The modifier action applied to this modifier.
image

object (Image)

Output only. Image to display for this modifier in the UI.
integrationAttributes

object (ModifierIntegrationAttributes)

Output only. Metadata associated with this entity used for downstream integrations.
modifierGroups[]

object (OrderModifierGroup)

Optional. Nested modifier groups applied to this modifier.

OrderModifierAction

OrderModifierAction specifies the ModifierAction associated with an applied OrderModifier.

JSON representation 
{
  "name": string
}
Fields
name

string

Optional. The modifier action name -- e.g. "NO", "SIDE", "ADD", "EXTRA".

OrderMetadata

OrderMetadata contains other metadata collected or inferred during the order.

JSON representation 
{
  "collectedCustomerName": string,
  "callerPhoneNumber": string
}
Fields
collectedCustomerName

string

Optional. Name of the customer, collected while taking the order. Only populated when the agent is configured to collect the customer's name. This may be collected verbally and could contain spelling mistakes or mistranscriptions, so care should be taken when displaying it to users, and it shouldn't be trusted as e.g. payment information.
callerPhoneNumber

string

Optional. The phone number of the customer placing the order.

OrderFulfillment

OrderFulfillment contains information about order fulfillment.

JSON representation 
{
  "fulfillmentMethod": enum (FulfillmentMethod),
  "createTime": string,
  "targetFulfillmentTime": string
}
Fields
fulfillmentMethod

enum (FulfillmentMethod)

Optional. The fulfillment method of the order.
createTime

string (Timestamp format)

Output only. The time the order was created at.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
targetFulfillmentTime

string (Timestamp format)

Optional. The time the order is scheduled for fulfillment, used for 'order ahead'. If not provided, the order is assumed to be for 'as soon as possible'.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

OrderPriceInfo

OrderPriceInfo encapsulates the various price components of an order.

JSON representation 
{
  "totalPrice": {
    object (Money)
  },
  "subtotalPrice": {
    object (Money)
  },
  "taxPrice": {
    object (Money)
  }
}
Fields
totalPrice

object (Money)

Optional. The final total price after all taxes, fees, and discounts are applied.
subtotalPrice

object (Money)

Optional. The subtotal price of all items and modifiers, before taxes, discounts.
taxPrice

object (Money)

Optional. The amount of tax applied to the order.