Package google.maps.booking.v1alpha

string

L'URL du point d'entrée correspondant à ce lien d'action.

string

Balise de langue BCP-47 identifiant la langue du contenu associé à cet URI.

string

Code pays ISO 3166-1 Alpha-2. Laissez ce champ vide si vous ne souhaitez pas restreindre la visibilité du contenu.

ActionPlatform

Plate-forme sur laquelle cette action doit être effectuée. Si ce champ n'est pas défini, ACTION_PLATFORM_WEB_APPLICATION est utilisé à la place.

ActionLinkType

Type d'action prédéterminé.

OrderOnlineMetadata

Métadonnées du lien de commande en ligne. Prise en charge de l'action avec ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

Métadonnées pour les liens de commande de repas. Compatible avec le type d'action: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT Ne prend PAS en charge ACTION_LINK_TYPE_ORDER_FOOD.

Text

Message personnalisé à présenter à l'utilisateur lorsqu'il effectue une réservation via Réserver avec Google.

Timestamp

Heure de début du créneau horaire.

Duration

Durée du créneau horaire

int64

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 {spots_total: 10, spots_open: 7 ...}
• Une séance de massage sur chaise qui est déjà complètement réservée : availability {spots_total: 1, spots_open: 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 spots_total=1 et spots_open=1 en cas de "Recurrence".
• Définissez spots_total=1 et spots_open=0 en cas de "ScheduleException".

int64

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.

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 { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 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.

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é.

ScheduleException

Nombre de fois où ce service ne peut pas être planifié. Pour limiter le nombre de messages de schedule_exception, envisagez de joindre les exceptions adjacentes.

Deposit

Acompte facultatif pour cette disponibilité. Remplace l'acompte éventuellement défini au niveau du service.

NoShowFee

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

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 {ticket_type_id: "adulte_1" short_description: "Adulte en semaine"} TicketType {ticket_type_id: "adulte_2" short_description: "Adulte le week-end"} TicketType {ticket_type_id: "jeune_1" short_description: "Jeune en semaine"} TicketType {ticket_type_id: "jeune_2" short_description: "Jeune le week-end"}

Pour représenter l'inventaire en semaine : availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Pour représenter l'inventaire pendant les fêtes : availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

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

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

(facultatif)

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)

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.

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 disponibilités dont le mode de confirmation est CONFIRMATION_MODE_ASYNCHRONOUS doivent être refusées immédiatement ou créées avec l'état PENDING.

Timestamp

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

Duration

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 repeat_every de 30 min, une valeur start_time de 9h00 et une valeur repeat_until de 11h00 généreront des créneaux à 9h-9h20, 9h30-9h50, 10h-10h20, 10h30-10h50 et à 11h-11h20. (obligatoire)

TimeRange

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

Exemple : Une récurrence spécifiant une durée de 20 min, une valeur repeat_every de 30 min, une valeur start_time de 9h00 et une valeur repeat_until de 11h00, puis une exception ScheduleException dont la valeur time_range 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é.

int64

Dernier moment (en secondes) auquel ce créneau peut être réservé. Cet horodatage doit se situer avant la valeur start_sec associée au créneau (si les utilisateurs peuvent réserver après l'heure de début, utilisez SchedulingRules.min_booking_before_end_time au niveau du service). Si cette valeur est définie, elle remplace toute valeur spécifiée dans min_booking_buffer au niveau des SchedulingRules du service correspondant.

int64

Premier moment (en secondes) auquel ce créneau peut être réservé. Cet horodatage doit être situé avant la valeur start_sec associée au créneau, ou avant la valeur last_bookable_sec si elle est spécifiée.

int64

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)

string

Nom de la ressource, au format partners/{partner_id}/feeds/{feed_name}.

GenericDeleteRecord

Enregistrements à supprimer. Un appel d'API peut comporter jusqu'à 1 000 enregistrements.

string

Nom de la ressource, au format partners/{partner_id}/feeds/{feed_name}.

GenericRecord

Enregistrements à insérer et/ou à mettre à jour. Un appel d'API peut comporter jusqu'à 1 000 enregistrements.

string

Format partners/{partner_id}.

ExtendedServiceAvailability

Disponibilité étendue du service utilisée pour remplacer les créneaux de disponibilité existants.

ExtendedServiceAvailability

Messages bien mis à jour concernant la disponibilité étendue du service qui ont été utilisés pour remplacer les créneaux de disponibilité existants.

string

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

string

ID du marchand pour l'emplacement

string

ID du service marchand

Timestamp

Heure de début du créneau horaire

Duration

Durée du créneau horaire

ClientInformation

Informations personnelles du client prenant rendez-vous

BookingStatus

État de la réservation

PaymentInformation

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

int64

Nombre de personnes pour la réservation

Cause

Cause de l'échec de la réservation. (obligatoire)

CreditCardType

(obligatoire uniquement si la cause est PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

Ce champ facultatif permet au partenaire d'inclure des informations supplémentaires à des fins de débogage seulement. (facultatif)

PaymentFailureInformation

Données concernant les échecs de paiement.

ThreeDS1Parameters

Paramètres utilisés par un agrégateur RwG pour lancer un protocole d’authentification 3DS1 avec l’utilisateur. Le système ignore ces paramètres, à moins que BookingFailure.cause ne soit défini sur PAYMENT_REQUIRES_3DS1.

string

URL à partir de laquelle charger un formulaire à présenter à l'utilisateur pour authentification.

string

Une requête PaymentAuthentication. À publier dans le formulaire ACSUrl, le cas échéant.

string

Un identifiant utilisé par le fournisseur ACS. À publier dans le formulaire ACSUrl, le cas échéant.

string

Données du marchand. À publier dans le formulaire ACSUrl, le cas échéant.

RefundCondition

Aucune, une ou plusieurs conditions de remboursement applicables aux conditions de remboursement.

Duration

Période avant l'heure de début jusqu'à laquelle le client peut recevoir un remboursement pour une partie du coût du service spécifié dans refund_percent. Si la valeur est définie sur 0 (valeur par défaut), le service peut être annulé à tout moment.

uint32

Pourcentage remboursable, à condition que la réservation du service soit annulée au moins min_duration_before_start_time avant l'heure de début du service, dans la plage de [0, 100]. Si la valeur est définie sur 0 (valeur par défaut), le service n'est pas remboursable. Si la valeur est définie sur 100 (valeur par défaut), le service est remboursable dans son intégralité.

string

Prénom du client

string

Nom de famille du client

PostalAddress

Adresse du client

string

Numéro de téléphone du client

string

Adresse e-mail du client

string

Nom de la ressource parente du partenaire propriétaire de ce marchand, au format partners/{partner_id}.

string

Référence marchand à utiliser pour ce marchand.

Merchant

Marchand à créer.

string

Nom de la ressource parente du marchand propriétaire de ce service, au format partners/{partner_id}/merchants/{merchant_id}.

string

ID à utiliser pour ce service.

Service

Service à créer.

CreditCardType

Liste des cartes de crédit acceptées. Aucune carte de crédit n'est acceptée si non défini.

string

Nom de la ressource du marchand à supprimer. Au format partners/{partner_id}/merchants/{merchant_id}

string

Nom de la ressource du service à supprimer. Au format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

Price

Montant du virement

int64

Délai d'annulation minimal pour l'acompte.

PriceType

Définit la manière dont l'acompte est déterminé à partir d'une disponibilité.

Text

Les utilisateurs sont invités à ne payer que via les modes de paiement mentionnés ci-dessous.

Duration

Durée minimale.

Duration

Durée maximale.

string

Ce champ obligatoire permet d'indiquer à quel marchand appartiennent les messages de disponibilité ci-dessous.

string

Ce champ obligatoire permet d'indiquer à quel service appartiennent les messages de disponibilité ci-dessous.

Timestamp

Nous traitons les entités de disponibilité éventuellement fournies comme un instantané complet de [start_time_restrict, end_time_restrict). Autrement dit, le système supprime toute disponibilité existante si la condition suivante est remplie :

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Si un message "duration" (durée) est défini, la condition est encore plus exigeante :

  availability.duration == duration_restrict

Si un message "resources_restrict" est défini, la condition est plus exigeante encore :

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Ces champs sont généralement utilisés pour fournir une mise à jour complète de la disponibilité pour une période donnée.

Si vous définissez la valeur start_time_restrict, mais pas la valeur end_time_restrict, le système en conclut que toutes les heures commencent à start_time_restrict.

Timestamp

Si vous définissez la valeur end_time_restrict, mais pas la valeur start_time_restrict, le système en conclut que toutes les heures sont incluses jusqu'à la fin de end_time_restrict.

Duration

Lorsque la durée est définie, toute mise à jour de la disponibilité est limitée aux créneaux de cette durée.

Resources

Lorsque resources_restrict est défini, toute mise à jour est limitée à cet ensemble de ressources. Tous les champs des identifiants de ressources doivent correspondre exactement.

Availability

Nouvelle liste de disponibilités.

int64

Nouveaux éléments ajoutés par ce flux. En fonction du type de flux, les éléments peuvent correspondre à des marchands, des services ou des créneaux de disponibilité.

int64

Éléments existants, mis à jour selon les besoins à partir des informations plus récentes du flux.

int64

Articles qui ne sont plus présents dans ce flux et qui ont donc été supprimés.

string

Nom de la ressource du flux, au format

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

État de traitement de ce flux.

string

Chaîne lisible fournissant plus de détails si nous n'avons pas pu traiter ce flux.

FeedStatistics

Statistiques spécifiques à ce flux.

FeeDetails

Détails des frais facturés à l'utilisateur en plus du montant total de l'article. Répéter pour différents types de frais, tels que les frais de service, les frais de livraison, etc.

AdvanceOrderDetails

Détails sur l'assistance avancée aux commandes, également appelée "commande à l'avance", qui permet à l'utilisateur de passer une commande à traiter plus tard.

Duration

Durée fixe. Par exemple: 30 minutes.

DurationRange

Une plage de durées. Exemples: * 30 min à 45 min * Plus de 30 min * Moins de 50 min

bool

True si les commandes anticipées, également appelées commandes à l'avance, sont acceptées. (obligatoire)

FeeType

Type de frais. (obligatoire)

FeeAmount

Montant des frais exprimé en devise unitaire, sous forme de pourcentage de la valeur du panier ou une combinaison des deux. (obligatoire)

QuantitativeValue

Frais exprimés en pourcentage de la valeur du panier. Compatible avec une plage (limitée et illimitée) ou un pourcentage fixe. La valeur doit être comprise entre 0 et 100. Exemples: * Fixe 5,5% * Au moins 5,5% * Au maximum 5,5% * 4,5% à 5,5%

Money

Montant fixe. Exemple : 3,5 USD.

MoneyRange

Plage de montants. Exemples: * 3,5 € à 5,5 € * Au moins 3,5 € x 5,5 € maximum

bool

Montant inconnu.

FulfillmentType

Obligatoire. Type de traitement.

AvailableDay

Obligatoire. Liste des jours pendant lesquels la disponibilité est disponible pour cette méthode de traitement des commandes (au moins deux de préférence).

FeeDetails

Obligatoire. Détails des frais pour la méthode de fulfillment.

Price

Obligatoire. Commande minimale pour la méthode de traitement associée au lien d'action.

Date

Obligatoire. Date disponible pour une méthode de traitement. Est censé se trouver dans le fuseau horaire du marchand.

Timestamp

Obligatoire. Horodatage Unix. Dernière fois qu'un utilisateur a pu commander et recevoir des articles d'ici le fulfillment_date. En d'autres termes, après last_ordering_time, fulfillment_date ne sera plus affiché comme disponible.

Par exemple, si fulfillment_date est 2020-08-10: - une valeur last_ordering_time de 2020-08-10 18:00 signifie que pour recevoir sa commande le 2020-08-10, un client doit la passer avant 18h le même jour. : la valeur 2020-08-08 20:00 signifie que pour recevoir sa commande le 10/08/2020, le client doit la passer avant 20h deux jours avant.

NoFee

Aucuns frais pour la méthode de traitement.

MinimumFee

Frais de base associés à la méthode de traitement.

FixedFee

Frais fixes associés à la méthode de traitement.

Price

Obligatoire. Montant des frais fixes pour la méthode de traitement.

Price

Obligatoire. Montant des frais de base pour la méthode de traitement.

Timestamp

Obligatoire. Ce code temporel permet de déterminer l'ordre dans lequel les suppressions seront appliquées à l'inventaire.

bytes

Pour les flux qui ne sont pas basés sur le protocole proto.

Any

Pour les flux basés sur le protocole proto.

Timestamp

Obligatoire. Cet horodatage permet de garantir le bon ordre des mises à jour de l'inventaire.

bytes

Pour les flux qui ne sont pas basés sur le protocole proto.

Any

Pour les flux basés sur le protocole proto.

double

Latitude en degrés. (facultatif)

double

Longueur en degrés. (facultatif)

PostalAddress

Adresse postale du lieu (à privilégier).

string

Une adresse non structurée peut également être fournie en remplacement. Par exemple, "1600 amphitheatre parkway mountain view, ca 94043, états-unis".

string

Obligatoire. Nom de la ressource, au format partners/{partner_id}/merchants/{merchant_id}/status.

string

Nom de la ressource du flux, au format

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

Catégorie générale à laquelle ce service à domicile appartient. Exemple : plombier, électricien, etc.

string

Type de poste sous la catégorie à laquelle appartient le service à domicile donné. Exemple : unclog_drain et install_faucet sont les types de tâches sous la catégorie plombier.

string

Nom de la ressource à invalider.

Par exemple, pour une ressource de retrait, le nom doit être au format partners/{partner_id}/pickups/{pickup_id}. Les implémentations DOIVENT supprimer les versions mises en cache de la ressource identifiée.

string

ID du service du marchand.

int64

Heure de début du créneau horaire en secondes de l'heure UTC depuis l'epoch Unix.

int64

Durée du créneau horaire en secondes.

OrderedTickets

Nombre de billets commandés par type de billet.

Price

Prix total (hors taxes) de cette ligne.

BookingStatus

État de l'élément de campagne.

string

ID d'un type de billet.

int32

Nombre de billets commandés pour ce type.

string

Obligatoire. Parent, qui possède cette collection d'états du marchand. Format : partners/{partner_id}/merchants

int32

Obligatoire. Le nombre maximum d'éléments à renvoyer. Notez que le serveur peut réduire la taille de la page.

string

Facultatif. La valeur nextPageToken renvoyée par une ListMerchantStatusResponse précédente, le cas échéant.

BookingInventoryStatus

Facultatif. Restriction facultative permettant de filtrer les résultats en fonction de l'état de la réservation de l'inventaire.

WaitlistInventoryStatus

Facultatif. Restriction facultative permettant de filtrer les résultats par état de l'inventaire sur liste d'attente.

GeoMatchingStatus

Facultatif. Restriction facultative permettant de filtrer les résultats par état de correspondance géographique.

MerchantStatus

Liste des états des marchands qui remplissent les conditions de filtre.

string

Jeton permettant de récupérer la page de résultats suivante. Si aucune valeur n'est définie, cela signifie que la liste ne contient plus de résultats.

string

Nom de la ressource du flux, au format

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

Le nombre maximum d'éléments à renvoyer.

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

State

Restriction facultative permettant de filtrer les résultats par état du flux.

TimeRange

Restriction facultative permettant de filtrer les résultats par limites supérieure et inférieure. Si start_time n'est pas défini, la valeur par défaut correspond au début de l'heure Unix. Si end_time n'est pas défini, la valeur par défaut est l'heure actuelle.

FeedStatus

Liste des états des flux importés en ordre chronologique inversé. Le nombre maximal d'éléments renvoyés est basé sur le champ page_size de la requête.

string

Jeton permettant de récupérer la page de résultats suivante. Si aucune valeur n'est définie, cela signifie que la liste ne contient plus de résultats.

string

Code de langue IETF BCP 47, tel que "en", "mas", "zh-Hant", "de-CH-1901". Voir http://www.w3.org/International/article/language-tags/.

string

Message utilisant les paramètres régionaux ci-dessus (UTF-8).

string

ID du lieu dans la base de données Google Adresses et sur Google Maps. Pour en savoir plus sur les ID de lieu, consultez la page https://developers.google.com/places/web-service/place-id. Si cet ID est fourni, Google met le lieu en correspondance avec cette adresse.

string

Le nom, le numéro de téléphone, l'URL et la zone géographique du lieu, utilisés pour mettre en correspondance le lieu avec des adresses déjà présentes sur Google Maps.

Ce champ est facultatif, mais peut être obligatoire dans certains cas. Par exemple, un service Service.location sans nom ne sera pas mis en correspondance avec une entité commerciale, même si l'entité est située à la même adresse. (facultatif)

string

Numéro de téléphone public du lieu, y compris l'indicatif du pays et de la région (par exemple, +14567891234). (facultatif)

string

URL du site Web public du lieu. (facultatif)

GeoCoordinates

Données géographiques concernant le lieu, y compris la latitude, la longitude et l'adresse. (facultatif)

LocationType

Type d'emplacement, doit être fourni si celui-ci est fourni pour un service.

string

Référence unique associé au lieu au sein du service. Cet identifiant peut être utilisé pour faire référence à ce lieu dans d'autres champs du service. Exemple : Dans le formulaire d'enregistrement personnalisé, un ensemble d'identifiants de lieu peut être utilisé pour spécifier les options de lieu de prise en charge. S'il est défini, cet identifiant doit être unique au sein du même service. (facultatif)

string

Nom de la ressource marchand, au format partners/{partner_id}/merchants/{merchant_id}.

string

Les champs "merchant_name", "telephone", "url" et "geo" permettent de faire correspondre l'inventaire du partenaire avec les marchands déjà présents sur Google Maps. Ces informations ne sont pas affichées.

Nom du marchand.

string

Numéro de téléphone public du marchand, y compris l'indicatif pays et l'indicatif régional, par exemple +14567891234.

string

URL du site Web public du marchand.

GeoCoordinates

Informations géographiques du marchand, y compris la latitude, la longitude et l'adresse.

string

Catégorie de l'entreprise sur la plate-forme de l'agrégateur.

int64

Ce champ a été abandonné.

uint32

Taux de taxe du marchand en points de base (un centième de 1 %). Par exemple, si le taux de taxe est de 7,5 %, ce champ doit être défini sur 750.

Si ce champ n'est pas défini ou est défini sur 0, le prix total facturé à un utilisateur pour tout service fourni par ce marchand correspond au prix exact spécifié dans le champ Service.price. Le prix du service est considéré comme étant exonéré de taxes applicables ou comme incluant déjà ces taxes. Les taxes ne sont donc pas présentées à l'utilisateur sur une ligne distincte.

Si ce champ est défini sur une valeur supérieure à 0, le prix total facturé à un utilisateur pour tout service fourni par ce marchand inclut le prix du service, ainsi que la taxe calculée à l'aide du taux fourni dans ce champ. Les fractions de la plus petite unité monétaire (par exemple, les fractions d'un centime) sont arrondies au pair le plus proche. Les taxes sont présentées à l'utilisateur sur une ligne distincte.

Ce champ a été abandonné. Veuillez plutôt utiliser tax_rate.

TaxRate

Taux de taxe appliqué par le marchand. S'il est défini, ce champ remplace le champ obsolète tax_rate_basis_points. Un message vide (autrement dit, tax_rate { }) réinitialise le taux de taxe appliqué à zéro.

PaymentRestrictions

Restrictions concernant les modes de paiement que ce marchand accepte. Si le champ n'est pas défini, le système en déduit qu'il n'y a aucune restriction.

PaymentOption

Options de paiement disponibles pour ce marchand. Les services de ce marchand pourront limiter individuellement les options de paiement autorisées.

PaymentProcessorConfig

Configuration d'une société de traitement des paiements tokenisée, si le marchand accepte cette option.

TokenizationConfig

Configuration d'une société de traitement des paiements tokenisée, si le marchand accepte cette option.

Terms

Conditions d'utilisation spécifiques au marchand présentées à l'utilisateur lors de la réservation d'un service via Réserver avec Google. En outre, les conditions d'utilisation du partenaire de l'agrégateur sont toujours présentées à l'utilisateur. Elles ne doivent donc pas être fournies ici.

string

Chaîne opaque qui identifie la marque à présenter aux utilisateurs lors de l'affichage de l'attribution du partenaire. Ce champ permet à un partenaire de fournir des marchands pour toutes les marques qu'il gère au sein d'un même flux.

Une marque comprend des propriétés à présenter aux utilisateurs, du type nom, logo, conditions d'utilisation et règles de confidentialité.

Si le partenaire n'a qu'une seule marque à présenter aux utilisateurs, ce champ n'a pas besoin d'être défini et peut être ignoré.

Si le partenaire...

n'a qu'une seule marque à présenter aux utilisateurs… --> Ignorez ce champ.

a plusieurs marques qui ont été configurées…

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Attention : La plupart des partenaires n'ont pas besoin de définir ce champ. Si un partenaire souhaite utiliser ce champ, il doit d'abord nous contacter pour configurer des marques distinctes, y compris la marque par défaut.

MerchantMatchingHints

Conseils pour aider Google à mettre un marchand en correspondance avec une adresse sur Google Maps. Remarque : la plupart des partenaires n'ont pas besoin de définir ce champ, car Google met les marchands en correspondance avec les adresses sur Google Maps à l'aide des informations fournies ci-dessus. (facultatif)

ServiceAttribute

Définitions des attributs de service utilisés pour décrire les services pour ce marchand. (facultatif)

ActionLink

Facultatif. Une URL d'action avec la langue associée, la liste des restrictions de pays, le type et la plate-forme facultative sur laquelle cette action doit être effectuée

Advisement

Facultatif. Conseils généraux d'un marchand spécifique pour un utilisateur qui s'inscrit sur une liste d'attente via Réserver avec Google. La longueur des champs de texte individuels dans les conseils ne doit pas dépasser 100 octets.

string

ID du lieu dans la base de données Google Adresses et sur Google Maps. Pour en savoir plus sur les ID de lieu, consultez la page https://developers.google.com/places/web-service/place-id.

string

Nom de la ressource d'état du marchand, au format partners/{partner_id}/merchants/{merchant_id}/status.

string

Nom du marchand indiqué par les partenaires.

GeoCoordinates

Les partenaires ont fourni des informations géographiques sur le marchand.

ProcessingStatus

État du traitement par le marchand.

BookingStatus

État lié à l'intégration de bout en bout des réservations.

WaitlistStatus

État lié à l'intégration à la liste d'attente.

PlaceInfo

Région géographique correspondant à ce marchand. Ce champ est vide si aucune correspondance géographique n'est établie pour le marchand.

LocalServicesMatchInfo

Les annonces Local Services correspondent à ce marchand. Ce champ est vide s'il ne s'agit pas d'un marchand de services locaux ou s'il ne correspond à aucun fournisseur.

DirectUrl

Liste d'URL illustrant le contenu de l'inventaire actuel du marchand. Notez que cela ne signifie pas que l'inventaire est en cours de diffusion et que l'URL peut être différente de celle visible publiquement.

bool

"True" si le marchand dispose d'un inventaire dans les 30 prochains jours. Cela ne garantit pas que le marchand sera effectivement servi.

UrlType

Type de cette URL.

string

URL susceptible d'afficher ce marchand.

MatchedProvider

Fournisseurs de services correspondants. Un marchand peut être mis en correspondance avec plusieurs fournisseurs de services.

int64

Numéro client externe Google Local Services.

string

Catégories de services locaux (secteurs). Exemple : "plombier" et "carpet_cleaning".

string

Nom du lieu.

string

Adresse au format approprié dans la langue locale.

string

ID de lieu Google de ce lieu. Permet de créer une URL Google Maps ou d'obtenir plus de détails sur le lieu. Consultez la page https://developers.google.com/places/web-service/place-id pour obtenir un exemple d'utilisation.

bool

"True" si le marchand propose un service de listes d'attente. Cela ne garantit pas que le marchand sera effectivement servi.

Money

Montant minimal.

Money

Montant maximal.

Price

Montant susceptible d'être facturé à l'utilisateur s'il ne se présente pas à sa réservation.

PriceType

Définit la manière dont les frais sont déterminés à partir de la disponibilité.

string

Nom de ressource de la commande: partners/{partner ID}/orders/{order ID}

ClientInformation

Informations personnelles du client effectuant la commande.

PaymentInformation

Informations sur les transactions de paiement liées à la commande.

string

ID du marchand auquel appartiennent tous les services dans cette commande.

LineItem

Lignes de cette commande.

FulfillmentOption

Options de traitement disponibles pour un lien d'action de commande en ligne.

PrepaymentStatus

État du pré-paiement de la réservation. Si la valeur du prepayment_status est PREPAYMENT_PROVIDED ou PREPAYMENT_REFUNDED, alors l'identifiant payment_transaction_id contient l'identifiant de transaction unique associé.

string

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

string

Cet ID permet d'identifier cette option de paiement.

Cet identifiant s'applique de manière globale du côté de l'agrégateur. Ainsi, si vous réutilisez une valeur pour plusieurs marchands, l'utilisateur pourra payer tous ces marchands avec l'option de paiement correspondante.

Lorsque vous réutilisez un identifiant pour plusieurs marchands, la mise à jour de la valeur d'une option de paiement pour un marchand entraîne la mise à jour de toute autre option de paiement associée au même identifiant utilisée par un autre marchand. Par conséquent, afin d'éviter tout risque de comportement instable, il est recommandé que toutes les options de paiement partagent le même identifiant et qu'elles soient toujours mises à jour avec des valeurs identiques.

string

Nom de l'option de paiement. Peut être présenté à l'utilisateur.

string

Description de l'option de paiement. Peut être présenté à l'utilisateur.

Price

Prix de l'option de paiement.

TaxRate

Taux de taxe pour cette option de paiement. S'il est renseigné, ce champ remplace le champ tax_rate au niveau du marchand ou du service. Un message vide (autrement dit, tax_rate { }) réinitialise le taux de taxe appliqué à zéro.

PaymentOptionType

Type d'option de paiement. À usage unique pour les visites, à usages multiples pour les packs et à usage illimité pour les abonnements.

int64

Nombre de sessions pour lesquelles cette option de paiement peut être utilisée. Valable seulement pour les séances/packs multiples, où la valeur doit être supérieure à 1.

TimeRange

L'option de paiement peut être achetée dans cet intervalle.

TimeRange

L'option de paiement peut être achetée au cours de cet intervalle (par exemple, tarif spécial pour janvier 2017). Si cette valeur est renseignée, elle remplace les valeurs valid_duration et activation_type.

Duration

Durée de validité de l'option de paiement (par exemple, abonnement de 30 jours).

ActivationType

Définit la manière dont la date de début de validité est déterminée pour cette option de paiement.

UserPurchaseRestriction

Définit une limite concernant les utilisateurs pouvant acheter cette option de paiement. Peut être utilisé pour limiter une option de paiement promotionnelle à un sous-ensemble d'utilisateurs. Si aucune valeur n'est définie, tous les utilisateurs sont éligibles.

Processor

Définit la société de traitement des paiements partenaire à laquelle cette configuration s'applique.

string

Clé utilisée pour identifier ce marchand auprès de la société de traitement des paiements.

Pour Stripe, consultez la page https://stripe.com/docs/dashboard#api-keys. Pour Braintree, consultez la page https://articles.braintreepayments.com/control-panel/important-gateway-credentials.

string

Numéro de version de l'API envoyé à la société de traitement des paiements avec les demandes de paiement.

CreditCardRestrictions

Restrictions concernant les cartes de crédit que ce marchand accepte. Nous supposons que toutes les cartes de crédit sont acceptées si ce champ n'est pas défini. Notez que la liste des cartes compatibles avec CreditCardType s'allongera au fil du temps, ce qui signifie que si vous laissez ce champ vide, vous devrez modifier votre configuration dans le futur.

Price

Frais pouvant varier selon le mode de livraison.

Price

Frais liés au traitement du mode de paiement de l'utilisateur.

Price

Frais supplémentaires facturés pour un service.

Price

Frais à payer sur le lieu/l'établissement

Price

Taxes par billet.

string

Pays, spécifié à l'aide de son code pays ISO 3166-1 alpha-2, par exemple "US" (obligatoire)

string

La localité, par exemple "Mountain View". (obligatoire)

string

La région, par exemple "CA". Ce champ n'est obligatoire que dans les pays où la région est généralement incluse dans l'adresse. (facultatif)

string

Le code postal, par exemple "94043". (obligatoire)

string

L'adresse postale, par exemple "1600 Amphitheatre Pkwy". (obligatoire)

int64

Prix en micro-unités de la devise. Les fractions de la plus petite unité monétaire sont arrondies au pair le plus proche (par exemple, 2,5 centimes arrondis à 2 centimes, 3,5 centimes arrondis à 4 centimes, 0,5 centime arrondis à 0 centime, 2,51 centimes arrondis à 3 centimes).

string

Devise du prix définie dans la norme ISO 4217.

string

Chaîne facultative et opaque qui identifie l'option de tarification associée au prix étendu.

double

Valeur unique. Exemple: 5,6

RangeValue

Plage de valeurs qui peut également être ouverte ou limitée. Exemples: * Au moins 5,5 * Au maximum 5,5 * 5,5 à 6,5

double

Valeur minimale.

double

Valeur maximale.

double

Note moyenne (requise lorsque number_of_ratings > 0). La valeur doit être comprise dans la plage [1, 5] et peut être omise si (et seulement si) number_of_ratings est égal à zéro.

uint64

Nombre de notes utilisées pour calculer la valeur (obligatoire).

string

URL de cette source multimédia. Google explore le contenu multimédia hébergé sur cette URL.

MediaType

Type de cette source multimédia.

Text

Légende de l'élément multimédia conforme aux normes i18n. Seul le format texte brut est accepté. Tout élément HTML est supprimé. (facultatif)

Attribution

Informations sur l'attribution associée à la source de l'élément multimédia. Notez que ce champ doit être défini si l'attribution doit s'afficher avec l'élément multimédia (par exemple, pour ajouter un crédit photographique). (facultatif)

string

Obsolète. Utilisez plutôt localized_caption.

Text

Crédit photographique conforme aux normes i18n. Ce texte s'affiche avec la source de l'élément multimédia. Seul le format texte brut est accepté dans ce champ. Tout élément HTML est supprimé (l'attribution utilisant des liens hypertexte n'est pas acceptée).

string

Obsolète. Utilisez plutôt localized_text.

ServiceAvailability

Disponibilité du service utilisée pour remplacer les disponibilités existantes.

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é. Il doit également être stable au fil du temps pour permettre une corrélation avec les réservations passées. Ce champ doit être présent si staff_name est défini.

string

Nom facultatif d'un membre du personnel fournissant le service. Ce champ sera présenté aux utilisateurs effectuant une réservation. Il doit être lisible et ne pas être un identifiant opaque. Ce champ doit être présent si staff_id est défini.

string

ID facultatif de la salle dans laquelle est fourni le service. Ce champ identifie la salle pour tous les marchands, services et enregistrements de disponibilité. Il doit également être stable au fil du temps pour permettre une corrélation avec les réservations passées. Ce champ doit être présent si room_name est défini.

string

Nom facultatif de la salle où 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 room_id) est défini Il est fortement recommandé de ne pas associer de pièce au coin salon par défaut.

int32

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 créneaux en même temps, chacun spécifiant un party_size différent, si par exemple 2, 3 ou 4 personnes peuvent être assis pour la même réservation.

int64

Délai de préavis minimal en secondes nécessaire pour annuler un rendez-vous en ligne. (facultatif)

Price

Frais facturés en cas d'annulation dans le délai de préavis minimal.

Price

Frais de non-présentation facturés lorsque l'utilisateur n'a pas annulé la réservation.

AdmissionPolicy

Règles d'admission applicables à ce service. Si aucune valeur n'est définie, la valeur par défaut est TIME_STRICT. (facultatif)

CancellationPolicy

Modalités d'annulation associées aux règles de planification. (obligatoire pour le secteur des activités à découvrir)

int64

Durée (en secondes) entre le moment où la dernière réservation peut être effectuée et le début du créneau de disponibilité.

int64

Durée (en secondes) entre le moment où la dernière réservation peut être effectuée et la fin du créneau de disponibilité. Si ce champ est défini, le champ "admission_policy" doit être défini sur TIME_FLEXIBLE pour indiquer que les utilisateurs peuvent utiliser les billets achetés après le début du créneau.

string

Nom de la ressource du service, au format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

string

Nom du service (par exemple, "Coupe de cheveux pour hommes"). Obsolète. Utilisez plutôt localized_service_name.

Text

Nom du service (par exemple, "Coupe de cheveux pour hommes"). Possibilité de fournir plusieurs versions linguistiques.

string

Description du service, telle qu'elle sera présentée à l'utilisateur. Obsolète. Utilisez plutôt localized_description.

Text

Description du service, telle qu'elle sera présentée à l'utilisateur.

Ce champ accepte à la fois le format texte brut et le format HTML. Vous pouvez créer à cet endroit des mises en page personnalisées avec des en-têtes, des paragraphes, des listes et des balises d'expressions (autrement dit, avec des éléments de mise en page non présents dans les sections texte brut). Pour garantir la meilleure expérience utilisateur possible, tenez compte des instructions et des remarques suivantes :

Balises de mise en forme HTML compatibles :

Balises d'en-tête : <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Ces balises peuvent être utilisées pour l'affichage de titres et de sous-titres. Par exemple, <h1>Itinéraire</h1> permet d'afficher le texte intégré entre les balises comme le titre le plus important de la section. Notez que le système ignore tout autre élément HTML (balise, style ou attribut) inclus à l'intérieur des balises ci-dessus. Par exemple, le système traite de la même manière <h1 style=".."> et <h1>. Seul le texte brut est conservé.

Balise de paragraphe : <p>
Vous pouvez utiliser cette balise pour mettre en évidence une introduction détaillée ou tout autre contenu. À l'exception des balises <br>, <strong> et <em>, le système ignore tout autre élément (balise, style ou attribut) inclus à l'intérieur des balises de paragraphe. Pour plus de détails, lisez la section ci-dessous concernant les balises d'expressions.

Balises de création de listes : <ul>, <ol>, <li>
La balise <ul> peut être utilisée avec la balise <li> pour afficher des listes à puces, et la balise <ol> peut être utilisée avec la balise <li> pour afficher des listes numérotées. Ces formats sont utiles pour l'affichage de listes de contrôle, d'horaires ou toute autre liste adaptée à vos cas d'utilisation.
Exemple: Pour afficher une liste des caractéristiques d'une croisière:
<ol>
<li>Magnifique vue sur l'océan et possibilité de jouer avec les animaux sauvages.</li>
<li>Organisation et services de voyage soigneusement conçus.</li>
<li>Prix le plus bas garanti.</li>
</ol>
Notez que seuls les <li> enfants de moins de <ul> ou <ol> sont convertis. Tous les autres éléments enfants seront supprimés. En outre, le système ignore tous les autres éléments (balises, attributs et styles) inclus à l'intérieur des balises. Il ne conserve que le texte brut.

Balise de création d'une division : {div}
Le système analyse toutes les balises compatibles insérées au sein de la balise {div} en tenant compte des règles indiquées ci-dessus. La seule balise {div} n'entraîne pas nécessairement un regroupement ou un retrait du texte. En outre, tous les attributs et styles internes sont ignorés.

Balises d'expressions : <br>, <strong>, <em>
Seules ces trois balises sont acceptées. Vous pouvez utiliser la balise <br> pour créer des sauts de ligne au sein de paragraphes, et la balise <strong> ou <em> pour mettre des contenus textuels en évidence. Le système ignorera toute autre balise d'expressions.

Balises non compatibles :

• Les balises <html>, <header> et <body> ne sont pas autorisées.
• Toutes les autres balises qui n'ont pas été mentionnées ci-dessus (par exemple, <table>, <td>...) ne sont pas acceptées.
  Le système supprime les URL, les ancres et les liens, et ne les présente jamais aux utilisateurs finaux. Si vous souhaitez utiliser des photos pour enrichir l'expérience utilisateur, utilisez le champ "related_media" ci-dessous pour envoyer vos URL de photos.
  

Remarques importantes :

• Essayez de ne pas utiliser d'autres balises que celles mentionnées ci-dessus, car le système supprimera tout contenu inséré au sein de balises non compatibles, ce qui entraînera une mauvaise expérience utilisateur.
  
• Essayez d'éviter les structures imbriquées (plus de trois niveaux de titres ou des listes imbriquées, par exemple). Pour une meilleure expérience utilisateur, structurez votre contenu de manière simple et claire.
  
• N'hésitez pas à contacter l'équipe Réserver avec Google si les mises en page actuellement acceptées par le système ne sont pas suffisantes pour vos cas d'utilisation.
  
• La taille maximale recommandée est de 32 000 caractères.

Price

Prix du service.

PriceInterpretation

Décrit de quelle manière le prix est interprété et présenté à l'utilisateur. Peut être utilisé par tous les secteurs pour configurer l'affichage du prix du service, à l'exception des catégories de la restauration et À voir, à faire.

SchedulingRules

Règles de réservation ou d'annulation de rendez-vous.

PrepaymentType

Indique si un pré-paiement est obligatoire, facultatif ou non accepté.

PrepaymentTerms

Conditions relatives à la finalisation du prépaiement.

ServiceIntakeForm

Obsolète. Veuillez utiliser intake_form et per_ticket_intake_form.

ServiceIntakeForm

Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. (facultatif)

ServiceIntakeForm

Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. Ce formulaire doit être rempli une fois pour chaque billet réservé par l'utilisateur. (facultatif)

TaxRate

Taux de taxe appliqué au service. S'il est présent, ce champ remplace tout tax_rate défini au niveau du marchand. Un message vide (autrement dit, tax_rate { }) réinitialise le taux de taxe appliqué à zéro.

string

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

Deposit

Définit la manière dont un acompte peut être facturé à l'utilisateur. Remplace l'acompte éventuellement défini au niveau du service. Un message vide entraîne la suppression de tout acompte défini au niveau du service. (facultatif)

NoShowFee

Définit les frais de non-présentation pouvant éventuellement être facturés à l'utilisateur. Remplace les frais de non-présentation éventuellement définis au niveau du service. Un message vide entraîne la suppression de tous frais de non-présentation définis au niveau du service. (facultatif)

RequireCreditCard

Indique si l'utilisateur doit fournir une carte de crédit pour réserver ce service. Ce champ peut être remplacé par celui défini au niveau de la disponibilité. (facultatif)

ActionLink

Lien d'action associé à ce service. Si un lien d'action existe, son type (voir ci-dessous) doit être défini au niveau du service.

ServiceType

Type prédéfini du service. (facultatif)

TicketType

Types de billets pouvant être réservés/achetés pour ce service (si les billets sont acceptés). (facultatif)

RelatedMedia

Photos associées à ce service. Google explore et stocke les contenus multimédias de manière à optimiser leur affichage auprès des utilisateurs finaux. (facultatif)

ServiceAttributeValueId

Valeurs facultatives des attributs de service qui s'appliquent à ce service. Aucune ou plusieurs valeurs peuvent être définies pour chaque attribut de service défini au niveau du marchand correspondant. (facultatif)

WaitlistRules

Règles pour s'inscrire sur la liste d'attente.

TicketingVerticalSpecificData

Informations supplémentaires propres au secteur de la vente de billets pour des événements. (facultatif)

IntegrationType

Niveau d'intégration que nous acceptons pour ce service. (Facultatif) Ne concerne pas les partenaires complétant l'intégration de démarrage. En effet, l'intégration de bout en bout est toujours désactivée dans ce cas.

PerOrderFee

Frais facturés au niveau de la commande pour l'achat de ce service. (facultatif)

ToursAndActivitiesContent

Champs de contenu spécifiques aux visites guidées et aux activités.

Location

Lieux associés à ce service. IMPORTANT : Si plusieurs visites de lieux sont associées à ce service, ou si START_LOCATION est différent de VISITED_LOCATION, START_LOCATION doit alors être spécifié. Exemples : – Une visite guidée de trois sites est organisée à vélo. Dans ce cas, vous devez spécifier le lieu de départ. – Une visite guidée en bus commence par se donner rendez-vous dans le foyer d'un hôtel avant de se diriger directement vers le lieu visité. Dans ce cas, vous devez spécifier le lieu de rendez-vous.

Rating

La note des visiteurs pour ce service en tant que métrique globale pour tous les avis.

HomeServiceData

Informations supplémentaires spécifiques au secteur des services à domicile. (facultatif)

VirtualSession

Facultatif. Informations sur la session virtuelle. Il est nécessaire pour activer les services virtuels.

DirectMerchantPayment

Facultatif. Informations supplémentaires à ajouter si le service nécessite que l'utilisateur paie directement au marchand. REMARQUE IMPORTANTE: RwG n'est pas impliqué dans cette transaction. Il est obligatoire si virtual_session est défini et que le service n'est pas sans frais ou si prepayment_type n'est PAS défini sur REQUIRED.

ChargeTiming

Lorsque le débit interviendra en fonction de l'heure d'achat.

int64

Temps écoulé, en secondes, avant l'heure de début du service, pendant lequel l'utilisateur est facturé pour le paiement. Ce champ ne doit être défini que si ChargeTiming est défini sur CHARGE_LATER.

string

Identifiant qui identifie cet attribut de service de manière unique parmi d'autres attributs pour le même marchand (par exemple, "account-type".

string

Nom visible par l'utilisateur pour cet attribut, comme "Type de compte".

Value

Toutes les valeurs possibles pour cet attribut de service.

string

Identifiant qui identifie cette valeur de manière unique parmi d'autres valeurs pour cet attribut de service, par exemple "personnel".

string

Nom de la valeur visible par l'utilisateur (par exemple, "Personnel".

string

ID d'un attribut tel que défini dans "Merchant.service_attribute", par exemple "service-type".

string

Identifiant de la valeur de cet attribut, par exemple "coupe de cheveux". Doit correspondre à un identifiant value_id dans la définition de l'attribut de service.

string

Nom de la ressource du service auquel appliquer ce paramètre. Au format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

Timestamp

Nous traitons les entités de disponibilité éventuellement fournies comme un instantané complet de [start_time_restrict, end_time_restrict). Autrement dit, le système supprime toute disponibilité existante si la condition suivante est remplie :

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Si un message "duration" (durée) est défini, la condition est encore plus exigeante :

  availability.duration == duration_restrict

Si un message "resources_restrict" est défini, la condition est plus exigeante encore :

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Ces champs sont généralement utilisés pour fournir une mise à jour complète de la disponibilité pour une période donnée.

Si vous définissez la valeur start_time_restrict, mais pas la valeur end_time_restrict, le système en conclut que toutes les heures commencent à start_time_restrict.

Timestamp

Si vous définissez la valeur end_time_restrict, mais pas la valeur start_time_restrict, le système en conclut que toutes les heures sont incluses jusqu'à la fin de end_time_restrict.

Duration

Lorsque la durée est définie, toute mise à jour de la disponibilité est limitée aux créneaux de cette durée.

Resources

Lorsque resources_restrict est défini, toute mise à jour est limitée à cet ensemble de ressources. Tous les champs des identifiants de ressources doivent correspondre exactement.

Availability

Nouvelle liste de disponibilités.

ServiceIntakeFormField

Champs qui seront présentés à l'utilisateur.

bool

Si la valeur est "true", ce formulaire est présenté aux nouveaux clients. Obsolète. Cette fonctionnalité n'est pas compatible avec les formulaires d'enregistrement.

bool

Si la valeur est "true", ce formulaire est présenté aux clients connus. Obsolète. Cette fonctionnalité n'est pas compatible avec les formulaires d'enregistrement.

string

Chaîne provenant d'un partenaire agrégateur qui identifie de manière unique un champ de formulaire. Cet identifiant doit être identique à celui indiqué dans la réponse du champ de formulaire correspondant, et doit être unique à la fois pour les formulaires au niveau du service et pour les formulaires d'enregistrement au niveau du billet. (obligatoire)

FieldType

Type de ce champ.

string

Texte présenté à l'utilisateur pour ce champ. Obsolète. Utilisez plutôt localized_label.

Text

Texte présenté à l'utilisateur pour ce champ. Le champ peut être fourni dans différents paramètres régionaux. (obligatoire)

string

À définir si et seulement si le type de champ est LOCATION_SEARCH. Veuillez utiliser l'identifiant "location_id" dans le champ "location" pour spécifier la valeur du créneau.

Text

Définissez ce paramètre uniquement si le type de champ est MULTIPLE_CHOICE, CHECKBOXES ou DROPDOWN. Permet d'énumérer les choix possibles.

bool

Indique si l'utilisateur doit répondre à ce champ.

bool

Indique si une valeur personnalisée est autorisée en plus des réponses prédéfinies. Cela n'est applicable que lorsque le type de champ est LOCATION_SEARCH. (facultatif)

Text

Options supplémentaires fournies en plus des valeurs fournies. Ne s'applique que lorsque le type de champ est LOCATION_SEARCH. Exemple : En plus de la liste d'emplacements fournie, une autre option disponible peut être "Je contacterai le fournisseur plus tard". (facultatif)

string

Si cette question ne doit être affichée que lorsque l'utilisateur réserve certains types de billets, ce champ doit être défini comme l'ensemble des ID de types de billets applicables. Laissez le champ vide si la question est toujours applicable.

Text

Texte d'indice pour la saisie, qui s'affiche sous la forme d'un espace réservé de texte. Cela ne s'applique que si le type de champ est SHORT_ANSWER ou PARAGRAPH. (facultatif)

int32

Taux de taxe en millionièmes de 1 %, ce qui donne une précision de six décimales. Par exemple, si le taux de taxe est de 7,253 %, ce champ doit être défini sur 7253000.

Si ce champ n'est pas défini ou est défini sur 0, le prix total facturé à un utilisateur pour tout service fourni par ce marchand correspond au prix exact spécifié dans le champ Service.price. Le prix du service est considéré comme étant exonéré de taxes applicables ou comme incluant déjà ces taxes. Les taxes ne sont donc pas présentées à l'utilisateur sur une ligne distincte.

Si ce champ est défini sur une valeur supérieure à 0, le prix total facturé à un utilisateur pour tout service fourni par ce marchand inclut le prix du service, ainsi que la taxe calculée à l'aide du taux fourni dans ce champ. Les fractions de la plus petite unité monétaire (par exemple, les fractions d'un centime) sont arrondies au pair le plus proche. Les taxes sont présentées à l'utilisateur sur une ligne distincte.

string

Éventuellement, l'URL des conditions d'utilisation

string

Texte à afficher auprès de l'utilisateur. Pour les nouvelles intégrations, utilisez localized_text ci-dessous.

Text

Texte localisé à présenter à l'utilisateur.

string

Valeur textuelle dans des paramètres régionaux inconnus. Obligatoire si (et seulement si) localized_value est vide. Les paramètres régionaux définis pour cette valeur peuvent dépendre du partenaire ou du fournisseur de services. Le système ne s'attend pas nécessairement à une langue spécifique.

LocalizedString

Valeurs textuelles par paramètre régional. Facultatif.

string

L'identifiant du billet permet de différencier les types de billets proposés pour un même service. Il ne doit être unique qu'au sein d'un service.

string

Description courte de ce TicketType.

Il peut être visible par l'utilisateur, par exemple, "adult", "child", "veteran", "Row J", etc. Obligatoire, chaque type de billet doit avoir une description visible par l'utilisateur. Obsolète. Utilisez plutôt localized_short_description.

Text

Une brève description de ce TicketType conforme aux normes i18n.

Il peut être visible par l'utilisateur, par exemple, "adult", "child", "veteran", "Row J", etc. Obligatoire, chaque type de billet doit avoir une description visible par l'utilisateur. Des valeurs distinctes peuvent être fournies pour chaque paramètre régional.

Price

Prix d'un seul billet de ce type, hors taxes. Le taux de taxe défini au niveau du service est appliqué aux billets.

PerTicketFee

Frais supplémentaires appliqués à l'achat de ce billet. (facultatif)

string

Description de toute option supplémentaire auquel ce type de billet est éventuellement associé. Obsolète. Utilisez plutôt localized_option_description.

Text

Description de toute option supplémentaire auquel ce type de billet est éventuellement associé. Des valeurs distinctes peuvent être fournies pour chaque paramètre régional.

L'ajout d'autres options est utile lorsque le type de billet représente plusieurs dimensions.

Exemple 1 : Dans le cas d'un billet d'entrée pour lequel différents types ont été définis ("adulte", "enfant" et la langue comme option supplémentaire), le système s'attend à la liste TicketType suivante : - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adulte" } localized_option_description { value: "anglais" } } - { ticketTypeId: "ticket_type_2" localized_short_description { value: "adulte" } localized_option_description { value: "espagnol" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "enfant" } localized_option_description { value: "anglais" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "enfant" } localized_option_description { value: "espagnol" } }

Exemple 2 : Dans le cas d'un service de location de kayaks pour un nombre variable d'heures avec offre de location facultative d'un sac étanche, short_description pourrait être "3 heures" et option_description pourrait être soit "avec sac étanche" ou "sans sac étanche" : - { ticketTypeId: "ticket_type_1" localized_short_description { value: "2 heures" } localized_option_description { value: "anglais" } } - { ticketTypeId: "ticket_type_2" localized_short_description { value: "2 heures" } localized_option_description { value: "espagnol" } } - { ticketTypeId: "ticket_type_3" localized_short_description { value: "3 heures" } localized_option_description { value: "anglais" } } - { ticketTypeId: "ticket_type_4" localized_short_description { value: "3 heures" } localized_option_description { value: "espagnol" } }

(Facultatif) Si ce champ est défini pour un des types de billets du service, le système s'attend à ce qu'il soit défini également pour tous les autres types de billets (envisagez d'utiliser une option_description par défaut). Par exemple, [{ticket_type_1, adulte, anglais}, {ticket_type_1, adulte, ''}] n'est pas une liste valide.

Seules les deux balises de mise en forme HTML et
sont acceptées. Ces balises sont utiles pour les options présentant un titre et une description détaillée. Par exemple : "Loges premium
. Bénéficiez d'une loge privée, avec sièges rembourrés, télévision privée, et service de restauration et de boissons sur place. Vue pittoresque sur le terrain."

EventCategory

Catégorie de l'événement. À définir seulement lorsque l'événement appartient à l'une des catégories prédéfinies. (facultatif)

string

URL de l'événement sur le site Web du partenaire. (facultatif)

Entity

Liste d'entités associées à l'événement. (facultatif)

AttendanceMode

Obligatoire. Type de participation à l'événement.

string

Facultatif. URL où l'événement peut être regardé.

Text

Facultatif. Organisateur de l'événement.

string

Facultatif. URL de l'organisateur de l'événement.

OrganizerType

Facultatif. Type d'organisateur.

string

Obligatoire. URL des pages sur lesquelles figurent les informations ou les descriptions de l'événement

EventState

Facultatif. État de l'événement.

string

Identifiant unique de l'entité dans la base de données du partenaire. (facultatif)

string

Nom de l'entité. (obligatoire)

string

URL de la page Web qui décrit l'entité sans ambiguïté. Il s'agit de la page éventuellement associée à l'entité sur le site Web du partenaire. Pour d'autres URL publiques concernant l'entité, utilisez relevant_url dans public_identification_data. (facultatif)

EntityType

Type d'entité. (facultatif)

EntityRole

Rôle de l'entité pendant l'événement. (facultatif)

PublicIdentificationData

Références publiques associées à l'entité. (facultatif)

string

URL publique d'une page Web dédiée uniquement au sujet. Il peut s'agir de sites Web officiels, de discogs, de plates-formes sur les réseaux sociaux, de pages Wikipédia ou Imdb (par exemple, https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan). (facultatif)

string

Identifiant musicbrainz de 36 caractères de l'artiste ou d'autres entités musicales, le cas échéant. Voir https://musicbrainz.org/doc/MusicBrainz_Identifier. (facultatif)

Timestamp

Seuil inférieur de la plage de dates.

Timestamp

Seuil supérieur de la plage de dates.

map<string, string>

Une configuration de tokenisation comporte généralement un paramètre tokenization_parameter dont la clé est "gateway" et dont la valeur est le nom de la société de traitement des paiements.

Les autres paramètres dépendent du processeur. Pour en savoir plus, consultez la documentation Google Pay.

Exemple avec Braintree : tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Exemple avec Stripe : tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Exemple avec Adyen : tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

Indiquez dans le jeton de paiement les informations bancaires de l'utilisateur telles que saisies dans Google Pay avec son mode de paiement (voir ci-dessus). Si vous laissez ce champ vide, le système en déduit que la valeur est MIN.