Order

Entidad Order. Nota: 1. Todas las cadenas de todos los niveles deben tener menos de 1,000 caracteres, a menos que se especifique lo contrario. 2. A menos que se especifique lo contrario, el recuento de todos los campos repetidos en todos los niveles debe ser inferior a 50. 3. Todas las marcas de tiempo en todos los niveles, si se especifican, deben ser marcas válidas.

Representación JSON
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Campos
googleOrderId

string

ID de pedido asignado por Google.

merchantOrderId

string

Obligatorio: ID de pedido interno asignado por el comercio. Este ID debe ser único y se requiere para las operaciones de actualización de pedidos posteriores. Este ID se puede establecer como el googleOrderId proporcionado o cualquier otro valor único. Ten en cuenta que el ID que se presenta a los usuarios es userVisibleOrderId, que puede ser un valor diferente y más fácil de usar. La longitud máxima permitida es de 128 caracteres.

userVisibleOrderId

string

Es el ID orientado al usuario que hace referencia al pedido actual. Este ID debe ser coherente con el que se muestra para este pedido en otros contextos, como sitios web, apps y correo electrónico.

userVisibleStateLabel
(deprecated)

string

Obsoleto: usa el estado OrderExtensions en su lugar. Es la etiqueta visible para el usuario correspondiente al estado de este pedido.

buyerInfo

object (UserInfo)

información sobre el comprador.

image

object (Image)

Imagen asociada con el pedido.

createTime

string (Timestamp format)

Obligatorio: Es la fecha y hora en que se creó el pedido.

Es una marca de tiempo en el formato RFC3339 UTC "Zulu", con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

fecha y hora en que se actualizó el pedido por última vez. Obligatorio para OrderUpdate.

Es una marca de tiempo en el formato RFC3339 UTC "Zulu", con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

transactionMerchant

object (Merchant)

Comercio que facilitó la confirmación de la compra. Puede ser diferente de un proveedor a nivel de la línea de pedido. Ejemplo: Pedido de Expedia con una línea de pedido de ANA.

contents

object (Contents)

Obligatorio: Ordena los contenidos que son un grupo de líneas de pedido.

priceAttributes[]

object (PriceAttribute)

Precio, descuentos, impuestos, etc.

followUpActions[]

object (Action)

Acciones de seguimiento a nivel del pedido.

paymentData

object (PaymentData)

Datos relacionados con el pago del pedido.

termsOfServiceUrl

string

Un vínculo a las Condiciones del Servicio que se aplican al pedido o al pedido propuesto.

note

string

Notas adjuntas a un pedido.

promotions[]

object (Promotion)

Todas las promociones asociadas con este pedido.

disclosures[]

object (Disclosure)

Divulgaciones asociadas con este pedido.

vertical
(deprecated)

object

Obsoleto: usa verticales en su lugar. Estas propiedades se aplicarán a todas las líneas de pedido, a menos que se anulen en algunas. Esta vertical debe coincidir con el tipo de vertical a nivel de la línea de pedido. Valores posibles: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Un objeto que contiene campos de un tipo arbitrario. Un campo adicional "@type" contiene una URI que identifica el tipo. Ejemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

Campo de unión verticals. Estas propiedades se aplicarán a todas las líneas de pedido, a menos que se anulen en algunas. Esta vertical debe coincidir con el tipo de vertical a nivel de la línea de pedido. Las direcciones (verticals) solo pueden ser una de las siguientes opciones:
purchase

object (PurchaseOrderExtension)

Orden de compra

ticket

object (TicketOrderExtension)

Pedido de entrada

Contenido

Wrapper para líneas de pedido.

Representación JSON
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Campos
lineItems[]

object (LineItem)

Es una lista de líneas de pedido. Se requiere al menos 1 elemento de una sola línea y se permite un máximo de 50. Todas las líneas de pedido deben pertenecer a la misma vertical.

PaymentData

Datos de pago relacionados con un pedido.

Representación JSON
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Campos
paymentResult

object (PaymentResult)

Es el resultado del pago que usa el integrador para completar una transacción. Este campo se propagará con Actions on Google si Actions-on-Google administra la experiencia de confirmación de la compra.

paymentInfo

object (PaymentInfo)

Es la información de pago relacionada con el pedido que es útil para la interacción que puede realizar el usuario.

PaymentResult

Resultado del pago que usa el integrador para completar una transacción.

Representación JSON
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Campos
Campo de unión result. Se proporcionan los datos de pago de Google o la forma de pago para comercios. Las direcciones (result) solo pueden ser una de las siguientes opciones:
googlePaymentData

string

Datos de la forma de pago proporcionados por Google. Si tu procesador de pagos aparece como procesador de pagos compatible con Google en el siguiente vínculo: https://developers.google.com/pay/api/ navega a tu procesador de pagos mediante el vínculo para obtener más información. De lo contrario, consulta la siguiente documentación para conocer los detalles de la carga útil: https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

El usuario elige la forma de pago proporcionada por el comercio o la acción.

PaymentInfo

Es la información de pago relacionada con el pedido realizado. Este protocolo captura información útil para la interacción que tiene el usuario.

Representación JSON
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Campos
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

Es la información visible de la forma de pago que se usó para realizar la transacción.

paymentMethodProvenance

enum (PaymentMethodProvenance)

Indica la procedencia de la forma de pago que se usó para realizar la transacción. Es posible que el usuario haya registrado la misma forma de pago en Google y en el comercio.

PaymentMethodDisplayInfo

Resultado del pago que usa el integrador para completar una transacción.

Representación JSON
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string
}
Campos
paymentType

enum (PaymentType)

Es el tipo de pago.

paymentMethodDisplayName

string

Es el nombre visible del usuario de la forma de pago. Por ejemplo, VISA **** 1234 Checks ctat **** 5678

Promoción

Promociones o ofertas que se agregaron al carrito.

Representación JSON
{
  "coupon": string
}
Campos
coupon

string

Obligatorio: Se aplica el código de cupón a esta oferta.

PurchaseOrderExtension

Extensión de pedido para la vertical de compras. Estas propiedades se aplican a todas las líneas de pedido dentro del pedido, a menos que se anulen en una línea de pedido.

Representación JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Campos
status

enum (PurchaseStatus)

Obligatorio: estado general del pedido.

userVisibleStatusLabel

string

Etiqueta o cadena visibles del usuario para el estado. La longitud máxima permitida es de 50 caracteres.

type

enum (PurchaseType)

Obligatorio: Tipo de compra.

returnsInfo

object (PurchaseReturnsInfo)

Información de devolución del pedido.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Es la información de entrega del pedido.

extension

object

Cualquier campo adicional intercambiado entre el comercio y Google

Un objeto que contiene campos de un tipo arbitrario. Un campo adicional "@type" contiene una URI que identifica el tipo. Ejemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

purchaseLocationType

enum (PurchaseLocationType)

Ubicación de la compra (en la tienda / en línea)

errors[]

object (PurchaseError)

Opcional: Errores por los que se rechazó este pedido.

PurchaseError

Errores por los que se puede rechazar una orden de compra.

Representación JSON
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
Campos
type

enum (ErrorType)

Obligatorio: Representa el motivo detallado por el que el comercio rechaza un pedido.

description

string

Descripción adicional del error.

entityId

string

Es el ID de entidad que corresponde al error. Ejemplo que puede corresponder a LineItemId / ItemOptionId.

updatedPrice

object (PriceAttribute)

Esto es relevante en el caso de los tipos de error PRICE_CHANGED o INCORRECT_PRICE.

availableQuantity

integer

Cantidad disponible ahora. Aplicable en el caso de AVAILABILITY_CHANGED.

TicketOrderExtension

Pide contenido para pedidos de entradas, como películas, deportes, etcétera.

Representación JSON
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Campos
ticketEvent

object (TicketEvent)

El evento se aplica a todas las entradas de línea de pedido.

TicketEvent

Representa un evento único.

Representación JSON
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Campos
type

enum (Type)

Obligatorio: Tipo de evento de entrada, p.ej., película o concierto.

name

string

Obligatorio: Es el nombre del evento. Por ejemplo, si el evento es una película, este debe ser el nombre de la película.

description

string

descripción del evento.

url

string

URL a la información del evento.

location

object (Location)

Es la ubicación donde se realizará el evento o donde se encuentra una organización.

eventCharacters[]

object (EventCharacter)

Son los caracteres relacionados con este evento. Pueden ser directores o actores de un evento cinematográfico, o los artistas de un concierto, etcétera.

startDate

object (Time)

Hora de inicio

endDate

object (Time)

Hora de finalización

doorTime

object (Time)

Hora de entrada, que puede ser diferente de la hora de inicio del evento. P. ej., el evento comienza a las 9 a.m., pero el horario de entrada es a las 8:30 a.m.

EventCharacter

Un carácter del evento, p.ej., organizador, intérprete, etc.

Representación JSON
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Campos
type

enum (Type)

el tipo de personaje del evento, p. ej., actor o director

name

string

nombre del carácter.

image

object (Image)

Imágenes del personaje