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 lista pełnych nazw pól rozdzielona przecinkami. 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. BookingFailure służy przede wszystkim do rejestrowania błędów logiki biznesowej.

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

enum (Cause)

przyczyna niepowodzenia rezerwacji; (wymagane)
rejectedCardType

enum (CreditCardType)

(wymagany tylko wtedy, gdy przyczyna to PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

To opcjonalne pole służy do przekazywania przez partnera dodatkowych informacji tylko na potrzeby 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łany przedział dostępności nie jest już dostępny.
SLOT_ALREADY_BOOKED_BY_USER Użytkownik ma już zarezerwowaną wizytę w określonym czasie.
LEASE_EXPIRED Umowa najmu (jeśli została podana) wygasła i nie można jej już użyć do zrealizowania żą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 rejectedCardType.
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 członkostwa użytego do opłacenia rezerwacji. Mogą nie być już żadne prawidłowe użycia, może on 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ścią, tylko jeśli nie pasuje on do żadnego z wymienionych 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 Rezerwacji, której użytkownik próbował anulować, nie można anulować.
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 niezmieniony. Ponowne próby będą całkowicie oddzielne.

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 agregatora RwG do zainicjowania protokołu uwierzytelniania 3DS 1 z użytkownikiem. Będzie zignorowany, chyba że BookingFailure.cause jest ustawiony na PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Parametry, które wymagają od RwG wykonania wyzwania 3DS1.

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

Prośba o płatność. Przesłanie do formularza ACSUrl, jeśli został podany.
transactionId

string

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

string

Dane sprzedawcy. Przesłanie do formularza ACSUrl, jeśli został podany.