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 annuncio
serviceId

string

ID del servizio del commerciante
startTime

string (Timestamp format)

Ora di inizio dello spazio per appuntamenti

Un timestamp in formato "Zulu" UTC RFC3339, 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

Una durata in secondi con un massimo di nove cifre frazionarie, che 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 correlate alla prenotazione.
partySize

string (int64 format)

Numero di persone della prenotazione

ClientInformation

Informazioni personali sulla 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 cliente

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 dal commerciante prima di poter passare allo stato CONFERMATO (al momento NON è supportata)
PENDING_CLIENT_CONFIRMATION La prenotazione è in attesa di conferma da parte del cliente prima di poter passare allo stato CONFERMATO (al momento NON è supportata)
CANCELED La prenotazione è stata annullata per conto dell'utente.
NO_SHOW Il cliente non è stato mostrato per l'appuntamento
NO_SHOW_PENALIZED Il cliente non si è presentato per l'appuntamento, violando le norme sulla cancellazione.
FAILED Impossibile completare la prenotazione a causa di un errore di elaborazione.
DECLINED_BY_MERCHANT La prenotazione è stata rifiutata dal commerciante in modo asincrono.

PaymentInformation

Dettagli di 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, il pagamentoTransactionId contiene l'ID transazione univoco associato.
paymentTransactionId

string

Identificatore univoco per 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 Il costo della prenotazione è stato pagato in anticipo.
PREPAYMENT_NOT_PROVIDED Il costo della prenotazione non è stato pagato in anticipo.
PREPAYMENT_REFUNDED La commissione in precedenza era di PREPAYMENT_PROVIDED, ma ora è stata rimborsata.

Metodi

patch

 Aggiorna un elemento Booking esistente.