Method: notification.partners.bookings.patch

Actualiza un Booking existente.

Solicitud HTTP

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
booking.name

string

Es el nombre de recurso de la reserva: partners/{partner ID}/bookings/{booking ID}.

Parámetros de búsqueda

Parámetros
updateMask

string (FieldMask format)

Es la máscara de campo de todos los campos de reserva que se deben actualizar.

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
bookingFailure

object (BookingFailure)

Si se produce un error al procesar una solicitud de reserva confirmada de forma asíncrona y el estado de la reserva se actualiza a FAILED, este campo debería reflejar el error de lógica empresarial (p. ej., el usuario ya tiene una reserva demasiado próxima). Además, solo se debe configurar al actualizar el estado de la reserva a FAILED y se ignorará de lo contrario.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Booking.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Booking.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

Son datos del estado que indican por qué se produjo un error al procesar una reserva de forma asíncrona. El principal objetivo de BookingFailure es captar errores de lógica empresarial.

Representación JSON 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Campos
cause

enum (Cause)

Es el motivo por el que se produjo un error en la reserva. (Obligatorio)
rejectedCardType

enum (CreditCardType)

(Es obligatorio solo si la causa es PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

Este campo opcional se utiliza para que el socio incluya información adicional solo con fines de depuración. (Opcional)
paymentFailure

object (PaymentFailureInformation)

Es la información sobre los errores de pago.

Cause

Es una enumeración de las causas del error.

Enumeraciones
CAUSE_UNSPECIFIED Valor predeterminado: No utilizar. Equivale a un "error desconocido".
SLOT_UNAVAILABLE El horario disponible al que se hace referencia ya no está disponible.
SLOT_ALREADY_BOOKED_BY_USER El usuario ya reservó una cita para el horario disponible al que se hace referencia.
LEASE_EXPIRED La retención (si se realizó) venció y ya no se puede utilizar para completar la reserva solicitada.
OUTSIDE_CANCELLATION_WINDOW La cancelación solicitada no se puede realizar en este momento debido a restricciones de tiempo en la política de cancelación del comercio.
PAYMENT_ERROR_CARD_TYPE_REJECTED Se produjo un error al procesar el pago porque el comercio no aceptó el tipo de tarjeta de crédito proporcionada. El tipo de tarjeta de crédito debe suministrarse en rejectedCardType.
PAYMENT_ERROR_CARD_DECLINED Se produjo un error al procesar el pago porque se rechazó la tarjeta de crédito proporcionada.
PAYMENT_OPTION_NOT_VALID Se produjo un error relacionado con el paquete o la membresía que se utilizó para pagar la reserva. Es posible que no queden usos válidos, que haya vencido, etc.
PAYMENT_ERROR Se produjo un error al procesar el pago de esta reserva. Utiliza este valor para indicar un error general relacionado con el pago, solo si el error no coincide con alguno específico mencionado arriba.
USER_CANNOT_USE_PAYMENT_OPTION El usuario no puede utilizar la opción de pago especificada (p. ej., intenta utilizar dos veces un precio otorgado por única vez).
BOOKING_ALREADY_CANCELLED Ya se canceló la reserva que el usuario intentó cancelar.
BOOKING_NOT_CANCELLABLE No se puede cancelar la reserva que el usuario intentó cancelar.
OVERLAPPING_RESERVATION El usuario ya tiene una reserva demasiado próxima.
USER_OVER_BOOKING_LIMIT No se pudo completar la reserva porque el usuario superó el límite de reservas por usuario del agregador.
PAYMENT_REQUIRES_3DS1

Se establece cuando el pago se rechaza debido a que solicitas que se intente realizar la transacción nuevamente, pero esta vez después de pasar el desafío o la respuesta 3DS1. Ten presente que se conservará el estado actual de error en la transacción. El reintento se hará completamente por separado.

Cuando este es el motivo del error, se DEBE establecer paymentFailure.3DS1_parameters. De lo contrario, la causa actual se tratará como si fuera del tipo PAYMENT_ERROR.

PaymentFailureInformation

Es la información sobre los errores de pago.

Representación JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Campos
threeds1Parameters

object (ThreeDS1Parameters)

Son los parámetros que utiliza un agregador RwG para iniciar un protocolo de autenticación 3DS1 con el usuario. Se ignorará, a menos que BookingFailure.cause se establezca en PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Son los parámetros que solicitan que RwG realice un desafío 3DS1.

Los parámetros se establecen en función de la descripción de EMVCo sobre el protocolo 3DS1.

Representación JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Campos
acsUrl

string

Es la URL desde la que se carga un formulario de autenticación para presentárselo al usuario.
paReq

string

Es una solicitud de PaymentAuthentication. Se publicará en el formulario ACSUrl si se proporciona.
transactionId

string

Es un identificador que utiliza el proveedor de ACS. Se publicará en el formulario ACSUrl si se proporciona.
mdMerchantData

string

Datos del comercio. Se publicará en el formulario ACSUrl si se proporciona.