Method: notification.partners.bookings.patch

Consente di aggiornare 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 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 su NON RIUSCITA, questo campo dovrebbe riflettere l'errore della logica di business (ad esempio, l'utente ha una prenotazione esistente troppo vicina a questo momento). Questo campo deve essere impostato solo quando si aggiorna lo stato della prenotazione su NON RIUSCITA, altrimenti 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 di stato che indicano perché l'elaborazione di una prenotazione non è riuscita in modo asincrono. BookingFailure è pensato per acquisire principalmente gli 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 è 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 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 lo spazio di disponibilità indicato.
LEASE_EXPIRED Il leasing (se fornito) è scaduto e non può più essere utilizzato per completare la prenotazione richiesta.
OUTSIDE_CANCELLATION_WINDOW Al momento non è possibile effettuare l'annullamento richiesto a causa dei limiti di tempo previsti 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 specificato nel campo 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/abbonamento utilizzato per il pagamento della prenotazione. Potrebbero non esserci altri utilizzi validi, potrebbero essere scaduti 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 indicata (ad es. se l'utente prova a utilizzare per la seconda volta il prezzo di un acquisto).
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 Prenotazione non riuscita perché l'utente supera 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à non riuscito. 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.