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 della risorsa della prenotazione: partners/{partner ID}/bookings/{booking ID}

Parametri di query

Parametri
updateMask

string (FieldMask format)

Maschera dei 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 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 viene aggiornato lo stato della prenotazione su FAILED e, in caso contrario, verrà ignorato.

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 utilizzare; equivale a un "errore sconosciuto"
SLOT_UNAVAILABLE Lo spazio di disponibilità a cui si fa 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/l'abbonamento utilizzato per pagare la 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 generale relativo al pagamento, solo se non corrisponde a un errore di pagamento specifico sopra indicato.
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 provato ad annullare non è annullabile.
OVERLAPPING_RESERVATION L'utente ha già una prenotazione 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

Impostato quando il pagamento viene rifiutato perché richiedi di riprovare a effettuare la transazione, ma questa volta dopo aver superato la verifica/risposta 3DS1. Tieni presente che lo stato di errore della transazione corrente rimarrà non riuscito. Il nuovo tentativo sarà completamente separato.

Se questo è il motivo dell'errore, il parametro 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 pagamento. 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.