Esquema de acciones de entrega

En esta página, se describe la carga útil del servicio web de entrega (API de Ordering End-to-End) cuando se trabaja con la API de acción integrada de Ordering End-to-End. Para obtener una versión legible por máquinas de esta información, puedes descargar el esquema JSON.

Tipos de base

Carrito

Contiene detalles del pedido, así como si la solicitud es para retiro o entrega. Un carrito también contiene detalles de la entrega, propinas y la dirección de entrega. El objeto Cart se define en un Checkout AppRequest.Si incluyes una copia del carrito en tu Checkout AppResponse

En la siguiente tabla, se enumeran las propiedades del tipo Cart:

Propiedad Tipo Descripción
@type Const

Es el tipo de este objeto. Omite este campo si el objeto Cart superior forma parte de ProposedOrder.

Valor: type.googleapis.com/google.actions.v2.orders.Cart

id String

Es el ID opcional del carrito.

merchant Merchant

Es el comercio afiliado a este carrito.

lineItems List<LineItem>

Obligatorio.

Es la lista de los bienes o servicios que el usuario pide.

Debe tener al menos 1 elemento.

promotions List<Promotion>

Es la promoción que se aplica en este carrito. Por el momento, solo se admite una promoción.

notes String

Notas sobre el pedido o las instrucciones de entrega

extension FoodCartExtension

Define detalles sobre el usuario, como las preferencias de entrega.

En el siguiente ejemplo, se muestra un elemento Cart:

Ejemplo 1

{
  "@type": "type.googleapis.com/google.actions.v2.orders.Cart",
  "merchant": {
    "id": "https://www.exampleprovider.com/merchant/id1",
    "name": "Cucina Venti"
  },
  "lineItems": [
    {
      "name": "Sizzling Prawns Dinner",
      "type": "REGULAR",
      "id": "sample_item_offer_id_1",
      "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
      "quantity": 1,
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "16",
          "nanos": 750000000
        }
      },
      "subLines": [
        {
          "note": "Notes for this item."
        }
      ],
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
        "options": [
          {
            "id": "sample_addon_offer_id_1",
            "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
            "name": "Honey Mustard",
            "price": {
              "currencyCode": "USD"
            },
            "quantity": 1
          },
          {
            "id": "sample_addon_offer_id_2",
            "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
            "name": "BBQ Sauce",
            "price": {
              "currencyCode": "USD",
              "nanos": 500000000
            },
            "quantity": 1
          }
        ]
      }
    }
  ],
  "extension": {
    "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
    "fulfillmentPreference": {
      "fulfillmentInfo": {
        "delivery": {
          "deliveryTimeIso8601": "P0M"
        }
      }
    },
    "location": {
      "coordinates": {
        "latitude": 37.788783,
        "longitude": -122.41384
      },
      "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
      "zipCode": "94043",
      "city": "Mountain View",
      "postalAddress": {
        "regionCode": "US",
        "postalCode": "94043",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "1350 Charleston Road"
        ]
      },
      "notes": "Gate code is #111"
    }
  }
}

Ejemplo 2

{
  "merchant": {
    "id": "https://www.exampleprovider.com/merchant/id1",
    "name": "Falafel Bite"
  },
  "lineItems": [
    {
      "name": "Pita Chips",
      "type": "REGULAR",
      "id": "sample_item_offer_id_1",
      "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
      "quantity": 1,
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "2",
          "nanos": 750000000
        }
      },
      "subLines": [
        {
          "note": "Notes for this item."
        }
      ],
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
        "options": [
          {
            "id": "sample_addon_offer_id_1",
            "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
            "name": "Honey Mustard",
            "price": {
              "currencyCode": "USD"
            },
            "quantity": 1
          },
          {
            "id": "sample_addon_offer_id_2",
            "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
            "name": "BBQ Sauce",
            "price": {
              "currencyCode": "USD",
              "nanos": 500000000
            },
            "quantity": 1
          }
        ]
      }
    },
    {
      "name": "Chicken Shwarma Wrap",
      "type": "REGULAR",
      "id": "sample_item_offer_id_2",
      "offerId": "https://www.exampleprovider.com/menu/item/offer/id2",
      "quantity": 1,
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "8"
        }
      },
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
      }
    },
    {
      "name": "Greek Salad",
      "type": "REGULAR",
      "id": "sample_item_offer_id_3",
      "offerId": "https://www.exampleprovider.com/menu/item/offer/id3",
      "quantity": 1,
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "9",
          "nanos": 990000000
        }
      },
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
      }
    },
    {
      "name": "Prawns Biryani",
      "type": "REGULAR",
      "id": "sample_item_offer_id_4",
      "offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
      "quantity": 1,
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "15",
          "nanos": 990000000
        }
      },
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
      }
    }
  ],
  "extension": {
    "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
    "fulfillmentPreference": {
      "fulfillmentInfo": {
        "delivery": {
          "deliveryTimeIso8601": "P90M"
        }
      }
    },
    "location": {
      "coordinates": {
        "latitude": 37.788783,
        "longitude": -122.41384
      },
      "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
      "zipCode": "94043",
      "city": "Mountain View",
      "postalAddress": {
        "regionCode": "US",
        "postalCode": "94043",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "1350 Charleston Road"
        ]
      },
      "notes": "Gate code is #111"
    }
  }
}

Contacto

Especifica los detalles de la persona que recibe el pedido. Solo está disponible en AppResponse.

En la siguiente tabla, se enumeran las propiedades del tipo Contact:

Propiedad Tipo Descripción
displayName String

Es el nombre de la persona que recibe el pedido, como quieres que aparezca. Usa este campo si no se especifican firstName y lastName.

Ejemplo: Lovefood Ordering

email String

Dirección de correo electrónico de la persona que recibe el pedido.

Ejemplo: ilovefood@example.com

firstName String

Es el nombre de la persona que recibe el pedido.

Ejemplo: Lovefood

lastName String

Es el apellido de la persona que recibe el pedido.

Ejemplo: Ordering

phoneNumber String

Número de teléfono de la persona que recibe el pedido, incluido el código de país

Ejemplo: +16501234567

emailVerified Booleano

Indica si la persona que recibe el pedido accedió con su Cuenta de Google.

En el siguiente ejemplo, se muestra un elemento Contact:

Ejemplo

{
  "displayName": "Lovefood Ordering",
  "email": "ilovefood@example.com",
  "phoneNumber": "+16501234567"
}

CustomPushMessage

Contiene el OrderUpdate de la solicitud.

En la siguiente tabla, se enumeran las propiedades del tipo CustomPushMessage:

Propiedad Tipo Descripción
orderUpdate OrderUpdate

Obligatorio.

Se actualizó la información del pedido.

En el siguiente ejemplo, se muestra un elemento CustomPushMessage:

Ejemplo

{
  "orderUpdate": {
    "actionOrderId": "sample_action_order_id",
    "orderState": {
      "state": "IN_TRANSIT",
      "label": "Order is on the way"
    },
    "inTransitInfo": {
      "updatedTime": "2017-07-17T12:00:00Z"
    },
    "updateTime": "2017-07-17T12:00:00Z",
    "orderManagementActions": [
      {
        "type": "CUSTOMER_SERVICE",
        "button": {
          "title": "Contact customer service",
          "openUrlAction": {
            "url": "mailto:support@example.com"
          }
        }
      },
      {
        "type": "EMAIL",
        "button": {
          "title": "Email restaurant",
          "openUrlAction": {
            "url": "mailto:person@example.com"
          }
        }
      },
      {
        "type": "CALL_RESTAURANT",
        "button": {
          "title": "Call restaurant",
          "openUrlAction": {
            "url": "tel:+16505554679"
          }
        }
      }
    ],
    "receipt": {
      "userVisibleOrderId": "userVisibleId1234"
    },
    "infoExtension": {
      "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension",
      "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z"
    }
  }
}

DeliveryInfo

En la siguiente tabla, se enumeran las propiedades del tipo DeliveryInfo:

Propiedad Tipo Descripción
deliveryTimeIso8601 String

Es el tiempo de entrega estimado, en formato de marca de tiempo ISO 8601: "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z" o en formato de duración: "P(n)Y(n)M(n)DT(n)H(n)M(n)S". Por ejemplo, PT90M representa una duración de 90 minutos. El valor predeterminado ,"PT0M", indica que el tiempo de entrega preferido es lo antes posible. Referencia: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. Úsalo para actualizar el tiempo de entrega estimado durante la respuesta de confirmación de la compra.

Ejemplo: PT90M

En el siguiente ejemplo, se muestra un elemento DeliveryInfo:

Ejemplo

{
  "deliveryTimeIso8601": "PT90M"
}

Renuncia de responsabilidad

En la siguiente tabla, se enumeran las propiedades del tipo Disclaimer:

Propiedad Tipo Descripción
predefinedMessage PredefinedMessage

Obligatorio.

Para mostrar mensajes de renuncia de responsabilidad predefinidos durante la confirmación de la compra.

feeAmount Money

El socio le cobrará al comercio una tarifa de N por este pedido.

feeAmountRange FeeAmountRange

El socio le cobrará al restaurante una tarifa de entre N y M por pedido.

feePercent Número

El socio le cobrará al comercio una tarifa del N% por este pedido.

feePercentRange FeePercentRange

El socio le cobrará al comercio una tarifa de entre N% y M% por pedido.

En el siguiente ejemplo, se muestra un elemento Disclaimer:

Ejemplo 1

{
  "predefinedMessage": "NEW_YORK_DELIVERY_FEE_TIP_DISCLAIMER"
}

Ejemplo 2

{
  "predefinedMessage": "FEE_CHARGED_TO_RESTAURANT_DISCLOSURE"
}

Ejemplo 3

{
  "predefinedMessage": "FEE_CHARGED_TO_RESTAURANT_DISCLOSURE",
  "feePercent": 25
}

Ejemplo 4

{
  "predefinedMessage": "FEE_CHARGED_TO_RESTAURANT_DISCLOSURE",
  "feePercentRange": {
    "minFeePercent": 20,
    "maxFeePercent": 30
  }
}

Ejemplo 5

{
  "predefinedMessage": "FEE_CHARGED_TO_RESTAURANT_DISCLOSURE",
  "feeAmount": {
    "currencyCode": "AUD",
    "units": 2,
    "nanos": 500000000
  }
}

Ejemplo 6

{
  "predefinedMessage": "FEE_CHARGED_TO_RESTAURANT_DISCLOSURE",
  "feeAmountRange": {
    "minFeeAmount": {
      "currencyCode": "AUD",
      "units": 2,
      "nanos": 500000000
    },
    "maxFeeAmount": {
      "currencyCode": "AUD",
      "units": 10,
      "nanos": 0
    }
  }
}

Error

El tipo Error tiene los siguientes valores posibles:

  • CLOSED: El restaurante está cerrado en el momento de realizar el pedido.
  • NO_CAPACITY: No hay capacidad de servicio disponible (por ejemplo, una interrupción temporal debido a horas pico).
  • NO_COURIER_AVAILABLE: No se puede procesar el pedido debido a la escasez de personal de entrega.
  • REQUIREMENTS_NOT_MET: No se cumplieron las restricciones para aceptar el pedido (por ejemplo, el tamaño mínimo del carrito).
  • UNAVAILABLE_SLOT: El pedido no se puede entregar en el horario de pedido anticipado especificado por DeliveryInfo o PickupInfo.
  • OUT_OF_SERVICE_AREA: El pedido no se puede entregar a la dirección del usuario.
  • PROMO_EXPIRED: No se pudo aplicar porque la promoción venció.
  • PROMO_NOT_APPLICABLE: Es un código de error genérico para detectar todos los casos de fallas en la aplicación del código promocional, si ninguno de los otros errores del código promocional coincide.
  • PROMO_NOT_RECOGNIZED: No se reconoció el código del cupón.
  • PROMO_ORDER_INELIGIBLE: El pedido actual no es apto para este cupón.
  • PROMO_USER_INELIGIBLE: El usuario actual no es apto para este cupón.
  • AVAILABILITY_CHANGED: El artículo ya no está disponible o no hay suficientes para cumplir con la solicitud.
  • INCORRECT_PRICE: Errores de precio en las tarifas o el total.
  • INVALID: Un LineItem, FulfillmentOption o Promotion contiene datos no válidos.
  • NOT_FOUND: No se puede encontrar un elemento de una sola línea, una FulfillmentOption o una promoción.
  • PRICE_CHANGED: Cambió el precio de un artículo.

FeeAmountRange

En la siguiente tabla, se enumeran las propiedades del tipo FeeAmountRange:

Propiedad Tipo Descripción
minFeeAmount Money

Es el límite inferior del importe de la tarifa cobrada.

maxFeeAmount Money

Es el límite superior del importe de la tarifa cobrada.

FeePercentRange

En la siguiente tabla, se enumeran las propiedades del tipo FeePercentRange:

Propiedad Tipo Descripción
minFeePercent Número

Es el límite inferior del porcentaje de tarifas cobradas.

maxFeePercent Número

Es el límite superior del porcentaje de tarifas cobradas.

FoodCartExtension

Contiene detalles sobre el usuario, como las preferencias de entrega.

En la siguiente tabla, se enumeran las propiedades del tipo FoodCartExtension:

Propiedad Tipo Descripción
@type Const

Es el tipo de esta extensión. Este campo siempre se establece en "type.googleapis.com/google.actions.v2.orders.FoodCartExtension".

Valor: type.googleapis.com/google.actions.v2.orders.FoodCartExtension

contact Contact

Es la información de contacto de la persona que recibe el pedido. Los detalles incluyen el nombre, el número de teléfono y la dirección de correo electrónico de la persona.

fulfillmentPreference FulfillmentOption

Obligatorio.

Es la preferencia de entrega del usuario.

location Location

En CheckoutRequestMessage, este campo especifica la dirección de entrega, que es obligatoria si el pedido es para entrega. En el caso de los pedidos para llevar o para retirar, este campo no se incluye en el mensaje.

En el siguiente ejemplo, se muestra un elemento FoodCartExtension:

Ejemplo 1

{
  "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
  "fulfillmentPreference": {
    "fulfillmentInfo": {
      "delivery": {
        "deliveryTimeIso8601": "P0M"
      }
    }
  },
  "location": {
    "coordinates": {
      "latitude": 37.788783,
      "longitude": -122.41384
    },
    "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
    "zipCode": "94043",
    "city": "Mountain View",
    "postalAddress": {
      "regionCode": "US",
      "postalCode": "94043",
      "administrativeArea": "CA",
      "locality": "Mountain View",
      "addressLines": [
        "1350 Charleston Road"
      ]
    },
    "notes": "Gate code is #111"
  }
}

Ejemplo 2

{
  "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
  "fulfillmentPreference": {
    "fulfillmentInfo": {
      "pickup": {
        "pickupTimeIso8601": "P0M"
      }
    }
  },
  "contact": {
    "displayName": "Lovefood Ordering",
    "email": "ilovefood@example.com",
    "phoneNumber": "+16501234567"
  }
}

FoodErrorExtension

Identifica uno o más errores que se produjeron durante el procesamiento de una solicitud. En la siguiente tabla, se describen los campos del tipo FoodErrorExtension. Los errores se pueden enviar en un CheckoutResponse.

En la siguiente tabla, se enumeran las propiedades del tipo FoodErrorExtension:

Propiedad Tipo Descripción
@type Const

Obligatorio.

Es el tipo de esta extensión.

Valor: type.googleapis.com/google.actions.v2.orders.FoodErrorExtension

foodOrderErrors List<FoodOrderError>

Obligatorio.

Es un array de objetos FoodOrderError que describen los errores que se produjeron. Se recomienda un error por carrito o por artículo.

Debe tener al menos 1 elemento.

correctedProposedOrder ProposedOrder

Obligatorio cuando foodOrderErrors.error = "UNAVAILABLE_SLOT", "PROMO_EXPIRED", "PROMO_NOT_APPLICABLE", "PROMO_NOT_RECOGNIZED", "PROMO_ORDER_INELIGIBLE", "PROMO_USER_INELIGIBLE", "AVAILABILITY_CHANGED", "INCORRECT_PRICE", "INVALID", "NOT_FOUND", or "PRICE_CHANGED".

Un nuevo ProposedOrder con correcciones Muestra este objeto si hay errores recuperables en el ProposedOrder original. Por ejemplo, un cambio en el precio de uno o más elementos de una sola línea en el carrito es un error recuperable. Los errores recuperables con un ProposedOrder válido avanzan a la etapa de confirmación, en lugar de requerir que el usuario revise su carrito.

paymentOptions PaymentOptions

Obligatorio cuando foodOrderErrors.error = "UNAVAILABLE_SLOT", "PROMO_EXPIRED", "PROMO_NOT_APPLICABLE", "PROMO_NOT_RECOGNIZED", "PROMO_ORDER_INELIGIBLE", "PROMO_USER_INELIGIBLE", "AVAILABILITY_CHANGED", "INCORRECT_PRICE", "INVALID", "NOT_FOUND", or "PRICE_CHANGED".

Son las opciones de pago predeterminadas que se seleccionaron para el usuario.

additionalPaymentOptions List<PaymentOptions>

Son las opciones de pago alternativas disponibles para el usuario.

En el siguiente ejemplo, se muestra un elemento FoodErrorExtension:

Ejemplo

{
  "@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
  "foodOrderErrors": [
    {
      "error": "PRICE_CHANGED",
      "id": "sample_item_offer_id_1",
      "description": "The price has changed.",
      "updatedPrice": {
        "currencyCode": "USD",
        "units": "2",
        "nanos": 750000000
      }
    },
    {
      "error": "PRICE_CHANGED",
      "id": "sample_item_offer_id_2",
      "description": "The price has changed.",
      "updatedPrice": {
        "currencyCode": "USD",
        "units": "8"
      }
    }
  ],
  "correctedProposedOrder": {
    "id": "sample_corrected_proposed_order_id_1",
    "otherItems": [
      {
        "name": "New customer discount",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "-5",
            "nanos": -500000000
          }
        },
        "type": "DISCOUNT"
      },
      {
        "name": "Delivery fee",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "3",
            "nanos": 500000000
          }
        },
        "type": "DELIVERY"
      },
      {
        "name": "Tax",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "1",
            "nanos": 500000000
          }
        },
        "type": "TAX"
      }
    ],
    "cart": {
      "merchant": {
        "id": "https://www.exampleprovider.com/merchant/id1",
        "name": "Falafel Bite"
      },
      "lineItems": [
        {
          "name": "Pita Chips",
          "type": "REGULAR",
          "id": "sample_item_offer_id_1",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "2",
              "nanos": 750000000
            }
          },
          "subLines": [
            {
              "note": "Notes for this item."
            }
          ],
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
            "options": [
              {
                "id": "sample_addon_offer_id_1",
                "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                "name": "Honey Mustard",
                "price": {
                  "currencyCode": "USD"
                },
                "quantity": 1
              },
              {
                "id": "sample_addon_offer_id_2",
                "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
                "name": "BBQ Sauce",
                "price": {
                  "currencyCode": "USD",
                  "nanos": 500000000
                },
                "quantity": 1
              }
            ]
          }
        },
        {
          "name": "Chicken Shwarma Wrap",
          "type": "REGULAR",
          "id": "sample_item_offer_id_2",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id2",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "8"
            }
          },
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
          }
        },
        {
          "name": "Greek Salad",
          "type": "REGULAR",
          "id": "sample_item_offer_id_3",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id3",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "9",
              "nanos": 990000000
            }
          },
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
          }
        },
        {
          "name": "Prawns Biryani",
          "type": "REGULAR",
          "id": "sample_item_offer_id_4",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "15",
              "nanos": 990000000
            }
          },
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
          }
        }
      ],
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
        "fulfillmentPreference": {
          "fulfillmentInfo": {
            "delivery": {
              "deliveryTimeIso8601": "P90M"
            }
          }
        },
        "location": {
          "coordinates": {
            "latitude": 37.788783,
            "longitude": -122.41384
          },
          "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
          "zipCode": "94043",
          "city": "Mountain View",
          "postalAddress": {
            "regionCode": "US",
            "postalCode": "94043",
            "administrativeArea": "CA",
            "locality": "Mountain View",
            "addressLines": [
              "1350 Charleston Road"
            ]
          },
          "notes": "Gate code is #111"
        }
      }
    },
    "totalPrice": {
      "type": "ESTIMATE",
      "amount": {
        "currencyCode": "USD",
        "units": "36",
        "nanos": 730000000
      }
    },
    "extension": {
      "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
      "availableFulfillmentOptions": [
        {
          "fulfillmentInfo": {
            "delivery": {
              "deliveryTimeIso8601": "P90M"
            }
          },
          "expiresAt": "2017-07-17T12:30:00Z"
        }
      ]
    }
  },
  "paymentOptions": {
    "googleProvidedOptions": {
      "tokenizationParameters": {
        "tokenizationType": "PAYMENT_GATEWAY",
        "parameters": {
          "gateway": "stripe",
          "stripe:publishableKey": "pk_live_stripe_client_key",
          "stripe:version": "2017-04-06"
        }
      },
      "supportedCardNetworks": [
        "AMEX",
        "DISCOVER",
        "MASTERCARD",
        "JCB",
        "VISA"
      ],
      "prepaidCardDisallowed": true
    }
  }
}

FoodItemExtension

Define los complementos para los alimentos.

En la siguiente tabla, se enumeran las propiedades del tipo FoodItemExtension:

Propiedad Tipo Descripción
@type Const

Obligatorio.

Es el tipo de esta extensión. Este campo siempre se establece en "type.googleapis.com/google.actions.v2.orders.FoodItemExtension".

Valor: type.googleapis.com/google.actions.v2.orders.FoodItemExtension

options List<FoodItemOption>

Una opción puede ser un elemento o un grupo de complementos que contiene un conjunto de complementos.

En el siguiente ejemplo, se muestra un elemento FoodItemExtension:

Ejemplo

{
  "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
  "options": [
    {
      "id": "sample_addon_offer_id_1",
      "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
      "name": "Honey Mustard",
      "price": {
        "currencyCode": "USD"
      },
      "quantity": 1
    },
    {
      "id": "sample_addon_offer_id_2",
      "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
      "name": "BBQ Sauce",
      "price": {
        "currencyCode": "USD",
        "nanos": 500000000
      },
      "quantity": 1,
      "subOptions": [
        {
          "id": "10239138",
          "offerId": "912391723",
          "name": "Fries",
          "price": {
            "currencyCode": "USD",
            "units": "2",
            "nanos": 230000000
          },
          "quantity": 1
        }
      ]
    }
  ]
}

FoodItemOption

En la siguiente tabla, se enumeran las propiedades del tipo FoodItemOption:

Propiedad Tipo Descripción
id String

Es un ID único que asigna Google. Cuando envíes un FoodOrderError o un AsyncOrderUpdateRequest, usa este campo para diferenciar los casos en los que un carrito contiene más de un artículo con el mismo offerId.

Ejemplo: 39231093

offerId String

Es el ID de la oferta del artículo.

Ejemplo: 912835081

name String

Es el nombre de la opción.

Ejemplo: Honey Mustard

price Money
note String

Nota relacionada con la opción.

quantity Número

Para las opciones que son elementos, la cantidad de elementos.

Ejemplo: 3

subOptions List<FoodItemOption>

Son las opciones secundarias de la opción, si las hay.

Ejemplo: [ { "id": "71283712", "offerId": "51209121", "name": "BBQ Sauce", "price": { "currencyCode": "USD", "units": "3", "nanos": 780000000 }, "quantity": 2 }, { "id": "102941024", "offerId": "12084102", "name": "Ketchup", "price": { "currencyCode": "USD", "units": "2", "nanos": 980000000 }, "quantity": 6 } ]

En el siguiente ejemplo, se muestra un elemento FoodItemOption:

Ejemplo 1

{
  "id": "10293231",
  "offerId": "1918491",
  "name": "Honey Mustard",
  "price": {
    "currencyCode": "USD",
    "units": "1",
    "nanos": 250000000
  },
  "quantity": 5
}

Ejemplo 2

{
  "id": "123166552",
  "offerId": "912849184",
  "name": "Make It A Meal",
  "price": {
    "currencyCode": "USD",
    "units": "3",
    "nanos": 730000000
  },
  "quantity": 1,
  "subOptions": [
    {
      "id": "10239138",
      "offerId": "912391723",
      "name": "Fries",
      "price": {
        "currencyCode": "USD",
        "units": "2",
        "nanos": 230000000
      },
      "quantity": 1
    },
    {
      "id": "57159183",
      "offerId": "81837123",
      "name": "Drink",
      "price": {
        "currencyCode": "USD",
        "units": "3",
        "nanos": 130000000
      },
      "quantity": 1
    }
  ]
}

FoodOrderError

Contiene detalles sobre los errores en un CheckoutResponse.

En la siguiente tabla, se enumeran las propiedades del tipo FoodOrderError:

Propiedad Tipo Descripción
error Error

Obligatorio.

id String

Obligatorio cuando error = "AVAILABILITY_CHANGED", "INCORRECT_PRICE", "PRICE_CHANGED", "INVALID", or "NOT_FOUND".

Este campo es obligatorio para los errores a nivel del artículo. Es el LineItem.id asignado por Google para los elementos del menú o FoodItemOption.id para los complementos.

description String

Descripción del error. Esta descripción es para el registro interno y los usuarios no pueden verla.

updatedPrice Money

Obligatorio cuando error = "PRICE_CHANGED".

Es el precio nuevo de un artículo que causó el error. Este campo es obligatorio solo cuando el error es "PRICE_CHANGED".

availableQuantity Número entero

Obligatorio cuando error = "INVALID", or "NOT_FOUND".

Es la nueva cantidad disponible del artículo que causó el error. Esto es obligatorio solo cuando el error es "INVALID" o "NOT_FOUND". El valor debe ser cero para "INVALID" y "NOT_FOUND".

En el siguiente ejemplo, se muestra un elemento FoodOrderError:

Ejemplo 1

{
  "error": "CLOSED",
  "description": "This store is currently reachable. Please try again later."
}

Ejemplo 2

{
  "error": "PRICE_CHANGED",
  "id": "french_fries",
  "description": "The price has changed.",
  "updatedPrice": {
    "currencyCode": "USD",
    "units": "2",
    "nanos": 750000000
  }
}

FoodOrderExtension

Contiene información de entrega sobre el pedido.

En la siguiente tabla, se enumeran las propiedades del tipo FoodOrderExtension:

Propiedad Tipo Descripción
@type Const

Es el tipo de esta extensión. Este campo siempre se establece en "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension".

Valor: type.googleapis.com/google.actions.v2.orders.FoodOrderExtension

availableFulfillmentOptions List<FulfillmentOption>

Representa las opciones de entrega disponibles para el pedido.

optinForRemarketing Booleano

Solicitud del usuario para habilitar tus canales de marketing De forma predeterminada, no puedes enviar contenido de marketing sin el consentimiento del usuario. Si optinForRemarketing es verdadero, puedes suscribir al usuario. Si optinForRemarketing es falso o no está presente, debes mantener el estado de la suscripción en tu sistema tal como está. Los usuarios no pueden inhabilitar esta opción a través de Google, solo a través de una función de anulación de la suscripción que se proporciona en tus canales de marketing. Esta marca solo está presente en SubmitOrderRequestMessage.

En el siguiente ejemplo, se muestra un elemento FoodOrderExtension:

Ejemplo 1

{
  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
  "availableFulfillmentOptions": [
    {
      "fulfillmentInfo": {
        "delivery": {
          "deliveryTimeIso8601": "P0M"
        }
      },
      "expiresAt": "2017-07-17T12:30:00Z"
    }
  ]
}

Ejemplo 2

{
  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
  "availableFulfillmentOptions": [
    {
      "fulfillmentInfo": {
        "pickup": {
          "pickupTimeIso8601": "P0M"
        }
      },
      "expiresAt": "2020-08-20T11:41:00Z"
    }
  ],
  "optinForRemarketing": true
}

FulfillmentOption

Puedes usar un objeto FulfillmentOption de las siguientes maneras:
  • En Checkout AppRequest y Submit AppRequest, Cart.extension.fulfillmentPreference almacena la preferencia del usuario (entrega o retiro). El precio siempre es 0 cuando se envía la solicitud de confirmación de la compra.
  • En Checkout AppResponse, ProposedOrder.extension.availableFulfillmentOptions define una o más opciones de entrega (actualmente, solo se admite una opción). Especificas la opción predeterminada como un LineItem en ProposedOrder.otherItems. El offerId de FulfillmentOption debe coincidir con el ID del LineItem especificado en ProposedOrder.otherItems.

En la siguiente tabla, se enumeran las propiedades del tipo FulfillmentOption:

Propiedad Tipo Descripción
offerId String

Es el identificador único de esta opción de entrega, si corresponde.

fulfillmentInfo FulfillmentOptionInfo

Obligatorio.

expiresAt Marca de tiempo ISO

Hora a la que vence esta opción de entrega.

price Money

Es el costo de esta opción.

En el siguiente ejemplo, se muestra un elemento FulfillmentOption:

Ejemplo

{
  "offerId": "offer5",
  "fulfillmentInfo": {
    "pickup": {
      "pickupTimeIso8601": "P0M"
    }
  },
  "expiresAt": "2019-05-02T00:00:00-07:00",
  "price": {
    "currencyCode": "USD",
    "units": "5",
    "nanos": 230000000
  }
}

FulfillmentOptionInfo

Define la información relacionada con FulfillmentInfo.

En la siguiente tabla, se enumeran las propiedades del tipo FulfillmentOptionInfo:

Propiedad Tipo Descripción
Se requiere exactamente uno de los siguientes grupos de propiedades.
delivery Grupo 1 DeliveryInfo

Si está presente, indica el pedido de entrega.

pickup Grupo 2 PickupInfo

Si está presente, indica un pedido de retiro.

Imagen

En la siguiente tabla, se enumeran las propiedades del tipo Image:

Propiedad Tipo Descripción
sourceUrl String

Obligatorio.

Es la URL de la imagen. Como mínimo, la imagen debe tener 72 × 72 píxeles. Para obtener los mejores resultados, usa una imagen de al menos 216 × 216 píxeles. La imagen debe tener un tamaño inferior a 6 MB y 64 megapíxeles.

LineItem

Define el contenido de un carrito (Cart.lineItems) o los cargos adicionales de un pedido (ProposedOrder.otherItems).

En la siguiente tabla, se enumeran las propiedades del tipo LineItem:

Propiedad Tipo Descripción
id String

Obligatorio cuando type = "REGULAR".

En el caso de un elemento de una lista de artículos de un carrito (ProposedOrder.cart.lineItems[0].id), este es el ID único que Google crea cuando se crea el pedido. En el caso de una línea de pedido en un ProposedOrder (ProposedOrder.otherItems[0].id), que se usa para agregar elementos como tarifas de envío y impuestos, el proveedor define el valor de id. Por ejemplo, en un carrito hay dos de los mismos artículos con diferentes instrucciones de preparación (como dos pizzas medianas con diferentes conjuntos de ingredientes). En este caso, ambos artículos tienen el mismo offerId base. Cuando envíes una solicitud de actualización de pedido para indicar que se rechazó un artículo, usa este ID como desambiguador. En otras palabras, si se rechaza una de las pizzas porque no tiene un ingrediente en particular, el ID ayuda a Google a determinar a qué artículo del pedido te refieres. Este campo es obligatorio, excepto en otherItems.

name String

Obligatorio.

Es el nombre de la línea de pedido. Esta es una cadena visible para el usuario y debe escribirse en mayúsculas cuando sea posible (como "Tarifa de entrega", "Cargo por servicio", "Impuesto"). Este campo se trunca en 100 caracteres para los usuarios.

type LineItemType

Obligatorio.

quantity Número entero

Obligatorio cuando type = "REGULAR".

Cantidad de artículos incluidos. No se aplica a ProposedOrder.otherItems.

description String

Descripción del artículo

price Price

Obligatorio.

Es el precio del artículo o los artículos. Este valor refleja el precio total de todos los bienes o servicios de esta línea de pedido (en otras palabras, suma el costo de los complementos y multiplícalo por la cantidad). Por ejemplo, si un artículo de USD 10 tiene una cantidad de 3, el precio sería de USD 30. Para una pizza con un precio base de USD 5 y un complemento de USD 1, el precio sería de USD 6. Para dos pizzas (cantidad = 2) con un precio base de USD 5 y cada una con un complemento de USD 1, el precio sería de USD 12. Cada LineItem debe tener un precio, incluso si es "0". Cuando el tipo sea DISCOUNT, especifica el valor como negativo (por ejemplo, "-2").

subLines List<SublineNote>

Es opcional y solo es válido si el tipo es “REGULAR”. En este campo, se puede enviar una nota específica del usuario en la solicitud de confirmación de la compra y en la solicitud de envío del pedido. Asegúrate de que el comercio reciba la nota cuando se la envíes. Estará en la solicitud como subLines[0].note, que es el único valor que se proporciona en este campo cuando está presente en una solicitud.

No debe tener más de 1 elemento.

offerId String

Obligatorio cuando type = "REGULAR".

Es el ID de la oferta del elemento MenuItem. No se aplica a ProposedOrder.otherItems.

extension FoodItemExtension

Define los complementos para los alimentos.

En el siguiente ejemplo, se muestra un elemento LineItem:

Ejemplo 1

{
  "name": "New customer discount",
  "price": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "-5",
      "nanos": -500000000
    }
  },
  "type": "DISCOUNT"
}

Ejemplo 2

{
  "name": "Pita Chips",
  "type": "REGULAR",
  "id": "sample_item_offer_id_1",
  "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
  "quantity": 1,
  "price": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "2",
      "nanos": 750000000
    }
  },
  "subLines": [
    {
      "note": "Notes for this item."
    }
  ],
  "extension": {
    "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
    "options": [
      {
        "id": "sample_addon_offer_id_1",
        "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
        "name": "Honey Mustard",
        "price": {
          "currencyCode": "USD"
        },
        "quantity": 1
      },
      {
        "id": "sample_addon_offer_id_2",
        "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
        "name": "BBQ Sauce",
        "price": {
          "currencyCode": "USD",
          "nanos": 500000000
        },
        "quantity": 1
      }
    ]
  }
}

LineItemType

El tipo LineItemType tiene los siguientes valores posibles:

  • REGULAR: Es el elemento de una sola línea de bienes. Se aplica a Cart.lineItems.
  • TAX: Es el elemento de la línea de impuestos. Se aplica a ProposedOrder.otherItems.
  • DISCOUNT: Es el artículo de la línea de descuento. Ten en cuenta que el precio debe ser negativo. Se aplica a ProposedOrder.otherItems.
  • GRATUITY: Es el elemento de una sola línea de propina. Por lo general, se reserva para SubmitOrderRequestMessage para una propina seleccionada por el usuario. Se aplica a ProposedOrder.otherItems.
  • DELIVERY: Es la línea de pedido de publicación. Se aplica a ProposedOrder.otherItems.
  • SUBTOTAL: Es el elemento de la línea de subtotal. Se aplica a ProposedOrder.otherItems.
  • FEE: Es una línea de pedido adicional que no está cubierta por los otros tipos. Se aplica a ProposedOrder.otherItems.

Ubicación

Especifica una dirección para pedir comida. El tipo Location se usa en un elemento Cart solo para indicar el destino de un pedido de entrega. La ubicación final también está presente en TransactionDecisionValue si el usuario realiza el pedido. En el caso de los pedidos que especifican retiro, no se incluye ninguna ubicación (ni siquiera una vacía).

En la siguiente tabla, se enumeran las propiedades del tipo Location:

Propiedad Tipo Descripción
coordinates Coordinates
formattedAddress String

Muestra la dirección de la ubicación.

Ejemplo: 1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States

postalAddress PostalAddress
zipCode String

Ejemplo: 90210

city String

Es el nombre de la ciudad.

Ejemplo: Los Angeles

notes String

Notas sobre la ubicación, como códigos de portón Debe tener 500 caracteres o menos.

Ejemplo: Gate code is #111

En el siguiente ejemplo, se muestra un elemento Location:

Ejemplo

{
  "coordinates": {
    "latitude": 37.788783,
    "longitude": -122.41384
  },
  "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
  "zipCode": "94043",
  "city": "Mountain View",
  "postalAddress": {
    "regionCode": "US",
    "postalCode": "94043",
    "administrativeArea": "CA",
    "locality": "Mountain View",
    "addressLines": [
      "1350 Charleston Road"
    ]
  },
  "notes": "Gate code is #111"
}

Merchant

En la siguiente tabla, se enumeran las propiedades del tipo Merchant:

Propiedad Tipo Descripción
id String

Es el ID del comercio. Si se especifica, coincide con Restaurant.@id en el feed de restaurantes.

Ejemplo: https://www.exampleprovider.com/merchant/id1

name String

Obligatorio.

Es el nombre visible para el usuario del comercio.

Ejemplo: Falafel Bite

En el siguiente ejemplo, se muestra un elemento Merchant:

Ejemplo

{
  "id": "https://www.exampleprovider.com/merchant/id1",
  "name": "Falafel Bite"
}

Dinero

En la siguiente tabla, se enumeran las propiedades del tipo Money:

Propiedad Tipo Descripción
currencyCode String

Obligatorio.

Es un código de moneda de 3 letras en formato ISO 4217.

Ejemplo: USD

units String

La unidad entera del importe. Por ejemplo, si currencyCode es “USD”, la unidad “1” es un dólar estadounidense.

Ejemplo: 36

nanos Número entero

Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999, inclusive. Usa las siguientes reglas: Si la cantidad de unidades es positiva, los nanosegundos deben ser positivos o cero. Si la cantidad de unidades es cero, los nanosegundos pueden ser positivos, cero o negativos. Si la cantidad de unidades es negativa, los nanosegundos deben ser negativos o cero. Por ejemplo, $-1.75 se representa como unidades = -1 y nanos = -750,000,000.

Ejemplo: 730000000

En el siguiente ejemplo, se muestra un elemento Money:

Ejemplo 1

{
  "currencyCode": "USD",
  "units": "36",
  "nanos": 730000000
}

Ejemplo 2

{
  "currencyCode": "EUR",
  "units": "10"
}

Ordenar

Contiene el pedido final, incluidos los impuestos, las tarifas y los cargos de entrega, así como la información de pago. Tu acción recibe este objeto en un Submit AppRequest.

En la siguiente tabla, se enumeran las propiedades del tipo Order:

Propiedad Tipo Descripción
finalOrder ProposedOrder

Obligatorio.

Es la orden propuesta que causó el pedido.

googleOrderId String

Obligatorio.

Es el ID de pedido que asignó Google. Este ID debe ser estable durante todo el ciclo de vida de un pedido. El usuario final no puede ver este ID.

orderDate Marca de tiempo ISO

Obligatorio.

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

paymentInfo PaymentInfo

Obligatorio.

Es la información de pago correspondiente al pago de este pedido.

En el siguiente ejemplo, se muestra un elemento Order:

Ejemplo

{
  "finalOrder": {
    "cart": {
      "notes": "Guest prefers their food to be hot when it is delivered.",
      "merchant": {
        "id": "https://www.exampleprovider.com/merchant/id1",
        "name": "Cucina Venti"
      },
      "lineItems": [
        {
          "name": "Sizzling Prawns Dinner",
          "type": "REGULAR",
          "id": "sample_item_offer_id_1",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "16",
              "nanos": 750000000
            }
          },
          "subLines": [
            {
              "note": "Notes for this item."
            }
          ],
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
            "options": [
              {
                "id": "sample_addon_offer_id_1",
                "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                "name": "Honey Mustard",
                "price": {
                  "currencyCode": "USD"
                },
                "quantity": 1
              },
              {
                "id": "sample_addon_offer_id_2",
                "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
                "name": "BBQ Sauce",
                "price": {
                  "currencyCode": "USD",
                  "nanos": 500000000
                },
                "quantity": 1
              }
            ]
          }
        }
      ],
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
        "fulfillmentPreference": {
          "fulfillmentInfo": {
            "pickup": {
              "pickupTimeIso8601": "P0M"
            }
          }
        },
        "contact": {
          "displayName": "Lovefood Ordering",
          "email": "ilovefood@example.com",
          "phoneNumber": "+16501234567"
        }
      }
    },
    "otherItems": [
      {
        "name": "Service fee",
        "type": "FEE",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "3",
            "nanos": 500000000
          }
        }
      },
      {
        "name": "Tax",
        "type": "TAX",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "1",
            "nanos": 370000000
          }
        }
      },
      {
        "name": "Tip",
        "type": "GRATUITY",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "2",
            "nanos": 590000000
          }
        }
      }
    ],
    "totalPrice": {
      "type": "ESTIMATE",
      "amount": {
        "currencyCode": "USD",
        "units": "23",
        "nanos": 710000000
      }
    },
    "id": "sample_final_order_id",
    "extension": {
      "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
      "availableFulfillmentOptions": [
        {
          "fulfillmentInfo": {
            "pickup": {
              "pickupTimeIso8601": "P0M"
            }
          },
          "expiresAt": "2017-07-17T12:30:00Z"
        }
      ],
      "optinForRemarketing": true
    }
  },
  "googleOrderId": "sample_google_order_id",
  "orderDate": "2017-07-17T12:00:00Z",
  "paymentInfo": {
    "displayName": "Visa\u2006****\u20061111",
    "googleProvidedPaymentInstrument": {
      "instrumentToken": "abcd"
    },
    "paymentType": "PAYMENT_CARD"
  }
}

OrderUpdate

En la siguiente tabla, se describen los campos del tipo OrderUpdate que se incluye en AppResponse.

En la siguiente tabla, se enumeran las propiedades del tipo OrderUpdate:

Propiedad Tipo Descripción
actionOrderId String

Obligatorio.

Es el ID único del pedido en el sistema del integrador que se usa para identificar el pedido para el que se envía la actualización. Si no se proporciona receipt.user_visible_order_id al menos una vez en OrderUpdate para un pedido "CREATED", este ID será el ID visible para el usuario ingresado que se mostrará en la tarjeta de pedido de Google.

orderState OrderState

Obligatorio.

Es el estado nuevo del pedido.

lineItemUpdates Map<String, LineItemUpdate>
updateTime Marca de tiempo ISO

Obligatorio.

Es la hora en la que se actualizó el pedido.

orderManagementActions List<OrderManagementAction>

Acciones posteriores al pedido, como comunicarse con el equipo de asistencia y ver los detalles del pedido

Debe tener al menos 1 elemento y no más de 6.

rejectionInfo RejectionInfo

Obligatorio cuando orderState.state = "REJECTED".

cancellationInfo CancellationInfo

Obligatorio cuando orderState.state = "CANCELLED".

inTransitInfo InTransitInfo

Este campo dejó de estar disponible.

fulfillmentInfo FulfillmentInfo

Este campo dejó de estar disponible.

receipt Receipt

Obligatorio cuando orderState.state = "CONFIRMED", "IN_PREPARATION", or "READY_FOR_PICKUP".

Proporciona el ID del pedido visible para el usuario en un recibo.

totalPrice Price

Es el precio total del pedido.

infoExtension FoodOrderUpdateExtension

Define más detalles de la actualización del pedido, como el intervalo para la entrega o el retiro estimados.

En el siguiente ejemplo, se muestra un elemento OrderUpdate:

Ejemplo

{
  "actionOrderId": "sample_action_order_id",
  "orderState": {
    "state": "CONFIRMED",
    "label": "Provider confirmed"
  },
  "totalPrice": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "41",
      "nanos": 600000000
    }
  },
  "lineItemUpdates": {
    "sample_item_id_1": {
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "3",
          "nanos": 500000000
        }
      },
      "reason": "This item has an updated price."
    }
  },
  "receipt": {
    "userVisibleOrderId": "userVisibleId1234"
  },
  "updateTime": "2017-07-17T12:00:00Z",
  "orderManagementActions": [
    {
      "type": "CUSTOMER_SERVICE",
      "button": {
        "title": "Contact customer service",
        "openUrlAction": {
          "url": "mailto:support@example.com"
        }
      }
    },
    {
      "type": "EMAIL",
      "button": {
        "title": "Email restaurant",
        "openUrlAction": {
          "url": "mailto:person@example.com"
        }
      }
    },
    {
      "type": "CALL_RESTAURANT",
      "button": {
        "title": "Call restaurant",
        "openUrlAction": {
          "url": "tel:+16505554679"
        }
      }
    }
  ],
  "infoExtension": {
    "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension",
    "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z"
  }
}

PickupInfo

En la siguiente tabla, se enumeran las propiedades del tipo PickupInfo:

Propiedad Tipo Descripción
pickupTimeIso8601 String

Hora de partida estimada, en formato de marca de tiempo ISO 8601: "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z" o formato de duración: "P(n)Y(n)M(n)DT(n)H(n)M(n)S". Por ejemplo, PT90M representa una duración de 90 minutos. El valor predeterminado ,"PT0M", indica que la hora de partida preferida es lo antes posible. Referencia: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. Úsalo para actualizar la hora de retiro estimada durante la respuesta de confirmación de la compra.

Ejemplo: PT90M

En el siguiente ejemplo, se muestra un elemento PickupInfo:

Ejemplo

{
  "pickupTimeIso8601": "PT90M"
}

PostalAddress

En la siguiente tabla, se enumeran las propiedades del tipo PostalAddress:

Propiedad Tipo Descripción
regionCode String

Obligatorio.

Un código de país de dos letras.

Ejemplo: US

postalCode String

Corresponde al código postal,

Ejemplo: 94043

administrativeArea String

División administrativa más alta que se usa para las direcciones postales de un país o una región. Puede ser un estado, una provincia, un óblast o una prefectura.

Ejemplo: CA

locality String

Es la ciudad o el pueblo de esta ubicación. En las regiones del mundo donde las localidades no están bien definidas o no se ajustan a esta estructura, no especifiques la localidad y usa el campo addressLines.

Ejemplo: Mountain View

addressLines Lista<String>

Una o más líneas que puedes usar para especificar la dirección. No se debe modificar este campo porque puede contener localidades poco claras.

Ejemplo: [ "1350 Charleston Road" ]

recipients Lista<String>

Es la lista de destinatarios de un pedido. Este campo solo está disponible en billingAddress.

En el siguiente ejemplo, se muestra un elemento PostalAddress:

Ejemplo

{
  "regionCode": "US",
  "postalCode": "94043",
  "administrativeArea": "CA",
  "locality": "Mountain View",
  "addressLines": [
    "1350 Charleston Road"
  ]
}

Precio

En la siguiente tabla, se enumeran las propiedades del tipo Price:

Propiedad Tipo Descripción
type Enum [ "ESTIMATE", "ACTUAL" ]

Obligatorio.

El código del cupón de promoción

amount Money

Obligatorio.

Promoción

En la siguiente tabla, se enumeran las propiedades del tipo Promotion:

Propiedad Tipo Descripción
coupon String

Obligatorio.

El código del cupón de promoción

ProposedOrder

En la siguiente tabla, se enumeran las propiedades del tipo ProposedOrder:

Propiedad Tipo Descripción
id String

Es el ID opcional del pedido propuesto.

cart Cart

Obligatorio.

Son los artículos del usuario.

otherItems List<LineItem>

Son los elementos que agrega el proveedor, como los cargos de entrega, otras tarifas y los impuestos. otherItems también puede contener propinas o descuentos que haya agregado el usuario.

No debe tener más de 10 elementos.

image Image

Es la imagen asociada con el pedido propuesto.

totalPrice Price

Obligatorio.

Es el precio total del pedido propuesto.

extension FoodOrderExtension

Obligatorio.

Define la información de entrega de los pedidos de comida.

disclaimers List<Disclaimer>

Corresponde a los mensajes de renuncia de responsabilidad que se mostrarán en la IU antes de que se realice el pedido.

En el siguiente ejemplo, se muestra un elemento ProposedOrder:

Ejemplo

{
  "id": "sample_proposed_order_id_1",
  "otherItems": [
    {
      "name": "New customer discount",
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "-5",
          "nanos": -500000000
        }
      },
      "type": "DISCOUNT"
    },
    {
      "name": "Delivery fee",
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "3",
          "nanos": 500000000
        }
      },
      "type": "DELIVERY"
    },
    {
      "name": "Tax",
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "1",
          "nanos": 500000000
        }
      },
      "type": "TAX"
    }
  ],
  "cart": {
    "merchant": {
      "id": "https://www.exampleprovider.com/merchant/id1",
      "name": "Falafel Bite"
    },
    "lineItems": [
      {
        "name": "Pita Chips",
        "type": "REGULAR",
        "id": "sample_item_offer_id_1",
        "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
        "quantity": 1,
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "2",
            "nanos": 750000000
          }
        },
        "subLines": [
          {
            "note": "Notes for this item."
          }
        ],
        "extension": {
          "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
          "options": [
            {
              "id": "sample_addon_offer_id_1",
              "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
              "name": "Honey Mustard",
              "price": {
                "currencyCode": "USD"
              },
              "quantity": 1
            },
            {
              "id": "sample_addon_offer_id_2",
              "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
              "name": "BBQ Sauce",
              "price": {
                "currencyCode": "USD",
                "nanos": 500000000
              },
              "quantity": 1
            }
          ]
        }
      },
      {
        "name": "Chicken Shwarma Wrap",
        "type": "REGULAR",
        "id": "sample_item_offer_id_2",
        "offerId": "https://www.exampleprovider.com/menu/item/offer/id2",
        "quantity": 1,
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "8"
          }
        },
        "extension": {
          "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
        }
      },
      {
        "name": "Greek Salad",
        "type": "REGULAR",
        "id": "sample_item_offer_id_3",
        "offerId": "https://www.exampleprovider.com/menu/item/offer/id3",
        "quantity": 1,
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "9",
            "nanos": 990000000
          }
        },
        "extension": {
          "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
        }
      },
      {
        "name": "Prawns Biryani",
        "type": "REGULAR",
        "id": "sample_item_offer_id_4",
        "offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
        "quantity": 1,
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "15",
            "nanos": 990000000
          }
        },
        "extension": {
          "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
        }
      }
    ],
    "extension": {
      "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
      "fulfillmentPreference": {
        "fulfillmentInfo": {
          "delivery": {
            "deliveryTimeIso8601": "P90M"
          }
        }
      },
      "location": {
        "coordinates": {
          "latitude": 37.788783,
          "longitude": -122.41384
        },
        "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
        "zipCode": "94043",
        "city": "Mountain View",
        "postalAddress": {
          "regionCode": "US",
          "postalCode": "94043",
          "administrativeArea": "CA",
          "locality": "Mountain View",
          "addressLines": [
            "1350 Charleston Road"
          ]
        },
        "notes": "Gate code is #111"
      }
    }
  },
  "totalPrice": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "36",
      "nanos": 730000000
    }
  },
  "extension": {
    "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
    "availableFulfillmentOptions": [
      {
        "fulfillmentInfo": {
          "delivery": {
            "deliveryTimeIso8601": "P0M"
          }
        },
        "expiresAt": "2017-07-17T12:30:00Z"
      }
    ]
  }
}

SublineNote

En la siguiente tabla, se enumeran las propiedades del tipo SublineNote:

Propiedad Tipo Descripción
note String

Obligatorio.

Marca de tiempo

La fecha y la hora, en el siguiente formato: "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z"

TransactionDecisionValue

Contiene Order.

En la siguiente tabla, se enumeran las propiedades del tipo TransactionDecisionValue:

Propiedad Tipo Descripción
order Order

Obligatorio.

Pedido que se realizará con los detalles del pago

En el siguiente ejemplo, se muestra un elemento TransactionDecisionValue:

Ejemplo

{
  "order": {
    "finalOrder": {
      "cart": {
        "notes": "Guest prefers their food to be hot when it is delivered.",
        "merchant": {
          "id": "https://www.exampleprovider.com/merchant/id1",
          "name": "Cucina Venti"
        },
        "lineItems": [
          {
            "name": "Sizzling Prawns Dinner",
            "type": "REGULAR",
            "id": "sample_item_offer_id_1",
            "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
            "quantity": 1,
            "price": {
              "type": "ESTIMATE",
              "amount": {
                "currencyCode": "USD",
                "units": "16",
                "nanos": 750000000
              }
            },
            "subLines": [
              {
                "note": "Notes for this item."
              }
            ],
            "extension": {
              "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
              "options": [
                {
                  "id": "sample_addon_offer_id_1",
                  "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                  "name": "Honey Mustard",
                  "price": {
                    "currencyCode": "USD"
                  },
                  "quantity": 1
                },
                {
                  "id": "sample_addon_offer_id_2",
                  "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
                  "name": "BBQ Sauce",
                  "price": {
                    "currencyCode": "USD",
                    "nanos": 500000000
                  },
                  "quantity": 1
                }
              ]
            }
          }
        ],
        "extension": {
          "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
          "fulfillmentPreference": {
            "fulfillmentInfo": {
              "pickup": {
                "pickupTimeIso8601": "P0M"
              }
            }
          },
          "contact": {
            "displayName": "Lovefood Ordering",
            "email": "ilovefood@example.com",
            "phoneNumber": "+16501234567"
          }
        }
      },
      "otherItems": [
        {
          "name": "Service fee",
          "type": "FEE",
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "3",
              "nanos": 500000000
            }
          }
        },
        {
          "name": "Tax",
          "type": "TAX",
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "1",
              "nanos": 370000000
            }
          }
        },
        {
          "name": "Tip",
          "type": "GRATUITY",
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "2",
              "nanos": 590000000
            }
          }
        }
      ],
      "totalPrice": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "23",
          "nanos": 710000000
        }
      },
      "id": "sample_final_order_id",
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
        "availableFulfillmentOptions": [
          {
            "fulfillmentInfo": {
              "pickup": {
                "pickupTimeIso8601": "P0M"
              }
            },
            "expiresAt": "2017-07-17T12:30:00Z"
          }
        ],
        "optinForRemarketing": true
      }
    },
    "googleOrderId": "sample_google_order_id",
    "orderDate": "2017-07-17T12:00:00Z",
    "paymentInfo": {
      "displayName": "Visa\u2006****\u20061111",
      "googleProvidedPaymentInstrument": {
        "instrumentToken": "abcd"
      },
      "paymentType": "PAYMENT_CARD"
    }
  }
}

Solicitud de entrega

AppRequest

En la siguiente tabla, se enumeran las propiedades del tipo AppRequest:

Propiedad Tipo Descripción
isInSandbox Booleano

Indica si las transacciones posteriores se realizan en un entorno de zona de pruebas.

conversation Conversation
inputs List<Input>

Obligatorio.

Contiene los argumentos esperados para confirmar la compra de un carrito.

Debe tener exactamente 1 elemento.

En el siguiente ejemplo, se muestra un elemento AppRequest:

Ejemplo 1

{
  "isInSandbox": true,
  "inputs": [
    {
      "intent": "actions.foodordering.intent.CHECKOUT",
      "arguments": [
        {
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.Cart",
            "merchant": {
              "id": "https://www.exampleprovider.com/merchant/id1",
              "name": "Cucina Venti"
            },
            "lineItems": [
              {
                "name": "Sizzling Prawns Dinner",
                "type": "REGULAR",
                "id": "sample_item_offer_id_1",
                "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
                "quantity": 1,
                "price": {
                  "type": "ESTIMATE",
                  "amount": {
                    "currencyCode": "USD",
                    "units": "16",
                    "nanos": 750000000
                  }
                },
                "subLines": [
                  {
                    "note": "Notes for this item."
                  }
                ],
                "extension": {
                  "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
                  "options": [
                    {
                      "id": "sample_addon_offer_id_1",
                      "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                      "name": "Honey Mustard",
                      "price": {
                        "currencyCode": "USD"
                      },
                      "quantity": 1
                    },
                    {
                      "id": "sample_addon_offer_id_2",
                      "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
                      "name": "BBQ Sauce",
                      "price": {
                        "currencyCode": "USD",
                        "nanos": 500000000
                      },
                      "quantity": 1
                    }
                  ]
                }
              }
            ],
            "extension": {
              "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
              "fulfillmentPreference": {
                "fulfillmentInfo": {
                  "delivery": {
                    "deliveryTimeIso8601": "P0M"
                  }
                }
              },
              "location": {
                "coordinates": {
                  "latitude": 37.788783,
                  "longitude": -122.41384
                },
                "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
                "zipCode": "94043",
                "city": "Mountain View",
                "postalAddress": {
                  "regionCode": "US",
                  "postalCode": "94043",
                  "administrativeArea": "CA",
                  "locality": "Mountain View",
                  "addressLines": [
                    "1350 Charleston Road"
                  ]
                },
                "notes": "Gate code is #111"
              }
            }
          }
        }
      ]
    }
  ]
}

Ejemplo 2

{
  "isInSandbox": true,
  "inputs": [
    {
      "intent": "actions.intent.TRANSACTION_DECISION",
      "arguments": [
        {
          "transactionDecisionValue": {
            "order": {
              "finalOrder": {
                "cart": {
                  "notes": "Guest prefers their food to be hot when it is delivered.",
                  "merchant": {
                    "id": "https://www.exampleprovider.com/merchant/id1",
                    "name": "Cucina Venti"
                  },
                  "lineItems": [
                    {
                      "name": "Sizzling Prawns Dinner",
                      "type": "REGULAR",
                      "id": "sample_item_offer_id_1",
                      "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "16",
                          "nanos": 750000000
                        }
                      },
                      "subLines": [
                        {
                          "note": "Notes for this item."
                        }
                      ],
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
                        "options": [
                          {
                            "id": "sample_addon_offer_id_1",
                            "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                            "name": "Honey Mustard",
                            "price": {
                              "currencyCode": "USD"
                            },
                            "quantity": 1
                          },
                          {
                            "id": "sample_addon_offer_id_2",
                            "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
                            "name": "BBQ Sauce",
                            "price": {
                              "currencyCode": "USD",
                              "nanos": 500000000
                            },
                            "quantity": 1
                          }
                        ]
                      }
                    }
                  ],
                  "extension": {
                    "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
                    "fulfillmentPreference": {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "P0M"
                        }
                      }
                    },
                    "contact": {
                      "displayName": "Lovefood Ordering",
                      "email": "ilovefood@example.com",
                      "phoneNumber": "+16501234567"
                    }
                  }
                },
                "otherItems": [
                  {
                    "name": "Service fee",
                    "type": "FEE",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "3",
                        "nanos": 500000000
                      }
                    }
                  },
                  {
                    "name": "Tax",
                    "type": "TAX",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "1",
                        "nanos": 370000000
                      }
                    }
                  },
                  {
                    "name": "Tip",
                    "type": "GRATUITY",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "2",
                        "nanos": 590000000
                      }
                    }
                  }
                ],
                "totalPrice": {
                  "type": "ESTIMATE",
                  "amount": {
                    "currencyCode": "USD",
                    "units": "23",
                    "nanos": 710000000
                  }
                },
                "id": "sample_final_order_id",
                "extension": {
                  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
                  "availableFulfillmentOptions": [
                    {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "P0M"
                        }
                      },
                      "expiresAt": "2017-07-17T12:30:00Z"
                    }
                  ],
                  "optinForRemarketing": true
                }
              },
              "googleOrderId": "sample_google_order_id",
              "orderDate": "2017-07-17T12:00:00Z",
              "paymentInfo": {
                "displayName": "Visa\u2006****\u20061111",
                "googleProvidedPaymentInstrument": {
                  "instrumentToken": "abcd"
                },
                "paymentType": "PAYMENT_CARD"
              }
            }
          }
        }
      ]
    }
  ]
}

CheckoutRequestMessage

Un CheckoutRequestMessage es un AppRequest con el intent actions.foodordering.intent.CHECKOUT.

SubmitOrderRequestMessage

Un SubmitOrderRequestMessage es un AppRequest con el intent actions.foodordering.intent.TRANSACTION_DECISION.

Conversación

Un Conversation es único para una sola sesión. Puedes usarlo para vincular varias acciones Checkout y SubmitOrder si es necesario.

En la siguiente tabla, se enumeran las propiedades del tipo Conversation:

Propiedad Tipo Descripción
conversationId String

Obligatorio.

Es el ID único de la conversación.

En el siguiente ejemplo, se muestra un elemento Conversation:

Ejemplo

{
  "conversationId": "CQnJ7Z4i7UmvEZ9ph3AxyZRJ"
}

Entrada

Los argumentos esperados para confirmar la compra de un carrito.

En la siguiente tabla, se enumeran las propiedades del tipo Input:

Propiedad Tipo Descripción
intent Enum [ "actions.foodordering.intent.CHECKOUT", "actions.intent.TRANSACTION_DECISION" ]

Obligatorio.

Establece el valor en "actions.foodordering.intent.CHECKOUT" para el mensaje de solicitud de confirmación de la compra O "actions.intent.TRANSACTION_DECISION" para el mensaje de solicitud de envío del pedido.

arguments List<Argument>

Obligatorio.

Contiene el carrito que se confirmará o el pedido que se realizará.

Debe tener exactamente 1 elemento.

Argumento

Contiene detalles sobre los alimentos que el usuario quiere revisar. En el caso de la confirmación de la compra, solo se aplica la extensión. Para enviar el pedido, solo se aplica transactionDecisionValue.

En la siguiente tabla, se enumeran las propiedades del tipo Argument:

Propiedad Tipo Descripción
Se requiere exactamente uno de los siguientes grupos de propiedades.
extension Grupo 1 Cart

Detalla los alimentos que el usuario quiere revisar.

transactionDecisionValue Grupo 2 TransactionDecisionValue

Contiene el pedido que se realizará junto con los detalles del pago.

Respuesta de entrega

AppResponse

En la siguiente tabla, se enumeran las propiedades del tipo AppResponse:

Propiedad Tipo Descripción
expectUserResponse Const

Se establece como falso.

Valor: False

finalResponse FinalResponse

Obligatorio.

Contiene tu respuesta a la confirmación de la compra del carrito.

En el siguiente ejemplo, se muestra un elemento AppResponse:

Ejemplo 1

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "structuredResponse": {
            "checkoutResponse": {
              "proposedOrder": {
                "id": "sample_proposed_order_id_1",
                "otherItems": [
                  {
                    "name": "New customer discount",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "-5",
                        "nanos": -500000000
                      }
                    },
                    "type": "DISCOUNT"
                  },
                  {
                    "name": "Delivery fee",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "3",
                        "nanos": 500000000
                      }
                    },
                    "type": "DELIVERY"
                  },
                  {
                    "name": "Tax",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "1",
                        "nanos": 500000000
                      }
                    },
                    "type": "TAX"
                  }
                ],
                "cart": {
                  "merchant": {
                    "id": "https://www.exampleprovider.com/merchant/id1",
                    "name": "Falafel Bite"
                  },
                  "lineItems": [
                    {
                      "name": "Pita Chips",
                      "type": "REGULAR",
                      "id": "sample_item_offer_id_1",
                      "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "2",
                          "nanos": 750000000
                        }
                      },
                      "subLines": [
                        {
                          "note": "Notes for this item."
                        }
                      ],
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
                        "options": [
                          {
                            "id": "sample_addon_offer_id_1",
                            "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                            "name": "Honey Mustard",
                            "price": {
                              "currencyCode": "USD"
                            },
                            "quantity": 1
                          },
                          {
                            "id": "sample_addon_offer_id_2",
                            "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
                            "name": "BBQ Sauce",
                            "price": {
                              "currencyCode": "USD",
                              "nanos": 500000000
                            },
                            "quantity": 1
                          }
                        ]
                      }
                    },
                    {
                      "name": "Chicken Shwarma Wrap",
                      "type": "REGULAR",
                      "id": "sample_item_offer_id_2",
                      "offerId": "https://www.exampleprovider.com/menu/item/offer/id2",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "8"
                        }
                      },
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
                      }
                    },
                    {
                      "name": "Greek Salad",
                      "type": "REGULAR",
                      "id": "sample_item_offer_id_3",
                      "offerId": "https://www.exampleprovider.com/menu/item/offer/id3",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "9",
                          "nanos": 990000000
                        }
                      },
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
                      }
                    },
                    {
                      "name": "Prawns Biryani",
                      "type": "REGULAR",
                      "id": "sample_item_offer_id_4",
                      "offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "15",
                          "nanos": 990000000
                        }
                      },
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
                      }
                    }
                  ],
                  "extension": {
                    "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
                    "fulfillmentPreference": {
                      "fulfillmentInfo": {
                        "delivery": {
                          "deliveryTimeIso8601": "P90M"
                        }
                      }
                    },
                    "location": {
                      "coordinates": {
                        "latitude": 37.788783,
                        "longitude": -122.41384
                      },
                      "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
                      "zipCode": "94043",
                      "city": "Mountain View",
                      "postalAddress": {
                        "regionCode": "US",
                        "postalCode": "94043",
                        "administrativeArea": "CA",
                        "locality": "Mountain View",
                        "addressLines": [
                          "1350 Charleston Road"
                        ]
                      },
                      "notes": "Gate code is #111"
                    }
                  }
                },
                "totalPrice": {
                  "type": "ESTIMATE",
                  "amount": {
                    "currencyCode": "USD",
                    "units": "36",
                    "nanos": 730000000
                  }
                },
                "extension": {
                  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
                  "availableFulfillmentOptions": [
                    {
                      "fulfillmentInfo": {
                        "delivery": {
                          "deliveryTimeIso8601": "P0M"
                        }
                      },
                      "expiresAt": "2017-07-17T12:30:00Z"
                    }
                  ]
                }
              },
              "paymentOptions": {
                "googleProvidedOptions": {
                  "facilitationSpecification": "{\"apiVersion\": 2,\"apiVersionMinor\": 0,\"merchantInfo\": {  \"merchantId\": \"Merchant ID\",  \"merchantName\": \"Merchant Name\"},\"allowedPaymentMethods\": [  {    \"type\": \"CARD\",    \"parameters\": {      \"allowedAuthMethods\": [        \"PAN_ONLY\"      ],      \"allowedCardNetworks\": [        \"VISA\",        \"AMEX\",        \"MASTERCARD\"      ],      \"billingAddressRequired\": false    },    \"tokenizationSpecification\": {      \"type\": \"PAYMENT_GATEWAY\",      \"parameters\": {        \"stripe:publishableKey\": \"pk_test_OoPcJNnxI1rDXhBq8BiXO2wz00s1Xc92dA\",        \"gateway\": \"stripe\",        \"stripe:version\": \"2019-05-16\"      }    }  }],\"transactionInfo\": {  \"currencyCode\": \"AUD\",  \"totalPriceStatus\": \"ESTIMATED\",  \"totalPrice\": \"1.0\"}}"
                }
              },
              "additionalPaymentOptions": [
                {
                  "actionProvidedOptions": {
                    "paymentType": "ON_FULFILLMENT",
                    "displayName": "Cash on delivery."
                  }
                }
              ]
            }
          }
        }
      ]
    }
  }
}

Ejemplo 2

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "structuredResponse": {
            "orderUpdate": {
              "actionOrderId": "sample_action_order_id",
              "orderState": {
                "state": "CONFIRMED",
                "label": "Provider confirmed"
              },
              "receipt": {
                "userVisibleOrderId": "userVisibleId1234"
              },
              "updateTime": "2017-07-17T12:00:00Z",
              "orderManagementActions": [
                {
                  "type": "CUSTOMER_SERVICE",
                  "button": {
                    "title": "Contact customer service",
                    "openUrlAction": {
                      "url": "mailto:support@example.com"
                    }
                  }
                },
                {
                  "type": "CUSTOMER_SERVICE",
                  "button": {
                    "title": "Call customer service",
                    "openUrlAction": {
                      "url": "tel:+18005554679"
                    }
                  }
                },
                {
                  "type": "EMAIL",
                  "button": {
                    "title": "Email restaurant",
                    "openUrlAction": {
                      "url": "mailto:person@example.com"
                    }
                  }
                },
                {
                  "type": "CALL_RESTAURANT",
                  "button": {
                    "title": "Call restaurant",
                    "openUrlAction": {
                      "url": "tel:+16505554679"
                    }
                  }
                }
              ],
              "infoExtension": {
                "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension",
                "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z"
              }
            }
          }
        }
      ]
    }
  }
}

Ejemplo 3

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "structuredResponse": {
            "error": {
              "@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
              "foodOrderErrors": [
                {
                  "error": "CLOSED",
                  "description": "The restaurant is closed."
                }
              ]
            }
          }
        }
      ]
    }
  }
}

Ejemplo 4

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "structuredResponse": {
            "checkoutResponse": {
              "proposedOrder": {
                "otherItems": [
                  {
                    "name": "Delivery Fees",
                    "subLines": [],
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "3",
                        "nanos": 500000000
                      }
                    },
                    "type": "DELIVERY"
                  },
                  {
                    "name": "Tax",
                    "subLines": [],
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "1",
                        "nanos": 370000000
                      }
                    },
                    "type": "TAX"
                  },
                  {
                    "name": "Promotion",
                    "subLines": [],
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "-5",
                        "nanos": 0
                      }
                    },
                    "id": "OWG_ACTIVE_CODE",
                    "type": "DISCOUNT"
                  }
                ],
                "cart": {
                  "merchant": {
                    "id": "https://www.exampleprovider.com/merchant/id1",
                    "name": "Falafel Bite"
                  },
                  "lineItems": [
                    {
                      "name": "Pita Chips",
                      "type": "REGULAR",
                      "id": "sample_item_offer_id_1",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "2",
                          "nanos": 750000000
                        }
                      },
                      "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
                      }
                    }
                  ],
                  "promotions": [
                    {
                      "coupon": "OWG_ACTIVE_CODE"
                    }
                  ],
                  "extension": {
                    "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
                    "fulfillmentPreference": {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "P0M"
                        }
                      }
                    }
                  }
                },
                "totalPrice": {
                  "type": "ESTIMATE",
                  "amount": {
                    "currencyCode": "USD",
                    "units": "14",
                    "nanos": 860000000
                  }
                },
                "extension": {
                  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
                  "availableFulfillmentOptions": [
                    {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "P0M"
                        }
                      },
                      "expiresAt": "2018-04-10T01:20:08.471Z"
                    }
                  ]
                }
              },
              "paymentOptions": {
                "googleProvidedOptions": {
                  "tokenizationParameters": {
                    "tokenizationType": "PAYMENT_GATEWAY",
                    "parameters": {
                      "gateway": "stripe",
                      "stripe:publishableKey": "pk_live_stripe_client_key",
                      "stripe:version": "2017-04-06"
                    }
                  },
                  "supportedCardNetworks": [
                    "AMEX",
                    "DISCOVER",
                    "MASTERCARD",
                    "VISA",
                    "JCB"
                  ],
                  "prepaidCardDisallowed": true,
                  "billingAddressRequired": true
                }
              }
            }
          }
        }
      ]
    }
  }
}

CheckoutResponseMessage

Un CheckoutResponseMessage es un AppResponse con un checkoutResponse o error en el StructuredResponse.

SubmitOrderResponseMessage

Un SubmitOrderResponseMessage es un AppResponse con un orderUpdate en StructuredResponse.

FinalResponse

Tu respuesta a la confirmación de la compra del carrito o SubmitOrderRequestMessage.

En la siguiente tabla, se enumeran las propiedades del tipo FinalResponse:

Propiedad Tipo Descripción
richResponse RichResponse

Obligatorio.

Contiene tu respuesta a CheckoutRequestMessage o SubmitOrderRequestMessage.

CheckoutResponse

En la siguiente tabla, se enumeran las propiedades del tipo CheckoutResponse:

Propiedad Tipo Descripción
proposedOrder ProposedOrder

Obligatorio.

Es el orden propuesto para usar en la transacción.

paymentOptions PaymentOptions

Obligatorio.

Es la opción de pago predeterminada que se seleccionó para el usuario.

additionalPaymentOptions List<PaymentOptions>

Son las opciones de pago alternativas disponibles para el usuario.

En el siguiente ejemplo, se muestra un elemento CheckoutResponse:

Ejemplo

{
  "proposedOrder": {
    "id": "sample_proposed_order_id_1",
    "otherItems": [
      {
        "name": "New customer discount",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "-5",
            "nanos": -500000000
          }
        },
        "type": "DISCOUNT"
      },
      {
        "name": "Delivery fee",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "3",
            "nanos": 500000000
          }
        },
        "type": "DELIVERY"
      },
      {
        "name": "Tax",
        "price": {
          "type": "ESTIMATE",
          "amount": {
            "currencyCode": "USD",
            "units": "1",
            "nanos": 500000000
          }
        },
        "type": "TAX"
      }
    ],
    "cart": {
      "merchant": {
        "id": "https://www.exampleprovider.com/merchant/id1",
        "name": "Falafel Bite"
      },
      "lineItems": [
        {
          "name": "Pita Chips",
          "type": "REGULAR",
          "id": "sample_item_offer_id_1",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "2",
              "nanos": 750000000
            }
          },
          "subLines": [
            {
              "note": "Notes for this item."
            }
          ],
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
            "options": [
              {
                "id": "sample_addon_offer_id_1",
                "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                "name": "Honey Mustard",
                "price": {
                  "currencyCode": "USD"
                },
                "quantity": 1
              },
              {
                "id": "sample_addon_offer_id_2",
                "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
                "name": "BBQ Sauce",
                "price": {
                  "currencyCode": "USD",
                  "nanos": 500000000
                },
                "quantity": 1
              }
            ]
          }
        },
        {
          "name": "Chicken Shwarma Wrap",
          "type": "REGULAR",
          "id": "sample_item_offer_id_2",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id2",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "8"
            }
          },
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
          }
        },
        {
          "name": "Greek Salad",
          "type": "REGULAR",
          "id": "sample_item_offer_id_3",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id3",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "9",
              "nanos": 990000000
            }
          },
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
          }
        },
        {
          "name": "Prawns Biryani",
          "type": "REGULAR",
          "id": "sample_item_offer_id_4",
          "offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
          "quantity": 1,
          "price": {
            "type": "ESTIMATE",
            "amount": {
              "currencyCode": "USD",
              "units": "15",
              "nanos": 990000000
            }
          },
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
          }
        }
      ],
      "extension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
        "fulfillmentPreference": {
          "fulfillmentInfo": {
            "delivery": {
              "deliveryTimeIso8601": "P90M"
            }
          }
        },
        "location": {
          "coordinates": {
            "latitude": 37.788783,
            "longitude": -122.41384
          },
          "formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
          "zipCode": "94043",
          "city": "Mountain View",
          "postalAddress": {
            "regionCode": "US",
            "postalCode": "94043",
            "administrativeArea": "CA",
            "locality": "Mountain View",
            "addressLines": [
              "1350 Charleston Road"
            ]
          },
          "notes": "Gate code is #111"
        }
      }
    },
    "totalPrice": {
      "type": "ESTIMATE",
      "amount": {
        "currencyCode": "USD",
        "units": "36",
        "nanos": 730000000
      }
    },
    "extension": {
      "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
      "availableFulfillmentOptions": [
        {
          "fulfillmentInfo": {
            "delivery": {
              "deliveryTimeIso8601": "P0M"
            }
          },
          "expiresAt": "2017-07-17T12:30:00Z"
        }
      ]
    }
  },
  "paymentOptions": {
    "googleProvidedOptions": {
      "facilitationSpecification": "{\"apiVersion\": 2,\"apiVersionMinor\": 0,\"merchantInfo\": {  \"merchantId\": \"Merchant ID\",  \"merchantName\": \"Merchant Name\"},\"allowedPaymentMethods\": [  {    \"type\": \"CARD\",    \"parameters\": {      \"allowedAuthMethods\": [        \"PAN_ONLY\"      ],      \"allowedCardNetworks\": [        \"VISA\",        \"AMEX\",        \"MASTERCARD\"      ],      \"billingAddressRequired\": false    },    \"tokenizationSpecification\": {      \"type\": \"PAYMENT_GATEWAY\",      \"parameters\": {        \"stripe:publishableKey\": \"pk_test_OoPcJNnxI1rDXhBq8BiXO2wz00s1Xc92dA\",        \"gateway\": \"stripe\",        \"stripe:version\": \"2019-05-16\"      }    }  }],\"transactionInfo\": {  \"currencyCode\": \"AUD\",  \"totalPriceStatus\": \"ESTIMATED\",  \"totalPrice\": \"1.0\"}}"
    }
  },
  "additionalPaymentOptions": [
    {
      "actionProvidedOptions": {
        "paymentType": "ON_FULFILLMENT",
        "displayName": "Cash on delivery."
      }
    }
  ]
}

Elemento

Contiene tu respuesta a la confirmación de la compra del carrito o a SubmitOrderRequestMessage.

En la siguiente tabla, se enumeran las propiedades del tipo Item:

Propiedad Tipo Descripción
structuredResponse StructuredResponse

Obligatorio.

RichResponse

Contiene tu respuesta a la confirmación de compra de un carrito.

En la siguiente tabla, se enumeran las propiedades del tipo RichResponse:

Propiedad Tipo Descripción
items List<Item>

Obligatorio.

Debe tener exactamente 1 elemento.

StructuredResponse

Para CheckoutResponseMessage, puede ser uno de los siguientes: CheckoutResponse Indica que se realizó una confirmación de la compra correctamente. O FoodErrorExtension: Indica una falla durante la confirmación de la compra. La respuesta puede incluir un ProposedOrder y PaymentOptions corregidos, o bien un mensaje de error sin PaymentOptions. Para SubmitOrderResponseMessage, solo se aplica orderUpdate.

En la siguiente tabla, se enumeran las propiedades del tipo StructuredResponse:

Propiedad Tipo Descripción
Se requiere exactamente uno de los siguientes grupos de propiedades.
checkoutResponse Grupo 1 CheckoutResponse

Artículos prestados, más impuestos y descuentos.

error Grupo 2 FoodErrorExtension

Se observaron errores en los artículos del carrito. Según la naturaleza del error, esta propiedad puede incluir un ProposedOrder y PaymentOptions corregidos, o solo un mensaje de error sin PaymentOptions.

orderUpdate Grupo 3 OrderUpdate

Actualizaciones de pedidos asíncronas

En esta sección, se describen los tipos de alto nivel que conforman las solicitudes y respuestas de una interacción típica de acción integrada de pedido de comida.

AsyncOrderUpdateRequestMessage

Notifica al usuario sobre los cambios después de que se envía y confirma un pedido. Por ejemplo, puedes notificarle al usuario que el pedido está en tránsito o si cambió el precio. Para obtener más información, consulta

En la siguiente tabla, se enumeran las propiedades del tipo AsyncOrderUpdateRequestMessage:

Propiedad Tipo Descripción
isInSandbox Booleano

Indica que el pedido para el que se envió esta actualización es un pago de zona de pruebas.

customPushMessage CustomPushMessage

Obligatorio.

Contiene el objeto OrderUpdate de la solicitud.

En el siguiente ejemplo, se muestra un elemento AsyncOrderUpdateRequestMessage:

Ejemplo

{
  "isInSandbox": true,
  "customPushMessage": {
    "orderUpdate": {
      "actionOrderId": "sample_action_order_id",
      "orderState": {
        "state": "IN_TRANSIT",
        "label": "Order is on the way"
      },
      "inTransitInfo": {
        "updatedTime": "2017-07-17T12:00:00Z"
      },
      "updateTime": "2017-07-17T12:00:00Z",
      "receipt": {
        "userVisibleOrderId": "userVisibleId1234"
      },
      "orderManagementActions": [
        {
          "type": "CUSTOMER_SERVICE",
          "button": {
            "title": "Contact customer service",
            "openUrlAction": {
              "url": "mailto:support@example.com"
            }
          }
        },
        {
          "type": "EMAIL",
          "button": {
            "title": "Email restaurant",
            "openUrlAction": {
              "url": "mailto:person@example.com"
            }
          }
        },
        {
          "type": "CALL_RESTAURANT",
          "button": {
            "title": "Call restaurant",
            "openUrlAction": {
              "url": "tel:+16505554679"
            }
          }
        }
      ],
      "infoExtension": {
        "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension",
        "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z"
      }
    }
  }
}

AsyncOrderUpdateResponseMessage

Después de enviar correctamente un AsyncOrderUpdateRequestMessage, Google responde con un estado HTTP 200 y un cuerpo vacío. Si la actualización no se realizó correctamente, Google responde con detalles sobre por qué no se pudo actualizar el pedido.

Tipos de actualizaciones de pedidos

Botón

Define un elemento de interfaz de usuario que puedes agregar para proporcionar interacción del usuario.

En la siguiente tabla, se enumeran las propiedades del tipo Button:

Propiedad Tipo Descripción
title String

Obligatorio.

Es la etiqueta visible. Usa mayúsculas de oración con 30 caracteres o menos para garantizar una renderización adecuada.

Ejemplo: Contact us

openUrlAction OpenUrlAction

Obligatorio.

En el siguiente ejemplo, se muestra un elemento Button:

Ejemplo

{
  "title": "Send us feedback",
  "openUrlAction": {
    "url": "mailto:person@example.com"
  }
}

CancellationInfo

En la siguiente tabla, se enumeran las propiedades del tipo CancellationInfo:

Propiedad Tipo Descripción
reason String

Obligatorio.

Es el motivo del rechazo que se puede mostrar cuando OrderState.state es "CANCELLED".

Ejemplo: Restaurant closed

En el siguiente ejemplo, se muestra un elemento CancellationInfo:

Ejemplo

{
  "reason": "Insufficient inventory"
}

FoodOrderUpdateExtension

Este tipo le proporciona al usuario un intervalo estimado para el momento en que se entregará el pedido o estará listo para retirarlo. Envía esta extensión en un OrderUpdate cada vez que la información esté disponible o haya cambiado desde la última vez que se envió.

Proporciona una estimación conservadora del intervalo de entrega para que se cumplan las expectativas de los usuarios de forma coherente. Por ejemplo, si se estima que el pedido se entregará hoy a las 13:00, debes enviar un intervalo estimado que sea coherente con las variaciones debido a las condiciones de tráfico, como hoy de 12:45 a 13:15.

Una duración o marca de tiempo ISO 8601 se interpreta como el intervalo desde el updateTime de OrderUpdate (en esencia, "ahora") hasta el updateTime más duration. No uses este formato, a menos que "ahora" sea una expectativa razonable.

Un intervalo ISO 8601 se interpreta como el intervalo desde el inicio hasta el final del intervalo.

En la siguiente tabla, se enumeran las propiedades del tipo FoodOrderUpdateExtension:

Propiedad Tipo Descripción
@type Const

Es el tipo de esta extensión. Este campo siempre se establece en "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension".

Valor: type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension

estimatedFulfillmentTimeIso8601 String

Es la hora estimada en la que se entregará el pedido o estará listo para retirarlo. La cadena debe estar en formato ISO 8601 y debe corresponder a un intervalo en lugar de un horario fijo. Las convenciones aceptables son: Intervalos, Duraciones y Fechas/Horas. Este campo se puede enviar en SubmitOrderResponseMessage o AsyncOrderUpdateRequestMessage cuando la información esté disponible o haya un cambio, como llegadas anticipadas o demoradas.

Ejemplo: 2017-07-17T13:00:00Z/2017-07-17T13:30:00Z

foodOrderErrors List<FoodOrderError>

Describe los errores que se produjeron después del pedido. Se recomienda un error por carrito o por artículo. Usa FoodOrderUpdateExtension.FoodOrderErrors para cualquier error que no esté cubierto por RejectionInfo.

Debe tener al menos 1 elemento.

En el siguiente ejemplo, se muestra un elemento FoodOrderUpdateExtension:

Ejemplo 1

{
  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension",
  "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z"
}

Ejemplo 2

{
  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension",
  "foodOrderErrors": [
    {
      "error": "NO_CAPACITY",
      "description": "Sorry, the restaurant cannot take your order right now."
    }
  ]
}

FulfillmentInfo

En la siguiente tabla, se enumeran las propiedades del tipo FulfillmentInfo:

Propiedad Tipo Descripción
Se requiere exactamente uno de los siguientes grupos de propiedades.
deliveryTime Grupo 1 Marca de tiempo ISO

Usa estimatedFulfillmentTimeIso8601 en el mensaje FoodOrderingUpdateExtension

pickupTime Grupo 2 Marca de tiempo ISO

Usa estimatedFulfillmentTimeIso8601 en el mensaje FoodOrderingUpdateExtension

En el siguiente ejemplo, se muestra un elemento FulfillmentInfo:

Ejemplo 1

{
  "deliveryTime": "2017-05-10T02:36:38.803Z"
}

Ejemplo 2

{
  "pickupTime": "2019-12-26T07:24:27.803Z"
}

InTransitInfo

En la siguiente tabla, se enumeran las propiedades del tipo InTransitInfo:

Propiedad Tipo Descripción
updatedTime Marca de tiempo ISO

Usa estimatedFulfillmentTimeIso8601 en el mensaje FoodOrderingUpdateExtension

En el siguiente ejemplo, se muestra un elemento InTransitInfo:

Ejemplo

{
  "updatedTime": "2017-05-10T02:36:38.803Z"
}

LineItemUpdate

En la siguiente tabla, se enumeran las propiedades del tipo LineItemUpdate:

Propiedad Tipo Descripción
orderState OrderState
price Price
reason String

Motivo del cambio. Obligatorio para los cambios de precio.

En el siguiente ejemplo, se muestra un elemento LineItemUpdate:

Ejemplo

{
  "orderState": {
    "state": "CONFIRMED",
    "label": "Provider confirmed"
  },
  "price": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "5",
      "nanos": 500000000
    }
  },
  "reason": "Menu updated prices."
}

OpenUrlAction

En la siguiente tabla, se enumeran las propiedades del tipo OpenUrlAction:

Propiedad Tipo Descripción
url String

Obligatorio.

Es la acción que se activa cuando se hace clic en el botón o se lo toca. La lista de prefijos aplicables depende de orderManagementActionType. "EMAIL": El prefijo debe ser "mailto". "CALL": El prefijo debe ser "tel". "CUSTOMER_SERVICE": El prefijo debe ser "mailto", "tel", "http" o "https".

Ejemplo: https://www.google.com

OrderManagementAction

La administración de pedidos permite que los usuarios obtengan asistencia posterior a la compra y se debe enviar en cada OrderUpdate dentro del pedido enviado AppResponse y en cada AsyncOrderUpdateRequestMessage posterior. Las acciones de administración de pedidos que se envían para un pedido en particular pueden variar según el estado.

Por ejemplo, en el estado "CREATED", CUSTOMER_SERVICE podría hacer referencia a tu teléfono de asistencia al cliente. Luego, en el estado "CONFIRMED", CUSTOMER_SERVICE puede cambiar al teléfono del restaurante si ese se convierte en el mejor punto de contacto para el cliente. De manera similar, una vez que el pedido esté en el estado “COMPLETADO”, CUSTOMER_SERVICE podrá consultar tu dirección de correo electrónico de asistencia.

En la siguiente tabla, se enumeran las propiedades del tipo OrderManagementAction:

Propiedad Tipo Descripción
type OrderManagementActionType

Obligatorio.

button Button

Obligatorio.

En el siguiente ejemplo, se muestra un elemento OrderManagementAction:

Ejemplo 1

{
  "type": "CUSTOMER_SERVICE",
  "button": {
    "title": "Contact customer service",
    "openUrlAction": {
      "url": "mailto:support@example.com"
    }
  }
}

Ejemplo 2

{
  "type": "EMAIL",
  "button": {
    "title": "Email restaurant",
    "openUrlAction": {
      "url": "mailto:person@example.com"
    }
  }
}

OrderManagementActionType

Define los tipos relacionados con OrderManagementAction.

El tipo OrderManagementActionType tiene los siguientes valores posibles:

  • CUSTOMER_SERVICE: Es el correo electrónico o número de contacto del servicio de atención al cliente que se mostrará en la página de confirmación del pedido. Este campo es obligatorio. El prefijo de openUrlAction.url debe ser "mailto", "tel", "http" o "https".
  • EMAIL: Acción de correo electrónico solo en la página de detalles del pedido. El prefijo openUrlAction.url debe ser "mailto".
  • CALL_DRIVER: Llamada a la acción solo en la página de detalles del pedido. El prefijo openUrlAction.url debe ser "tel".
  • CALL_RESTAURANT: Llamada a la acción solo en la página de detalles del pedido. El prefijo openUrlAction.url debe ser "tel".

OrderState

Es el estado actual del pedido. Cada valor state de OrderState también corresponde a un estado de compra en myaccount.google.com.

En la siguiente tabla, se enumeran las propiedades del tipo OrderState:

Propiedad Tipo Descripción
state OrderStateEnum

Obligatorio.

label String

Obligatorio.

Es la cadena de visualización visible para el usuario del estado. Usa mayúscula inicial.

Ejemplo: Your order has been received

En el siguiente ejemplo, se muestra un elemento OrderState:

Ejemplo

{
  "state": "CONFIRMED",
  "label": "Provider confirmed"
}

OrderStateEnum

Define los tipos relacionados con OrderState.

El tipo OrderStateEnum tiene los siguientes valores posibles:

  • CREATED: El integrador creó el pedido y está esperando la confirmación del proveedor. Corresponde al estado de compra "Enviado".
  • CONFIRMED: El proveedor confirmó el pedido y está activo. Corresponde al estado de compra "Aceptada".
  • REJECTED: El integrador o el proveedor rechazó el pedido. Corresponde al estado de compra "Rechazado".
  • CANCELLED: El usuario canceló el pedido. Corresponde al estado de compra "Cancelada".
  • IN_PREPARATION: Se está preparando la comida. Corresponde al estado de compra "Estado desconocido".
  • READY_FOR_PICKUP: La comida está lista para retirarla. Corresponde al estado de compra "Listo para retirar".
  • IN_TRANSIT: El pedido se está entregando. Corresponde al estado de compra "En proceso".
  • FULFILLED: El usuario recibió lo que pidió. Corresponde al estado de compra "Retirado".

Recibo

Envía este tipo en un pedido de envío AppResponse, en el que OrderState sea “CONFIRMED”, “FULFILLED” o “IN_TRANSIT”. Envía el recibo cuando userVisibleOrderId esté disponible. No es necesario que sigas enviando el recibo en actualizaciones posteriores.

En la siguiente tabla, se enumeran las propiedades del tipo Receipt:

Propiedad Tipo Descripción
userVisibleOrderId String

Obligatorio.

Obligatorio si el estado del pedido es "CONFIRMED", "IN_TRANSIT" o "FULFILLED". Este campo es el único ID para el usuario de este pedido (por lo general, el ID del pedido del restaurante) que se muestra en el recibo del integrador y en la tarjeta de pedido de Google. El usuario debe poder usar este ID para consultar su pedido en el servicio de atención al cliente con el proveedor y el integrador. Solo debes proporcionar este ID una vez en cualquier OrderUpdate determinado. Hasta que se proporcione, el actionOrderId es el userVisibleOrderId. Por ejemplo, es posible que no tengas un userVisibleOrderId hasta que el restaurante confirme el pedido. Una vez que se confirme, debes enviar un AsyncOrderUpdateRequestMessage con un OrderUpdate y un Receipt.

En el siguiente ejemplo, se muestra un elemento Receipt:

Ejemplo

{
  "userVisibleOrderId": "userVisibleId1234"
}

RejectionInfo

En la siguiente tabla, se enumeran las propiedades del tipo RejectionInfo:

Propiedad Tipo Descripción
type RejectionType

Obligatorio.

reason String

Es el motivo del rechazo que se usa para el registro interno. Los usuarios no pueden ver este campo.

En el siguiente ejemplo, se muestra un elemento RejectionInfo:

Ejemplo

{
  "type": "PAYMENT_DECLINED",
  "reason": "There is an issue with payment processing."
}

RejectionType

El tipo RejectionType tiene los siguientes valores posibles:

  • INELIGIBLE: El usuario no es apto debido a problemas relacionados con políticas o riesgos.
  • PAYMENT_DECLINED: Hay un problema con el procesamiento del pago.
  • UNAVAILABLE_SLOT: El pedido no se puede entregar en el horario de pedido anticipado especificado por DeliveryInfo o PickupInfo.
  • PROMO_NOT_APPLICABLE: Hay un problema con la promoción.
  • UNKNOWN: Cualquier otro motivo

Tipos relacionados con pagos

En esta sección, se describen los tipos relacionados con los pagos que se usan para la entrega de pedidos de comida.

ActionProvidedPaymentOptions

Requisitos para una forma de pago proporcionada por una acción

En la siguiente tabla, se enumeran las propiedades del tipo ActionProvidedPaymentOptions:

Propiedad Tipo Descripción
paymentType PaymentType

Obligatorio.

displayName String

Obligatorio.

Es el nombre del instrumento de pago que se muestra en el recibo.

Ejemplo: Taco Points Total

onFulfillmentPaymentData OnFulfillmentPaymentData

Datos adicionales para el paymentType "ON_FULFILLMENT". Por ejemplo, puedes usar este campo para especificar si se admite efectivo o tarjeta en la entrega.

En el siguiente ejemplo, se muestra un elemento ActionProvidedPaymentOptions:

Ejemplo

{
  "paymentType": "ON_FULFILLMENT",
  "displayName": "Pay when you get your food.",
  "onFulfillmentPaymentData": {
    "supportedPaymentOptions": [
      "Cash",
      "Card"
    ]
  }
}

AllowedAuthMethods

El tipo AllowedAuthMethods tiene los siguientes valores posibles:

  • PAN_ONLY: Es el método de autenticación asociado con las tarjetas de pago almacenadas en la Cuenta de Google del usuario. Los datos de pago que se devuelven incluyen el número de cuenta personal (PAN) con el mes y el año de vencimiento.

AllowedCardNetworks

El tipo AllowedCardNetworks tiene los siguientes valores posibles:

  • AMEX
  • DISCOVER
  • INTERAC
  • JCB
  • MASTERCARD
  • VISA

BillingAddressParameters

Este objeto te permite establecer campos adicionales que se mostrarán para una dirección de facturación solicitada.

En la siguiente tabla, se enumeran las propiedades del tipo BillingAddressParameters:

Propiedad Tipo Descripción
format String

Formato de dirección de facturación obligatorio para completar la transacción. MÍNIMO: Nombre, código de país y código postal. COMPLETO: Nombre, dirección, localidad, región, código de país y código postal.

En el siguiente ejemplo, se muestra un elemento BillingAddressParameters:

Ejemplo 1

{
  "format": "MIN"
}

Ejemplo 2

{
  "format": "FULL"
}

CardParameters

Usa este objeto para configurar la compatibilidad de tu sitio con la API de Google Pay.

En la siguiente tabla, se enumeran las propiedades del tipo CardParameters:

Propiedad Tipo Descripción
allowedAuthMethods List<Const>

Obligatorio.

Campos admitidos para autenticar una transacción con tarjeta.

Debe tener al menos 1 elemento.

allowedCardNetworks List<AllowedCardNetworks>

Obligatorio.

Una o más redes de tarjetas que admitas y que también sean compatibles con la API de Google Pay.

Debe tener al menos 1 elemento.

billingAddressRequired Booleano

Establece este valor en verdadero si necesitas una dirección de facturación. Solo solicita una dirección de facturación si es necesaria para procesar la transacción. Las solicitudes de datos adicionales pueden aumentar los inconvenientes en el proceso de confirmación de la compra y generar porcentajes de conversiones más bajos.

billingAddressParameters BillingAddressParameters

Son los campos esperados que se muestran si billingAddressRequired se establece como verdadero.

cvcRequired Booleano

Se establece como verdadero si se usa TimesofMoney y como falso para todos los demás procesadores de pagos.

En el siguiente ejemplo, se muestra un elemento CardParameters:

Ejemplo 1

{
  "allowedAuthMethods": [
    "PAN_ONLY"
  ],
  "allowedCardNetworks": [
    "AMEX",
    "DISCOVER"
  ],
  "billingAddressRequired": false,
  "cvcRequired": false
}

Ejemplo 2

{
  "allowedAuthMethods": [
    "PAN_ONLY"
  ],
  "allowedCardNetworks": [
    "AMEX",
    "DISCOVER"
  ],
  "billingAddressRequired": true,
  "billingAddressParameters": {
    "format": "MIN"
  },
  "cvcRequired": false
}

GoogleProvidedPaymentInstrument

En la siguiente tabla, se enumeran las propiedades del tipo GoogleProvidedPaymentInstrument:

Propiedad Tipo Descripción
instrumentToken String

Obligatorio.

Es una cadena codificada en base 64 que contiene el token de pago para cobrarle al usuario con un procesador de Google Pay participante, según las GoogleProvidedPaymentOptions especificadas anteriormente.

billingAddress PostalAddress

Dirección de facturación del pago

En el siguiente ejemplo, se muestra un elemento GoogleProvidedPaymentInstrument:

Ejemplo

{
  "instrumentToken": "abcd",
  "billingAddress": {
    "regionCode": "US",
    "postalCode": "94043",
    "administrativeArea": "CA",
    "locality": "Mountain View",
    "addressLines": [
      "1350 Charleston Road"
    ]
  }
}

GoogleProvidedPaymentOptions

Requisitos para la forma de pago proporcionada por Google

En la siguiente tabla, se enumeran las propiedades del tipo GoogleProvidedPaymentOptions:

Propiedad Tipo Descripción
facilitationSpecification String

Un JSON de PaymentDataRequest como una cadena. Usa este objeto para configurar la compatibilidad de tu sitio con la API de Google Pay.

supportedCardNetworks List<SupportedCardNetworks>

En su lugar, usa facilitationSpecification. Es el tipo de redes de tarjetas que admite el agente.

Este campo dejó de estar disponible.

prepaidCardDisallowed Booleano

En su lugar, usa facilitationSpecification. Indica si se permite o no una tarjeta prepagada como tipo de pago.

Este campo dejó de estar disponible.

billingAddressRequired Booleano

En su lugar, usa facilitationSpecification. Indica si se requiere o no una dirección de facturación.

Este campo dejó de estar disponible.

tokenizationParameters TokenizationParameters

Este campo dejó de estar disponible.

En el siguiente ejemplo, se muestra un elemento GoogleProvidedPaymentOptions:

Ejemplo 1

{
  "facilitationSpecification": "{\"apiVersion\": 2,\"apiVersionMinor\": 0,\"merchantInfo\": {  \"merchantId\": \"Merchant ID\",  \"merchantName\": \"Merchant Name\"},\"allowedPaymentMethods\": [  {    \"type\": \"CARD\",    \"parameters\": {      \"allowedAuthMethods\": [        \"PAN_ONLY\"      ],      \"allowedCardNetworks\": [        \"VISA\",        \"AMEX\",        \"MASTERCARD\"      ],      \"billingAddressRequired\": false    },    \"tokenizationSpecification\": {      \"type\": \"PAYMENT_GATEWAY\",      \"parameters\": {        \"stripe:publishableKey\": \"pk_test_OoPcJNnxI1rDXhBq8BiXO2wz00s1Xc92dA\",        \"gateway\": \"stripe\",        \"stripe:version\": \"2019-05-16\"      }    }  }],\"transactionInfo\": {  \"currencyCode\": \"AUD\",  \"totalPriceStatus\": \"ESTIMATED\",  \"totalPrice\": \"1.0\"}}"
}

Ejemplo 2

{
  "tokenizationParameters": {
    "tokenizationType": "PAYMENT_GATEWAY",
    "parameters": {
      "gateway": "braintree",
      "braintree:apiVersion": "v1",
      "braintree:sdkVersion": "1.4.0",
      "braintree:merchantId": "a1b2c3d4e5",
      "braintree:clientKey": "production_braintree_client_key",
      "braintree:authorizationFingerprint": "same_as_client_key"
    }
  },
  "supportedCardNetworks": [
    "AMEX",
    "DISCOVER",
    "MASTERCARD",
    "JCB",
    "VISA"
  ],
  "prepaidCardDisallowed": true
}

Ejemplo 3

{
  "tokenizationParameters": {
    "tokenizationType": "PAYMENT_GATEWAY",
    "parameters": {
      "gateway": "stripe",
      "stripe:publishableKey": "pk_live_stripe_client_key",
      "stripe:version": "2017-04-06"
    }
  },
  "supportedCardNetworks": [
    "AMEX",
    "DISCOVER",
    "MASTERCARD",
    "VISA",
    "JCB"
  ],
  "prepaidCardDisallowed": true,
  "billingAddressRequired": true
}

MerchantInfo

Usa este objeto para configurar la compatibilidad de tu sitio con la API de Google Pay.

En la siguiente tabla, se enumeran las propiedades del tipo MerchantInfo:

Propiedad Tipo Descripción
merchantId String

Es el identificador de comerciante de Google que te emitió Google Pay.

merchantName String

Obligatorio.

Es el nombre del comercio codificado como UTF-8. El nombre del comercio se renderiza en la hoja de pagos.

OnFulfillmentPaymentData

Usa este objeto para enviar datos adicionales para el tipo de pago "ON_FULFILLMENT".

En la siguiente tabla, se enumeran las propiedades del tipo OnFulfillmentPaymentData:

Propiedad Tipo Descripción
supportedPaymentOptions List<PaymentOptionsEnums>

Es la lista de opciones de pago disponibles para el usuario en el momento de la entrega del pedido.

En el siguiente ejemplo, se muestra un elemento OnFulfillmentPaymentData:

Ejemplo

{
  "supportedPaymentOptions": [
    "Cash",
    "Card"
  ]
}

Parámetros

Define los tipos relacionados con TokenizationParameters.

En la siguiente tabla, se enumeran las propiedades del tipo Parameters:

Propiedad Tipo Descripción
gateway String

Obligatorio.

Ejemplo: braintree

gatewayMerchantId String
[additionalKey: string] String Pares clave-valor adicionales

En el siguiente ejemplo, se muestra un elemento Parameters:

Ejemplo 1

{
  "gatewayMerchantId": "90412491",
  "gateway": "olo"
}

Ejemplo 2

{
  "gateway": "braintree",
  "braintree:apiVersion": "v1",
  "braintree:sdkVersion": "1.4.0",
  "braintree:merchantId": "YOUR_MERCHANT_ID",
  "braintree:clientKey": "YOUR_BRAINTREE_SANDVOX_OR_PRODUCTION_KEY"
}

PaymentDataRequest

Usa este objeto para configurar la compatibilidad de tu sitio con la API de Google Pay.

En la siguiente tabla, se enumeran las propiedades del tipo PaymentDataRequest:

Propiedad Tipo Descripción
apiVersion Const

Obligatorio.

Versión principal de la API.

Valor: 2

apiVersionMinor Const

Obligatorio.

Versión secundaria de la API.

Valor: 0

merchantInfo MerchantInfo

Obligatorio.

(ID del comercio de Google Pay) Es la información del comercio que solicita datos de pago.

allowedPaymentMethods List<PaymentMethod>

Obligatorio.

Especifica la compatibilidad con una o más formas de pago que admite la API de Google Pay.

transactionInfo TransactionInfo

Obligatorio.

Detalles sobre la autorización de la transacción según si el usuario acepta o no la transacción. Este campo incluye el precio total y el estado del precio.

En el siguiente ejemplo, se muestra un elemento PaymentDataRequest:

Ejemplo

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "merchantInfo": {
    "merchantId": "10391231",
    "merchantName": "Burrito Town"
  },
  "allowedPaymentMethods": [
    {
      "type": "CARD",
      "parameters": {
        "allowedAuthMethods": [
          "PAN_ONLY"
        ],
        "allowedCardNetworks": [
          "VISA",
          "AMEX",
          "MASTERCARD"
        ],
        "billingAddressRequired": true,
        "billingAddressParameters": {
          "format": "FULL"
        },
        "cvcRequired": false
      },
      "tokenizationSpecification": {
        "type": "PAYMENT_GATEWAY",
        "parameters": {
          "gateway": "stripe",
          "stripe:version": "2019-05-16",
          "stripe:publishableKey": "pk_test_OoPcJNnxI1rDXhBq8BiXO2wz00s1Xc92dA"
        }
      }
    }
  ],
  "transactionInfo": {
    "currencyCode": "INR",
    "totalPriceStatus": "ESTIMATED",
    "totalPrice": "185.00"
  }
}

PaymentInfo

Es la información relacionada con el pago de un pedido.

En la siguiente tabla, se enumeran las propiedades del tipo PaymentInfo:

Propiedad Tipo Descripción
displayName String

Obligatorio.

Es el nombre visible para el usuario del instrumento de pago que se mostrará en el recibo.

paymentType PaymentType

Obligatorio.

googleProvidedPaymentInstrument GoogleProvidedPaymentInstrument

Es el token que puede usar la acción. Especifica esto solo si especificaste GoogleProvidedPaymentOptions como opción de pago en CheckoutResponseMessage.

En el siguiente ejemplo, se muestra un elemento PaymentInfo:

Ejemplo 1

{
  "displayName": "Visa\u2006****\u20061111",
  "googleProvidedPaymentInstrument": {
    "instrumentToken": "abcd"
  },
  "paymentType": "PAYMENT_CARD"
}

Ejemplo 2

{
  "displayName": "Visa\u2006****\u20061111",
  "googleProvidedPaymentInstrument": {
    "instrumentToken": "abcd",
    "billingAddress": {
      "regionCode": "US",
      "postalCode": "94043",
      "administrativeArea": "CA",
      "locality": "Mountain View",
      "addressLines": [
        "123 Random Street",
        "Unit ABC"
      ],
      "recipients": [
        "sample_receipient"
      ]
    }
  },
  "paymentType": "PAYMENT_CARD"
}

PaymentMethod

Usa este objeto para configurar la compatibilidad de tu sitio con la API de Google Pay.

En la siguiente tabla, se enumeran las propiedades del tipo PaymentMethod:

Propiedad Tipo Descripción
type Const

Obligatorio.

Es un identificador breve para la forma de pago admitida. Por el momento, solo se admite CARD.

Valor: CARD

parameters CardParameters

Obligatorio.

Son los parámetros necesarios para configurar el tipo de forma de pago proporcionada.

tokenizationSpecification TokenizationSpecification

Obligatorio.

Configura una cuenta o un proveedor de desencriptación para recibir información de pago. Esta propiedad es obligatoria para la forma de pago CARD.

En el siguiente ejemplo, se muestra un elemento PaymentMethod:

Ejemplo

{
  "type": "CARD",
  "parameters": {
    "allowedAuthMethods": [
      "PAN_ONLY"
    ],
    "allowedCardNetworks": [
      "VISA",
      "AMEX",
      "MASTERCARD"
    ],
    "billingAddressRequired": false
  },
  "tokenizationSpecification": {
    "type": "PAYMENT_GATEWAY",
    "parameters": {
      "gatewayMerchantId": "90412491",
      "gateway": "olo"
    }
  }
}

PaymentOptions

En la siguiente tabla, se enumeran las propiedades del tipo PaymentOptions:

Propiedad Tipo Descripción
Se requiere exactamente uno de los siguientes grupos de propiedades.
googleProvidedOptions Grupo 1 GoogleProvidedPaymentOptions

Son mutuamente excluyentes con actionProvidedOptions. Úsala para realizar pagos en línea con gPay.

actionProvidedOptions Grupo 2 ActionProvidedPaymentOptions

Es mutuamente excluyente con googleProvidedOptions. Úsala para "contrareembolso" o "pago al momento de la entrega".

En el siguiente ejemplo, se muestra un elemento PaymentOptions:

Ejemplo 1

{
  "googleProvidedOptions": {
    "facilitationSpecification": "{\"apiVersion\": 2,\"apiVersionMinor\": 0,\"merchantInfo\": {  \"merchantId\": \"Merchant ID\",  \"merchantName\": \"Merchant Name\"},\"allowedPaymentMethods\": [  {    \"type\": \"CARD\",    \"parameters\": {      \"allowedAuthMethods\": [        \"PAN_ONLY\"      ],      \"allowedCardNetworks\": [        \"VISA\",        \"AMEX\",        \"MASTERCARD\"      ],      \"billingAddressRequired\": false    },    \"tokenizationSpecification\": {      \"type\": \"PAYMENT_GATEWAY\",      \"parameters\": {        \"stripe:publishableKey\": \"pk_test_OoPcJNnxI1rDXhBq8BiXO2wz00s1Xc92dA\",        \"gateway\": \"stripe\",        \"stripe:version\": \"2019-05-16\"      }    }  }],\"transactionInfo\": {  \"currencyCode\": \"AUD\",  \"totalPriceStatus\": \"ESTIMATED\",  \"totalPrice\": \"1.0\"}}"
  }
}

Ejemplo 2

{
  "googleProvidedOptions": {
    "facilitationSpecification": "{\"apiVersion\": 2,\"apiVersionMinor\": 0,\"merchantInfo\": {  \"merchantId\": \"Merchant ID\",  \"merchantName\": \"Merchant Name\"},\"allowedPaymentMethods\": [  {    \"type\": \"CARD\",    \"parameters\": {      \"allowedAuthMethods\": [        \"PAN_ONLY\"      ],      \"allowedCardNetworks\": [        \"VISA\",        \"AMEX\",        \"MASTERCARD\"      ],      \"billingAddressRequired\":true,   \"billingAddressParameters\": {  \"format\":\"MIN\"  }    },    \"tokenizationSpecification\": {      \"type\": \"PAYMENT_GATEWAY\",      \"parameters\": {        \"stripe:publishableKey\": \"pk_test_OoPcJNnxI1rDXhBq8BiXO2wz00s1Xc92dA\",        \"gateway\": \"stripe\",        \"stripe:version\": \"2019-05-16\"      }    }  }],\"transactionInfo\": {  \"currencyCode\": \"AUD\",  \"totalPriceStatus\": \"ESTIMATED\",  \"totalPrice\": \"1.0\"}}"
  }
}

Ejemplo 3

{
  "actionProvidedOptions": {
    "paymentType": "ON_FULFILLMENT",
    "displayName": "Pay when you get your food.",
    "onFulfillmentPaymentData": {
      "supportedPaymentOptions": [
        "Cash",
        "Card"
      ]
    }
  }
}

PaymentOptionsEnums

El tipo PaymentOptionsEnums tiene los siguientes valores posibles:

  • Cash
  • Card
  • UPI
  • Paytm

PaymentType

El tipo PaymentType tiene los siguientes valores posibles:

  • PAYMENT_CARD: Para GoogleProvidedPaymentOptions.
  • ON_FULFILLMENT: Para ActionProvidedPaymentOptions.

SupportedCardNetworks

Define los tipos relacionados con GoogleProvidedPaymentOptions.

El tipo SupportedCardNetworks tiene los siguientes valores posibles:

  • UNSPECIFIED_CARD_NETWORK
  • AMEX
  • DISCOVER
  • JCB
  • MASTERCARD
  • VISA

TokenizationParameters

Define los tipos relacionados con GoogleProvidedPaymentOptions.

En la siguiente tabla, se enumeran las propiedades del tipo TokenizationParameters:

Propiedad Tipo Descripción
tokenizationType Enum [ "UNSPECIFIED_TOKENIZATION_TYPE", "PAYMENT_GATEWAY" ]

Obligatorio.

En su lugar, usa facilitationSpecification. Tipo de tokens aceptados

parameters Parameters

En su lugar, usa facilitationSpecification.

TokenizationSpecification

Este objeto te permite configurar una cuenta para recibir información de pago que se pueda cobrar.

En la siguiente tabla, se enumeran las propiedades del tipo TokenizationSpecification:

Propiedad Tipo Descripción
type Const

Obligatorio.

parameters Parameters

Obligatorio.

En el siguiente ejemplo, se muestra un elemento TokenizationSpecification:

Ejemplo 1

{
  "type": "PAYMENT_GATEWAY",
  "parameters": {
    "gatewayMerchantId": "1247192",
    "gateway": "cybersource"
  }
}

Ejemplo 2

{
  "type": "PAYMENT_GATEWAY",
  "parameters": {
    "gateway": "stripe",
    "stripe:version": "2018-10-31",
    "stripe:publishableKey": "12378127"
  }
}

TransactionInfo

Este objeto describe una transacción que determina la capacidad de pago de un pagador. Se usa para presentar un diálogo de autorización de pago.

En la siguiente tabla, se enumeran las propiedades del tipo TransactionInfo:

Propiedad Tipo Descripción
currencyCode String

Obligatorio.

Es el código alfabético de moneda ISO 4217.

transactionId String

Es un ID único que identifica un intento de transacción. Los comercios pueden usar un ID existente o generar uno específico para los intentos de transacciones de Google Pay. Este campo es obligatorio cuando envías devoluciones de llamada a la API de Google Transaction Events.

totalPriceStatus Const

Obligatorio.

Usa "ESTIMATED" como valor predeterminado. El precio total puede ajustarse según los detalles de la respuesta, como el impuesto sobre las ventas recaudado en función de una dirección de facturación.

Valor: ESTIMATED

totalPrice String

Obligatorio.

Es el valor monetario total de la transacción con una precisión decimal opcional de dos decimales. Este campo debe tener el mismo valor que cart.totalPrice.

En el siguiente ejemplo, se muestra un elemento TransactionInfo:

Ejemplo

{
  "totalPriceStatus": "ESTIMATED",
  "totalPrice": "12.34",
  "currencyCode": "USD"
}