REST Resource: inventory.partners.merchants.services.availability

string (Timestamp format)

Heure de début du créneau horaire.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

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"

string (int64 format)

Nombre total de créneaux et de créneaux disponibles pour cette disponibilité. Exemples :

• Un cours de yoga comprenant 10 créneaux dont 3 réservés : availability {spotsTotal: 10, spotsOpen: 7 ...}
• Une séance de massage sur chaise qui est déjà complètement réservée : availability {spotsTotal: 1, spotsOpen: 0 ...}

Remarque : Si vous envoyez des requêtes à l'aide du format de compression applicable au flux de disponibilité défini ci-dessous, le système infère la valeur de ces deux champs.

• Définissez spotsTotal=1 et spotsOpen=1 en cas de "Recurrence".
• Définissez spotsTotal=1 et spotsOpen=0 en cas de "ScheduleException".

string (int64 format)

Nombre de créneaux libres.

string

Chaîne opaque facultative permettant d'identifier ce créneau de disponibilité. Si la valeur est définie, elle est incluse dans les demandes de réservation/de mise à jour/d'annulation de rendez-vous.

object (Resources)

Ressources facultatives permettant de faire la distinction entre ce créneau de disponibilité et d'autres créneaux, lorsque plusieurs membres du personnel ou salles ont été définis pour le service.

Par exemple, le même cours de yoga avec deux enseignants :

availability { resources { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 2 }

string

Liste d'ID faisant référence aux options de paiement pouvant être utilisées pour le paiement de ce créneau. Les options de paiement réelles sont définies au niveau du marchand et peuvent également s'appliquer à plusieurs marchands.

Ce champ remplace tout ID payment_option_ids éventuellement spécifié dans le message du service. De même, les identifiants payment_option_ids spécifiés ici ne doivent PAS OBLIGATOIREMENT être inclus dans le message du service, mais doivent l'être au niveau du marchand.

object (Recurrence)

Informations de récurrence sur la disponibilité, représentant plusieurs heures de début. Une récurrence doit contenir des rendez-vous sur un jour ouvré.

object (ScheduleException)

Nombre de fois où ce service ne peut pas être planifié. Pour limiter le nombre de messages scheduleException, envisagez d'agréger les exceptions adjacentes.

object (Deposit)

Acompte facultatif à verser pour ce créneau de disponibilité. Remplace l'acompte éventuellement défini au niveau du service.

object (NoShowFee)

Frais de non-présentation facultatifs pour cette disponibilité. Remplace les frais de non-présentation éventuellement définis au niveau du service.

enum (RequireCreditCard)

Indique si une carte de crédit est requise pour réserver ce créneau de disponibilité. Si la valeur n'est pas définie, elle est héritée le cas échéant du niveau service. (facultatif)

string

Indique la liste des types de billets acceptés pour ce créneau de disponibilité. Si ce paramètre n'est pas défini, tous les types de demandes du service parent sont disponibles pour ce créneau. Notez que les valeurs de ce champ doivent être définies dans le service parent. Exemples :

• Service avec quatre types de billets : TicketType {ticketTypeId: "adulte_1" shortDescription: "Adulte en semaine"} TicketType {ticketTypeId: "adulte_2" shortDescription: "Adulte le week-end"} TicketType {ticketTypeId: "jeune_1" shortDescription: "Jeune en semaine"} TicketType {ticketTypeId: "jeune_2" shortDescription: "Jeune le week-end"}

Pour représenter l'inventaire en semaine : availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...}. Pour représenter l'inventaire les jours non ouvrés : availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...}.

• Service avec trois types de billets : TicketType {ticketTypeId: "adulte" shortDescription: "Adulte"} TicketType {ticketTypeId: "jeune" shortDescription: "Jeune"} TicketType {ticketTypeId: "retraité" shortDescription: "Retraité"}

Pour indiquer que les trois types de billets sont disponibles pour ce créneau horaire, utilisez soit availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...}, soit "availability {...}" (ne définissez pas la valeur ticketTypeId pour ce créneau).

(facultatif)

enum (DurationRequirement)

Obligation d'indiquer la durée et/ou l'heure de fin des créneaux. Ce champ sera ignoré si le créneau n'est pas disponible. Non utilisé pour le secteur des activités à découvrir. (facultatif)

object (SchedulingRuleOverrides)

Règles de planification des créneaux de disponibilité. Si des champs sont renseignés, ils remplacent toutes les règles de planification correspondantes dans SchedulingRules au niveau du service.

enum (ConfirmationMode)

Mode de confirmation utilisé lors de la réservation de cette disponibilité. Les tentatives de création de réservations pour des disponibilités avec un mode de confirmation CONFIRMATION_MODE_SYNCHRONOUS doivent être immédiatement confirmées ou refusées. Les tentatives de création de réservations pour des créneaux de disponibilité dont le mode de confirmation est CONFIRMATION_MODE_ASYNCHRONOUS doivent être immédiatement refusées ou créées avec l'état PENDING.

string

ID facultatif d'un membre du personnel fournissant le service. Ce champ identifie le membre du personnel pour tous les marchands, services et enregistrements de disponibilité. La valeur doit rester la même au fil du temps afin de pouvoir établir des corrélations avec les réservations passées. Si le champ staffName est défini, celui-ci doit l'être aussi.

string

Nom facultatif d'un membre du personnel fournissant le service. La valeur de ce champ est présentée aux utilisateurs qui effectuent une réservation. Elle doit être lisible (et ne doit donc pas être un identifiant opaque). Si le champ staffId est défini, celui-ci doit l'être aussi.

string

ID facultatif de la salle dans laquelle le service est fourni. Ce champ identifie la salle pour tous les marchands, services et enregistrements de disponibilité. La valeur doit rester la même au fil du temps afin de pouvoir établir des corrélations avec les réservations passées. Si le champ roomName est défini, celui-ci doit l'être aussi.

string

Nom facultatif de la salle dans laquelle est fourni le service. Ce champ sera présenté aux utilisateurs effectuant une réservation. Il doit être lisible et ne pas être un identifiant opaque. (Facultatif, mais obligatoire si roomId est présent) Dans le restaurant, le nom d'une salle ne doit être utilisé que pour les coins salon tels que le bar ou le patio. Il ne doit pas être utilisé pour les menus à prix fixe, les activités spéciales ou toute autre valeur qui ne correspond pas à la chambre (réservation ou dîner, par exemple). Il est fortement recommandé de ne pas associer de pièce au coin salon par défaut.

integer

Applicable uniquement au secteur de la restauration : nombre de personnes pouvant être incluses dans la réservation de ce créneau. Un restaurant peut être associé à plusieurs Slots pour le même créneau horaire, chacun spécifiant un nombre de personnes (partySize) différent, si par exemple 2, 3 ou 4 personnes peuvent réserver une table.

string (Timestamp format)

Horodatage au format UTC maximal et inclusif jusqu'auquel ce créneau de disponibilité se répète.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Définit l'intervalle entre des créneaux de disponibilité successifs.

Exemple : Un créneau de disponibilité d'une durée de 20 min, une valeur repeatEvery de 30 min, une valeur startTime de 9h00 et une valeur repeatUntil de 11h00 généreront des créneaux à 9h-9h20, 9h30-9h50, 10h-10h20, 10h30-10h50 et à 11h-11h20. (obligatoire)

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

object (TimeRange)

Période à laquelle l'exception s'applique. Tous les créneaux décrits par la récurrence qui chevauchent cette période ouvert-fermé seront considérés comme non disponibles.

Exemple : Une récurrence spécifiant une durée de 20 min, une valeur repeatEvery de 30 min, une valeur startTime de 9h00 et une valeur repeatUntil de 11h00, puis une exception ScheduleException dont la valeur timeRange est de 9h45-11h00 rendraient les créneaux 9h30-9h50, 10h-10h20 et 10h30-10h50 non disponibles.

Notez que, comme la période est de type ouvert-fermé, le créneau commençant à 11h n'est pas affecté.

string (int64 format)

Dernière heure (en secondes) à laquelle ce créneau peut être réservé. Cet horodatage doit être situé avant la valeur startSec du créneau (si les utilisateurs ont la possibilité de réserver après l'heure de début, utilisez le niveau de service SchedulingRules.min_booking_before_end_time). Lorsque cette valeur est définie, elle remplace toute valeur spécifiée dans le champ min_booking_buffer des règles SchedulingRules correspondantes définies au niveau du service.

string (int64 format)

Première heure (en secondes) à laquelle ce créneau peut être réservé. Cet horodatage doit être situé avant la valeur startSec du créneau (ou avant la valeur lastBookableSec si elle est spécifiée).

string (int64 format)

Si cette option est définie, il s'agit de la dernière heure (en secondes depuis l'epoch Unix) à laquelle ce créneau horaire spécifique peut être annulé via Réserver avec Google. Ce champ remplace les règles d'annulation définies au niveau du service. (facultatif)