Method: notification.partners.bookings.patch

Aktualizuje istniejące Booking.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
booking.name

string

Nazwa zasobu rezerwacji: partners/{partner ID}/bookings/{booking ID}

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

maska pól wszystkich rezerwacji do zaktualizowania;

Jest to rozdzielona przecinkami lista pełnych i jednoznacznych nazw pól. Przykład: "user.displayName,photo".
bookingFailure

object (BookingFailure)

Jeśli przetwarzanie żądania rezerwacji potwierdzonej asynchronicznie się nie powiedzie i stan rezerwacji zostanie zaktualizowany na „NIEPOWIEDNIE”, to pole powinno odzwierciedlać błąd logiki biznesowej (np. użytkownik ma już rezerwację zbyt blisko tego czasu). To pole powinno być ustawione tylko wtedy, gdy stan rezerwacji jest ustawiony na „FAILED” (Niepowodzenie). W przeciwnym razie zostanie ono zignorowany.

Treść żądania

Treść żądania zawiera wystąpienie elementu Booking.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Booking.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

BookingFailure

Dane stanu, które wskazują, dlaczego przetwarzanie rezerwacji zakończyło się niepowodzeniem w niesynchronizowany sposób. Funkcja BookingFailure ma przede wszystkim wykrywać błędy logiki biznesowej.

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

enum (Cause)

Powód niepowodzenia rezerwacji. (wymagane)
rejectedCardType

enum (CreditCardType)

(wymagane tylko wtedy, gdy przyczyna to PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

To opcjonalne pole pozwala partnerowi podać dodatkowe informacje tylko do celów debugowania. (opcjonalnie)
paymentFailure

object (PaymentFailureInformation)

informacje o nieudanych płatnościach.

Przyczyna

Wyliczenie przyczyn niepowodzenia.

Wartości w polu enum
CAUSE_UNSPECIFIED Wartość domyślna: nie używaj; oznacza „nieznany błąd”
SLOT_UNAVAILABLE Odwołanie do slotu dostępności nie jest już dostępne.
SLOT_ALREADY_BOOKED_BY_USER Użytkownik zarezerwował już spotkanie w podanym przedziale czasu.
LEASE_EXPIRED Dzierżawa (jeśli została przewidziana) wygasła i nie można jej już wykorzystać do realizacji żądanej rezerwacji.
OUTSIDE_CANCELLATION_WINDOW W tej chwili nie możemy anulować zamówienia z powodu ograniczeń czasowych w zasadach anulowania dla sprzedawcy.
PAYMENT_ERROR_CARD_TYPE_REJECTED Podczas przetwarzania płatności wystąpił błąd, ponieważ sprzedawca nie akceptuje podanego typu karty kredytowej. Typ karty kredytowej musi być podany w odrzuconym typie karty.
PAYMENT_ERROR_CARD_DECLINED Podczas przetwarzania płatności wystąpił błąd, ponieważ podana karta kredytowa została odrzucona.
PAYMENT_OPTION_NOT_VALID Wystąpił błąd dotyczący pakietu lub subskrypcji użytej do opłacenia rezerwacji. Być może nie ma już więcej prawidłowych zastosowań, mogły wygasnąć itp.
PAYMENT_ERROR Podczas przetwarzania płatności za tę rezerwację wystąpił błąd. Użyj tej wartości, aby wskazać ogólny błąd związany z płatnościami, tylko wtedy, gdy nie pasuje on do konkretnego błędu płatności powyżej.
USER_CANNOT_USE_PAYMENT_OPTION Użytkownik nie może użyć danej opcji płatności (np. próbuje skorzystać z ceny dla nowych użytkowników po raz drugi).
BOOKING_ALREADY_CANCELLED Rezerwacja, którą użytkownik próbował anulować, została już anulowana.
BOOKING_NOT_CANCELLABLE Rezerwacja, którą użytkownik próbował anulować, nie może zostać anulowana.
OVERLAPPING_RESERVATION Użytkownik ma już rezerwację na ten czas.
USER_OVER_BOOKING_LIMIT Rezerwacja nie powiodła się, ponieważ użytkownik przekroczył limit rezerwacji na użytkownika u agregatora.
PAYMENT_REQUIRES_3DS1

Ustaw, gdy płatność zostanie odrzucona, ponieważ prosisz o ponowne przetworzenie transakcji, ale tym razem po zastosowaniu uwierzytelniania 3DS 1. Pamiętaj, że stan błędu bieżącej transakcji pozostanie niepowodzenie. Proces będzie przebiegał osobno.

Jeśli jest to przyczyna niepowodzenia, parametr paymentFailure.3DS1_parameters MUSI być ustawiony. Jeśli nie, bieżąca przyczyna zostanie potraktowana tak, jakby była to przyczyna PAYMENT_ERROR.

PaymentFailureInformation

informacje o nieudanych płatnościach.

Zapis JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Pola
threeds1Parameters

object (ThreeDS1Parameters)

Parametry używane przez agregator RwG do zainicjowania protokołu uwierzytelniania 3DS1 z użytkownikiem. Będzie ignorowana, chyba że ustawienie BookingFailure.cause ma wartość PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Parametry żądające wykonania testu 3DS1 przez RwG.

Parametry są ustawiane przez opis protokołu 3DS1 firmy EMVCo.

Zapis JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Pola
acsUrl

string

Adres URL, z którego wczytywane jest formularz, który użytkownik musi wypełnić w celu uwierzytelnienia.
paReq

string

a PaymentAuthentication Request. Do opublikowania w formularzu ACSUrl, jeśli został podany.
transactionId

string

Identyfikator używany przez dostawcę ACS. Przesłanie do formularza ACSUrl, jeśli został podany.
mdMerchantData

string

Dane sprzedawcy. Do opublikowania w formularzu ACSUrl, jeśli został podany.