Method: notification.partners.bookings.patch

Aggiorna un Booking esistente.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
booking.name

string

Nome risorsa della prenotazione: partners/{partner ID}/bookings/{booking ID}

Parametri di query

Parametri
updateMask

string (FieldMask format)

Maschera del campo di tutti i campi di prenotazione da aggiornare

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".
bookingFailure

object (BookingFailure)

Se l'elaborazione di una richiesta di prenotazione confermata in modo asincrono non va a buon fine e lo stato della prenotazione viene aggiornato a FAILED, questo campo deve riflettere l'errore della logica di business (ad es. l'utente ha una prenotazione esistente troppo vicina a questo orario). Questo campo deve essere impostato solo quando lo stato della prenotazione viene aggiornato a FAILED e verrà ignorato in caso contrario.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Booking.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Booking.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

BookingFailure

Dati di stato che indicano in modo asincrono il motivo per cui l'elaborazione di una prenotazione non è riuscita. BookingFailure ha lo scopo di acquisire principalmente gli errori di logica di business.

Rappresentazione JSON 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Campi
cause

enum (Cause)

Il motivo per cui la prenotazione non è riuscita. (obbligatorio)
rejectedCardType

enum (CreditCardType)

(obbligatorio solo se la causa è PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

Questo campo facoltativo viene utilizzato dal partner per includere informazioni aggiuntive solo a scopo di debug. (facoltativo)
paymentFailure

object (PaymentFailureInformation)

Informazioni sugli errori di pagamento.

Causa

Enumerazione delle cause di errore.

Enum
CAUSE_UNSPECIFIED Valore predefinito: non utilizzare; equivale a un "errore sconosciuto"
SLOT_UNAVAILABLE Lo spazio di disponibilità a cui viene fatto riferimento non è più disponibile.
SLOT_ALREADY_BOOKED_BY_USER L'utente ha già prenotato un appuntamento per lo slot di disponibilità a cui viene fatto riferimento.
LEASE_EXPIRED Il contratto di locazione (se fornito) è scaduto e non può più essere utilizzato per completare la prenotazione richiesta.
OUTSIDE_CANCELLATION_WINDOW L'annullamento richiesto non può essere eseguito al momento a causa delle limitazioni temporali previste dalle norme di annullamento del commerciante.
PAYMENT_ERROR_CARD_TYPE_REJECTED Si è verificato un errore durante l'elaborazione del pagamento perché il tipo di carta di credito fornito non è stato accettato dal commerciante. Il tipo di carta di credito deve essere fornito in rejectedCardType.
PAYMENT_ERROR_CARD_DECLINED Si è verificato un errore durante l'elaborazione del pagamento perché la carta di credito fornita è stata rifiutata.
PAYMENT_OPTION_NOT_VALID Si è verificato un errore con il pacchetto/abbonamento utilizzato per pagare la prenotazione. Potrebbero non essere rimasti utilizzi validi, potrebbe essere scaduto e così via.
PAYMENT_ERROR Si è verificato un errore durante l'elaborazione del pagamento per questa prenotazione. Utilizza questo valore per indicare un errore generale relativo ai pagamenti, solo se l'errore non corrisponde a un errore di pagamento specifico riportato sopra.
USER_CANNOT_USE_PAYMENT_OPTION L'utente non può utilizzare l'opzione di pagamento specificata (ad es. l'utente tenta di utilizzare un prezzo per la prima volta per la seconda volta).
BOOKING_ALREADY_CANCELLED Una prenotazione che l'utente ha tentato di annullare è già stata annullata.
BOOKING_NOT_CANCELLABLE Una prenotazione che l'utente ha tentato di annullare non è annullabile.
OVERLAPPING_RESERVATION L'utente ha una prenotazione esistente troppo vicina a questo orario.
USER_OVER_BOOKING_LIMIT La prenotazione non è riuscita perché l'utente ha superato il limite di prenotazioni per utente dell'aggregatore.
PAYMENT_REQUIRES_3DS1

Imposta quando il pagamento viene rifiutato perché stai richiedendo che la transazione venga riprovata, ma questa volta dopo aver superato la verifica 3DS1. Tieni presente che lo stato di errore della transazione corrente rimarrà invariato. Il nuovo tentativo sarà completamente separato.

Quando questo è il motivo dell'errore, paymentFailure.3DS1_parameters DEVE essere impostato. In caso contrario, la causa attuale verrà trattata come se fosse PAYMENT_ERROR.

PaymentFailureInformation

Informazioni sugli errori di pagamento.

Rappresentazione JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Campi
threeds1Parameters

object (ThreeDS1Parameters)

Parametri utilizzati da un aggregatore RwG per avviare un protocollo di autenticazione 3DS1 con l'utente. Verrà ignorato a meno che BookingFailure.cause non sia impostato su PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Parametri che richiedono a RwG di eseguire una verifica 3DS1.

I parametri sono impostati dalla descrizione del protocollo 3DS1 di EMVCo.

Rappresentazione JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Campi
acsUrl

string

L'URL da cui caricare un modulo da presentare all'utente per l'autenticazione.
paReq

string

Una richiesta di autenticazione del pagamento. Se fornito, verrà pubblicato nel modulo ACSUrl.
transactionId

string

Un identificatore utilizzato dal provider ACS. Se fornito, verrà pubblicato nel modulo ACSUrl.
mdMerchantData

string

Dati del commerciante. Se fornito, verrà pubblicato nel modulo ACSUrl.