Index
BookingNotification
(interface)Feed
(interface)InvalidationService
(interface)InventoryStatus
(interface)InventoryUpdate
(interface)ActionLink
(message)ActionLink.ActionLinkType
(enum)ActionPlatform
(enum)Advisement
(message)Availability
(message)Availability.ConfirmationMode
(enum)Availability.DurationRequirement
(enum)Availability.Recurrence
(message)Availability.ScheduleException
(message)Availability.SchedulingRuleOverrides
(message)BatchDeleteGenericRecordsRequest
(message)BatchPushGenericRecordRequest
(message)BatchReplaceServiceAvailabilityRequest
(message)BatchReplaceServiceAvailabilityResponse
(message)Booking
(message)BookingFailure
(message)BookingFailure.Cause
(enum)BookingFailure.PaymentFailureInformation
(message)BookingFailure.PaymentFailureInformation.ThreeDS1Parameters
(message)BookingStatus
(enum)CallMerchant
(message)CancellationPolicy
(message)CancellationPolicy.RefundCondition
(message)ClientInformation
(message)CreateMerchantRequest
(message)CreateServiceRequest
(message)CreditCardRestrictions
(message)CreditCardRestrictions.CreditCardType
(enum)DeleteMerchantRequest
(message)DeleteServiceRequest
(message)Deposit
(message)DirectMerchantPayment
(message)DurationRange
(message)ExtendedServiceAvailability
(message)FeedStatistics
(message)FeedStatus
(message)FeedStatus.State
(enum)FoodOrderingMetadata
(message)FoodOrderingMetadata.AdvanceOrderDetails
(message)FoodOrderingMetadata.FeeDetails
(message)FoodOrderingMetadata.FeeDetails.FeeAmount
(message)FoodOrderingMetadata.FeeDetails.FeeType
(enum)FulfillmentOption
(message)FulfillmentOption.AvailableDay
(message)FulfillmentOption.FeeDetails
(message)FulfillmentOption.FixedFee
(message)FulfillmentOption.FulfillmentType
(enum)FulfillmentOption.MinimumFee
(message)FulfillmentOption.NoFee
(message)GenericDeleteRecord
(message)GenericRecord
(message)GeoCoordinates
(message)GetMerchantStatusRequest
(message)GetStatusRequest
(message)HomeServiceData
(message)IntegrationType
(enum)InvalidateResourceRequest
(message)LineItem
(message)LineItem.OrderedTickets
(message)ListMerchantStatusesRequest
(message)ListMerchantStatusesRequest.BookingInventoryStatus
(enum)ListMerchantStatusesRequest.GeoMatchingStatus
(enum)ListMerchantStatusesRequest.WaitlistInventoryStatus
(enum)ListMerchantStatusesResponse
(message)ListStatusRequest
(message)ListStatusResponse
(message)LocalizedString
(message)Location
(message)LocationType
(enum)Merchant
(message)MerchantMatchingHints
(message)MerchantStatus
(message)MerchantStatus.BookingStatus
(message)MerchantStatus.DirectUrl
(message)MerchantStatus.DirectUrl.UrlType
(enum)MerchantStatus.LocalServicesMatchInfo
(message)MerchantStatus.LocalServicesMatchInfo.MatchedProvider
(message)MerchantStatus.PlaceInfo
(message)MerchantStatus.ProcessingStatus
(enum)MerchantStatus.WaitlistStatus
(message)MoneyRange
(message)NoShowFee
(message)Order
(message)OrderOnlineMetadata
(message)PaymentInformation
(message)PaymentOption
(message)PaymentOption.ActivationType
(enum)PaymentOption.PaymentOptionType
(enum)PaymentProcessorConfig
(message)PaymentProcessorConfig.Processor
(enum)PaymentRestrictions
(message)PerOrderFee
(message)PerTicketFee
(message)PostalAddress
(message)PrepaymentStatus
(enum)Price
(message)PriceInterpretation
(enum)PriceType
(enum)QuantitativeValue
(message)QuantitativeValue.RangeValue
(message)Rating
(message)RelatedMedia
(message)RelatedMedia.Attribution
(message)RelatedMedia.MediaType
(enum)ReplaceServiceAvailabilityRequest
(message)RequireCreditCard
(enum)Resources
(message)SchedulingRules
(message)SchedulingRules.AdmissionPolicy
(enum)Service
(message)Service.PrepaymentTerms
(message)Service.PrepaymentTerms.ChargeTiming
(enum)Service.PrepaymentType
(enum)Service.ServiceType
(enum)ServiceAttribute
(message)ServiceAttribute.Value
(message)ServiceAttributeValueId
(message)ServiceAvailability
(message)ServiceIntakeForm
(message)ServiceIntakeFormField
(message)ServiceIntakeFormField.FieldType
(enum)TaxRate
(message)Terms
(message)Text
(message)TicketType
(message)TicketingVerticalSpecificData
(message)TicketingVerticalSpecificData.AttendanceMode
(enum)TicketingVerticalSpecificData.Entity
(message)TicketingVerticalSpecificData.Entity.EntityRole
(enum)TicketingVerticalSpecificData.Entity.EntityType
(enum)TicketingVerticalSpecificData.EventCategory
(enum)TicketingVerticalSpecificData.EventState
(enum)TicketingVerticalSpecificData.OrganizerType
(enum)TicketingVerticalSpecificData.PublicIdentificationData
(message)TimeRange
(message)TokenizationConfig
(message)TokenizationConfig.BillingInformationFormat
(enum)ToursAndActivitiesContent
(message)UnsupportedPartySizeOption
(message)UpdateBookingRequest
(message)UpdateMerchantRequest
(message)UpdateOrderRequest
(message)UpdateServiceRequest
(message)UserPurchaseRestriction
(message)VirtualSession
(message)VirtualSession.VirtualPlatformInfo
(message)VirtualSession.VirtualPlatformInfo.Platform
(enum)WaitlistRules
(message)
BookingNotification
Reçoit des notifications pour les rendez-vous pris auprès de partenaires externes. Le partenaire doit appeler UpdateBooking ou UpdateOrder selon qu'il met en œuvre des RPC basés sur des réservations, tels que CreateBooking et CheckAvailability, ou des RPC basés sur des commandes, telles que CreateOrder et CheckOrderFulfillability.
UpdateBooking |
---|
Met à jour une valeur
|
UpdateOrder |
---|
Met à jour une valeur
|
Flux
Récupère l'état de traitement des flux importés par des partenaires agrégateurs externes.
GetStatus |
---|
Récupère la valeur
|
ListStatus |
---|
Récupère la valeur
|
InvalidationService
Reçoit les demandes d'invalidation de ressources de la part de partenaires externes.
InvalidateResource |
---|
Invalide une ressource existante. Une requête est ignorée si la ressource demandée n'est pas abonnée au service Google. Types de ressources compatibles : Retrait
|
InventoryStatus
Récupérer l'état de l'inventaire et la correspondance des marchands importés
GetMerchantStatus |
---|
Obtenez le
|
ListMerchantStatuses |
---|
Répertorie tous les
|
InventoryUpdate
Reçoit les mises à jour d'inventaire d'agrégateurs externes.
BatchDeleteGenericRecords |
---|
Supprime les enregistrements du type de flux spécifié. n'effectue qu'une validation de base (comme une requête mal formée), après laquelle une réponse appropriée est immédiatement renvoyée au partenaire. Google valide la logique métier sur la requête de manière asynchrone. Cet appel par lot ne garantit pas l'atomicité.
|
BatchPushGenericRecord |
---|
Insère et/ou met à jour les enregistrements du type de flux spécifié. n'effectue qu'une validation de base (comme une requête mal formée), après laquelle une réponse appropriée est immédiatement renvoyée au partenaire. Google valide la logique métier sur la requête de manière asynchrone. Cet appel par lot ne garantit pas l'atomicité.
|
BatchReplaceServiceAvailability |
---|
Remplace la valeur
|
CreateMerchant |
---|
Créé une valeur
|
CreateService |
---|
Crée une valeur
|
DeleteMerchant |
---|
Supprime une valeur
|
DeleteService |
---|
Supprime une valeur
|
ReplaceServiceAvailability |
---|
Remplace la valeur
|
UpdateMerchant |
---|
Met à jour une valeur
|
UpdateService |
---|
Met à jour une valeur
|
ActionLink
Une URL d'action, en même temps que la langue associée, la liste des restrictions locales applicables et une plate-forme facultative sur laquelle cette action doit être effectuée.
Champs | |
---|---|
url |
L'URL du point d'entrée correspondant à ce lien d'action. |
language |
Balise de langue BCP-47 identifiant la langue du contenu associé à cet URI. |
restricted_country[] |
Code pays ISO 3166-1 Alpha-2. Laissez ce champ vide si vous ne souhaitez pas restreindre la visibilité du contenu. |
platform |
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. |
action_link_type |
Type d'action prédéterminé. |
order_online_metadata |
Métadonnées du lien de commande en ligne. Prise en charge de l'action avec ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE. |
food_ordering_metadata |
Métadonnées pour les liens de commande de repas. Compatible avec le type d'action: * |
ActionLinkType
Type d'action prédéterminé associé à un lien d'action.
Énumérations | |
---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
Le type de lien d'action n'est pas spécifié. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
Le lien d'action est de type "prendre rendez-vous". |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
Le lien d'action est de type "effectuer des réservations en ligne". |
ACTION_LINK_TYPE_ORDER_FOOD |
Le lien d'action est de type "commander des plats en livraison ou à emporter, ou les deux à la fois". |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
Le lien d'action est de type "commander des plats en livraison". |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
Le lien d'action est de type "commander des plats à emporter". |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
Le lien d'action est de type "effectuer une réservation au restaurant". |
ACTION_LINK_TYPE_SHOP_ONLINE |
Le lien d'action est de type "Commande pour un achat". Il peut s'agir de la livraison, du retrait ou des deux. |
ActionPlatform
Plate-forme sur laquelle l'action est effectuée. "Application Web" est la valeur utilisée par défaut. Il est recommandé de définir au moins un ActionLink avec la valeur ACTION_PLATFORM_WEB_APPLICATION. Les liens définissant Android ou iOS comme plate-forme ne sont utilisés que sur le système respectif.
Énumérations | |
---|---|
ACTION_PLATFORM_UNSPECIFIED |
La plate-forme n'est pas spécifiée. |
ACTION_PLATFORM_WEB_APPLICATION |
La plate-forme associée à l'action est le Web en général. |
ACTION_PLATFORM_MOBILE_WEB |
La plate-forme associée à l'action est le Web mobile. |
ACTION_PLATFORM_ANDROID |
La plate-forme associée à l'action est Android OS. |
ACTION_PLATFORM_IOS |
La plate-forme associée à l'action est iOS. |
Conseils
Conseils qui s'affichent lorsque l'utilisateur effectue une réservation via Réserver avec Google.
Champs | |
---|---|
text |
Message personnalisé à présenter à l'utilisateur lorsqu'il effectue une réservation via Réserver avec Google. |
Disponibilité
Un créneau de disponibilité du service du marchand, indiquant l'heure et le nombre de créneaux.
Champs | |
---|---|
start_time |
Heure de début du créneau horaire. |
duration |
Durée du créneau horaire |
spots_total |
Nombre total de créneaux et de créneaux disponibles pour cette disponibilité. Exemples :
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.
|
spots_open |
Nombre de créneaux libres. |
availability_tag |
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 :
|
payment_option_id[] |
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é. |
schedule_exception[] |
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. |
no_show_fee |
Frais de non-présentation facultatifs pour cette disponibilité. Remplace les frais de non-présentation éventuellement définis au niveau du service. |
require_credit_card |
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) |
ticket_type_id[] |
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 :
Pour représenter l'inventaire en semaine :
Pour indiquer que les trois types de billets sont disponibles pour ce créneau horaire, utilisez soit (facultatif) |
duration_requirement |
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) |
scheduling_rule_overrides |
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. |
confirmation_mode |
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. |
Mode de confirmation
Modes de confirmation utilisés lors de la réservation de créneaux de disponibilité.
Énumérations | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED |
Le mode de confirmation n'a pas été spécifié. La confirmation synchrone sera utilisée. |
CONFIRMATION_MODE_SYNCHRONOUS |
Les réservations pour ce créneau de disponibilité seront confirmées de manière synchrone. |
CONFIRMATION_MODE_ASYNCHRONOUS |
Les réservations pour ce créneau de disponibilité seront confirmées de manière asynchrone. |
DurationRequirement
Cette énumération indique les conditions requises pour que l'utilisateur puisse prendre connaissance ou afficher la durée/l'heure de fin des emplacements demandés.
Enums | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
Le traitement de l'heure de fin n'est pas spécifié. Il s'agit de la valeur par défaut. |
DO_NOT_SHOW_DURATION |
L'heure de fin n'est pas visible par l'utilisateur. |
MUST_SHOW_DURATION |
L'heure de fin doit être indiquée à l'utilisateur avant qu'un rendez-vous puisse être pris. |
Récurrence
Les messages de récurrence sont facultatifs, mais ils permettent de représenter de façon plus compacte les créneaux de disponibilité qui se réitèrent. Ces messages correspondent généralement au planning d'une journée ouvrée. Les messages ScheduleException sont ensuite utilisés pour représenter des périodes réservées/non disponibles pendant la journée ouvrée.
Conditions requises :
- Veillez à ce qu'une fois développés, les créneaux de disponibilité ou les récurrences ne génèrent PAS des créneaux identiques. Si l'ID, la valeur start_time, la durée et les ressources sont les mêmes, les créneaux sont considérés comme identiques.
- N'utilisez PAS en même temps le format de disponibilité standard et la récurrence pour les créneaux du même service. La fonctionnalité de récurrence est particulièrement adaptée aux marchands/services qui proposent des rendez-vous. Le format standard est conçu pour les marchands/services dont les séances suivent un planning régulier.
- Les récurrences ne doivent pas durer plus de 24 heures.
Champs | |
---|---|
repeat_until |
Horodatage au format UTC maximal et inclusif jusqu'auquel ce créneau de disponibilité se répète. |
repeat_every |
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) |
ScheduleException
Les messages ScheduleException représentent des périodes réservées/indisponibles au cours de la journée ouvrée, qui constituent des exceptions à la récurrence décrite ci-dessus. À mesure que les créneaux horaires sont réservés, la liste des exceptions doit être mise à jour afin de prendre en compte les créneaux qui ne sont désormais plus disponibles. La récurrence elle-même ne doit pas être modifiée.
Champs | |
---|---|
time_range |
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é. |
SchedulingRuleOverrides
Règles de planification au niveau du créneau de disponibilité
Champs | |
---|---|
last_bookable_sec |
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. |
first_bookable_sec |
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. |
last_online_cancellable_sec |
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) |
BatchDeleteGenericRecordsRequest
Requête par lot pour supprimer les enregistrements du type de flux spécifié.
Champs | |
---|---|
parent |
Nom de la ressource, au format |
records[] |
Enregistrements à supprimer. Un appel d'API peut comporter jusqu'à 1 000 enregistrements. |
BatchPushGenericRecordRequest
Requête par lot pour insérer et/ou mettre à jour les enregistrements du type de flux spécifié dans l'URL de la requête.
Champs | |
---|---|
parent |
Nom de la ressource, au format |
records[] |
Enregistrements à insérer et/ou à mettre à jour. Un appel d'API peut comporter jusqu'à 1 000 enregistrements. |
BatchReplaceServiceAvailabilityRequest
Requête par lot pour remplacer plusieurs créneaux de disponibilité du Service
.
Champs | |
---|---|
parent |
Format |
extended_service_availability[] |
Disponibilité étendue du service utilisée pour remplacer les créneaux de disponibilité existants. |
BatchReplaceServiceAvailabilityResponse
Réponse par lot pour remplacer plusieurs créneaux de disponibilité du Service
. Seuls les créneaux mis à jour sont inclus dans ce message.
Champs | |
---|---|
extended_service_availability[] |
Messages bien mis à jour concernant la disponibilité étendue du service qui ont été utilisés pour remplacer les créneaux de disponibilité existants. |
Booking
Une réservation pour un créneau d'inventaire
Champs | |
---|---|
name |
Nom de ressource de la réservation: |
merchant_id |
ID du marchand pour l'emplacement |
service_id |
ID du service marchand |
start_time |
Heure de début du créneau horaire |
duration |
Durée du créneau horaire |
client_information |
Informations personnelles du client prenant rendez-vous |
status |
État de la réservation |
payment_information |
Informations sur les transactions de paiement liées à la réservation. |
party_size |
Nombre de personnes pour la réservation |
BookingFailure
Données d'état indiquant la raison pour laquelle le traitement d'une réservation confirmée de manière asynchrone a échoué. L'objectif principal de BookingFailure est de capturer les erreurs de logique métier.
Champs | |
---|---|
cause |
Cause de l'échec de la réservation. (obligatoire) |
rejected_card_type |
(obligatoire uniquement si la cause est PAYMENT_ERROR_CARD_TYPE_REJECTED) |
description |
Ce champ facultatif permet au partenaire d'inclure des informations supplémentaires à des fins de débogage seulement. (facultatif) |
payment_failure |
Données concernant les échecs de paiement. |
Cause
Énumération des causes d'échec.
Énumérations | |
---|---|
CAUSE_UNSPECIFIED |
Valeur par défaut : ne pas utiliser. Équivaut à une "erreur inconnue". |
SLOT_UNAVAILABLE |
Le créneau de disponibilité référencé n'est plus disponible. |
SLOT_ALREADY_BOOKED_BY_USER |
L'utilisateur a déjà pris rendez-vous pour le créneau de disponibilité référencé. |
LEASE_EXPIRED |
La location qui a été éventuellement définie a expiré et ne peut plus être utilisée pour finaliser la réservation demandée. |
OUTSIDE_CANCELLATION_WINDOW |
L'annulation demandée ne peut pas être effectuée à l'heure actuelle en raison de restrictions imposées par les modalités d'annulation du marchand. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
Une erreur s'est produite lors du traitement du paiement, car le marchand n'a pas accepté le type de carte de crédit fourni. Le type de carte de crédit doit être spécifié dans "rejected_card_type". |
PAYMENT_ERROR_CARD_DECLINED |
Une erreur s'est produite lors du traitement du paiement, car la carte de crédit fournie a été refusée. |
PAYMENT_OPTION_NOT_VALID |
Une erreur s'est produite au niveau du pack ou de l'abonnement utilisé pour payer la réservation. Il ne peut plus être utilisé, il est peut-être arrive à expiration, etc. |
PAYMENT_ERROR |
Une erreur s'est produite lors du traitement du paiement de cette réservation. Utilisez cette valeur pour indiquer une erreur de paiement générale, mais seulement si l'erreur ne correspond pas à une des erreurs de paiement spécifiques ci-dessus. |
USER_CANNOT_USE_PAYMENT_OPTION |
L'utilisateur ne peut pas utiliser l'option de paiement indiquée (par exemple, l'utilisateur essaie d'utiliser un prix spécial proposé aux nouveaux clients pour la deuxième fois). |
BOOKING_ALREADY_CANCELLED |
Une réservation que l'utilisateur a tenté d'annuler a déjà été annulée. |
BOOKING_NOT_CANCELLABLE |
Une réservation que l'utilisateur a tenté d'annuler ne peut pas être annulée. |
OVERLAPPING_RESERVATION |
L'utilisateur a une réservation existante qui est trop proche de cette heure. |
USER_OVER_BOOKING_LIMIT |
La réservation a échoué, car l'utilisateur a dépassé la limite de réservations par utilisateur définie par l'agrégateur. |
PAYMENT_REQUIRES_3DS1 |
Défini lorsque le paiement est refusé, car vous demandez que la transaction soit tentée une nouvelle fois, mais cette fois après que l'utilisateur a répondu au test 3DS1. Notez que l'état d'échec de la transaction actuelle n'est pas modifié. Le système traite la nouvelle tentative comme une transaction complètement distincte. S'il s'agit de la cause de l'échec, vous DEVEZ définir payment_failure.3DS1_parameters. Sinon, la cause sera traitée comme s'il s'agissait de PAYMENT_ERROR. |
PaymentFailureInformation
Données concernant les échecs de paiement.
Champs | |
---|---|
threeds1_parameters |
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. |
ThreeDS1Parameters
Paramètres demandant que RwG effectue un défi 3DS1.
Les paramètres sont définis par la description du protocole 3DS1 d'EMVCo.
Champs | |
---|---|
acs_url |
URL à partir de laquelle charger un formulaire à présenter à l'utilisateur pour authentification. |
pa_req |
Une requête PaymentAuthentication. À publier dans le formulaire ACSUrl, le cas échéant. |
transaction_id |
Un identifiant utilisé par le fournisseur ACS. À publier dans le formulaire ACSUrl, le cas échéant. |
md_merchant_data |
Données du marchand. À publier dans le formulaire ACSUrl, le cas échéant. |
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. |
CallMerchant
Message vide à utiliser dans UnsupportedPartySizeOption. Ce paramètre permettra aux utilisateurs d'appeler l'établissement pour effectuer une réservation.
CancellationPolicy
Modalités d'annulation d'un service.
Champs | |
---|---|
refund_condition[] |
Aucune, une ou plusieurs conditions de remboursement applicables aux conditions de remboursement. |
RefundCondition
Définit une seule condition de remboursement. Pour décrire les "étapes de remboursement", vous pouvez définir différentes périodes d'annulation avant l'heure de début du service et y associer différentes conditions de remboursement regroupées ensemble.
Champs | |
---|---|
min_duration_before_start_time |
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 |
Pourcentage remboursable, à condition que la réservation du service soit annulée au moins |
ClientInformation
Informations personnelles sur la personne effectuant la réservation
Champs | |
---|---|
given_name |
Prénom du client |
family_name |
Nom de famille du client |
address |
Adresse du client |
telephone |
Numéro de téléphone du client |
email |
Adresse e-mail du client |
CreateMerchantRequest
Demande de création d'un Merchant
.
Champs | |
---|---|
parent |
Nom de la ressource parente du partenaire propriétaire de ce marchand, au format |
merchant_id |
Référence marchand à utiliser pour ce marchand. |
merchant |
Marchand à créer. |
CreateServiceRequest
Demande de création d'un Service
.
Champs | |
---|---|
parent |
Nom de la ressource parente du marchand propriétaire de ce service, au format |
service_id |
ID à utiliser pour ce service. |
service |
Service à créer. |
CreditCardRestrictions
Restrictions concernant les types de cartes de crédit que ce marchand accepte.
Champs | |
---|---|
credit_card_type[] |
Liste des cartes de crédit acceptées. Aucune carte de crédit n'est acceptée si non défini. |
CreditCardType
Un type de carte de crédit.
Énumérations | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Non utilisé. |
VISA |
Une carte de crédit Visa. |
MASTERCARD |
Une carte de crédit Mastercard. |
AMERICAN_EXPRESS |
Une carte de crédit American Express. |
DISCOVER |
Une carte de crédit Discover. |
JCB |
Une carte de crédit JCB. |
DeleteMerchantRequest
Demande de suppression d'un Merchant
.
Champs | |
---|---|
name |
Nom de la ressource du marchand à supprimer. Au format partners/{partner_id}/merchants/{merchant_id} |
DeleteServiceRequest
Demande de suppression d'un Service
.
Champs | |
---|---|
name |
Nom de la ressource du service à supprimer. Au format |
Acompte
Acompte susceptible d'être facturé à l'utilisateur ou dont le montant peut être retenu sur sa carte de crédit.
Champs | |
---|---|
deposit |
Montant du virement |
min_advance_cancellation_sec |
Délai d'annulation minimal pour l'acompte. |
deposit_type |
Définit la manière dont l'acompte est déterminé à partir d'une disponibilité. |
DirectMerchantPayment
Informations sur la manière dont l'utilisateur peut payer directement au marchand au lieu de prépayer le service via RwG.
Champs | |
---|---|
payment_methods[] |
Les utilisateurs sont invités à ne payer que via les modes de paiement mentionnés ci-dessous. |
DurationRange
Wrapper pour une plage de durée qui peut être limitée ou illimitée. Veuillez indiquer au moins une durée (min_duration et max_duration)
Champs | |
---|---|
min_duration |
Durée minimale. |
max_duration |
Durée maximale. |
ExtendedServiceAvailability
Liste de disponibilités et à qui/quand les appliquer
Champs | |
---|---|
merchant_id |
Ce champ obligatoire permet d'indiquer à quel marchand appartiennent les messages de disponibilité ci-dessous. |
service_id |
Ce champ obligatoire permet d'indiquer à quel service appartiennent les messages de disponibilité ci-dessous. |
start_time_restrict |
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 :
Si un message "duration" (durée) est défini, la condition est encore plus exigeante :
Si un message "resources_restrict" est défini, la condition est plus exigeante encore :
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. |
end_time_restrict |
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_restrict |
Lorsque la durée est définie, toute mise à jour de la disponibilité est limitée aux créneaux de cette durée. |
resources_restrict |
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. |
FeedStatistics
Statistiques obtenues lors du traitement d'un flux importé.
Champs | |
---|---|
new_items |
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é. |
existing_items |
Éléments existants, mis à jour selon les besoins à partir des informations plus récentes du flux. |
deleted_items |
Articles qui ne sont plus présents dans ce flux et qui ont donc été supprimés. |
FeedStatus
État d'un flux importé par la plate-forme de l'agrégateur.
Champs | |
---|---|
name |
Nom de la ressource du flux, au format
|
state |
État de traitement de ce flux. |
error_details |
Chaîne lisible fournissant plus de détails si nous n'avons pas pu traiter ce flux. |
statistics |
Statistiques spécifiques à ce flux. |
State
Énumération indiquant l'état de traitement d'un flux.
Énumérations | |
---|---|
STATE_UNSPECIFIED |
Valeur par défaut. Non utilisé. |
IN_PROGRESS |
Le flux est toujours en cours de traitement. |
SUCCESS |
Le flux a été traité. |
FAILURE |
Une erreur s'est produite lors du traitement du flux. |
FoodOrderingMetadata
Métadonnées pour les liens d'action de commande de repas.
Champs | |
---|---|
fee_details[] |
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. |
advance_order_details |
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. |
Champ d'union fulfillment_duration_options . Délai de traitement de la commande indiqué dans la confirmation de commande. Pour les commandes à livrer, délai avant la livraison du plat Pour les commandes à retirer, il s'agit du temps nécessaire pour que les plats soient prêts à être retirés. fulfillment_duration_options ne peut être qu'un des éléments suivants : |
|
fulfillment_lead_time_duration |
Durée fixe. Par exemple: 30 minutes. |
fulfillment_lead_time_duration_range |
Une plage de durées. Exemples: * 30 min à 45 min * Plus de 30 min * Moins de 50 min |
AdvanceOrderDetails
Pour une assistance concernant les commandes à l'avance.
Champs | |
---|---|
is_supported |
True si les commandes anticipées, également appelées commandes à l'avance, sont acceptées. (obligatoire) |
FeeDetails
Détails des frais.
Champs | |
---|---|
type |
Type de frais. (obligatoire) |
fee_amount |
Montant des frais exprimé en devise unitaire, sous forme de pourcentage de la valeur du panier ou une combinaison des deux. (obligatoire) |
FeeAmount
FeeAmount
exemples: * Frais fixes: 0 USD (aucuns frais), 1,5 USD * Plage de frais fixes: 1 USD (minimum), 3 USD (maximum), 5-6 USD * Pourcentage de taille du panier: 15,5 %, 10 %-20 %, 10 % (minimum), 15 % (maximum) * Combinée de la plage et du pourcentage: 25 2,5 USD (minimum), 25,5 % et 4,5 USD (maximum), 10 % et 1,5-2,5 USD, 10,5%-20 % et 2,5-3,5 USD
Champs | |
---|---|
cart_percentage |
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% |
Champ d'union amount_options . Options permettant de spécifier une valeur monétaire. amount_options ne peut être qu'un des éléments suivants : |
|
amount |
Montant fixe. Exemple : 3,5 USD. |
amount_range |
Plage de montants. Exemples: * 3,5 € à 5,5 € * Au moins 3,5 € x 5,5 € maximum |
amount_unknown |
Montant inconnu. |
FeeType
Type de frais.
Enums | |
---|---|
FEE_TYPE_UNSPECIFIED |
Type de frais non spécifié. |
DELIVERY |
Pour les frais de livraison. |
SERVICE |
Pour les frais de service. |
FulfillmentOption
Option de traitement d'un lien d'action de commande en ligne.
Champs | |
---|---|
fulfillment_type |
Obligatoire. Type de traitement. |
available_day[] |
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). |
fee_details |
Obligatoire. Détails des frais pour la méthode de fulfillment. |
minimum_order |
Obligatoire. Commande minimale pour la méthode de traitement associée au lien d'action. |
AvailableDay
Disponibilité au niveau de la journée.
Champs | |
---|---|
fulfillment_date |
Obligatoire. Date disponible pour une méthode de traitement. Est censé se trouver dans le fuseau horaire du marchand. |
last_ordering_time |
Obligatoire. Horodatage Unix. Dernière fois qu'un utilisateur a pu commander et recevoir des articles d'ici le 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. |
FeeDetails
Détails des frais pour la méthode de traitement associée au lien d'action.
Champs | |
---|---|
Champ d'union fee_details . Modèle de frais pour la méthode de fulfillment. fee_details ne peut être qu'un des éléments suivants : |
|
no_fee |
Aucuns frais pour la méthode de traitement. |
base_fee |
Frais de base associés à la méthode de traitement. |
fixed_fee |
Frais fixes associés à la méthode de traitement. |
FixedFee
Frais fixes requis pour la méthode de traitement associée au lien d'action.
Champs | |
---|---|
amount |
Obligatoire. Montant des frais fixes pour la méthode de traitement. |
FulfillmentType
Type de traitement associé à un lien d'action.
Enums | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Le type de traitement n'est pas spécifié. |
FULFILLMENT_TYPE_DELIVERY |
Le type de traitement est la livraison. |
FULFILLMENT_TYPE_PICKUP |
Le type de traitement est "Retrait". |
MinimumFee
Frais minimaux requis pour la méthode de traitement associée au lien d'action.
Champs | |
---|---|
base_fee_amount |
Obligatoire. Montant des frais de base pour la méthode de traitement. |
NoFee
Aucuns frais ne sont requis pour la méthode de traitement associée au lien d'action.
GenericDeleteRecord
Enregistrement à supprimer du type de flux mentionné dans la demande d'URL.
Champs | |
---|---|
delete_time |
Obligatoire. Ce code temporel permet de déterminer l'ordre dans lequel les suppressions seront appliquées à l'inventaire. |
Champ d'union record_type . Encapsuler différents types de flux (ndjson, proto-basé, etc.) Le partenaire peut fournir un enregistrement complet de la même manière qu'un enregistrement est fourni dans un flux ou avec l'API BatchPush. Les partenaires ont également la possibilité d'inclure uniquement les champs essentiels d'un enregistrement requis pour l'identifier de façon unique. record_type ne peut être qu'un des éléments suivants : |
|
data_record |
Pour les flux qui ne sont pas basés sur le protocole proto. |
proto_record |
Pour les flux basés sur le protocole proto. |
GenericRecord
Enregistrement du type de flux mentionné dans la demande d'URL.
Champs | |
---|---|
generation_timestamp |
Obligatoire. Cet horodatage permet de garantir le bon ordre des mises à jour de l'inventaire. |
Champ d'union record_type . Encapsuler différents types de flux (ndjson, proto-basé, etc.) record_type ne peut être qu'un des éléments suivants : |
|
data_record |
Pour les flux qui ne sont pas basés sur le protocole proto. |
proto_record |
Pour les flux basés sur le protocole proto. |
GeoCoordinates
Coordonnées géographiques d'un lieu, y compris la latitude, la longitude et l'adresse.
Champs | |
---|---|
latitude |
Latitude en degrés. (facultatif) |
longitude |
Longueur en degrés. (facultatif) |
Champ d'union addresses . Adresse (structurée ou non) d'un lieu. addresses ne peut être qu'un des éléments suivants : |
|
address |
Adresse postale du lieu (à privilégier). |
unstructured_address |
Une adresse non structurée peut également être fournie en remplacement. Par exemple, "1600 amphitheatre parkway mountain view, ca 94043, états-unis". |
GetMerchantStatusRequest
La requête pour obtenir un MerchantStatus
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource, au format partners/{partner_id}/merchants/{merchant_id}/status. |
GetStatusRequest
Demande de récupération de l'état (Status
) d'un flux spécifique importé par la plate-forme de l'agrégateur.
Champs | |
---|---|
name |
Nom de la ressource du flux, au format
|
HomeServiceData
Des informations supplémentaires sont requises pour le secteur des services à domicile.
Champs | |
---|---|
category_type |
Catégorie générale à laquelle ce service à domicile appartient. Exemple : plombier, électricien, etc. |
job_type |
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. |
IntegrationType
Niveau d'intégration accepté.
Énumérations | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
La valeur par défaut est END_TO_END. |
INTEGRATION_TYPE_END_TO_END |
Intégration complète permettant un processus de réservation de bout en bout via Google. |
INTEGRATION_TYPE_INVENTORY_ONLY |
Le serveur de réservation n'a pas besoin d'être compatible avec ce service. Seuls les marchands, les services et (éventuellement) les données de disponibilité doivent être envoyés. |
InvalidateResourceRequest
Requête d'invalidation d'une ressource.
Champs | |
---|---|
resource_id |
Nom de la ressource à invalider. Par exemple, pour une ressource de retrait, le nom doit être au format |
LineItem
Un élément unique dans une commande : la réservation d'un seul service dans un seul créneau horaire.
Champs | |
---|---|
service_id |
ID du service du marchand. |
start_sec |
Heure de début du créneau horaire en secondes de l'heure UTC depuis l'epoch Unix. |
duration_sec |
Durée du créneau horaire en secondes. |
tickets[] |
Nombre de billets commandés par type de billet. |
price |
Prix total (hors taxes) de cette ligne. |
status |
État de l'élément de campagne. |
OrderedTickets
Nombre de billets commandés par type de billet.
Champs | |
---|---|
ticket_id |
ID d'un type de billet. |
count |
Nombre de billets commandés pour ce type. |
ListMerchantStatusesRequest
Requête d'obtention d'une liste de MerchantStatus
Champs | |
---|---|
parent |
Obligatoire. Parent, qui possède cette collection d'états du marchand. Format : |
page_size |
Obligatoire. Le nombre maximum d'éléments à renvoyer. Notez que le serveur peut réduire la taille de la page. |
page_token |
Facultatif. La valeur nextPageToken renvoyée par une ListMerchantStatusResponse précédente, le cas échéant. |
booking_inventory_status_restrict |
Facultatif. Restriction facultative permettant de filtrer les résultats en fonction de l'état de la réservation de l'inventaire. |
waitlist_inventory_status_restrict |
Facultatif. Restriction facultative permettant de filtrer les résultats par état de l'inventaire sur liste d'attente. |
geo_match_restrict |
Facultatif. Restriction facultative permettant de filtrer les résultats par état de correspondance géographique. |
BookingInventoryStatus
État de l'inventaire de réservation de bout en bout.
Enums | |
---|---|
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
Non spécifié. |
NO_VALID_FUTURE_INVENTORY |
Le marchand ne dispose d'aucun inventaire de réservation pour les 30 prochains jours. |
HAS_VALID_FUTURE_INVENTORY |
Le marchand a réservé un inventaire pour les 30 prochains jours. |
GeoMatchingStatus
État de la mise en correspondance géographique du marchand.
Enums | |
---|---|
GEO_MATCHING_STATUS_UNSPECIFIED |
Non spécifié. |
GEO_UNMATCHED |
Aucune correspondance géographique n'est établie pour le marchand. |
GEO_MATCHED |
Le marchand fait l'objet d'une correspondance géographique. |
WaitlistInventoryStatus
État de l'inventaire de bout en bout sur liste d'attente
Enums | |
---|---|
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
Non spécifié. |
NO_VALID_WAITLIST_SERVICE |
Le marchand ne dispose pas d'un service prenant en charge la liste d'attente. |
HAS_VALID_WAITLIST_SERVICE |
Le marchand dispose d'un service prenant en charge une liste d'attente. |
ListMerchantStatusesResponse
Réponse à la liste MerchantStatus
.
Champs | |
---|---|
merchant_statuses[] |
Liste des états des marchands qui remplissent les conditions de filtre. |
next_page_token |
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. |
ListStatusRequest
Demande de récupération de l'état (Status
) de plusieurs flux importés par la plate-forme de l'agrégateur.
Champs | |
---|---|
name |
Nom de la ressource du flux, au format
|
page_size |
Le nombre maximum d'éléments à renvoyer. |
page_token |
Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant. |
state_restrict |
Restriction facultative permettant de filtrer les résultats par état du flux. |
time_range_restrict |
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. |
ListStatusResponse
Demande de récupération de l'état (Status
) de plusieurs flux importés par la plate-forme de l'agrégateur.
Champs | |
---|---|
status[] |
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. |
next_page_token |
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. |
LocalizedString
Instance d'une chaîne dans un paramètre régional.
Champs | |
---|---|
locale |
Code de langue IETF BCP 47, tel que "en", "mas", "zh-Hant", "de-CH-1901". Voir http://www.w3.org/International/article/language-tags/. |
value |
Message utilisant les paramètres régionaux ci-dessus (UTF-8). |
Location
Données géographiques concernant un lieu.
Champs | |
---|---|
place_id |
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. |
name |
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) |
telephone |
Numéro de téléphone public du lieu, y compris l'indicatif du pays et de la région (par exemple, +14567891234). (facultatif) |
url |
URL du site Web public du lieu. (facultatif) |
geo |
Données géographiques concernant le lieu, y compris la latitude, la longitude et l'adresse. (facultatif) |
location_type |
Type d'emplacement, doit être fourni si celui-ci est fourni pour un service. |
location_id |
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) |
LocationType
Type de lieu.
Énumérations | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
Type de lieu non spécifié. |
VISITED_LOCATION |
Lieux visités dans le cadre de ce service. |
START_LOCATION |
Le point de départ de ce service, également utilisé comme MEETING_LOCATION. |
END_LOCATION |
Point d'arrivée de ce service. |
Merchant
Informations sur un marchand figurant sur la plate-forme de l'agrégateur.
Champs | |
---|---|
name |
Nom de la ressource marchand, au format |
merchant_name |
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. |
telephone |
Numéro de téléphone public du marchand, y compris l'indicatif pays et l'indicatif régional, par exemple +14567891234. |
url |
URL du site Web public du marchand. |
geo |
Informations géographiques du marchand, y compris la latitude, la longitude et l'adresse. |
category |
Catégorie de l'entreprise sur la plate-forme de l'agrégateur. |
num_bookings_30d |
Ce champ a été abandonné. |
tax_rate_basis_points |
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. |
tax_rate |
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. |
payment_restrictions |
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. |
payment_option[] |
Options de paiement disponibles pour ce marchand. Les services de ce marchand pourront limiter individuellement les options de paiement autorisées. |
payment_processor_config |
Configuration d'une société de traitement des paiements tokenisée, si le marchand accepte cette option. |
tokenization_config |
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. |
brand_id |
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…
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. |
matching_hints |
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) |
service_attribute[] |
Définitions des attributs de service utilisés pour décrire les services pour ce marchand. (facultatif) |
action_link[] |
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 |
waitlist_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. |
MerchantMatchingHints
Conseils pour aider Google à mettre un marchand en correspondance avec une adresse sur Google Maps.
Champs | |
---|---|
place_id |
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. |
MerchantStatus
État d'un marchand sur la plate-forme Réserver avec Google.
Champs | |
---|---|
name |
Nom de la ressource d'état du marchand, au format |
merchant_name |
Nom du marchand indiqué par les partenaires. |
input_geo_info |
Les partenaires ont fourni des informations géographiques sur le marchand. |
processing_status |
État du traitement par le marchand. |
booking_status |
État lié à l'intégration de bout en bout des réservations. |
waitlist_status |
État lié à l'intégration à la liste d'attente. |
geo_match |
Région géographique correspondant à ce marchand. Ce champ est vide si aucune correspondance géographique n'est établie pour le marchand. |
local_services_match |
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. |
direct_urls[] |
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. |
BookingStatus
État lié à l'intégration de bout en bout des réservations.
Champs | |
---|---|
has_valid_future_inventory |
"True" si le marchand dispose d'un inventaire dans les 30 prochains jours. Cela ne garantit pas que le marchand sera effectivement servi. |
DirectUrl
URL qui affiche le marchand.
Champs | |
---|---|
type |
Type de cette URL. |
url |
URL susceptible d'afficher ce marchand. |
UrlType
Type de l'URL affichée.
Enums | |
---|---|
URL_TYPE_UNSPECIFIED |
Non spécifié. |
BOOKING |
URL de réservation de bout en bout. |
WAITLIST |
URL de la liste d'attente de bout en bout. |
LOCAL_SERVICES |
URL Google Local Services. |
LocalServicesMatchInfo
Informations sur la correspondance Google Local Services (définies uniquement pour les marchands Local Services).
Champs | |
---|---|
matched_providers[] |
Fournisseurs de services correspondants. Un marchand peut être mis en correspondance avec plusieurs fournisseurs de services. |
MatchedProvider
Local Services - Fournisseur de services
Champs | |
---|---|
customer_id |
Numéro client externe Google Local Services. |
categories[] |
Catégories de services locaux (secteurs). Exemple : "plombier" et "carpet_cleaning". |
PlaceInfo
Informations sur une adresse correspondante.
Champs | |
---|---|
name |
Nom du lieu. |
formatted_address |
Adresse au format approprié dans la langue locale. |
place_id |
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. |
ProcessingStatus
État du traitement par le marchand.
Enums | |
---|---|
PROCESSING_STATUS_UNSPECIFIED |
État non spécifié. |
IN_PROGRESS |
Madden a bien reçu le marchand, mais il est toujours en cours de traitement. Aucun autre état ne sera renseigné pour les marchands associés à cet état. |
COMPLETED |
D'autres états du marchand ont été calculés. |
WaitlistStatus
État lié à l'intégration à la liste d'attente.
Champs | |
---|---|
has_valid_waitlist_service |
"True" si le marchand propose un service de listes d'attente. Cela ne garantit pas que le marchand sera effectivement servi. |
MoneyRange
Enveloppe d'une plage de montants monétaires pouvant être limitées ou illimitées. Vous devez renseigner au moins l'un des champs "min_amount" et "max_amount".
Champs | |
---|---|
min_amount |
Montant minimal. |
max_amount |
Montant maximal. |
NoShowFee
Frais pouvant être facturés à un utilisateur s'il a effectué une réservation, mais ne se présente pas.
Champs | |
---|---|
fee |
Montant susceptible d'être facturé à l'utilisateur s'il ne se présente pas à sa réservation. |
fee_type |
Définit la manière dont les frais sont déterminés à partir de la disponibilité. |
Order
Une commande de rendez-vous auprès d'un marchand.
Champs | |
---|---|
name |
Nom de ressource de la commande: |
client_information |
Informations personnelles du client effectuant la commande. |
payment_information |
Informations sur les transactions de paiement liées à la commande. |
merchant_id |
ID du marchand auquel appartiennent tous les services dans cette commande. |
item[] |
Lignes de cette commande. |
OrderOnlineMetadata
Métadonnées d'un lien d'action de commande en ligne.
Champs | |
---|---|
fulfillment_option[] |
Options de traitement disponibles pour un lien d'action de commande en ligne. |
PaymentInformation
Détails du paiement lié à une réservation.
Champs | |
---|---|
prepayment_status |
É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é. |
payment_transaction_id |
Identifiant unique d'une transaction de paiement associée à la réservation. Vide si non applicable. |
PaymentOption
Option de paiement qui peut être utilisée pour payer les services fournis par un marchand. Les options de paiement peuvent être partagées entre plusieurs marchands (par exemple, entre marchands appartenant à une même chaîne).
Champs | |
---|---|
payment_option_id |
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. |
name |
Nom de l'option de paiement. Peut être présenté à l'utilisateur. |
description |
Description de l'option de paiement. Peut être présenté à l'utilisateur. |
price |
Prix de l'option de paiement. |
tax_rate |
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. |
payment_option_type |
Type d'option de paiement. À usage unique pour les visites, à usages multiples pour les packs et à usage illimité pour les abonnements. |
session_count |
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. |
purchase_interval |
L'option de paiement peut être achetée dans cet intervalle. |
valid_interval |
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. |
valid_duration |
Durée de validité de l'option de paiement (par exemple, abonnement de 30 jours). |
activation_type |
Définit la manière dont la date de début de validité est déterminée pour cette option de paiement. |
user_restriction |
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. |
ActivationType
Définit la manière dont est déterminée la date de début de validité.
Énumérations | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Non utilisé. |
ACTIVATION_ON_PURCHASE |
La période de validité commence au moment de l'achat. |
ACTIVATION_ON_FIRST_USE |
La période de validité commence lorsque l'option de paiement est utilisée pour la première fois. |
PaymentOptionType
Un type d'option de paiement.
Énumérations | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Non utilisé. |
PAYMENT_OPTION_SINGLE_USE |
L'option de paiement ne peut être utilisée qu'une seule fois. |
PAYMENT_OPTION_MULTI_USE |
L'option de paiement peut être utilisée si le nombre de séances est supérieur à 0. |
PAYMENT_OPTION_UNLIMITED |
L'option de paiement peut être utilisée pendant la plage de dates applicable. Le nombre de séances n'est pas pris en compte. |
PaymentProcessorConfig
Une configuration pour une société de traitement des paiements, effectuée au niveau du marchand.
Champs | |
---|---|
processor |
Définit la société de traitement des paiements partenaire à laquelle cette configuration s'applique. |
public_key |
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. |
version |
Numéro de version de l'API envoyé à la société de traitement des paiements avec les demandes de paiement. |
Processor
Définit une société partenaire de traitement des paiements particulière.
Énumérations | |
---|---|
PROCESSOR_UNSPECIFIED |
Non utilisé |
PROCESSOR_STRIPE |
Une configuration pour les paiements effectués avec Stripe. |
PROCESSOR_BRAINTREE |
Une configuration pour les paiements effectués avec Braintree. |
PaymentRestrictions
Restrictions concernant les modes de paiement que ce marchand accepte.
Champs | |
---|---|
credit_card_restrictions |
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. |
PerOrderFee
Frais à payer une fois par commande, quel que soit le nombre de billets.
Champs | |
---|---|
delivery_fee |
Frais pouvant varier selon le mode de livraison. |
processing_fee |
Frais liés au traitement du mode de paiement de l'utilisateur. |
PerTicketFee
Frais à payer pour chaque billet acheté par l'utilisateur.
Champs | |
---|---|
service_charge |
Frais supplémentaires facturés pour un service. |
facility_fee |
Frais à payer sur le lieu/l'établissement |
taxes |
Taxes par billet. |
PostalAddress
Adresse d'un client ou d'une entreprise.
Champs | |
---|---|
address_country |
Pays, spécifié à l'aide de son code pays ISO 3166-1 alpha-2, par exemple "US" (obligatoire) |
address_locality |
La localité, par exemple "Mountain View". (obligatoire) |
address_region |
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) |
postal_code |
Le code postal, par exemple "94043". (obligatoire) |
street_address |
L'adresse postale, par exemple "1600 Amphitheatre Pkwy". (obligatoire) |
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. |
Price
Prix d'un service ou un montant de frais.
Champs | |
---|---|
price_micros |
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). |
currency_code |
Devise du prix définie dans la norme ISO 4217. |
pricing_option_tag |
Chaîne facultative et opaque qui identifie l'option de tarification associée au prix étendu. |
PriceInterpretation
Décrit comment un prix doit être interprété et présenté à l'utilisateur.
Énumérations | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED |
Interprétation du prix non spécifiée. Valeur par défaut : EXACT_AMOUNT. |
EXACT_AMOUNT |
Le prix doit être interprété comme une valeur spécifique. Exemples : 20 € pour une séance de yoga ; 15 € pour une coupe de cheveux enfant |
STARTS_AT |
Le prix d'un service est variable, mais un prix minimum est spécifié et doit être présenté à l'utilisateur. Le prix peut alors augmenter en fonction des choix effectués par l'utilisateur. Notez que pour tout service pour lequel vous utilisez PriceInterpretation, vous devez définir PrepaymentType sur NOT_SUPPORTED. Exemples : 30 € pour un service de toilettage de chiens, mais le prix peut augmenter en fonction des choix effectués par le client. |
NOT_DISPLAYED |
Le prix d'un service est variable. Aucune information sur le prix n'est présentée à l'avance à l'utilisateur. Notez que pour tout service pour lequel vous utilisez PriceInterpretation, vous devez définir PrepaymentType sur NOT_SUPPORTED, et la valeur de Price doit être vide. Exemple : Une consultation pour un service à domicile |
PriceType
Définit la manière dont un prix total est déterminé à partir d'une disponibilité.
Énumérations | |
---|---|
FIXED_RATE_DEFAULT |
Le prix correspond à un montant fixe. Si le champ n'est pas défini, cette valeur est utilisée par défaut. Exemples : Un acompte de 50 € pour réserver une table ; 20 € de frais de non présentation pour un cours de yoga |
PER_PERSON |
Le prix indiqué est par personne, et le prix total est calculé en fonction du nombre de personnes spécifié dans Ressources (calcul price_micros * party_size). En cas de prix PER_PERSON, le nombre de personnes doit être également défini dans les ressources associées à la disponibilité. Si le nombre de personnes n'est pas défini, la valeur 1 est utilisée par défaut. Exemple : 10 € par personne pour des billets d'entrée à un musée |
QuantitativeValue
Enveloppe d'une valeur numérique pouvant être une plage ou une valeur fixe. Exemples QuantitativeValue
: * Valeur singulière: value: 10.5
* Plage délimitée: value_range {min_value: 5.5, max_value 10.5}
* Limite inférieure: value_range {min_value: 5.5}
* Limite supérieure: value_range {max_value: 10.5}
Champs | |
---|---|
Champ d'union value_options . (Obligatoire) value_options ne peut être que l'un des éléments suivants: |
|
value |
Valeur unique. Exemple: 5,6 |
value_range |
Plage de valeurs qui peut également être ouverte ou limitée. Exemples: * Au moins 5,5 * Au maximum 5,5 * 5,5 à 6,5 |
RangeValue
Plage de valeurs telle que min_value
< max_value
Nécessite au moins l'un des éléments suivants : min_value
et max_value
.
Champs | |
---|---|
min_value |
Valeur minimale. |
max_value |
Valeur maximale. |
Notes
Définit une note associée à une entité.
Champs | |
---|---|
value |
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. |
number_of_ratings |
Nombre de notes utilisées pour calculer la valeur (obligatoire). |
RelatedMedia
Photos associées à ce service. Google explore ces éléments multimédias pour s'assurer qu'elles s'affichent correctement auprès des utilisateurs finaux. (facultatif)
Champs | |
---|---|
url |
URL de cette source multimédia. Google explore le contenu multimédia hébergé sur cette URL. |
type |
Type de cette source multimédia. |
localized_caption |
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) |
caption |
Obsolète. Utilisez plutôt localized_caption. |
Attribution
Informations sur l'attribution associée à l'élément multimédia.
Champs | |
---|---|
localized_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). |
text |
Obsolète. Utilisez plutôt localized_text. |
MediaType
Énumération indiquant le type associé à cette source multimédia. Seules les photos sont acceptées. Veuillez contacter l'équipe Réserver avec Google si vous aimeriez inclure d'autres types d'éléments multimédias.
Énumérations | |
---|---|
TYPE_UNSPECIFIED |
Non utilisé. |
PHOTO |
Indique que le contenu multimédia fourni par l'URL est une photo. |
ReplaceServiceAvailabilityRequest
Demande de remplacement de la disponibilité d'un Service
.
Champs | |
---|---|
service_availability |
Disponibilité du service utilisée pour remplacer les disponibilités existantes. |
RequireCreditCard
Définit si une carte de crédit est requise pour effectuer une réservation.
Énumérations | |
---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED |
La nécessité de payer par carte de crédit n'est pas explicitement spécifiée. Le comportement est donc identique à celui spécifié pour CONDITIONAL. |
REQUIRE_CREDIT_CARD_CONDITIONAL |
Google exige une carte de crédit pour la réservation si l'une des conditions suivantes est remplie : * La disponibilité a un prix et prepayment_type est REQUIRED * no_show_fee est défini * Le champ deposit est défini. |
REQUIRE_CREDIT_CARD_ALWAYS |
Une carte de paiement est toujours requise pour réserver cette disponibilité, quelles que soient les valeurs des autres champs. |
Ressources
Une ressource permet de faire la distinction entre différents créneaux de disponibilité lorsque plusieurs membres du personnel ou salles ont été définis pour le service. Plusieurs créneaux pour le même service et le même intervalle de temps peuvent coexister lorsqu'ils ont des ressources différentes.
Champs | |
---|---|
staff_id |
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. |
staff_name |
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. |
room_id |
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. |
room_name |
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. |
party_size |
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. |
SchedulingRules
Règles de planification d'un service.
Champs | |
---|---|
min_advance_online_canceling |
Délai de préavis minimal en secondes nécessaire pour annuler un rendez-vous en ligne. (facultatif) |
late_cancellation_fee |
Frais facturés en cas d'annulation dans le délai de préavis minimal. |
noshow_fee |
Frais de non-présentation facturés lorsque l'utilisateur n'a pas annulé la réservation. |
admission_policy |
Règles d'admission applicables à ce service. Si aucune valeur n'est définie, la valeur par défaut est TIME_STRICT. (facultatif) |
cancellation_policy |
Modalités d'annulation associées aux règles de planification. (obligatoire pour le secteur des activités à découvrir) |
Champ d'union Si "min_advance_booking" est défini, la dernière heure pouvant être réservée est calculée comme suit : (<slot start time> - "min_advance_booking"). Si "min_booking_buffer_before_end_time" est défini, la dernière heure pouvant être réservée est calculée comme suit : (<slot end time> - "min_booking_buffer_before_end_time"). Notez que si elle est définie, la valeur de "min_booking_buffer_before_end_time" doit être positive. Si les deux valeurs ne sont pas définies, le créneau peut être réservé jusqu'à son heure de début. Si les deux champs sont définis, une seule valeur est sélectionnée, tandis que l'autre est ignorée. Nous ne pouvons pas prédire de manière fiable quelle valeur est choisie. Exemples :
|
|
min_advance_booking |
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é. |
min_booking_buffer_before_end_time |
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. |
AdmissionPolicy
Règles d'admission associées à ce service.
Énumérations | |
---|---|
ADMISSION_POLICY_UNSPECIFIED |
Non utilisé. |
TIME_STRICT |
Les clients doivent être présents au début du créneau de disponibilité, et il est prévu que le service se termine à la fin du créneau. Exemples de cas d'utilisation de TIME_STRICT : * Une visite qui commence à 9h exige que tous les participants arrivent à l'heure de début. Il est prévu que le retour se fasse aux alentours de 12h. * Une réservation pour une coupe de cheveux à 15h samedi, qui durera environ 30 minutes. * Une séance de remise en forme de 18h à 20h. |
TIME_FLEXIBLE |
Les clients peuvent arriver à tout moment entre le début et la fin du créneau de disponibilité pour bénéficier de cette réservation. Exemples de cas d'utilisation de TIME_FLEXIBLE : * Un billet d'accès à un musée qui peut être utilisé à tout moment le jour de la date d'achat. * Une entrée dans un parc d'attractions utilisable l'après-midi entre 12h et 21h. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION |
Les clients doivent arriver chez le marchand au début du créneau de disponibilité, mais peuvent partir à l'heure de leur choix. Par exemple, dans le scénario du billet d'entrée pour un musée, le billet peut indiquer que l'utilisateur doit se présenter au musée à 10h. L'heure de début des créneaux de disponibilité de ce service correspond à l'heure d'entrée spécifiée. En revanche, l'heure de fin sert seulement de repère permettant d'identifier le créneau de disponibilité lors de la réservation. |
Service
Informations concernant un service fourni par le marchand (par exemple, "coupe de cheveux").
Champs | |
---|---|
name |
Nom de la ressource du service, au format |
service_name |
Nom du service (par exemple, "Coupe de cheveux pour hommes"). Obsolète. Utilisez plutôt localized_service_name. |
localized_service_name |
Nom du service (par exemple, "Coupe de cheveux pour hommes"). Possibilité de fournir plusieurs versions linguistiques. |
description |
Description du service, telle qu'elle sera présentée à l'utilisateur. Obsolète. Utilisez plutôt localized_description. |
localized_description |
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> Balise de paragraphe : <p> Balises de création de listes : <ul>, <ol>, <li> Balise de création d'une division : {div} Balises d'expressions : <br>, <strong>, <em> Balises non compatibles :
Remarques importantes :
|
price |
Prix du service. |
price_interpretation |
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. |
rules |
Règles de réservation ou d'annulation de rendez-vous. |
prepayment_type |
Indique si un pré-paiement est obligatoire, facultatif ou non accepté. |
prepayment_terms |
Conditions relatives à la finalisation du prépaiement. |
form[] |
Obsolète. Veuillez utiliser intake_form et per_ticket_intake_form. |
intake_form |
Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. (facultatif) |
per_ticket_intake_form |
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) |
tax_rate |
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. |
payment_option_id[] |
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) |
no_show_fee |
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) |
require_credit_card |
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) |
action_link[] |
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. |
type |
Type prédéfini du service. (facultatif) |
ticket_type[] |
Types de billets pouvant être réservés/achetés pour ce service (si les billets sont acceptés). (facultatif) |
related_media[] |
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) |
service_attribute_value_id[] |
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) |
waitlist_rules |
Règles pour s'inscrire sur la liste d'attente. |
ticketing_vertical_specific_data |
Informations supplémentaires propres au secteur de la vente de billets pour des événements. (facultatif) |
integration_type |
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. |
per_order_fee |
Frais facturés au niveau de la commande pour l'achat de ce service. (facultatif) |
tours_and_activities_content |
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. |
home_service_data |
Informations supplémentaires spécifiques au secteur des services à domicile. (facultatif) |
virtual_session |
Facultatif. Informations sur la session virtuelle. Il est nécessaire pour activer les services virtuels. |
direct_merchant_payment |
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. |
PrepaymentTerms
Des informations spécifiques sur la date à laquelle le prépaiement sera effectué.
Champs | |
---|---|
charge_timing |
Lorsque le débit interviendra en fonction de l'heure d'achat. |
charge_time_before_start_time_sec |
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. |
ChargeTiming
Énumération spécifiant le moment où le débit sera effectué par rapport à la date d'achat.
Enums | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
Non utilisé. |
CHARGE_NOW |
Les frais sont immédiatement facturés au Client. |
CHARGE_LATER |
Le client sera facturé ultérieurement. |
PrepaymentType
Énumération pour indiquer le type de pré-paiement.
Énumérations | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
Par défaut, nous partons du principe que le pré-paiement est NOT_SUPPORTED. |
REQUIRED |
L'utilisateur doit payer ce service au moment de la réservation. |
OPTIONAL |
L'utilisateur peut choisir de prépayer ce service au moment de la réservation ou ultérieurement, mais le paiement n'est pas requis pour effectuer la réservation. |
NOT_SUPPORTED |
Le pré-paiement n'est pas accepté pour ce service. |
ServiceType
Types de services prédéfinis.
Énumérations | |
---|---|
SERVICE_TYPE_UNSPECIFIED |
Non utilisé. |
SERVICE_TYPE_DINING_RESERVATION |
Réservation dans le secteur de la restauration. |
SERVICE_TYPE_FOOD_ORDERING |
La commande de repas peut être la livraison de repas, la vente à emporter ou les deux. |
SERVICE_TYPE_FOOD_DELIVERY |
Livraison de repas. |
SERVICE_TYPE_FOOD_TAKEOUT |
Repas à emporter. |
SERVICE_TYPE_EVENT_TICKET |
Billet pour un événement. |
SERVICE_TYPE_TRIP_TOUR |
Visite guidée. |
SERVICE_TYPE_APPOINTMENT |
Service qui propose des rendez-vous ou des cours. Recommandé pour les secteurs (1) de la santé et de la remise en forme, (2) des spas et soins beauté, et (3) des services conseil et évaluation financiers. Vous trouverez les types de service compatibles sur la page https://developers.google.com/maps-booking/guides/end-to-end-integration/overview. |
SERVICE_TYPE_ONLINE_APPOINTMENT |
Service qui permet de prendre rendez-vous en ligne pour un cours ou une session entièrement virtuels. Doit être défini si vous activez les réservations de services virtuels. |
SERVICE_TYPE_SHOPPING |
Service permettant aux utilisateurs d'effectuer des achats auprès du marchand donné. Il peut s'agir d'un service de livraison ou de retrait. |
ServiceAttribute
Les attributs de service correspondent à des catégories définies par le partenaire. Elles décrivent les services d'un marchand. Par exemple, une banque peut définir un attribut de service "Account Type" avec les valeurs possibles "Personnel" et "Entreprise", tandis qu'un salon de coiffure peut définir un attribut de service "Service Type" avec les valeurs possibles "Coupe de cheveux", "Couleur" et "Style".
Champs | |
---|---|
attribute_id |
Identifiant qui identifie cet attribut de service de manière unique parmi d'autres attributs pour le même marchand (par exemple, "account-type". |
attribute_name |
Nom visible par l'utilisateur pour cet attribut, comme "Type de compte". |
value[] |
Toutes les valeurs possibles pour cet attribut de service. |
Value
Représente une valeur pouvant être utilisée pour un attribut particulier du service.
Champs | |
---|---|
value_id |
Identifiant qui identifie cette valeur de manière unique parmi d'autres valeurs pour cet attribut de service, par exemple "personnel". |
value_name |
Nom de la valeur visible par l'utilisateur (par exemple, "Personnel". |
ServiceAttributeValueId
Identifie une valeur particulière d'un attribut de service à appliquer à un service.
Champs | |
---|---|
attribute_id |
ID d'un attribut tel que défini dans "Merchant.service_attribute", par exemple "service-type". |
value_id |
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. |
ServiceAvailability
Liste de disponibilités et à qui/quand les appliquer
Champs | |
---|---|
name |
Nom de la ressource du service auquel appliquer ce paramètre. Au format |
start_time_restrict |
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 :
Si un message "duration" (durée) est défini, la condition est encore plus exigeante :
Si un message "resources_restrict" est défini, la condition est plus exigeante encore :
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. |
end_time_restrict |
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_restrict |
Lorsque la durée est définie, toute mise à jour de la disponibilité est limitée aux créneaux de cette durée. |
resources_restrict |
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. |
ServiceIntakeForm
Définit un formulaire d'enregistrement qui permet à l'utilisateur de personnaliser le service fourni par un marchand.
Champs | |
---|---|
field[] |
Champs qui seront présentés à l'utilisateur. |
first_time_customers |
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. |
returning_customers |
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. |
ServiceIntakeFormField
Définit un champ inclus dans un formulaire ServiceIntakeForm.
Champs | |
---|---|
id |
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) |
type |
Type de ce champ. |
label |
Texte présenté à l'utilisateur pour ce champ. Obsolète. Utilisez plutôt |
localized_label |
Texte présenté à l'utilisateur pour ce champ. Le champ peut être fourni dans différents paramètres régionaux. (obligatoire) |
value[] |
À 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. |
choice_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. |
is_required |
Indique si l'utilisateur doit répondre à ce champ. |
allow_custom_answer |
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) |
additional_option[] |
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) |
ticket_type_restrict[] |
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. |
hint |
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) |
FieldType
Énumération pour indiquer le type de champ.
Énumérations | |
---|---|
FIELD_TYPE_UNSPECIFIED |
Le système ignore les champs dont le type n'est pas spécifié ou est inconnu. |
SHORT_ANSWER |
Champ de saisie d'une ligne pour le texte. |
PARAGRAPH |
Champ de saisie de plusieurs lignes pour le texte. |
MULTIPLE_CHOICE |
Un ensemble de cases d'option nécessitant un choix parmi différentes options. |
CHECKBOXES |
Un ou plusieurs éléments énumérés associés à des cases à cocher. |
DROPDOWN |
Une sélection dans une liste déroulante. |
BOOLEAN |
Un bouton Oui/Non. |
LOCATION_SEARCH |
Champ de recherche permettant de trouver un lieu correspondant en fonction des données saisies par l'utilisateur dans la liste d'adresses fournie. |
TaxRate
Taux de taxe appliqué lors de la facturation d'un service à l'utilisateur, qui peut être défini au niveau du marchand ou du service.
Champs | |
---|---|
micro_percent |
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. |
Terms
Ensemble de règles et consignes présentées à l'utilisateur souhaitant effectuer une réservation via Réserver avec Google.
Champs | |
---|---|
url |
Éventuellement, l'URL des conditions d'utilisation |
text |
Texte à afficher auprès de l'utilisateur. Pour les nouvelles intégrations, utilisez localized_text ci-dessous. |
localized_text |
Texte localisé à présenter à l'utilisateur. |
Text
Une charge utile de texte qui peut être localisé. Certains champs de texte peuvent contenir du contenu balisé.
Champs | |
---|---|
value |
Valeur textuelle dans des paramètres régionaux inconnus. Obligatoire si (et seulement si) |
localized_value[] |
Valeurs textuelles par paramètre régional. Facultatif. |
TicketType
TicketType permet de différencier les billets dont les prix et/ou les disponibilités varient en fonction des types d'utilisateurs, des attributs de service ou des options/services complémentaires.
Un billet correspond au nombre minimal d'unités pouvant être réservées pour un service, par exemple une place sur une expédition en radeau, une entrée dans un musée ou une location de kayak pour une journée entière.
Champs | |
---|---|
ticket_type_id |
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. |
short_description |
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. |
localized_short_description |
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. |
per_ticket_fee |
Frais supplémentaires appliqués à l'achat de ce billet. (facultatif) |
option_description |
Description de toute option supplémentaire auquel ce type de billet est éventuellement associé. Obsolète. Utilisez plutôt localized_option_description. |
localized_option_description |
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 |
TicketingVerticalSpecificData
Informations supplémentaires propres au secteur de la vente de billets pour des événements.
Champs | |
---|---|
event_category |
Catégorie de l'événement. À définir seulement lorsque l'événement appartient à l'une des catégories prédéfinies. (facultatif) |
event_url |
URL de l'événement sur le site Web du partenaire. (facultatif) |
entity[] |
Liste d'entités associées à l'événement. (facultatif) |
event_attendance_mode |
Obligatoire. Type de participation à l'événement. |
event_virtual_location_url[] |
Facultatif. URL où l'événement peut être regardé. |
event_organizer |
Facultatif. Organisateur de l'événement. |
event_organizer_url |
Facultatif. URL de l'organisateur de l'événement. |
event_organizer_type |
Facultatif. Type d'organisateur. |
event_source_url[] |
Obligatoire. URL des pages sur lesquelles figurent les informations ou les descriptions de l'événement |
event_state |
Facultatif. État de l'événement. |
AttendanceMode
Type de participation à l'événement.
Enums | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED |
Non spécifié. |
ONLINE |
Pour les événements virtuels. |
PHYSICAL |
Pour les événements physiques. |
PHYSICAL_ONLINE_MIXED |
Pour les événements à la fois physiques et virtuels. |
Entité
Représente une entité associée à l'événement.
Champs | |
---|---|
id |
Identifiant unique de l'entité dans la base de données du partenaire. (facultatif) |
name |
Nom de l'entité. (obligatoire) |
url |
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) |
entity_type |
Type d'entité. (facultatif) |
entity_role |
Rôle de l'entité pendant l'événement. (facultatif) |
public_identification_data |
Références publiques associées à l'entité. (facultatif) |
EntityRole
Rôle de l'entité pendant l'événement.
Énumérations | |
---|---|
ENTITY_ROLE_UNSPECIFIED |
Non spécifié. |
ENTITY_ROLE_HEADLINER |
L'entité correspond à la vedette ou à l'artiste principal qui se produit lors de l'événement. |
ENTITY_ROLE_SUPPORTER |
L'entité correspond à un artiste participant à l'événement. |
ENTITY_ROLE_HOME_TEAM |
L'entité correspond à l'équipe hôte lors de l'événement sportif. |
ENTITY_ROLE_AWAY_TEAM |
L'entité correspond à l'équipe des visiteurs lors de l'événement sportif. |
EntityType
Type d'entité. Remarque : Il ne s'agit pas d'une ontologie universelle.
Énumérations | |
---|---|
ENTITY_TYPE_UNSPECIFIED |
Non spécifié. Ne pas utiliser. |
ENTITY_TYPE_PERFORMER |
L'entité correspond à l'artiste ou au groupe qui se produit lors d'un concert ou d'un spectacle. Ne s'applique que si la catégorie d'événement est "CONCERT" ou "THEATRE". |
ENTITY_TYPE_PLAYER |
L'entité correspond à l'équipe ou au joueur lors de l'événement sportif. Ne s'applique que si la catégorie d'événement est "SPORTS". |
ENTITY_TYPE_CONCERT_TOUR |
L'entité correspond à la visite guidée à laquelle cet événement appartient. Ne s'applique que si la catégorie d'événement est "CONCERT". |
ENTITY_TYPE_SPORTS_SERIES |
L'entité correspond à un événement sportif auquel cet événement appartient. Ne s'applique que si la catégorie d'événement est "SPORTS". |
ENTITY_TYPE_PLAY |
L'entité correspond au type de pièce (comédie musicale, comédie, ballet, etc.) jouée lors de l'événement. Ne s'applique que si la catégorie d'événement est "THEATRE". |
EventCategory
Sous-ensemble de catégories d'événements pour lesquelles nous personnalisons l'expérience produit. Remarque : Il ne s'agit pas d'une ontologie universelle des événements.
Énumérations | |
---|---|
EVENT_CATEGORY_UNSPECIFIED |
Non spécifié. Ne pas utiliser. |
EVENT_CATEGORY_CONCERT |
Concerts. |
EVENT_CATEGORY_SPORTS |
Événements sportifs. |
EVENT_CATEGORY_THEATRE |
Événements théâtre. |
EVENT_CATEGORY_EXHIBITS |
Expositions. |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
Ateliers et cours. |
EventState
État de l'événement.
Enums | |
---|---|
EVENT_STATE_UNSPECIFIED |
Non spécifié. |
SCHEDULED |
L'événement est planifié. |
RESCHEDULED |
L'événement est reprogrammé. |
CANCELLED |
L'événement est annulé. |
POSTPONED |
L'événement est reporté. |
OrganizerType
Type d'organisateur.
Enums | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
Non spécifié. |
PERSON |
Pour l'organisateur qui est une personne |
ORGANIZATION |
Pour l'organisateur qui est une organisation. |
PublicIdentificationData
Identifiants, pages Web ou toute autre source publique référençant une entité.
Champs | |
---|---|
relevant_url[] |
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) |
musicbrainz_id |
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) |
TimeRange
Une période ouvert-fermé, autrement dit [start_time, end_time].
Champs | |
---|---|
start_time |
Seuil inférieur de la plage de dates. |
end_time |
Seuil supérieur de la plage de dates. |
TokenizationConfig
Une configuration pour la tokenisation de la société de traitement des paiements, effectuée au niveau du marchand.
Champs | |
---|---|
tokenization_parameter |
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" } |
billing_information_format |
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. |
BillingInformationFormat
La partie de l'adresse de facturation à exiger de l'utilisateur et à inclure dans le jeton. Les valeurs de l'énumération correspondent aux paramètres dans l'API Google Pay (voir https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
Énumérations | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
Non spécifié. La valeur par défaut est MIN. |
MIN |
Nom, code pays et code postal (paramètre Google Pay par défaut). |
FULL |
Nom, adresse postale, localité, région, code pays et code postal. |
ToursAndActivitiesContent
Champs de contenu spécifiques aux visites guidées et aux activités. Chaque élément du champ répété doit être indépendant pour permettre un affichage séparé (par exemple, sous forme de puces).
Il est fortement recommandé de renseigner ToursAndActivitiesContent, mais ce n'est pas strictement obligatoire. Tous les champs acceptent à la fois le format texte brut et le format HTML pour une mise en forme simple. Balises de mise en forme HTML compatibles :
Balises d'expressions :
, , , Seules ces trois balises sont acceptées. Vous pouvez utiliser la balise
pour créer des sauts de ligne au sein de paragraphes, et les balises // pour mettre des contenus textuels en évidence. Le système ignorera toute autre balise d'expressions.
Toutes les autres balises et tous les autres styles personnalisés ne sont pas autorisés et seront supprimés. Les URL, les ancres et les liens seront supprimés et ne seront jamais présentés aux utilisateurs finaux.
Remarques importantes : * Ne dupliquez pas les données déjà fournies dans highlights
, exclusion
et dans d'autres champs plus spécifiques dans la description du service. * 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.
Champs | |
---|---|
highlights[] |
Liste des temps forts visible par l'utilisateur. |
inclusions[] |
Liste d'inclusions visible par l'utilisateur. |
exclusions[] |
Liste d'exclusions présentée à l'utilisateur. |
must_know[] |
Liste de remarques importantes visible par l'utilisateur à utiliser pour des détails tels que des limites d'âge ou d'autres conditions qui rendent ce service inapproprié. |
UnsupportedPartySizeOption
Options pour les groupes hors de portée.
Champs | |
---|---|
call_merchant |
Les personnes situées en dehors de la plage peuvent appeler l'entreprise. Un message prédéfini s'affiche. Exemple de texte à afficher : "Pour les groupes de plus de {waitlist_rules.max_party_size}, veuillez appeler le restaurant au {phone}." La valeur "CallMerchant" doit être définie, mais elle sera vide. |
UpdateBookingRequest
Demande de mise à jour d'une réservation google.maps.booking.v1alpha.Booking
Champs | |
---|---|
update_mask |
Masque de champ de tous les champs de la réservation à mettre à jour |
booking |
Réservation à mettre à jour |
booking_failure |
Si le traitement d'une demande de réservation confirmée de manière asynchrone échoue, et si l'état de la réservation est désormais FAILED, ce champ doit indiquer l'erreur de logique métier (par exemple, l'utilisateur a une réservation existante qui est trop proche). Ce champ ne doit être défini que lors de la mise à jour de l'état de la réservation sur FAILED. Il est ignoré dans les autres cas. |
UpdateMerchantRequest
Demande de mise à jour d'un Merchant
.
Champs | |
---|---|
merchant |
Données du nouveau marchand. |
update_mask |
Champs spécifiques à mettre à jour pour le marchand. |
UpdateOrderRequest
Demande de mise à jour d'une commande google.maps.booking.v1alpha.Order
Champs | |
---|---|
update_mask |
Masque de champ de tous les champs de la commande à mettre à jour |
order |
La commande à mettre à jour |
UpdateServiceRequest
Demande de mise à jour d'un Service
.
Champs | |
---|---|
service |
Les nouvelles données du service |
update_mask |
Champs spécifiques à mettre à jour pour le service. |
UserPurchaseRestriction
Définit une limite concernant les utilisateurs pouvant acheter une option de paiement.
Champs | |
---|---|
new_to_merchant |
Option de paiement réservée aux utilisateurs n'ayant jamais effectué d'achat auprès du même marchand. |
new_to_payment_option |
Option de paiement qui ne peut être achetée que par les utilisateurs qui n'ont jamais acheté la même option de paiement auparavant. |
VirtualSession
Informations sur la session virtuelle/en ligne. Exemple : Cours de yoga en ligne, cours de cuisine virtuels, etc.
Champs | |
---|---|
session_instructions |
Instructions de configuration de ce cours virtuel. Si le partenaire n'indique pas l'URL de la vidéo lors de la réservation, ce texte doit indiquer à quel moment l'URL de la vidéo sera partagée avec l'utilisateur. Par exemple : "L'URL Zoom sera envoyée par courrier 30 minutes avant le cours." (recommandé) |
session_requirements |
Conditions requises pour la session virtuelle donnée. Par exemple, tapis de yoga, ustensiles de cuisine, etc. (recommandé) |
virtual_platform_info |
Informations sur la plate-forme virtuelle utilisée lors de cette session. (Obligatoire pour activer les services virtuels) |
is_session_prerecorded |
Obligatoire. Définissez ce paramètre sur "true" si la session virtuelle n'est pas en direct et est préenregistrée. |
VirtualPlatformInfo
Informations sur la plate-forme qui sera utilisée pour cette session virtuelle.
Champs | |
---|---|
platform |
Plate-forme utilisée pour la session virtuelle. |
other_platform_name |
Nom de la plate-forme si elle est définie sur OTHER. (Obligatoire si la plate-forme est définie sur OTHER) |
Plate-forme
Énumération indiquant la plate-forme virtuelle que le marchand utilisera.
Enums | |
---|---|
PLATFORM_UNSPECIFIED |
Non utilisé. |
FLEXIBLE |
Le marchand est flexible quant à la plate-forme vidéo qu'il utilise. |
GOOGLE_HANGOUTS |
Produit Google Hangouts. |
GOOGLE_MEET |
Produit Google Meet. |
ZOOM |
Communications vidéo Zoom. |
SKYPE |
Skype |
YOUTUBE |
Diffusion en direct sur YouTube. |
OTHER |
Doit être défini si la plate-forme vidéo utilisée est différente de celles mentionnées ici. |
WaitlistRules
Règles applicables à l'inscription sur la liste d'attente
Champs | |
---|---|
min_party_size |
Obligatoire. Doit être un entier positif pour les services fournissant la fonctionnalité de liste d'attente. Ce champ ne doit pas être renseigné si le service ou le marchand ne propose pas la fonctionnalité de liste d'attente. |
max_party_size |
Obligatoire. Doit être un entier positif pour les services fournissant la fonctionnalité de liste d'attente. Ce champ ne doit pas être renseigné si le service ou le marchand ne propose pas la fonctionnalité de liste d'attente. |
supports_additional_request |
Si la valeur est "true", l'utilisateur peut envoyer une requête de texte supplémentaire à forme libre lorsqu'il s'inscrit sur la liste d'attente de ce service. |
above_max_party_size_options[] |
Définissez les options pour les groupes dont la taille dépasse le paramètre max_party_size défini. Laissez ce champ vide si des groupes plus importants ne doivent pas avoir d'autres options pour rejoindre une liste d'attente. |