- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- OrderUpdate
- Tipo
- UserNotification
Actualiza el pedido de 3p a AOG. Muestra INVALID_{8/} si el ID del pedido está vacío o no es igual a un pedido existente.
Solicitud HTTP
PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
orderUpdate.order.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 64 caracteres. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON | |
---|---|
{ "header": { object ( |
Campos | ||
---|---|---|
header |
Encabezado de la solicitud de actualización del pedido. |
|
orderUpdate.type |
Obsoleto: usa OrderUpdate.update_mask en su lugar. Si el tipo es SNAPSHOT, OrderUpdate.order debería ser el pedido completo. Si el tipo es ORDER_STATUS, este es el cambio de estado a nivel de pedido. Solo se recogen order.last_update_time y este estado de la vertical. Nota: type.ORDER_STATUS solo admite actualizaciones de estado de PurcahaseOrderExtension y no hay un plan para extender esta compatibilidad. En cambio, recomendamos usar updateMask, ya que es más genérico, extensible y se puede utilizar para todas las verticales. |
|
orderUpdate.order.googleOrderId |
ID de pedido asignado por Google. |
|
orderUpdate.order.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. |
|
orderUpdate.order.userVisibleStateLabel |
Obsoleto: usa el estado OrderExtensions en su lugar. Es la etiqueta visible para el usuario correspondiente al estado de este pedido. |
|
orderUpdate.order.buyerInfo |
Información sobre el comprador. |
|
orderUpdate.order.image |
Imagen asociada con el pedido. |
|
orderUpdate.order.createTime |
Obligatorio: Fecha y hora en que se creó el pedido. Es una marca de tiempo en el formato RFC3339 UTC "Zulu", con precisión de nanosegundos. Ejemplo: |
|
orderUpdate.order.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: |
|
orderUpdate.order.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. |
|
orderUpdate.order.contents |
Obligatorio: Ordena los contenidos que son un grupo de líneas de pedido. |
|
orderUpdate.order.priceAttributes[] |
Precio, descuentos, impuestos, etc. |
|
orderUpdate.order.followUpActions[] |
Acciones de seguimiento a nivel del pedido. |
|
orderUpdate.order.paymentData |
Datos relacionados con el pago del pedido. |
|
orderUpdate.order.termsOfServiceUrl |
Un vínculo a las Condiciones del Servicio que se aplican al pedido o al pedido propuesto. |
|
orderUpdate.order.note |
Notas adjuntas a un pedido. |
|
orderUpdate.order.promotions[] |
Todas las promociones asociadas con este pedido. |
|
orderUpdate.order.disclosures[] |
Divulgaciones asociadas con este pedido. |
|
orderUpdate.order.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 |
|
orderUpdate.updateMask |
Nota: A continuación se indican las consideraciones o recomendaciones para los siguientes campos especiales: 1. order.last_update_time siempre se actualizará como parte de la solicitud de actualización. 2. Se ignorarán order.create_time, order.google_order_id y order.merchant_order_id si se proporcionan como parte de updateMask. Una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: |
|
orderUpdate.userNotification |
Si se especifica, muestra una notificación al usuario con el título y el texto especificados. Especificar una notificación es una sugerencia para notificar y no se garantiza que genere una notificación. |
|
orderUpdate.reason |
Motivo del cambio o la actualización. |
|
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: |
||
orderUpdate.order.purchase |
Orden de compra |
|
orderUpdate.order.ticket |
Pedido de entrada |
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Order
.
OrderUpdate
Actualización de un pedido.
Representación JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
Obsoleto: usa OrderUpdate.update_mask en su lugar. Si el tipo es SNAPSHOT, OrderUpdate.order debería ser el pedido completo. Si el tipo es ORDER_STATUS, este es el cambio de estado a nivel de pedido. Solo se recogen order.last_update_time y este estado de la vertical. Nota: type.ORDER_STATUS solo admite actualizaciones de estado de PurcahaseOrderExtension y no hay un plan para extender esta compatibilidad. En cambio, recomendamos usar updateMask, ya que es más genérico, extensible y se puede utilizar para todas las verticales. |
order |
|
updateMask |
Nota: A continuación se indican las consideraciones o recomendaciones para los siguientes campos especiales: 1. order.last_update_time siempre se actualizará como parte de la solicitud de actualización. 2. Se ignorarán order.create_time, order.google_order_id y order.merchant_order_id si se proporcionan como parte de updateMask. Una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: |
userNotification |
Si se especifica, muestra una notificación al usuario con el título y el texto especificados. Especificar una notificación es una sugerencia para notificar y no se garantiza que genere una notificación. |
reason |
Motivo del cambio o la actualización. |
Tipo
Obsoleto: usa OrderUpdate.update_mask en su lugar. Actualizaciones permitidas de un pedido.
Enumeradores | |
---|---|
TYPE_UNSPECIFIED |
Tipo sin especificar; no debes configurarlo de forma explícita. |
ORDER_STATUS |
Solo actualiza el estado del pedido. |
SNAPSHOT |
Actualiza el resumen del pedido. |
UserNotification
Es una notificación opcional para el usuario que se mostrará como parte de la actualización del pedido.
Representación JSON | |
---|---|
{ "title": string, "text": string } |
Campos | |
---|---|
title |
El título de la notificación del usuario. La longitud máxima permitida es de 30 caracteres. |
text |
El contenido de la notificación La longitud máxima permitida es de 100 caracteres. |