- Representación JSON
- Contenido
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- Promoción
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
Entidad de pedido. Nota: 1. Todas las cadenas de todos los niveles deben tener menos de 1,000 caracteres, a menos que se especifique lo contrario. 2. Todos los campos repetidos en todos los niveles deben tener un tamaño inferior a 50, a menos que se especifique lo contrario. 3. Si se especifican, todas las marcas de tiempo de todos los niveles deben ser marcas de tiempo válidas.
Representación JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
Campos | ||
---|---|---|
googleOrderId |
Es el ID de pedido asignado por Google. |
|
merchantOrderId |
Obligatorio: ID de pedido interno asignado por el comercio. Este ID debe ser único y se requiere para las operaciones posteriores de actualización de pedidos. Este ID se puede establecer en el googleOrderId proporcionado o cualquier otro valor único. Ten en cuenta que el ID que se muestra 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 |
El ID visible para el 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, aplicaciones y correo electrónico. |
|
userVisibleStateLabel |
Obsoleto: usa el estado OrderExtensions en su lugar. Etiqueta visible para el usuario para el estado de este pedido. |
|
buyerInfo |
información sobre el comprador. |
|
image |
Imagen asociada con el pedido. |
|
createTime |
Obligatorio: 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: |
|
lastUpdateTime |
y la 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: |
|
transactionMerchant |
Comercio que facilitó la confirmación de la compra. Puede ser diferente de la de un proveedor a nivel de la línea de pedido. Ejemplo: Pedido de Expedia con un elemento de una sola línea de ANA. |
|
contents |
Obligatorio: El contenido del pedido es un grupo de líneas de pedido. |
|
priceAttributes[] |
Precio, descuentos, impuestos, etc. |
|
followUpActions[] |
Haz un seguimiento de las acciones a nivel del pedido. |
|
paymentData |
Datos relacionados con el pago del pedido. |
|
termsOfServiceUrl |
Un vínculo a las condiciones del servicio que se aplican al pedido/pedido propuesto. |
|
note |
Notas adjuntas a un pedido |
|
promotions[] |
Son todas las promociones asociadas a este pedido. |
|
disclosures[] |
Divulgaciones asociadas con este pedido. |
|
vertical |
Obsoleto: Usa verticales en su lugar. Estas propiedades se aplicarán a todas las líneas de pedido, a menos que se anulen en alguna. Esta vertical debe coincidir con el tipo de vertical a nivel de la línea de pedido. Valores posibles: Un objeto que contiene campos de un tipo arbitrario. Un campo adicional |
|
Campo de unión verticals . Estas propiedades se aplicarán a todas las líneas de pedido, a menos que se anulen en alguna. 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 |
Orden de compra |
|
ticket |
Pedido de entrada |
Contenido
Envoltorio para líneas de pedido.
Representación JSON | |
---|---|
{
"lineItems": [
{
object ( |
Campos | |
---|---|
lineItems[] |
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
Son los datos de pago relacionados con un pedido.
Representación JSON | |
---|---|
{ "paymentResult": { object ( |
Campos | |
---|---|
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 |
Información de pago relacionada con el pedido que es útil para la interacción del usuario. |
PaymentResult
El integrador usa el resultado del pago para completar una transacción.
Representación JSON | |
---|---|
{ // Union field |
Campos | ||
---|---|---|
Campo de unión result . Se proporcionan los datos de Google Payments o una forma de pago de comerciante. Las direcciones (result ) solo pueden ser una de las siguientes opciones: |
||
googlePaymentData |
Google proporcionó los datos de la forma de pago. Si tu procesador de pagos aparece como procesador de pagos compatible con Google aquí: https://developers.google.com/pay/api/ Navega a tu procesador de pagos a través del 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 |
Forma de pago proporcionada por el comercio o por la acción elegida por el usuario. |
PaymentInfo
Información de pago relacionada con el pedido realizado. Este proto captura información útil para la interacción del usuario.
Representación JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Campos | |
---|---|
paymentMethodDisplayInfo |
Es la información visible de la forma de pago que se usó para realizar la transacción. |
paymentMethodProvenance |
Procedencia de la forma de pago utilizada para la transacción. Es posible que el usuario haya registrado la misma forma de pago en Google y en el comercio. |
PaymentMethodDisplayInfo
El integrador usa el resultado del pago para completar una transacción.
Representación JSON | |
---|---|
{
"paymentType": enum ( |
Campos | |
---|---|
paymentType |
Es el tipo de pago. |
paymentMethodDisplayName |
Es el nombre visible del usuario de la forma de pago. Por ejemplo, cuenta corriente VISA **** 1234 **** 5678 |
Promoción
Promociones/ofertas que se agregaron al carrito.
Representación JSON | |
---|---|
{ "coupon": string } |
Campos | |
---|---|
coupon |
Obligatorio: Se aplicó 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 ( |
Campos | |
---|---|
status |
Obligatorio: Estado general del pedido. |
userVisibleStatusLabel |
Etiqueta o cadena visible para el usuario para el estado. La longitud máxima permitida es de 50 caracteres. |
type |
Obligatorio: Tipo de compra. |
returnsInfo |
Devolución de la información del pedido |
fulfillmentInfo |
Es la información de entrega del pedido. |
extension |
Cualquier campo adicional que se intercambie entre el comercio y Google Un objeto que contiene campos de un tipo arbitrario. Un campo adicional |
purchaseLocationType |
Ubicación de la compra (en la tienda o en línea) |
errors[] |
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 ( |
Campos | |
---|---|
type |
Obligatorio: Representa el motivo detallado por el que el comercio rechaza un pedido. |
description |
Descripción adicional del error. |
entityId |
El ID de entidad que corresponde al error. Ejemplo que puede corresponder a LineItemId o ItemOptionId. |
updatedPrice |
Es relevante en caso de un tipo de error de PRICE_CHANGED o INCORRECT_PRICE. |
availableQuantity |
La cantidad está disponible ahora. Se aplica en el caso de AVAILABILITY_CHANGED. |
TicketOrderExtension
Pedir contenido para pedidos de entradas como películas, deportes, etc.
Representación JSON | |
---|---|
{
"ticketEvent": {
object ( |
Campos | |
---|---|
ticketEvent |
El evento se aplica a todas las entradas de líneas de pedido. |
TicketEvent
Representa un evento único.
Representación JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
Obligatorio: tipo de evento de entrada, p.ej., película, concierto. |
name |
Obligatorio: nombre del evento. Por ejemplo, si el evento es una película, este debe ser el nombre de la película. |
description |
descripción del evento. |
url |
Es la URL de la información del evento. |
location |
Es la ubicación donde se lleva a cabo el evento o se encuentra una organización. |
eventCharacters[] |
Son los personajes relacionados con este evento. Pueden ser directores o actores de un evento cinematográfico, o bien actores de un concierto, etcétera. |
startDate |
Hora de inicio |
endDate |
Hora de finalización |
doorTime |
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 de evento, p.ej., organizador, artista, etc.
Representación JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
el tipo de carácter del evento, p.ej., es el actor o el director. |
name |
el nombre del personaje. |
image |
Imágenes del personaje. |