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 dei campi di tutti i campi di prenotazione da aggiornare

Si tratta di un elenco di nomi completi dei campi separati da virgole. 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 in FAILED, questo campo deve riflettere l'errore della logica di business (ad es. l'utente ha già una prenotazione troppo vicina a questo orario). Questo campo deve essere impostato solo quando si aggiorna lo stato della prenotazione su NON RIUSCITA 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 sullo stato che indicano il motivo dell'errore di elaborazione di una prenotazione in modo asincrono. BookingFailure è destinato principalmente a rilevare 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 della mancata riuscita della prenotazione. (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 usare; equivale a un "errore sconosciuto"
SLOT_UNAVAILABLE Lo slot di disponibilità a cui viene fatto riferimento non è più disponibile.
SLOT_ALREADY_BOOKED_BY_USER L'utente ha già prenotato un appuntamento per l'intervallo di disponibilità a cui si fa riferimento.
LEASE_EXPIRED Il contratto di locazione (se fornito) è scaduto e non può più essere utilizzato per completare la prenotazione richiesta.
OUTSIDE_CANCELLATION_WINDOW Al momento non è possibile eseguire l'annullamento richiesto a causa di limitazioni temporali previste dalle norme sull'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 il pagamento della prenotazione. Potrebbe 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 generico relativo ai pagamenti, solo se l'errore non corrisponde a uno specifico errore di pagamento riportato sopra.
USER_CANNOT_USE_PAYMENT_OPTION L'utente non può utilizzare l'opzione di pagamento specificata (ad es. l'utente sta tentando di utilizzare un prezzo per la prima volta per la seconda volta).
BOOKING_ALREADY_CANCELLED Una prenotazione che l'utente ha cercato di annullare è già stata annullata.
BOOKING_NOT_CANCELLABLE Una prenotazione che l'utente ha tentato di annullare non può essere annullata.
OVERLAPPING_RESERVATION L'utente ha una prenotazione esistente troppo vicina a questo orario.
USER_OVER_BOOKING_LIMIT La prenotazione non è andata a buon fine perché l'utente ha superato il limite di prenotazioni per utente dell'aggregatore.
PAYMENT_REQUIRES_3DS1

Imposta il momento in cui il pagamento viene rifiutato perché hai richiesto un nuovo tentativo della transazione, ma questa volta dopo aver eseguito la verifica o la risposta 3DS1. Tieni presente che lo stato di errore della transazione corrente rimarrà in stato di errore. I nuovi tentativi saranno completamente separati.

Se questo è il motivo dell'errore, DEVE essere impostato paymentFailure.3DS1_parameters. In caso contrario, la causa corrente verrà considerata come 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 secondo la descrizione di EMVCo del protocollo 3DS1.

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 PaymentAuthentication. Da pubblicare nel modulo ACSUrl, se fornito.
transactionId

string

Un identificatore utilizzato dal provider ACS. Da pubblicare nel modulo ACSUrl, se fornito.
mdMerchantData

string

Dati del commerciante. Da pubblicare nel modulo ACSUrl, se fornito.