Method: notification.partners.bookings.patch

Aggiorna un elemento 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 ricerca

Parametri
updateMask

string (FieldMask format)

Maschera per 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 NON RIUSCITA, questo campo dovrebbe riflettere l'errore della logica di business (ad esempio, se l'utente ha una prenotazione esistente troppo vicina a questo orario). Questo campo deve essere impostato solo quando si aggiorna lo stato della prenotazione su FAILED. 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 per cui l'elaborazione di una prenotazione non è riuscita in modo asincrono. BookingFailure ha lo scopo di rilevare principalmente errori della 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 è andata a buon fine. (obbligatorio)
rejectedCardType

enum (CreditCardType)

(obbligatorio solo se la causa è PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

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

object (PaymentFailureInformation)

Informazioni sugli errori di pagamento.

Causa

Enumerazione delle cause dell'errore.

Enum
CAUSE_UNSPECIFIED Valore predefinito: non utilizzare; corrisponde 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 lo spazio di disponibilità di riferimento.
LEASE_EXPIRED Il contratto di affitto (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 dei limiti temporali stabiliti nelle 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 specificato nel valore rifiutatoCardType.
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 il pagamento della prenotazione. Potrebbe non essere più possibile alcun uso valido, 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 uno specifico errore di pagamento riportato sopra.
USER_CANNOT_USE_PAYMENT_OPTION L'utente non può utilizzare l'opzione di pagamento specificata (ad esempio l'utente sta tentando di utilizzare un prezzo prima volta per la seconda volta).
BOOKING_ALREADY_CANCELLED Una prenotazione che l'utente ha provato ad 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 Prenotazione non riuscita perché l'utente ha superato il limite di prenotazioni per utente definito dall'aggregatore.
PAYMENT_REQUIRES_3DS1

Imposta quando il pagamento viene rifiutato perché richiedi un nuovo tentativo di transazione, ma questa volta dopo aver eseguito la verifica/risposta di 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, 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 che RwG esegua una verifica 3DS1.

I parametri sono impostati dalla 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 di PaymentAutenticazione. 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.