REST Resource: notification.partners.bookings

Zasób: rezerwacja

Rezerwacja boksu zasobów reklamowych

Zapis JSON
{
  "name": string,
  "merchantId": string,
  "serviceId": string,
  "startTime": string,
  "duration": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "status": enum (BookingStatus),
  "paymentInformation": {
    object (PaymentInformation)
  },
  "partySize": string
}
Pola
name

string

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

merchantId

string

Identyfikator sprzedawcy przedziału

serviceId

string

Identyfikator usługi sprzedawcy

startTime

string (Timestamp format)

Godzina rozpoczęcia przedziału czasu dla spotkań

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

Czas trwania przedziału czasu dla spotkań

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

clientInformation

object (ClientInformation)

Dane osobowe klienta organizującego spotkanie

status

enum (BookingStatus)

Stan rezerwacji

paymentInformation

object (PaymentInformation)

Informacje o transakcjach płatniczych związanych z rezerwacją.

partySize

string (int64 format)

Liczba osób dokonujących rezerwacji

ClientInformation

Dane osobowe osoby dokonującej rezerwacji

Zapis JSON
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
Pola
givenName

string

Imię klienta

familyName

string

Nazwisko klienta

address

object (PostalAddress)

Adres klienta

telephone

string

Numer telefonu klienta

email

string

Adres e-mail klienta

BookingStatus

Stan rezerwacji

Wartości w polu enum
BOOKING_STATUS_UNSPECIFIED Nie określono.
CONFIRMED Rezerwacja została potwierdzona
PENDING_MERCHANT_CONFIRMATION Rezerwacja oczekuje na potwierdzenie przez sprzedawcę, zanim będzie mogła mieć stan POTWIERDZONO (ta funkcja NIE jest obecnie obsługiwana)
PENDING_CLIENT_CONFIRMATION Rezerwacja oczekuje na potwierdzenie przez klienta, zanim będzie mogła uzyskać stan POTWIERDZONO (ta funkcja NIE jest obecnie obsługiwana).
CANCELED Rezerwacja została anulowana w imieniu użytkownika.
NO_SHOW Klient nie pojawił się na spotkaniu
NO_SHOW_PENALIZED Klient nie pojawił się na spotkaniu z naruszeniem zasad anulowania.
FAILED Nie udało się dokończyć rezerwacji z powodu błędu przetwarzania.
DECLINED_BY_MERCHANT Rezerwacja została asynchronicznie odrzucona przez sprzedawcę.

PaymentInformation

Dane do płatności związane z rezerwacją

Zapis JSON
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
Pola
prepaymentStatus

enum (PrepaymentStatus)

Stan przedpłaty za rezerwację. Jeśli stan przedpłaty to PREPAYMENT_PROVIDED lub PREPAYMENT_REFUNDED, metoda paymentTransactionId zawiera powiązany unikalny identyfikator transakcji.

paymentTransactionId

string

Unikalny identyfikator transakcji płatności powiązanej z rezerwacją. Jeśli nie ma zastosowania, pole puste.

PrepaymentStatus

Stan przedpłaty za rezerwację.

Wartości w polu enum
PREPAYMENT_STATUS_UNSPECIFIED Nie określono, domyślna wartość to PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED Opłata za rezerwację została opłacona z góry.
PREPAYMENT_NOT_PROVIDED Opłata za rezerwację nie została wniesiona z góry.
PREPAYMENT_REFUNDED Wcześniej opłata wynosiła PREPAYMENT_PROVIDED, ale została zwrócona.

Metody

patch

Aktualizuje istniejące Booking.