REST Resource: notification.partners.bookings

Zasób: Booking

Rezerwacja miejsca na reklamę

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 dla przedziału

serviceId

string

Identyfikator usługi sprzedawcy

startTime

string (Timestamp format)

Godzina rozpoczęcia terminu spotkania

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

duration

string (Duration format)

Czas trwania terminu spotkania

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

clientInformation

object (ClientInformation)

Dane osobowe klienta, który umawia 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 w 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 przejść do stanu POTWIERDZONA (obecnie NIE jest to obsługiwane).
PENDING_CLIENT_CONFIRMATION Rezerwacja oczekuje na potwierdzenie przez klienta, zanim będzie mogła przejść do stanu POTWIERDZONA (obecnie NIE jest 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, co jest niezgodne z zasadami anulowania.
FAILED Nie udało się dokonać rezerwacji z powodu błędu przetwarzania.
DECLINED_BY_MERCHANT Rezerwacja została asynchronicznie odrzucona przez sprzedawcę.

PaymentInformation

dane 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 wartość prepaymentStatus to PREPAYMENT_PROVIDED lub PREPAYMENT_REFUNDED, pole paymentTransactionId zawiera powiązany unikalny identyfikator transakcji.

paymentTransactionId

string

Unikalny identyfikator transakcji płatniczej powiązanej z rezerwacją. Puste, jeśli nie dotyczy.

PrepaymentStatus

Stan przedpłaty za rezerwację.

Wartości w polu enum
PREPAYMENT_STATUS_UNSPECIFIED Nie określono, domyślnie PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED Opłata za rezerwację została uiszczona z góry.
PREPAYMENT_NOT_PROVIDED Opłata za rezerwację nie została uiszczona z góry.
PREPAYMENT_REFUNDED Opłata była wcześniej typu PREPAYMENT_PROVIDED, ale została zwrócona.

Metody

patch

Aktualizuje istniejący Booking.