- Representación JSON
- Contenido
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- Promoción
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
Entidad Order. Nota: 1. Todas las cadenas de todos los niveles deben tener menos de 1,000 caracteres, a menos que se especifique lo contrario. 2. A menos que se especifique lo contrario, el recuento de todos los campos repetidos en todos los niveles debe ser inferior a 50. 3. Todas las marcas de tiempo en todos los niveles, si se especifican, deben ser marcas válidas.
Representación JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
Campos | ||
---|---|---|
googleOrderId |
ID de pedido asignado por Google. |
|
merchantOrderId |
Obligatorio: ID de pedido interno asignado por el comercio. Este ID debe ser único y se requiere para las operaciones de actualización de pedidos posteriores. Este ID se puede establecer como el googleOrderId proporcionado o cualquier otro valor único. Ten en cuenta que el ID que se presenta a los usuarios es userVisibleOrderId, que puede ser un valor diferente y más fácil de usar. La longitud máxima permitida es de 128 caracteres. |
|
userVisibleOrderId |
Es el ID orientado al usuario que hace referencia al pedido actual. Este ID debe ser coherente con el que se muestra para este pedido en otros contextos, como sitios web, apps y correo electrónico. |
|
userVisibleStateLabel |
Obsoleto: usa el estado OrderExtensions en su lugar. Es la etiqueta visible para el usuario correspondiente al estado de este pedido. |
|
buyerInfo |
información sobre el comprador. |
|
image |
Imagen asociada con el pedido. |
|
createTime |
Obligatorio: Es la fecha y hora en que se creó el pedido. Es una marca de tiempo en el formato RFC3339 UTC "Zulu", con precisión de nanosegundos. Ejemplo: |
|
lastUpdateTime |
fecha y hora en que se actualizó el pedido por última vez. Obligatorio para OrderUpdate. Es una marca de tiempo en el formato RFC3339 UTC "Zulu", con precisión de nanosegundos. Ejemplo: |
|
transactionMerchant |
Comercio que facilitó la confirmación de la compra. Puede ser diferente de un proveedor a nivel de la línea de pedido. Ejemplo: Pedido de Expedia con una línea de pedido de ANA. |
|
contents |
Obligatorio: Ordena los contenidos que son un grupo de líneas de pedido. |
|
priceAttributes[] |
Precio, descuentos, impuestos, etc. |
|
followUpActions[] |
Acciones de seguimiento a nivel del pedido. |
|
paymentData |
Datos relacionados con el pago del pedido. |
|
termsOfServiceUrl |
Un vínculo a las Condiciones del Servicio que se aplican al pedido o al pedido propuesto. |
|
note |
Notas adjuntas a un pedido. |
|
promotions[] |
Todas las promociones asociadas con este pedido. |
|
disclosures[] |
Divulgaciones asociadas con este pedido. |
|
vertical |
Obsoleto: usa verticales en su lugar. Estas propiedades se aplicarán a todas las líneas de pedido, a menos que se anulen en algunas. Esta vertical debe coincidir con el tipo de vertical a nivel de la línea de pedido. Valores posibles: Un objeto que contiene campos de un tipo arbitrario. Un campo adicional |
|
Campo de unión verticals . Estas propiedades se aplicarán a todas las líneas de pedido, a menos que se anulen en algunas. Esta vertical debe coincidir con el tipo de vertical a nivel de la línea de pedido. Las direcciones (verticals ) solo pueden ser una de las siguientes opciones: |
||
purchase |
Orden de compra |
|
ticket |
Pedido de entrada |
Contenido
Wrapper para líneas de pedido.
Representación JSON | |
---|---|
{
"lineItems": [
{
object ( |
Campos | |
---|---|
lineItems[] |
Es una lista de líneas de pedido. Se requiere al menos 1 elemento de una sola línea y se permite un máximo de 50. Todas las líneas de pedido deben pertenecer a la misma vertical. |
PaymentData
Datos de pago relacionados con un pedido.
Representación JSON | |
---|---|
{ "paymentResult": { object ( |
Campos | |
---|---|
paymentResult |
Es el resultado del pago que usa el integrador para completar una transacción. Este campo se propagará con Actions on Google si Actions-on-Google administra la experiencia de confirmación de la compra. |
paymentInfo |
Es la información de pago relacionada con el pedido que es útil para la interacción que puede realizar el usuario. |
PaymentResult
Resultado del pago que usa el integrador para completar una transacción.
Representación JSON | |
---|---|
{ // Union field |
Campos | ||
---|---|---|
Campo de unión result . Se proporcionan los datos de pago de Google o la forma de pago para comercios. Las direcciones (result ) solo pueden ser una de las siguientes opciones: |
||
googlePaymentData |
Datos de la forma de pago proporcionados por Google. Si tu procesador de pagos aparece como procesador de pagos compatible con Google en el siguiente vínculo: https://developers.google.com/pay/api/ navega a tu procesador de pagos mediante el vínculo para obtener más información. De lo contrario, consulta la siguiente documentación para conocer los detalles de la carga útil: https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
El usuario elige la forma de pago proporcionada por el comercio o la acción. |
PaymentInfo
Es la información de pago relacionada con el pedido realizado. Este protocolo captura información útil para la interacción que tiene el usuario.
Representación JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Campos | |
---|---|
paymentMethodDisplayInfo |
Es la información visible de la forma de pago que se usó para realizar la transacción. |
paymentMethodProvenance |
Indica la procedencia de la forma de pago que se usó para realizar la transacción. Es posible que el usuario haya registrado la misma forma de pago en Google y en el comercio. |
PaymentMethodDisplayInfo
Resultado del pago que usa el integrador para completar una transacción.
Representación JSON | |
---|---|
{
"paymentType": enum ( |
Campos | |
---|---|
paymentType |
Es el tipo de pago. |
paymentMethodDisplayName |
Es el nombre visible del usuario de la forma de pago. Por ejemplo, VISA **** 1234 Checks ctat **** 5678 |
Promoción
Promociones o ofertas que se agregaron al carrito.
Representación JSON | |
---|---|
{ "coupon": string } |
Campos | |
---|---|
coupon |
Obligatorio: Se aplica el código de cupón a esta oferta. |
PurchaseOrderExtension
Extensión de pedido para la vertical de compras. Estas propiedades se aplican a todas las líneas de pedido dentro del pedido, a menos que se anulen en una línea de pedido.
Representación JSON | |
---|---|
{ "status": enum ( |
Campos | |
---|---|
status |
Obligatorio: estado general del pedido. |
userVisibleStatusLabel |
Etiqueta o cadena visibles del usuario para el estado. La longitud máxima permitida es de 50 caracteres. |
type |
Obligatorio: Tipo de compra. |
returnsInfo |
Información de devolución del pedido. |
fulfillmentInfo |
Es la información de entrega del pedido. |
extension |
Cualquier campo adicional intercambiado entre el comercio y Google Un objeto que contiene campos de un tipo arbitrario. Un campo adicional |
purchaseLocationType |
Ubicación de la compra (en la tienda / en línea) |
errors[] |
Opcional: Errores por los que se rechazó este pedido. |
PurchaseError
Errores por los que se puede rechazar una orden de compra.
Representación JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
Obligatorio: Representa el motivo detallado por el que el comercio rechaza un pedido. |
description |
Descripción adicional del error. |
entityId |
Es el ID de entidad que corresponde al error. Ejemplo que puede corresponder a LineItemId / ItemOptionId. |
updatedPrice |
Esto es relevante en el caso de los tipos de error PRICE_CHANGED o INCORRECT_PRICE. |
availableQuantity |
Cantidad disponible ahora. Aplicable en el caso de AVAILABILITY_CHANGED. |
TicketOrderExtension
Pide contenido para pedidos de entradas, como películas, deportes, etcétera.
Representación JSON | |
---|---|
{
"ticketEvent": {
object ( |
Campos | |
---|---|
ticketEvent |
El evento se aplica a todas las entradas de línea de pedido. |
TicketEvent
Representa un evento único.
Representación JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
Obligatorio: Tipo de evento de entrada, p.ej., película o concierto. |
name |
Obligatorio: Es el nombre del evento. Por ejemplo, si el evento es una película, este debe ser el nombre de la película. |
description |
descripción del evento. |
url |
URL a la información del evento. |
location |
Es la ubicación donde se realizará el evento o donde se encuentra una organización. |
eventCharacters[] |
Son los caracteres relacionados con este evento. Pueden ser directores o actores de un evento cinematográfico, o los artistas de un concierto, etcétera. |
startDate |
Hora de inicio |
endDate |
Hora de finalización |
doorTime |
Hora de entrada, que puede ser diferente de la hora de inicio del evento. P. ej., el evento comienza a las 9 a.m., pero el horario de entrada es a las 8:30 a.m. |
EventCharacter
Un carácter del evento, p.ej., organizador, intérprete, etc.
Representación JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
el tipo de personaje del evento, p. ej., actor o director |
name |
nombre del carácter. |
image |
Imágenes del personaje |