Esquema de acciones de entrega

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

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

Es el ID opcional del carrito.

El comercio está afiliado a este carrito.

Obligatorio.

Lista de los productos o servicios que solicita el usuario.

No debe tener menos de 1 elemento.

Promoción aplicada en este carrito. Por el momento, solo se admite una promoción.

Notas sobre las instrucciones del pedido o de la entrega.

Define los detalles del usuario, como las preferencias de entrega.

Nombre de la persona que recibe el pedido, tal como quieres que se muestre Usa este campo si no se especifican firstName y lastName.

Ejemplo: Lovefood Ordering

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

Ejemplo: ilovefood@example.com

Nombre de la persona que recibe el pedido

Ejemplo: Lovefood

Apellido de la persona que recibe el pedido.

Ejemplo: Ordering

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

Ejemplo: +16501234567

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

Obligatorio.

Se actualizó la información del pedido.

Tiempo de entrega estimado, en formato de marca de tiempo ISO 8601: “{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z” o el 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. Usa esta opción para actualizar el tiempo de entrega estimado durante la respuesta de confirmación de la compra.

Ejemplo: PT90M

Obligatorio.

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

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

El socio cobrará al restaurante un monto de tarifa N a M por pedido.

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

El socio cobrará al comercio una tarifa de N% a M% por pedido.

Límite inferior del importe de la tarifa que se cobra.

Límite superior del importe de la tarifa cobrada.

Límite inferior del porcentaje de tarifa cobrada.

Límite superior del porcentaje de tarifa cobrada.

Es el tipo de esta extensión. Este campo siempre está configurado como "type.googleapis.com/google.actions.v2.orders.FoodCartExtension".

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

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.

Obligatorio.

Preferencia de entrega del usuario.

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 retirar, este campo no se incluye en el mensaje.

Obligatorio.

Es el tipo de esta extensión.

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

Obligatorio.

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

No debe tener menos de 1 elemento.

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 ProposaldOrder con correcciones. Devuelve este objeto si hay errores recuperables en el ProposaldOrder original. Por ejemplo, un cambio en el precio de una o más líneas de pedido en el carrito es un error recuperable. Los errores recuperables con un ProposaldOrder válido se avanzan a la etapa de confirmación, en lugar de requerir que el usuario revise su carrito.

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 seleccionadas para el usuario.

Son las opciones de pago alternativas disponibles para el usuario.

Obligatorio.

Es el tipo de esta extensión. Este campo siempre está configurado como "type.googleapis.com/google.actions.v2.orders.FoodItemExtension".

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

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

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

Ejemplo: 39231093

Es el ID de oferta del artículo.

Ejemplo: 912835081

El nombre de la opción.

Ejemplo: Honey Mustard

Nota relacionada con la opción.

En el caso de las opciones que son elementos, indica la cantidad de elementos.

Ejemplo: 3

Subopciones para la opción, si las hubiera.

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 } ]

Obligatorio.

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 de menú o el FoodItemOption.id para los complementos.

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

Obligatorio cuando error = "PRICE_CHANGED"

Es el nuevo precio del artículo que causó el error. Solo es obligatorio cuando el error es "PRICE_CHANGED".

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

Nueva cantidad disponible del artículo que causó el error. Esta acción es obligatoria solo cuando el error es "INVALID" o "NOT_FOUND". El valor debe ser cero para "INVALID" y "NOT_FOUND".

Es el tipo de esta extensión. Este campo siempre está configurado como "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension".

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

Representa las opciones de entrega disponibles para el pedido.

Es la solicitud del usuario para habilitar tus canales de distribución. 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 mediante la función para anular la suscripción que se proporciona en tus canales de distribución. Esta marca solo está presente en SubmitOrderRequestMessage.

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

Obligatorio.

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

El costo de esta opción.

Si está presente, indica el orden de entrega.

Obligatorio.

URL de la imagen. Como mínimo, la imagen debe tener 72 x 72 píxeles. Para obtener mejores resultados, usa una imagen que sea de al menos 216 × 216 píxeles. La imagen debe tener menos de 6 MB y 64 megapíxeles.

Obligatorio cuando type = "REGULAR"

Para un elemento de una sola línea en un carrito (ProposaldOrder.cart.lineItems[0].id), este es el ID único que crea Google cuando se crea el pedido. Para un elemento de una sola línea en un pedido propuesto (ProposaldOrder.otherItems[0].id), que se usa para agregar elementos como impuestos y tarifas de envío, el proveedor define el valor de ID. Por ejemplo, en un carrito hay dos de los mismos elementos 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 para desambiguar. En otras palabras, si una de las pizzas se rechaza porque no tiene un ingrediente particular, el ID ayuda a Google a determinar a qué artículo del pedido te refieres. Este campo es obligatorio, excepto en otherItems.

Obligatorio.

Es el nombre de la línea de pedido. Es una cadena visible para el usuario que debe estar en mayúscula inicial cuando sea posible (como “Tarifa de entrega”, “Cargo por servicio” o “Impuestos”). Este campo se trunca a los 100 caracteres para los usuarios.

Obligatorio.

Obligatorio cuando type = "REGULAR"

Cantidad de elementos incluidos. No es aplicable a ProposaldOrder.otherItems.

Es la descripción del artículo.

Obligatorio.

Es el precio de los artículos. Este valor refleja el precio total de todos los bienes o servicios de esta línea de pedido (es decir, sumar el costo de cualquier complemento y multiplicarlo por la cantidad). Por ejemplo, si un artículo de USD 10 tiene la cantidad de 3, el precio sería de USD 30. Para una pizza con 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 línea de pedido debe tener un precio, incluso si este es "0". Cuando el tipo sea DISCOUNT, especifica el valor como negativo (por ejemplo, “-2”).

Opcional y solo válido si el tipo es "REGULAR". Es posible que el usuario envíe una nota específica para el artículo en este campo de las solicitudes de confirmación de la compra y de envío de pedido. Asegúrate de que el comercio reciba la nota cuando la recibas. Aparecerá en la solicitud como subLines[0].note, que es el único valor proporcionado en este campo cuando está presente en una solicitud.

No debe tener más de 1 elemento.

Obligatorio cuando type = "REGULAR"

Es el ID de oferta del MenuItem. No es aplicable a ProposaldOrder.otherItems.

Define los complementos para los alimentos.

Mostrar la dirección de la ubicación

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

Ejemplo: 90210

Indica el nombre de la ciudad.

Ejemplo: Los Angeles

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

Ejemplo: Gate code is #111

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

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

Obligatorio.

Es el nombre visible del usuario del comercio.

Ejemplo: Falafel Bite

Obligatorio.

Código de moneda de 3 letras en formato ISO 4217.

Ejemplo: USD

La unidad entera del importe. Por ejemplo, si currencyCode es "USD", entonces "1". la unidad es 1 dólar estadounidense.

Ejemplo: 36

Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999, ambos incluidos. Usa las siguientes reglas: Si las unidades son positivas, 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 negativas o cero. Por ejemplo, $-1.75 se representa como unidades = -1 y nanos = -750,000,000.

Ejemplo: 730000000

Obligatorio.

Es el pedido propuesto que causó el pedido.

Obligatorio.

Es el ID de pedido que asigna Google. Este ID debe ser estable durante todo el ciclo de vida de un pedido. Este ID no es visible para el usuario final.

Obligatorio.

Fecha y hora en que se creó el pedido.

Obligatorio.

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

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 recibo.user_visible_order_id al menos una vez en OrderUpdate para un estado "CREATED" este ID será el ID visible que el usuario ingrese y se mostrará en la tarjeta de pedido de Google.

Obligatorio.

Es el nuevo estado del pedido.

Obligatorio.

Indica la hora a la que se actualizó el pedido.

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

Debe tener, como mínimo, 1 elemento y 6 elementos como máximo.

Obligatorio cuando orderState.state = "REJECTED"

Obligatorio cuando orderState.state = "CANCELLED"

Este campo dejó de estar disponible.

Este campo dejó de estar disponible.

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

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

Es el precio total del pedido.

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

Hora estimada de retiro, en formato de marca de tiempo ISO 8601: “{año}-{month}-{day}T{hora}:{min}:{sec}[.{frac_sec}]Z” o el 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 horario de partida preferido es lo antes posible. Referencia: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. Usa esta opción para actualizar el tiempo de retiro estimado durante la respuesta de confirmación de la compra.

Ejemplo: PT90M

Obligatorio.

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

Ejemplo: US

Corresponde al código postal,

Ejemplo: 94043

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, una óblast o una prefectura.

Ejemplo: CA

Es la ciudad o el pueblo de esta ubicación. En 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

Una o más líneas que puedes usar para especificar la dirección. Este campo no debe modificarse porque puede contener localidades poco claras.

Ejemplo: [ "1350 Charleston Road" ]

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

Obligatorio.

Es el código del cupón promocional.

Obligatorio.

Obligatorio.

Es el código del cupón promocional.

Es el ID opcional del pedido propuesto.

Obligatorio.

Elementos del usuario.

Artículos que agregó el proveedor, como cargos de envío, impuestos y otras tarifas otherItems también pueden contener propinas o descuentos agregados por el usuario.

Debe tener un máximo de 10 elementos.

Imagen asociada con el pedido propuesto.

Obligatorio.

Es el precio total del pedido propuesto.

Obligatorio.

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

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

Obligatorio.

Obligatorio.

El pedido se realizará con los detalles del pago.

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

Obligatorio.

Contiene los argumentos esperados para pagar un carrito.

Debe tener exactamente 1 artículo.

Obligatorio.

Es el ID único de la conversación.

Obligatorio.

Se estableció como "actions.foodordering.intent.CHECKOUT". para el mensaje de solicitud de confirmación de la compra O "actions.intent.TRANSACTION_DECISION" para enviar una solicitud de pedido.

Obligatorio.

Contiene el carrito que se debe pagar o el pedido que se debe realizar

Debe tener exactamente 1 artículo.

Detalla los alimentos que el usuario desea comprobar.

Configurada como falsa.

Valor: False

Obligatorio.

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

Obligatorio.

Contiene tu respuesta a CheckoutRequestMessage o SubmitOrderRequestMessage.

Obligatorio.

Orden propuesto para usar en la transacción.

Obligatorio.

Opción de pago predeterminada seleccionada para el usuario.

Son las opciones de pago alternativas disponibles para el usuario.

Obligatorio.

Obligatorio.

Debe tener exactamente 1 artículo.

Artículos comprados con impuestos y descuentos

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

Obligatorio.

Contiene el OrderUpdate para la solicitud.

Obligatorio.

Es la etiqueta de visualización. Usa mayúscula inicial de 30 caracteres o menos para garantizar una renderización adecuada.

Ejemplo: Contact us

Obligatorio.

Obligatorio.

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

Ejemplo: Restaurant closed

Es el tipo de esta extensión. Este campo siempre está configurado como "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension".

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

La hora estimada en la que el pedido se entregará o estará listo para su retiro. La cadena debe estar en formato ISO 8601 y corresponde a un intervalo en lugar de a un único tiempo fijo. Las convenciones aceptables son: Intervalos, duraciones, y fechas y horas. Este campo se puede enviar en SubmitOrderResponseMessage o AsyncOrderUpdateRequestMessage cuando la información esté disponible o haya un cambio, como llegadas anticipadas o retrasadas.

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

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

No debe tener menos de 1 elemento.

Usa HulfillmentTimeIso8601 en el mensaje FoodOrderingUpdateExtension.

UsaestimatedFulfillmentTimeIso8601 en el mensaje FoodOrderingUpdateExtension

Motivo del cambio. Obligatorio para los cambios de precio.

Obligatorio.

La acción que se activa al hacer clic o tocar el botón. 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

Obligatorio.

Obligatorio.

Obligatorio.

Obligatorio.

Es la cadena de visualización del estado que se muestra al usuario. Usa mayúscula inicial.

Ejemplo: Your order has been received

Obligatorio.

Obligatorio si el pedido es “CONFIRMED”, “IN_TRANSIT” o “FULFILLED”. Este campo corresponde al ID que verá el usuario único para este pedido (por lo general, el ID de 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 hacer referencia a su pedido de atención al cliente con el proveedor y el integrador. Solo debes proporcionar este ID una vez en una OrderUpdate determinada. 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 confirmado, debes enviar un AsyncOrderUpdateRequestMessage con un OrderUpdate y un Recibo.

Obligatorio.

Motivo del rechazo que se usó para el registro interno. Los usuarios no pueden ver este campo.

Obligatorio.

Obligatorio.

Indica el nombre del instrumento de pago que aparece en el recibo.

Ejemplo: Taco Points Total

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

Se requiere el formato de la dirección de facturación para completar la transacción. MIN: 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.

Obligatorio.

Son los campos admitidos para autenticar una transacción con tarjeta.

No debe tener menos de 1 elemento.

Obligatorio.

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

No debe tener menos de 1 elemento.

Establécelo como verdadero si necesitas una dirección de facturación. Solicita una dirección de facturación solo si es necesario para procesar la transacción. Las solicitudes de datos adicionales pueden aumentar la fricción en el proceso de confirmación de la compra y reducir los porcentajes de conversiones.

Los campos esperados que se muestran si billingAddressRequired se establece como verdadero.

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

Obligatorio.

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

Dirección de facturación del pago.

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

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

Este campo dejó de estar disponible.

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

Este campo dejó de estar disponible.

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

Este campo dejó de estar disponible.

Este campo dejó de estar disponible.

Es el identificador de comerciante de Google emitido para usted por Google Pay.

Obligatorio.

El nombre del comercio está codificado como UTF-8. El nombre del comercio se muestra en la hoja de pagos.

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

Obligatorio.

Ejemplo: braintree

Obligatorio.

Versión principal de la API.

Valor: 2

Obligatorio.

Versión secundaria de la API.

Valor: 0

Obligatorio.

(ID del comerciante de Google Pay) Información sobre el comercio que solicita los datos de pago.

Obligatorio.

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

Obligatorio.

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

Obligatorio.

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

Obligatorio.

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

Obligatorio.

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

Valor: CARD

Obligatorio.

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

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.

Este campo es mutuamente excluyente con actionProvidedOptions. Úsala para pagar en línea con gPay.

Obligatorio.

En su lugar, usa facilitationSpecification. Son los tipos de tokens aceptables.

En su lugar, usa facilitationSpecification.

Obligatorio.

Obligatorio.

Obligatorio.

Código de moneda alfabético ISO 4217.

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 transacción de Google Pay. Este campo es obligatorio cuando envías devoluciones de llamada a la API de Google Transaction Events.

Obligatorio.

Utiliza “ESTIMATED” de forma predeterminada. 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

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.