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 pola wszystkich pól rezerwacji do zaktualizowania

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

object (BookingFailure)

Jeśli przetwarzanie asynchronicznie potwierdzonej prośby o rezerwację się nie uda, a stan rezerwacji zostanie zmieniony na NIEPRAWIDŁOWA, to pole powinno odzwierciedlać błąd logiki biznesowej (np. użytkownik ma już rezerwację zbyt blisko tej godziny). To pole należy ustawić tylko podczas aktualizowania stanu rezerwacji na BŁĄD. W przeciwnym razie będzie ignorowane.

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 o stanie, które informują, dlaczego asynchroniczne przetwarzanie rezerwacji nie powiodło się. Celem BookingFailure jest głównie wykrywanie 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. (pole wymagane)
rejectedCardType

enum (CreditCardType)

(wymagane tylko wtedy, gdy przyczyna to PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

To opcjonalne pole służy partnerowi do podawania dodatkowych informacji wyłącznie do celów debugowania. (opcjonalnie)
paymentFailure

object (PaymentFailureInformation)

Informacje o nieudanych płatności.

Przyczyna

Wyliczenie przyczyn niepowodzenia.

Wartości w polu enum
CAUSE_UNSPECIFIED Wartość domyślna: nie używać; oznacza „nieznany błąd”
SLOT_UNAVAILABLE Wskazany przedział dostępności nie jest już dostępny.
SLOT_ALREADY_BOOKED_BY_USER Użytkownik zarezerwował już spotkanie we wskazanym przedziale dostępności.
LEASE_EXPIRED Wynajem (jeśli został podany) wygasł i nie można go już wykorzystać do zrealizowania żądanej rezerwacji.
OUTSIDE_CANCELLATION_WINDOW Z powodu ograniczeń czasowych określonych przez sprzedawcę w zasadach anulowania w tej chwili nie można dokonać żądanego anulowania.
PAYMENT_ERROR_CARD_TYPE_REJECTED Podczas przetwarzania płatności wystąpił błąd, ponieważ podany typ karty kredytowej nie został zaakceptowany przez sprzedawcę. 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 związany z pakietem lub członkostwem użytymi do opłacenia rezerwacji. Możliwe, że nie zostało użyte żadne ważne konto, karta wygasła 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 jest on zgodny z podanym powyżej błędem płatności.
USER_CANNOT_USE_PAYMENT_OPTION Użytkownik nie może użyć danej opcji płatności (np. użytkownik próbuje użyć ceny za pierwszym razem).
BOOKING_ALREADY_CANCELLED Rezerwacja, którą użytkownik próbował anulować, została już anulowana.
BOOKING_NOT_CANCELLABLE Rezerwacji, którą użytkownik próbował anulować, nie można anulować.
OVERLAPPING_RESERVATION Użytkownik ma już rezerwację, która przypada zbyt blisko tej godziny.
USER_OVER_BOOKING_LIMIT Rezerwacja nie powiodła się, ponieważ użytkownik przekroczył ustalony przez pośrednika limit rezerwacji na użytkownika.
PAYMENT_REQUIRES_3DS1

Określ, kiedy płatność ma zostać odrzucona, ponieważ prosisz o ponowną próbę realizacji transakcji, ale tym razem po wykonaniu testu zabezpieczającego/odpowiedzi 3DS1. Pamiętaj, że stan błędu bieżącej transakcji pozostanie niepowodzeniem. Ponawiam próbę.

Jeśli jest to przyczyna niepowodzenia, musisz ustawić parametr paymentFailure.3DS1_parameters. Jeśli tak nie jest, obecna przyczyna jest traktowana tak, jakby była to PAYMENT_ERROR.

PaymentFailureInformation

Informacje o nieudanych płatności.

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

object (ThreeDS1Parameters)

Parametry używane przez agregator RwG do inicjowania protokołu uwierzytelniania 3DS1 u użytkownika. Jest ignorowana, chyba że BookingFailure.cause ma wartość PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Parametry żądające od RwG zadania 3DS1.

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

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

string

Adres URL, z którego ma zostać wczytany formularz, który zostanie przedstawiony użytkownikowi w celu uwierzytelnienia.
paReq

string

Żądanie uwierzytelniania PaymentAuth. Do opublikowania w formularzu ACSUrl, jeśli jest podany.
transactionId

string

Identyfikator używany przez dostawcę usługi ACS. Do opublikowania w formularzu ACSUrl, jeśli jest podany.
mdMerchantData

string

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