REST Resource: notification.partners.bookings

Ressource : Booking

Une réservation pour un créneau d'inventaire

Représentation JSON 
{
  "name": string,
  "merchantId": string,
  "serviceId": string,
  "startTime": string,
  "duration": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "status": enum (BookingStatus),
  "paymentInformation": {
    object (PaymentInformation)
  },
  "partySize": string
}
Champs
name

string

Nom de la ressource associée à la réservation : partners/{partner ID}/bookings/{booking ID}
merchantId

string

ID du marchand pour le créneau
serviceId

string

ID du service du marchand
startTime

string (Timestamp format)

Heure de début du créneau horaire

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
duration

string (Duration format)

Durée du créneau horaire

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par 's'. Exemple : "3.5s".
clientInformation

object (ClientInformation)

Informations personnelles du client prenant rendez-vous.
status

enum (BookingStatus)

État de la réservation
paymentInformation

object (PaymentInformation)

Informations sur les transactions de paiement liées à la réservation.
partySize

string (int64 format)

Nombre de personnes pour la réservation

ClientInformation

Informations personnelles sur la personne effectuant la réservation

Représentation JSON 
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
Champs
givenName

string

Nom du client
familyName

string

Nom de famille du client
address

object (PostalAddress)

Adresse du client
telephone

string

Numéro de téléphone du client
email

string

Adresse e-mail du client

BookingStatus

État d'une réservation

Énumérations
BOOKING_STATUS_UNSPECIFIED Non spécifié.
CONFIRMED La réservation a été confirmée.
PENDING_MERCHANT_CONFIRMATION La réservation attend la confirmation du marchand avant de pouvoir passer à l'état CONFIRMED (le système n'est PAS encore compatible avec cette fonctionnalité).
PENDING_CLIENT_CONFIRMATION La réservation attend la confirmation du client avant de pouvoir passer à l'état CONFIRMED (le système n'est PAS encore compatible avec cette fonctionnalité).
CANCELED La réservation a été annulée au nom de l'utilisateur.
NO_SHOW Le client ne s'est pas présenté au rendez-vous.
NO_SHOW_PENALIZED Le client ne s'est pas présenté au rendez-vous et a donc enfreint les modalités d'annulation.
FAILED La réservation a échoué en raison d'un problème au niveau du traitement.
DECLINED_BY_MERCHANT La réservation a été refusée de manière asynchrone par le marchand.

PaymentInformation

Détails du paiement lié à une réservation.

Représentation JSON 
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
Champs
prepaymentStatus

enum (PrepaymentStatus)

État du pré-paiement de la réservation. Si prepaymentStatus est défini sur PREPAYMENT_PROVIDED ou sur PREPAYMENT_REFUNDED, alors paymentTransactionId contient l'ID de transaction unique associé.
paymentTransactionId

string

Identifiant unique d'une transaction de paiement associée à la réservation. Vide si non applicable.

PrepaymentStatus

État du pré-paiement d'une réservation.

Énumérations
PREPAYMENT_STATUS_UNSPECIFIED Non spécifié. La valeur par défaut est PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED Les frais de réservation ont été réglés à l'avance.
PREPAYMENT_NOT_PROVIDED Les frais de réservation n'ont pas été réglés à l'avance.
PREPAYMENT_REFUNDED Les frais affichaient auparavant l'état PREPAYMENT_PROVIDED, mais ils ont maintenant été remboursés.

Méthodes

patch

 Met à jour une valeur Booking existante.