REST Resource: notification.partners.bookings

Risorsa: prenotazione

Una prenotazione per uno spazio pubblicitario

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

string

Nome risorsa della prenotazione: partners/{partner ID}/bookings/{booking ID}

merchantId

string

ID del commerciante per l'area

serviceId

string

ID del servizio commerciante

startTime

string (Timestamp format)

Ora di inizio dello spazio per appuntamenti

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

Durata dello spazio per appuntamenti

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

clientInformation

object (ClientInformation)

Informazioni personali del cliente che fissa l'appuntamento

status

enum (BookingStatus)

Stato della prenotazione

paymentInformation

object (PaymentInformation)

Informazioni sulle transazioni di pagamento relative alla prenotazione.

partySize

string (int64 format)

Numero di persone della prenotazione

ClientInformation

Informazioni personali della persona che effettua una prenotazione

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

string

Nome del cliente

familyName

string

Cognome del cliente

address

object (PostalAddress)

Indirizzo del client

telephone

string

Numero di telefono del cliente

email

string

Indirizzo email del client

BookingStatus

Stato di una prenotazione

Enum
BOOKING_STATUS_UNSPECIFIED Non specificato.
CONFIRMED La prenotazione è stata confermata
PENDING_MERCHANT_CONFIRMATION La prenotazione è in attesa di conferma da parte del commerciante prima che possa passare allo stato CONFERMA (questa operazione NON è attualmente supportata)
PENDING_CLIENT_CONFIRMATION La prenotazione è in attesa di conferma da parte del cliente prima che possa passare allo stato CONFERMA (questa operazione NON è attualmente supportata)
CANCELED La prenotazione è stata annullata per conto dell'utente.
NO_SHOW Il cliente non si è presentato per l'appuntamento
NO_SHOW_PENALIZED Il cliente non si è presentato per l'appuntamento in violazione delle norme sull'annullamento.
FAILED Impossibile completare la prenotazione a causa di un errore di elaborazione.
DECLINED_BY_MERCHANT La prenotazione è stata rifiutata in modo asincrono dal commerciante.

PaymentInformation

Dettagli sul pagamento relativi a una prenotazione

Rappresentazione JSON
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
Campi
prepaymentStatus

enum (PrepaymentStatus)

Stato del pagamento anticipato della prenotazione. Se prepaymentStatus è PREPAYMENT_PROVIDED o PREPAYMENT_REFUNDED, allora paymentTransactionId contiene l'ID transazione univoco associato.

paymentTransactionId

string

Identificatore univoco di una transazione di pagamento associata alla prenotazione. Vuoto se non applicabile.

PrepaymentStatus

Stato del pagamento anticipato di una prenotazione.

Enum
PREPAYMENT_STATUS_UNSPECIFIED Non specificato, il valore predefinito è PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED La tariffa per la prenotazione è stata pagata in anticipo.
PREPAYMENT_NOT_PROVIDED La commissione per la prenotazione non è stata pagata in anticipo.
PREPAYMENT_REFUNDED In precedenza la commissione era di PREPAYMENT_PROVIDED, ma ora è stata rimborsata.

Metodi

patch

Consente di aggiornare un elemento Booking esistente.