Package google.maps.booking.v1alpha

Index

• AdsAccountLinkingService (interface)
• BookingNotification (interface)
• Feed (interface)
• InvalidationService (interface)
• InventoryStatus (interface)
• InventoryUpdate (interface)
• ActionLink (message)
• ActionLink.ActionLinkType (enum)
• ActionLink.EventMetadata (message)
• ActionLink.EventMetadata.Surface (enum)
• ActionPlatform (enum)
• AdsAccountLink (message)
• AdsAccountLink.State (enum)
• Advisement (message)
• Availability (message)
• Availability.ConfirmationMode (enum)
• Availability.DurationRequirement (enum)
• Availability.LinkoutRequiredReason (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)
• CreateAdsAccountLinkRequest (message)
• CreateMerchantRequest (message)
• CreateServiceRequest (message)
• CreditCardRestrictions (message)
• CreditCardRestrictions.CreditCardType (enum)
• DeleteAdsAccountLinkRequest (message)
• DeleteMerchantRequest (message)
• DeleteServiceRequest (message)
• Deposit (message)
• DirectMerchantPayment (message)
• DurationRange (message)
• EconomicOperator (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)
• GetAdsAccountLinkRequest (message)
• GetMerchantStatusRequest (message)
• GetStatusRequest (message)
• HomeServiceData (message)
• IntegrationType (enum)
• InvalidateResourceRequest (message)
• LineItem (message)
• LineItem.OrderedTickets (message)
• LinkoutTemplate (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)
• Prepayment (message)
• PrepaymentStatus (enum)
• Price (message)
• PriceInfo (message)
• PriceInterpretation (enum)
• PriceRange (message)
• 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)
• TicketType.InventoryType (enum)
• TicketType.PriceDisplayType (enum)
• TicketingVerticalSpecificData (message)
• TicketingVerticalSpecificData.AttendanceMode (enum)
• TicketingVerticalSpecificData.Entity (message)
• TicketingVerticalSpecificData.Entity.EntityRole (enum)
• TicketingVerticalSpecificData.Entity.EntityType (enum)
• TicketingVerticalSpecificData.EventCategory (enum)
• TicketingVerticalSpecificData.EventCreator (message)
• TicketingVerticalSpecificData.EventState (enum)
• TicketingVerticalSpecificData.OrganizerType (enum)
• TicketingVerticalSpecificData.PublicIdentificationData (message)
• TimeRange (message)
• TokenizationConfig (message)
• TokenizationConfig.BillingInformationFormat (enum)
• ToursAndActivitiesContent (message)
• UnsupportedPartySizeOption (message)
• UpdateAdsAccountLinkRequest (message)
• UpdateBookingRequest (message)
• UpdateMerchantRequest (message)
• UpdateOrderRequest (message)
• UpdateServiceRequest (message)
• UriTemplate (message)
• UserPurchaseRestriction (message)
• VirtualSession (message)
• VirtualSession.VirtualPlatformInfo (message)
• VirtualSession.VirtualPlatformInfo.Platform (enum)
• WaitlistRules (message)

AdsAccountLinkingService

Service permettant de gérer l'association de comptes entre Google Ads et Partner Center.

CreateAdsAccountLink

rpc CreateAdsAccountLink(CreateAdsAccountLinkRequest) returns (AdsAccountLink) Crée un lien vers un compte Ads. Cela lancera l'association entre le compte Google Ads et le centre des partenaires. Le lien sera à l'état Pending jusqu'à ce qu'il soit approuvé dans le portail Ads. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

DeleteAdsAccountLink
rpc DeleteAdsAccountLink(DeleteAdsAccountLinkRequest) returns (Empty) Supprime l'association du compte Ads. Le compte Google Ads et le compte du centre des partenaires seront alors dissociés. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

GetAdsAccountLink
rpc GetAdsAccountLink(GetAdsAccountLinkRequest) returns (AdsAccountLink) Récupère l'association à un compte Ads. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

UpdateAdsAccountLink
rpc UpdateAdsAccountLink(UpdateAdsAccountLinkRequest) returns (AdsAccountLink) Met à jour l'association du compte Ads avec les articles de l'inventaire. L'association du compte Ads sera mise à jour avec les éléments d'inventaire fournis. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

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
rpc UpdateBooking(UpdateBookingRequest) returns (Booking) Met à jour une valeur Booking existante. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

UpdateOrder
rpc UpdateOrder(UpdateOrderRequest) returns (Order) Met à jour une valeur Order existante. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

Flux

Récupère l'état de traitement des flux importés par des partenaires agrégateurs externes.

GetStatus
rpc GetStatus(GetStatusRequest) returns (FeedStatus) Récupère la valeur Status d'un flux précédemment importé par l'agrégateur spécifié, puis renvoie cette valeur. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

ListStatus
rpc ListStatus(ListStatusRequest) returns (ListStatusResponse) Récupère la valeur Status de plusieurs flux de marchands, services ou disponibilité précédemment importés par l'agrégateur spécifié, puis renvoie cette valeur. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

InvalidationService

Reçoit les demandes d'invalidation de ressources de partenaires externes.

InvalidateResource
rpc InvalidateResource(InvalidateResourceRequest) returns (Empty) 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 acceptés : - Pickup Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

InventoryStatus

Récupérez l'état de l'inventaire et de la correspondance des marchands importés.

GetMerchantStatus
rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus) Obtenez le MerchantStatus d'un Merchant. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

ListMerchantStatuses
rpc ListMerchantStatuses(ListMerchantStatusesRequest) returns (ListMerchantStatusesResponse) Lister tous les MerchantStatus d'un partenaire qui répondent aux conditions de filtre. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

InventoryUpdate

Reçoit les mises à jour d'inventaire d'agrégateurs externes.

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords(BatchDeleteGenericRecordsRequest) returns (Empty) Supprime les enregistrements du type de flux spécifié. Il n'effectue qu'une validation de base (par exemple, une requête mal formée), après quoi une réponse appropriée est immédiatement renvoyée au partenaire. Google effectue une validation de la logique métier sur la demande de manière asynchrone. Cet appel par lot ne garantit pas l'atomicité. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

BatchPushGenericRecord

rpc BatchPushGenericRecord(BatchPushGenericRecordRequest) returns (Empty) Insère et/ou met à jour les enregistrements du type de flux spécifié. Il n'effectue qu'une validation de base (par exemple, une requête mal formée), après quoi une réponse appropriée est immédiatement renvoyée au partenaire. Google effectue une validation de la logique métier sur la demande de manière asynchrone. Cet appel par lot ne garantit pas l'atomicité. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability(BatchReplaceServiceAvailabilityRequest) returns (BatchReplaceServiceAvailabilityResponse) Remplace la valeur Availability de Services existants. Cet appel par lot ne garantit pas l'atomicité. Seuls les créneaux de disponibilité mis à jour sont renvoyés. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

CreateMerchant
rpc CreateMerchant(CreateMerchantRequest) returns (Merchant) Créé une valeur Merchant gérée par l'agrégateur spécifié, puis renvoie cette valeur. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

CreateService
rpc CreateService(CreateServiceRequest) returns (Service) Crée une valeur Service pour un marchand géré par l'agrégateur spécifié, puis renvoie cette valeur. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

DeleteMerchant

rpc DeleteMerchant(DeleteMerchantRequest) returns (Empty) Supprime une valeur Merchant existante gérée par l'agrégateur spécifié. Tous les services du marchand, ainsi que les informations sur la disponibilité, sont également désactivés. Si vous ajoutez de nouveau le marchand ultérieurement, le même ensemble de services et de créneaux de disponibilité s'affiche. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

DeleteService
rpc DeleteService(DeleteServiceRequest) returns (Empty) Supprime une valeur Service existante associée à un marchand géré par l'agrégateur spécifié. Toutes les données concernant la disponibilité du service sont également supprimées. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

ReplaceServiceAvailability
rpc ReplaceServiceAvailability(ReplaceServiceAvailabilityRequest) returns (ServiceAvailability) Remplace la valeur Availability d'un Service existant associé à un marchand géré par l'agrégateur spécifié, puis renvoie cette valeur. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

UpdateMerchant
rpc UpdateMerchant(UpdateMerchantRequest) returns (Merchant) Met à jour une valeur Merchant existante gérée par l'agrégateur spécifié, puis renvoie cette valeur. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

UpdateService
rpc UpdateService(UpdateServiceRequest) returns (Service) Met à jour une valeur Service existante associée à un marchand géré par l'agrégateur spécifié, puis renvoie cette valeur. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/mapsbooking

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	string L'URL du point d'entrée correspondant à ce lien d'action.
language	string Balise de langue BCP-47 identifiant la langue du contenu associé à cet URI.
restricted_country[]	string Code pays ISO 3166-1 Alpha-2. Laissez ce champ vide si vous ne souhaitez pas restreindre la visibilité du contenu.
platform	ActionPlatform Plate-forme sur laquelle cette action doit être effectuée. Si ce champ n'est pas défini, ACTION_PLATFORM_WEB_APPLICATION est utilisé à la place.
action_link_type	ActionLinkType Type d'action prédéterminé.
order_online_metadata	OrderOnlineMetadata Métadonnées du lien de commande en ligne. Compatible avec les actions dont ActionLinkType est défini sur ACTION_LINK_TYPE_SHOP_ONLINE.
food_ordering_metadata	FoodOrderingMetadata Métadonnées pour les liens de commande de repas. Types d'actions acceptés : * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT ACTION_LINK_TYPE_ORDER_FOOD n'est PAS accepté.
event_metadata	EventMetadata Informations supplémentaires sur le lien d'action, propres au secteur des événements.

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 "commander des articles", qui peuvent être livrés ou retirés, ou les deux à la fois.

EventMetadata

Informations supplémentaires sur le lien d'action, propres au secteur des événements.

Champs
surface	Surface Surface d'événement prédéterminée associée à un lien d'action. Cette option n'est utilisée que pour le secteur des événements.

Surface

Surface d'événement prédéterminée associée à un lien d'action. Cette option n'est utilisée que pour le secteur des événements.

Enums
SURFACE_UNSPECIFIED	La surface n'est pas spécifiée.
SURFACE_SEARCH	Le lien d'action permet de réserver un billet pour un événement dans la recherche.
SURFACE_YOUTUBE	Le lien d'action permet de réserver un billet pour un événement sur YouTube.
SURFACE_ADS	Le lien d'action correspond au clic sur une annonce pour l'événement.

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.

AdsAccountLink

AdsAccountLink est un lien entre un compte Ads et un compte Partner Center, ainsi que les éléments d'inventaire.

Champs
name	string Identifiant. Nom de ressource de AdsAccountLink. Format : partners/{partner}/adsAccountLinks/{ads_account_link}
item_ids[]	string Obligatoire. Liste des ID d'articles d'inventaire à associer au compte Google Ads.
state	State Uniquement en sortie. État de l'association du compte Ads.

État

État de l'association du compte Ads.

Enums
STATE_UNSPECIFIED	État inconnu.
LINKED	Le compte est associé entre le Centre des partenaires et le portail Ads.
PENDING	Le compte est en attente d'approbation dans le portail des partenaires ou le portail Ads.
DELETED	L'association des comptes est supprimée.
REJECTED	La demande d'association de compte est refusée par le Partner Center ou le portail Ads.

Conseils

Conseils affichés à l'utilisateur lorsqu'il effectue une réservation via Réserver avec Google.

Champs
text	Text Message personnalisé à afficher à l'utilisateur lors de la 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	Timestamp Heure de début du créneau horaire.
duration	Duration Durée du créneau horaire
spots_total	int64 Nombre total de créneaux et de créneaux disponibles pour cette disponibilité. Exemples : Un cours de yoga comprenant 10 créneaux dont 3 réservés : availability {spots_total: 10, spots_open: 7 ...} Une séance de massage sur chaise qui est déjà complètement réservée : availability {spots_total: 1, spots_open: 0 ...} Remarque : Si vous envoyez des requêtes à l'aide du format de compression applicable au flux de disponibilité défini ci-dessous, le système infère la valeur de ces deux champs. Définissez spots_total=1 et spots_open=1 en cas de "Recurrence". Définissez spots_total=1 et spots_open=0 en cas de "ScheduleException".
spots_open	int64 Nombre de créneaux disponibles.
availability_tag	string Chaîne opaque facultative permettant d'identifier ce créneau de disponibilité. Si la valeur est définie, elle est incluse dans les demandes de réservation/de mise à jour/d'annulation de rendez-vous.
resources	Resources Ressources facultatives permettant de faire la distinction entre ce créneau de disponibilité et d'autres créneaux, lorsque plusieurs membres du personnel ou salles ont été définis pour le service. Par exemple, le même cours de yoga avec deux enseignants : availability { resources { staff_id: "1" staff_name: "Amy" } spots_total: 10 spots_open: 7 } availability { resources { staff_id: "2" staff_name: "John" } spots_total: 5 spots_open: 2 }
payment_option_id[]	string Liste d'ID faisant référence aux options de paiement pouvant être utilisées pour le paiement de ce créneau. Les options de paiement réelles sont définies au niveau du marchand et peuvent également s'appliquer à plusieurs marchands. Ce champ remplace tout ID payment_option_ids éventuellement spécifié dans le message du service. De même, les identifiants payment_option_ids spécifiés ici ne doivent PAS OBLIGATOIREMENT être inclus dans le message du service, mais doivent l'être au niveau du marchand.
recurrence	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[]	ScheduleException Nombre de fois où ce service ne peut pas être planifié. Pour limiter le nombre de messages de schedule_exception, envisagez de joindre les exceptions adjacentes.
deposit	Deposit Acompte facultatif pour cette disponibilité. Remplace l'acompte éventuellement défini au niveau du service.
no_show_fee	NoShowFee Frais de non-présentation facultatifs pour cette disponibilité. Remplace les frais de non-présentation éventuellement définis au niveau du service.
prepayment	Prepayment Facultatif. Informations facultatives sur le prépaiement pour cette disponibilité.
require_credit_card	RequireCreditCard Indique si une carte de crédit est requise pour réserver ce créneau de disponibilité. Si la valeur n'est pas définie, elle est héritée le cas échéant du niveau service. (facultatif)
ticket_type_id[]	string Indique la liste des types de billets acceptés pour ce créneau de disponibilité. Si ce paramètre n'est pas défini, tous les types de demandes du service parent sont disponibles pour ce créneau. Notez que les valeurs de ce champ doivent être définies dans le service parent. Exemples : Service avec quatre types de billets : TicketType {ticket_type_id: "adulte_1" short_description: "Adulte en semaine"} TicketType {ticket_type_id: "adulte_2" short_description: "Adulte le week-end"} TicketType {ticket_type_id: "jeune_1" short_description: "Jeune en semaine"} TicketType {ticket_type_id: "jeune_2" short_description: "Jeune le week-end"} Pour représenter l'inventaire en semaine : availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Pour représenter l'inventaire pendant les fêtes : availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}. Service avec trois types de billets : TicketType {ticket_type_id: "adulte" short_description: "Adulte"} TicketType {ticket_type_id: "jeune" short_description: "Jeune"} TicketType {ticket_type_id: "retraité" short_description: "Retraité"} Pour indiquer que les trois types de billets sont disponibles pour ce créneau horaire, utilisez soit availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...}, soit 'availability {...}' (ne définissez pas la valeur ticket_type_id pour ce créneau). (facultatif)
duration_requirement	DurationRequirement Exigence d'afficher 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é dans le secteur d'activité "Activités". (facultatif)
scheduling_rule_overrides	SchedulingRuleOverrides Règles de planification des créneaux de disponibilité. Si des champs sont renseignés, ils remplacent toutes les règles de planification correspondantes dans SchedulingRules au niveau du service.
confirmation_mode	ConfirmationMode Mode de confirmation utilisé lors de la réservation de cette disponibilité. Les tentatives de création de réservations pour des disponibilités avec un mode de confirmation CONFIRMATION_MODE_SYNCHRONOUS doivent être immédiatement confirmées ou refusées. Les tentatives de création de réservations pour des disponibilités dont le mode de confirmation est CONFIRMATION_MODE_ASYNCHRONOUS doivent être refusées immédiatement ou créées avec l'état PENDING.
linkout_required_reason	LinkoutRequiredReason Facultatif. Motif pour lequel un lien externe est requis pour cet emplacement. Si elle est définie, la ressource Merchant pour cet emplacement doit disposer d'un LinkoutTemplate valide. (facultatif)

ConfirmationMode

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 exigences auxquelles l'utilisateur doit se conformer pour confirmer ou afficher la durée/l'heure de fin des créneaux 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 affichée pour l'utilisateur.
MUST_SHOW_DURATION	L'heure de fin doit être indiquée à l'utilisateur avant qu'il puisse prendre rendez-vous.

LinkoutRequiredReason

Raison pour laquelle un emplacement propose une expérience de lien externe.

Enums
LINKOUT_REQUIRED_REASON_UNSPECIFIED	Valeur par défaut : ne pas utiliser, équivaut à "inconnu".
PAYMENT_REQUIRED	Le créneau nécessite un paiement sur la plate-forme partenaire pour être réservé.

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 :

1. 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.
2. 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.
3. Les récurrences ne doivent pas durer plus de 24 heures.

Champs
repeat_until	Timestamp Horodatage au format UTC maximal et inclusif jusqu'auquel ce créneau de disponibilité se répète.
repeat_every	Duration Définit l'intervalle entre des créneaux de disponibilité successifs. Exemple : Un créneau de disponibilité d'une durée de 20 min, une valeur repeat_every de 30 min, une valeur start_time de 9h00 et une valeur repeat_until de 11h00 généreront des créneaux à 9h-9h20, 9h30-9h50, 10h-10h20, 10h30-10h50 et à 11h-11h20. (obligatoire)

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

TimeRange Période à laquelle l'exception s'applique. Tous les créneaux décrits par la récurrence qui chevauchent cette période de fermeture sont considérés comme non disponibles. Exemple : Une récurrence spécifiant une durée de 20 min, une valeur repeat_every de 30 min, une valeur start_time de 9h00 et une valeur repeat_until de 11h00, puis une exception ScheduleException dont la valeur time_range est de 9h45-11h00 rendraient les créneaux 9h30-9h50, 10h-10h20 et 10h30-10h50 non disponibles. Notez que, comme la période est de type ouvert-fermé, le créneau commençant à 11h n'est pas affecté.

SchedulingRuleOverrides

Règles de planification au niveau du créneau de disponibilité

Champs
last_bookable_sec	int64 Dernier moment (en secondes) auquel ce créneau peut être réservé. Cet horodatage doit se situer avant la valeur start_sec associée au créneau (si les utilisateurs peuvent réserver après l'heure de début, utilisez SchedulingRules.min_booking_before_end_time au niveau du service). Si cette valeur est définie, elle remplace toute valeur spécifiée dans min_booking_buffer au niveau des SchedulingRules du service correspondant.
first_bookable_sec	int64 Premier moment (en secondes) auquel ce créneau peut être réservé. Cet horodatage doit être situé avant la valeur start_sec associée au créneau, ou avant la valeur last_bookable_sec si elle est spécifiée.
last_online_cancellable_sec	int64 Si cette valeur est définie, il s'agit de la dernière heure (en secondes depuis l'epoch Unix) à laquelle ce créneau de rendez-vous spécifique peut être annulé via Réserver avec Google. Ce champ remplace toutes les règles d'annulation au niveau du service. (facultatif)

BatchDeleteGenericRecordsRequest

Requête par lot permettant de supprimer les enregistrements du type de flux spécifié.

Champs
parent	string Nom de la ressource, au format partners/{partner_id}/feeds/{feed_name}.
records[]	GenericDeleteRecord Enregistrements à supprimer. Vous ne pouvez pas inclure plus de 1 000 enregistrements dans un même appel d'API.

BatchPushGenericRecordRequest

Requête par lot permettant d'insérer et/ou de mettre à jour les enregistrements du type de flux spécifié dans l'URL de la requête.

Champs
parent	string Nom de la ressource, au format partners/{partner_id}/feeds/{feed_name}.
records[]	GenericRecord Enregistrements à insérer et/ou à mettre à jour. Vous ne pouvez pas inclure plus de 1 000 enregistrements dans un même appel d'API.

BatchReplaceServiceAvailabilityRequest

Requête par lot pour remplacer plusieurs créneaux de disponibilité du Service.

Champs
parent	string Format de partners/{partner_id}.
extended_service_availability[]	ExtendedServiceAvailability 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[]	ExtendedServiceAvailability Messages bien mis à jour concernant la disponibilité étendue du service utilisée pour remplacer les créneaux de disponibilité existants.

Booking

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

Champs
name	string Nom de la ressource associée à la réservation : partners/{partner ID}/bookings/{booking ID}
merchant_id	string ID du marchand associé au créneau
service_id	string ID du service du marchand
start_time	Timestamp Heure de début du créneau horaire
duration	Duration Durée du créneau horaire
client_information	ClientInformation Informations personnelles du client prenant rendez-vous
status	BookingStatus État de la réservation
payment_information	PaymentInformation Informations sur les transactions de paiement liées à la réservation.
party_size	int64 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 Cause de l'échec de la réservation. (obligatoire)
rejected_card_type	CreditCardType (obligatoire seulement si la cause est PAYMENT_ERROR_CARD_TYPE_REJECTED)
description	string Ce champ facultatif permet au partenaire d'inclure des informations supplémentaires à des fins de débogage seulement. (facultatif)
payment_failure	PaymentFailureInformation 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	ThreeDS1Parameters Paramètres utilisés par un agrégateur RwG pour lancer un protocole d’authentification 3DS1 avec l’utilisateur. Le système ignore ces paramètres, à moins que BookingFailure.cause ne soit défini sur PAYMENT_REQUIRES_3DS1.

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	string URL à partir de laquelle il est possible d'importer un formulaire à présenter à l'utilisateur pour authentification.
pa_req	string Une requête PaymentAuthentication. À publier dans le formulaire ACSUrl, le cas échéant.
transaction_id	string Un identifiant utilisé par le fournisseur ACS. À publier dans le formulaire ACSUrl, le cas échéant.
md_merchant_data	string 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

Ce type ne comporte aucun champ.

Message vide à utiliser dans UnsupportedPartySizeOption. Si vous définissez ce paramètre, une option s'affichera pour les utilisateurs afin qu'ils puissent appeler l'établissement pour effectuer une réservation.

CancellationPolicy

Modalités d'annulation d'un service.

Champs
refund_condition[]	RefundCondition Aucune, une ou plusieurs conditions de remboursement applicables aux conditions d'annulation.

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	Duration Période avant l'heure de début jusqu'à laquelle le client peut recevoir un remboursement pour une partie du coût du service spécifié dans refund_percent. Si la valeur est définie sur 0 (valeur par défaut), le service peut être annulé à tout moment.
refund_percent	uint32 Pourcentage remboursable, à condition que la réservation du service soit annulée au moins min_duration_before_start_time avant l'heure de début du service, dans la plage de [0, 100]. Si la valeur est définie sur 0 (valeur par défaut), le service n'est pas remboursable. Si la valeur est définie sur 100 (valeur par défaut), le service est remboursable dans son intégralité.

ClientInformation

Informations personnelles sur la personne effectuant la réservation

Champs
given_name	string Prénom du client
family_name	string Nom de famille du client
address	PostalAddress Adresse du client
telephone	string Numéro de téléphone du client
email	string Adresse e-mail du client

CreateAdsAccountLinkRequest

Message de requête pour AdsAccountLinkingService.CreateAdsAccountLink.

Champs
parent	string Obligatoire. Ressource parente dans laquelle ce lien de compte Ads sera créé. Il s'agit du même ID que celui du compte du Centre des partenaires. Format : partners/{partner}
ads_account_link_id	string Obligatoire. ID à utiliser pour l'association de compte Ads. Il s'agit du même numéro client que celui de Google Ads. Pour en savoir plus, consultez https://support.google.com/google-ads/answer/1704344. Format : xxx-xxx-xxxx.
ads_account_link	AdsAccountLink Obligatoire. AdsAccountLink à créer.

CreateMerchantRequest

Demande de création d'un Merchant.

Champs
parent	string Nom de la ressource parent du partenaire propriétaire de ce marchand, au format partners/{partner_id}.
merchant_id	string Référence marchand à utiliser pour ce marchand.
merchant	Merchant Marchand à créer.

CreateServiceRequest

Demande de création d'un Service.

Champs
parent	string Nom de la ressource parent du marchand propriétaire de ce service, au format partners/{partner_id}/merchants/{merchant_id}.
service_id	string ID à utiliser pour ce service.
service	Service Service à créer.

CreditCardRestrictions

Restrictions concernant les types de cartes de crédit que ce marchand accepte.

Champs
credit_card_type[]	CreditCardType 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.

DeleteAdsAccountLinkRequest

Message de requête pour AdsAccountLinkingService.DeleteAdsAccountLink.

Champs
name	string Obligatoire. Nom de AdsAccountLink à supprimer. Format : partners/{partner}/adsAccountLinks/{ads_account_link}

DeleteMerchantRequest

Demande de suppression d'un Merchant.

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

DeleteServiceRequest

Demande de suppression d'un Service.

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

Acompte

Acompte susceptible d'être facturé à l'utilisateur ou dont le montant peut être retenu sur sa carte de crédit.

Champs
deposit	Price Montant du dépôt.
min_advance_cancellation_sec	int64 Délai de préavis minimal pour toute annulation liée à l'acompte.
deposit_type	PriceType Définit la manière dont l'acompte est déterminé à partir d'une disponibilité.

DirectMerchantPayment

Informations sur la façon dont l'utilisateur peut payer directement le marchand au lieu de prépayer le service via RwG.

Champs
payment_methods[]	Text Nous recommandons aux utilisateurs de payer uniquement avec les modes de paiement mentionnés ci-dessous.

DurationRange

Wrapper pour une plage de durée pouvant être limitée ou illimitée. Vous devez indiquer au moins l'une des valeurs min_duration et max_duration.

Champs
min_duration	Duration Durée minimale.
max_duration	Duration Durée maximale.

EconomicOperator

Informations sur l'opérateur économique pour l'agrégateur.

Champs

text

Text Obligatoire. Nom, adresse, numéro de téléphone et adresse e-mail de l'opérateur économique, défini comme le fabricant, le représentant autorisé, l'importateur, le distributeur, le prestataire de services de traitement des commandes ou toute autre personne physique ou morale soumise à des obligations liées à la fabrication, à la mise à disposition ou à la mise en service de produits. Représentation sous forme de chaîne à format libre de l'opérateur économique. Ces informations peuvent être mises en forme à l'aide de " " et "\n".

ExtendedServiceAvailability

Liste de disponibilités et à qui/quand les appliquer

Champs
merchant_id	string Ce champ est obligatoire. Il spécifie le marchand auquel appartiennent les messages de disponibilité ci-dessous.
service_id	string Ce champ est obligatoire. Il spécifie le service auquel appartiennent les messages de disponibilité ci-dessous.
start_time_restrict	Timestamp Nous traitons les entités de disponibilité éventuellement fournies comme un instantané complet de [start_time_restrict, end_time_restrict). Autrement dit, le système supprime toute disponibilité existante si la condition suivante est remplie : start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict Si un message "duration" (durée) est défini, la condition est encore plus exigeante : availability.duration == duration_restrict Si un message "resources_restrict" est défini, la condition est plus exigeante encore : availability.resources.staff_id == resources_restrict.staff_id && availability.resources.room_id == resources_restrict.room_id Ces champs sont généralement utilisés pour fournir une mise à jour complète de la disponibilité pour une période donnée. Si vous définissez la valeur start_time_restrict, mais pas la valeur end_time_restrict, le système en conclut que toutes les heures commencent à start_time_restrict.
end_time_restrict	Timestamp Si vous définissez la valeur end_time_restrict, mais pas la valeur start_time_restrict, le système en conclut que toutes les heures sont incluses jusqu'à la fin de end_time_restrict.
duration_restrict	Duration Lorsque la durée est définie, toute mise à jour de la disponibilité est limitée aux créneaux de cette durée.
resources_restrict	Resources Lorsque resources_restrict est défini, toute mise à jour est limitée à cet ensemble de ressources. Tous les champs des identifiants de ressources doivent correspondre exactement.
availability[]	Availability Nouvelle liste de disponibilités.

FeedStatistics

Statistiques obtenues lors du traitement d'un flux importé.

Champs
new_items	int64 Nouveaux éléments ajoutés par ce flux. En fonction du type de flux, les éléments peuvent correspondre à des marchands, des services ou des créneaux de disponibilité.
existing_items	int64 Éléments existants, mis à jour en fonction des informations les plus récentes transmises par le flux.
deleted_items	int64 Éléments 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	string Nom de la ressource du flux, au format partners/{partner_id}/feeds/merchants/{file_name} partners/{partner_id}/feeds/services/{file_name} partners/{partner_id}/feeds/availability/{file_name}
state	State État de traitement de ce flux.
error_details	string Chaîne lisible fournissant plus de détails si nous n'avons pas pu traiter ce flux.
statistics	FeedStatistics 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[]	FeeDetails Détails des frais facturés à l'utilisateur en plus du montant total des articles. Répété pour différents types de frais, comme les frais de service, les frais de livraison, etc.
advance_order_details	AdvanceOrderDetails Informations sur la prise en charge des commandes avancées, également appelées "commander à l'avance", qui permettent aux utilisateurs de passer une commande pour une exécution ultérieure.
Champ d'union fulfillment_duration_options. Durée de traitement de la commande à partir de la confirmation de la commande. Pour les commandes en livraison, durée jusqu'à la livraison des plats. Pour les commandes à retirer, durée jusqu'à ce que la nourriture soit prête à être retirée. fulfillment_duration_options ne peut être qu'un des éléments suivants :
fulfillment_lead_time_duration	Duration Durée fixe. Par exemple, 30 min.
fulfillment_lead_time_duration_range	DurationRange Une plage de durée. Exemples : * 30 à 45 min * Plus de 30 min * Moins de 50 min

AdvanceOrderDetails

Pour l'assistance concernant les commandes à l'avance.

Champs
is_supported	bool Vrai si les commandes anticipées, également appelées "Commander à l'avance", sont acceptées. (obligatoire)

FeeDetails

Détails des frais.

Champs
type	FeeType Type de frais. (obligatoire)
fee_amount	FeeAmount Montant des frais en devise de l'unité, en pourcentage de la valeur du panier ou en combinant les deux. (obligatoire)

FeeAmount

Exemples de FeeAmount : * Frais fixes : 0 USD (aucun frais), 1,5 USD * Gamme de frais fixes : 1,0 USD (minimum), 3,0 USD (maximum), 5,0-6,0 USD * Pourcentage de la taille du panier : 15,5 %, 10-20 %, 10 % (minimum), 15 % (maximum) * Combinaison d'une gamme et d'un pourcentage : 25,5 % et 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	QuantitativeValue Frais en pourcentage de la valeur du panier. Accepte une plage (bornée et non bornée) ou un pourcentage fixe. La valeur doit être comprise entre 0 et 100. Exemples : * 5,5 % fixe * 5,5 % minimum * 5,5 % maximum * 4,5 % à 5,5 %
Champ d'union amount_options. Options permettant de spécifier un montant monétaire. amount_options ne peut être qu'un des éléments suivants :
amount	Money Montant fixe. Par exemple, 3,5 USD.
amount_range	MoneyRange Plage de montants. Exemples : * De 3,5 USD à 5,5 USD * Au moins 3,5 USD * Au plus 5,5 USD
amount_unknown	bool 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 pour un lien d'action de commande en ligne.

Champs
fulfillment_type	FulfillmentType Obligatoire. Type de traitement.
available_day[]	AvailableDay Obligatoire. Liste des jours où cette méthode de traitement est disponible (de préférence au moins deux).
fee_details	FeeDetails Obligatoire. Détails des frais pour la méthode de traitement.
minimum_order	Price Obligatoire. Montant minimal de la commande pour la méthode de traitement associée au lien d'action.

AvailableDay

Disponibilité au niveau du jour.

Champs
fulfillment_date	Date Obligatoire. Date de disponibilité d'une méthode de traitement. Il est supposé être dans le fuseau horaire du marchand.
last_ordering_time	Timestamp Obligatoire. Horodatage UNIX. Dernière date à laquelle un utilisateur peut commander et recevoir des articles : fulfillment_date. En d'autres termes, après last_ordering_time, fulfillment_date ne sera plus affichée comme disponible. Par exemple, si la valeur fulfillment_date est 2020-08-10 : - une valeur last_ordering_time de 2020-08-10 18:00 signifie que, pour recevoir sa commande le 10 août 2020, un client doit la passer avant 18h ce même jour. - Une valeur last_ordering_time de 2020-08-08 20:00 signifie que, pour recevoir sa commande le 10 août 2020, un 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	NoFee Aucun frais pour la méthode de fulfillment.
base_fee	MinimumFee Frais de base associés à la méthode de traitement.
fixed_fee	FixedFee Frais fixes associés à la méthode d'exécution.

FixedFee

Frais fixes requis pour la méthode de traitement associée au lien d'action.

Champs
amount	Price 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 minimum requis pour la méthode de traitement associée au lien d'action.

Champs
base_fee_amount	Price Obligatoire. Montant des frais de base pour la méthode de fulfillment.

NoFee

Ce type ne comporte aucun champ.

Aucun frais n'est requis pour le mode de traitement associé au lien d'action.

GenericDeleteRecord

Enregistrement à supprimer du type de flux mentionné dans la requête d'URL.

Champs
delete_time	Timestamp Obligatoire. Cet code temporel permet de déterminer l'ordre dans lequel une suppression sera appliquée à l'inventaire.
Champ d'union record_type. Encapsuler différents types de flux (ndjson, basé sur des fichiers .proto, etc.) Le partenaire peut fournir un enregistrement complet, comme dans un flux ou l'API BatchPush. Les partenaires peuvent également choisir d'inclure uniquement les champs essentiels d'un enregistrement nécessaires pour l'identifier de manière unique. record_type ne peut être qu'un des éléments suivants :
data_record	bytes Pour les flux non basés sur des fichiers .proto.
proto_record	Any Pour les flux basés sur des protos.

GenericRecord

Enregistrement du type de flux mentionné dans la demande d'URL.

Champs
generation_timestamp	Timestamp Obligatoire. Ce code temporel permet de s'assurer que les mises à jour de l'inventaire sont dans le bon ordre.
Champ d'union record_type. Encapsuler différents types de flux (ndjson, basé sur des fichiers .proto, etc.) record_type ne peut être qu'un des éléments suivants :
data_record	bytes Pour les flux non basés sur des fichiers .proto.
proto_record	Any Pour les flux basés sur des protos.

GeoCoordinates

Coordonnées géographiques d'un lieu, y compris la latitude, la longitude et l'adresse.

Champs
latitude	double Latitude en degrés. (facultatif)
longitude	double 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	PostalAddress Adresse postale du lieu (élément préféré).
unstructured_address	string Une adresse non structurée peut également être fournie en remplacement. Par exemple, "1600 amphitheatre parkway mountain view, ca 94043, états-unis".

GetAdsAccountLinkRequest

Message de requête pour AdsAccountLinkingService.GetAdsAccountLink.

Champs
name	string Obligatoire. Nom de l'association de compte Ads à récupérer. Format : partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

Demande d'obtention d'un MerchantStatus

Champs
name	string Obligatoire. Nom de 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	string Nom de la ressource du flux, au format partners/{partner_id}/feeds/merchants/{file_name} partners/{partner_id}/feeds/services/{file_name} partners/{partner_id}/feeds/availability/{file_name}

HomeServiceData

Informations supplémentaires à fournir pour le secteur des services à domicile.

Champs
category_type	string Catégorie de niveau supérieur à laquelle appartient ce service à domicile. Par exemple, plombier, électricien, etc.
job_type	string Type de job dans la catégorie à laquelle appartient le service à domicile donné. Par exemple, "déboucher_canalisation" et "installer_robinet" sont des types de missions de 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

Demande d'invalidation d'une ressource.

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

LineItem

Un élément unique dans une commande : la réservation d'un seul service dans un seul créneau horaire.

Champs
service_id	string ID du service du marchand.
start_sec	int64 Heure de début du créneau horaire en secondes de l'heure UTC depuis l'epoch Unix.
duration_sec	int64 Durée du créneau horaire en secondes.
tickets[]	OrderedTickets Nombre de billets commandés par type de billet.
price	Price Prix total (hors taxes) associé à cette ligne.
status	BookingStatus État de l'élément de campagne.

OrderedTickets

Nombre de billets commandés par type de billet.

Champs
ticket_id	string ID d'un type de billet.
count	int32 Nombre de billets commandés pour ce type.

LinkoutTemplate

Modèle spécifiant comment Google doit générer des URL vers le site d'un partenaire.

Champs
uri_template	string Le modèle d'URI doit respecter la norme RFC 6570, voir https://datatracker.ietf.org/doc/html/rfc6570. Compatible avec les modèles de niveau 1 et tous les modèles composites de niveau 4. Par exemple, http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

ListMerchantStatusesRequest

Requête permettant d'obtenir la liste des MerchantStatus

Champs
parent	string Obligatoire. Parent qui possède cette collection d'états de marchand. Format : partners/{partner_id}/merchants
page_size	int32 Obligatoire. Le nombre maximum d'éléments à renvoyer. Notez que le serveur peut réduire la taille de la page.
page_token	string Facultatif. Valeur nextPageToken renvoyée par une réponse ListMerchantStatusResponse précédente, le cas échéant.
booking_inventory_status_restrict	BookingInventoryStatus Facultatif. Restriction facultative permettant de filtrer les résultats en fonction de l'état de l'inventaire de réservation.
waitlist_inventory_status_restrict	WaitlistInventoryStatus Facultatif. Restriction facultative permettant de filtrer les résultats en fonction de l'état de l'inventaire de la liste d'attente.
geo_match_restrict	GeoMatchingStatus Facultatif. Restriction facultative permettant de filtrer les résultats en fonction de l'é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 pas d'inventaire de réservations pour les 30 prochains jours.
HAS_VALID_FUTURE_INVENTORY	Le marchand dispose d'un inventaire de réservations pour les 30 prochains jours.

GeoMatchingStatus

État de la correspondance géographique du marchand.

Enums
GEO_MATCHING_STATUS_UNSPECIFIED	Non spécifié.
GEO_UNMATCHED	Le marchand n'est pas associé à une zone géographique.
GEO_MATCHED	Le marchand est mis en correspondance géographique.

WaitlistInventoryStatus

État de l'inventaire de la liste d'attente de bout en bout.

Enums
WAITLIST_INVENTORY_STATUS_UNSPECIFIED	Non spécifié.
NO_VALID_WAITLIST_SERVICE	Le marchand ne propose pas de service de liste d'attente.
HAS_VALID_WAITLIST_SERVICE	Le marchand propose un service avec liste d'attente.

ListMerchantStatusesResponse

Réponse à la liste MerchantStatus.

Champs
merchant_statuses[]	MerchantStatus Liste des états des marchands qui répondent aux conditions de filtre.
next_page_token	string Jeton permettant de récupérer la page de résultats suivante. Si aucune valeur n'est définie, cela signifie que la liste ne contient plus de résultats.

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	string Nom de la ressource du flux, au format partners/{partner_id}/feeds/merchants partners/{partner_id}/feeds/services partners/{partner_id}/feeds/availability
page_size	int32 Le nombre maximum d'éléments à renvoyer.
page_token	string Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.
state_restrict	State Limite facultative appliquée au filtrage des résultats en fonction de l'état du flux.
time_range_restrict	TimeRange Limite facultative appliquée au filtrage des résultats en fonction des seuils supérieur et inférieur. 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[]	FeedStatus Liste des états des flux importés en ordre chronologique inversé. Le nombre maximal d'éléments renvoyés est basé sur le champ page_size de la requête.
next_page_token	string Jeton permettant de récupérer la page de résultats suivante. Si aucune valeur n'est définie, cela signifie que la liste ne contient plus de résultats.

LocalizedString

Instance d'une chaîne dans un paramètre régional.

Champs
locale	string Code de langue IETF BCP 47, tel que "en", "mas", "zh-Hant", "de-CH-1901". Voir http://www.w3.org/International/article/language-tags/.
value	string Message rédigé utilisant les paramètres régionaux ci-dessus (au format UTF-8).

Location

Données géographiques concernant un lieu.

Champs
place_id	string ID du lieu dans la base de données Google Adresses et sur Google Maps. Pour en savoir plus sur les identifiants de lieu, consultez https://developers.google.com/places/web-service/place-id. Si cet ID est fourni, Google met le lieu en correspondance avec cette adresse.
name	string Le nom, le numéro de téléphone, l'URL et la zone géographique du lieu, utilisés pour mettre en correspondance le lieu avec des adresses déjà présentes sur Google Maps. Ce champ est facultatif, mais peut être obligatoire dans certains contextes. Par exemple, un Service.location sans nom ne sera pas associé à une entité commerciale, même s'ils sont situés à la même adresse. (facultatif)
telephone	string Numéro de téléphone public du lieu, y compris l'indicatif du pays et de la région (par exemple, [phone]). (facultatif)
url	string URL du site Web public du lieu. (facultatif)
geo	GeoCoordinates Données géographiques concernant le lieu, y compris la latitude, la longitude et l'adresse. (facultatif)
location_type	LocationType Le type de lieu doit être fourni si ce lieu est fourni pour un service.
location_id	string Référence unique associé au lieu au sein du service. Cet identifiant peut être utilisé pour faire référence à ce lieu dans d'autres champs du service. Par exemple, dans le formulaire d'enregistrement personnalisé, un ensemble d'identifiants de lieux 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	string Nom de la ressource marchand, au format partners/{partner_id}/merchants/{merchant_id}.
merchant_name	string Les champs "merchant_name", "telephone", "url" et "geo" permettent de faire correspondre l'inventaire du partenaire avec les marchands déjà présents sur Google Maps. Ces informations ne sont pas affichées. Nom du marchand.
telephone	string Numéro de téléphone public du marchand, y compris l'indicatif du pays et de la région (par exemple, [phone]).
url	string URL du site Web public du marchand.
geo	GeoCoordinates Coordonnées géographiques du marchand, y compris la latitude, la longitude et l'adresse.
category	string Catégorie à laquelle l'entreprise appartient sur la plate-forme de l'agrégateur.
num_bookings_30d (deprecated)	int64 Cet élément a été abandonné. Ce champ a été abandonné.
tax_rate_basis_points (deprecated)	uint32 Cet élément a été abandonné. 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 (deprecated)	TaxRate Cet élément est obsolète. 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. Obsolète, car les paiements de bout en bout ne sont plus acceptés.
payment_restrictions (deprecated)	PaymentRestrictions Cet élément est obsolète. 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. Obsolète, car les paiements de bout en bout ne sont plus acceptés.
payment_option[] (deprecated)	PaymentOption Cet élément est obsolète. Options de paiement disponibles pour ce marchand. Les services de ce marchand pourront limiter individuellement les options de paiement autorisées. Obsolète, car les paiements de bout en bout ne sont plus acceptés.
payment_processor_config (deprecated)	PaymentProcessorConfig Cet élément est obsolète. Configuration d'une société de traitement des paiements tokenisée, si le marchand accepte cette option.
tokenization_config (deprecated)	TokenizationConfig Cet élément est obsolète. Configuration d'une société de traitement des paiements tokenisée, si le marchand accepte cette option. Obsolète, car les paiements de bout en bout ne sont plus acceptés.
terms	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	string Chaîne opaque qui identifie la marque à présenter aux utilisateurs lors de l'affichage de l'attribution du partenaire. Ce champ permet à un partenaire de fournir des marchands pour toutes les marques qu'il gère au sein d'un même flux. Une marque comprend des propriétés à présenter aux utilisateurs, du type nom, logo, conditions d'utilisation et règles de confidentialité. Si le partenaire n'a qu'une seule marque à présenter aux utilisateurs, ce champ n'a pas besoin d'être défini et peut être ignoré. Si le partenaire... n'a qu'une seule marque à présenter aux utilisateurs… --> Ignorez ce champ. a plusieurs marques qui ont été configurées… If this field is set --> Associated consumer-facing brand attribution is used If this field is unset or the empty string --> Default consumer-facing brand attribution is used Attention : La plupart des partenaires n'ont pas besoin de définir ce champ. Si un partenaire souhaite utiliser ce champ, il doit d'abord nous contacter pour configurer des marques distinctes, y compris la marque par défaut.
matching_hints	MerchantMatchingHints Conseils pour aider Google à mettre un marchand en correspondance avec une adresse sur Google Maps. Remarque : la plupart des partenaires n'ont pas besoin de définir ce champ, car Google met les marchands en correspondance avec les adresses sur Google Maps à l'aide des informations fournies ci-dessus. (facultatif)
service_attribute[]	ServiceAttribute Définitions des attributs de service utilisés pour décrire les services pour ce marchand. (facultatif)
action_link[]	ActionLink Facultatif. Une URL d'action, en même temps que la langue associée, la liste des restrictions locales applicables, le type et une plate-forme facultative sur laquelle cette action doit être effectuée.
reservation_linkout_template[]	LinkoutTemplate Facultatif. Modèle de lien externe qui spécifie comment Google doit générer l'URL du partenaire pour réserver une table sur sa plate-forme. Notez que, pour le moment, seule la première valeur sera utilisée si plusieurs sont fournies. Le modèle d'URI est compatible avec les champs qui seront renseignés en fonction des sélections de réservation de l'utilisateur. Tous les champs requis sont nécessaires pour créer une URL de réservation : * (obligatoire) party_size, int : taille du groupe pour lequel l'utilisateur demande une réservation. * (obligatoire) selected_date_time, date et heure ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601) : heure pour laquelle l'utilisateur demande une réservation. * (facultatif) merchant_id, chaîne : ID du marchand auprès duquel l'utilisateur demande une réservation. Cette information n'est pas nécessaire si le modèle inclut déjà un identifiant de marchand. * (facultatif) room_id, chaîne : ID de la salle pour laquelle l'utilisateur demande une réservation.
waitlist_advisement	Advisement Facultatif. Conseils généraux d'un marchand spécifique pour un utilisateur qui rejoint une liste d'attente via Réserver avec Google. La longueur des champs de texte individuels dans l'avis doit être limitée à 100 octets.
economic_operator	EconomicOperator Facultatif. Informations sur l'opérateur économique associées à ce marchand spécifique, nécessaires pour la conformité réglementaire. (facultatif)

MerchantMatchingHints

Conseils pour aider Google à mettre un marchand en correspondance avec une adresse sur Google Maps.

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

MerchantStatus

État d'un marchand sur la plate-forme Réserver avec Google.

Champs
name	string Nom de la ressource d'état du marchand, au format partners/{partner_id}/merchants/{merchant_id}/status
merchant_name	string Nom du marchand fourni par les partenaires.
input_geo_info	GeoCoordinates Les partenaires ont fourni les informations géographiques du marchand.
processing_status	ProcessingStatus État du traitement du marchand.
booking_status	BookingStatus État lié à l'intégration de réservation de bout en bout.
waitlist_status	WaitlistStatus État lié à l'intégration de la liste d'attente.
geo_match	PlaceInfo Lieu géographique correspondant à ce marchand. Vide si le marchand n'est pas associé à une zone géographique.
local_services_match	LocalServicesMatchInfo Services de proximité proposés par ce marchand. Vide s'il ne s'agit pas d'un marchand de services locaux ou s'il n'est associé à aucun fournisseur.
direct_urls[]	DirectUrl Liste d'URL permettant de présenter le contenu de l'inventaire actuel du marchand. Notez que cela ne signifie pas que l'inventaire est réellement diffusé et que l'URL peut être différente de celles visibles publiquement.

BookingStatus

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

Champs
has_valid_future_inventory	bool "True" si le marchand dispose d'un inventaire dans les 30 prochains jours. Ne garantit pas que le marchand est effectivement diffusé.

DirectUrl

URL qui présente le marchand.

Champs
type	UrlType Type de cette URL.
url	string URL pouvant présenter ce marchand.

UrlType

Type de l'URL de surface.

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 mise en relation avec des services locaux Google (uniquement définies pour les marchands de services locaux).

Champs
matched_providers[]	MatchedProvider Fournisseurs de services correspondants. Un marchand peut être associé à plusieurs fournisseurs de services.

MatchedProvider

Fournisseur Local Services.

Champs
customer_id	int64 Numéro client externe Google Local Services.
categories[]	string Catégories de services locaux (secteurs). Par exemple, "plombier" et "nettoyage_tapis".

PlaceInfo

Informations sur un lieu correspondant.

Champs
name	string Nom du lieu.
formatted_address	string Adresse formatée dans la langue locale.
place_id	string ID de lieu Google de cet établissement. Peut être utilisé pour créer une URL Google Maps ou obtenir plus d'informations sur le lieu. Pour obtenir des exemples d'utilisation, consultez https://developers.google.com/places/web-service/place-id.

ProcessingStatus

État du traitement du marchand.

Enums
PROCESSING_STATUS_UNSPECIFIED	État non spécifié.
IN_PROGRESS	Madden a bien reçu la demande, mais elle est toujours en cours de traitement. Les marchands dont l'état est "En attente de vérification" ne verront aucun autre état s'afficher.
COMPLETED	D'autres états du marchand ont été calculés.

WaitlistStatus

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

Champs
has_valid_waitlist_service	bool "True" si le marchand propose un service de liste d'attente. Ne garantit pas que le marchand est effectivement diffusé.

MoneyRange

Wrapper pour une plage de montants monétaires pouvant être limitée ou illimitée. Vous devez indiquer au moins l'une des valeurs min_amount et max_amount.

Champs
min_amount	Money Montant minimal.
max_amount	Money 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	Price Montant susceptible d'être facturé à l'utilisateur s'il ne se présente pas à sa réservation.
fee_type	PriceType Définit la manière dont les frais sont déterminés à partir d'une disponibilité.

Order

Une commande de rendez-vous auprès d'un marchand.

Champs
name	string Nom de ressource de la commande : partners/{partner ID}/orders/{order ID}
client_information	ClientInformation Informations personnelles du client effectuant la commande.
payment_information	PaymentInformation Informations sur les transactions de paiement liées à la commande.
merchant_id	string ID du marchand auquel appartiennent tous les services dans cette commande.
item[]	LineItem Éléments de campagne de cet ordre.

OrderOnlineMetadata

Métadonnées d'un lien d'action "Commander en ligne".

Champs
fulfillment_option[]	FulfillmentOption 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	PrepaymentStatus État du pré-paiement de la réservation. Si la valeur du prepayment_status est PREPAYMENT_PROVIDED ou PREPAYMENT_REFUNDED, alors l'identifiant payment_transaction_id contient l'identifiant de transaction unique associé.
payment_transaction_id	string 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	string Cet ID permet d'identifier cette option de paiement. Cet identifiant s'applique de manière globale du côté de l'agrégateur. Ainsi, si vous réutilisez une valeur pour plusieurs marchands, l'utilisateur pourra payer tous ces marchands avec l'option de paiement correspondante. Lorsque vous réutilisez un identifiant pour plusieurs marchands, la mise à jour de la valeur d'une option de paiement pour un marchand entraîne la mise à jour de toute autre option de paiement associée au même identifiant utilisée par un autre marchand. Par conséquent, afin d'éviter tout risque de comportement instable, il est recommandé que toutes les options de paiement partagent le même identifiant et qu'elles soient toujours mises à jour avec des valeurs identiques.
name	string Nom de l'option de paiement. Peut être présenté à l'utilisateur.
description	string Description de l'option de paiement. Peut être présenté à l'utilisateur.
price	Price Prix de l'option de paiement.
tax_rate	TaxRate Taux de taxe pour cette option de paiement. S'il est renseigné, ce champ remplace le champ tax_rate au niveau du marchand ou du service. Un message vide (autrement dit, tax_rate { }) réinitialise le taux de taxe appliqué à zéro.
payment_option_type	PaymentOptionType Type d'option de paiement. À usage unique pour les visites, à usages multiples pour les packs et à usage illimité pour les abonnements.
session_count	int64 Nombre de sessions pour lesquelles cette option de paiement peut être utilisée. Valable seulement pour les séances/packs multiples, où la valeur doit être supérieure à 1.
purchase_interval	TimeRange L'option de paiement peut être achetée au cours de cet intervalle.
valid_interval	TimeRange L'option de paiement peut être achetée au cours de cet intervalle (par exemple, tarif spécial pour janvier 2017). Si cette valeur est renseignée, elle remplace les valeurs valid_duration et activation_type.
valid_duration	Duration Durée de validité de l'option de paiement (par exemple, abonnement de 30 jours).
activation_type	ActivationType Définit la manière dont est déterminée la date de début de validité de cette option de paiement.
user_restriction	UserPurchaseRestriction Définit une limite concernant les utilisateurs pouvant acheter cette option de paiement. Peut être utilisé pour limiter une option de paiement promotionnelle à un sous-ensemble d'utilisateurs. Si aucune valeur n'est définie, tous les utilisateurs sont éligibles.

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	Processor Définit la société partenaire de traitement des paiements à laquelle cette configuration s'applique.
public_key	string Clé utilisée pour identifier ce marchand auprès de la société de traitement des paiements. Pour Stripe, consultez la page https://stripe.com/docs/dashboard#api-keys. Pour Braintree, consultez la page https://articles.braintreepayments.com/control-panel/important-gateway-credentials.
version	string Numéro de version de l'API envoyé à la société de traitement des paiements en même temps que toute demande 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	CreditCardRestrictions Restrictions concernant les cartes de crédit que ce marchand accepte. Nous supposons que toutes les cartes de crédit sont acceptées si ce champ n'est pas défini. Notez que la liste des cartes compatibles avec CreditCardType s'allongera au fil du temps, ce qui signifie que si vous laissez ce champ vide, vous devrez modifier votre configuration dans le futur.

PerOrderFee

Frais à payer une fois par commande, quel que soit le nombre de billets.

Champs
delivery_fee	Price Frais pouvant varier selon le mode de livraison.
processing_fee	Price Frais associés au traitement du mode de paiement de l'utilisateur.

PerTicketFee

Frais à payer pour chaque billet acheté par l'utilisateur.

Champs
service_charge	Price Frais supplémentaires facturés pour un service.
facility_fee	Price Frais de location du site.
taxes	Price Taxes appliquées en fonction du billet.

PostalAddress

Adresse d'un client ou d'une entreprise.

Champs
address_country	string Pays spécifié à l'aide de son code pays ISO 3166-1 Alpha-2, par exemple "FR" (obligatoire)
address_locality	string La localité, par exemple "Mountain View". (obligatoire)
address_region	string La région, par exemple "CA". Ce champ n'est obligatoire que dans les pays où la région est généralement incluse dans l'adresse. (facultatif)
postal_code	string Le code postal, par exemple "94043". (obligatoire)
street_address	string L'adresse postale, par exemple "1600 Amphitheatre Pkwy". (obligatoire)

Paiement d'avance

Paiement susceptible d'être facturé à l'utilisateur dans le cadre de sa réservation.

Champs
price_info	PriceInfo Conteneur pour les informations sur les prix.

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	int64 Prix en micro-unités de la devise. Les fractions de la plus petite unité monétaire sont arrondies au pair le plus proche (par exemple, 2,5 centimes arrondis à 2 centimes, 3,5 centimes arrondis à 4 centimes, 0,5 centime arrondis à 0 centime, 2,51 centimes arrondis à 3 centimes).
currency_code	string Devise associée au prix, telle qu'elle est définie dans la norme ISO 4217.
pricing_option_tag	string Chaîne facultative et opaque qui identifie l'option de tarification associée au prix étendu.

PriceInfo

Conteneur pour les informations sur les prix.

Champs
price_type	PriceType Définit la façon dont le prix ou la gamme de prix sont appliqués (par personne ou fixe)
Champ d'union price_options. Les options de prix permettent de spécifier un prix exact ou une fourchette de prix. price_options ne peut être qu'un des éléments suivants :
price	Price Prix d'un service ou un montant de frais.
price_range	PriceRange Limite supérieure et/ou inférieure d'un service ou de frais.

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

PriceRange

Wrapper pour une plage de montants monétaires traités comme illimités, sauf si les deux valeurs sont définies. Vous devez indiquer au moins l'une des valeurs min_amount et max_amount.

Champs
min_price	Price Montant minimal.
max_price	Price Montant maximal. Doit toujours être supérieur à min_price.

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

Wrapper pour une valeur numérique pouvant être une plage ou une valeur fixe. Exemples pour QuantitativeValue : * Valeur unique : value: 10.5 * Plage 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 qu'un des éléments suivants :
value	double Valeur singulière. Exemple : 5.6
value_range	RangeValue Plage de valeurs pouvant être ouverte ou limitée. Exemples : * Au moins 5,5 * Au plus 5,5 * 5,5 à 6,5

RangeValue

Plage de valeurs telle que min_value < max_value. Vous devez indiquer au moins l'une des valeurs suivantes : min_value ou max_value.

Champs
min_value	double Valeur minimale.
max_value	double Valeur maximale.

Notes

Définit une note associée à une entité.

Champs
value	double Note moyenne (requise lorsque number_of_ratings > 0). La valeur doit être comprise dans la plage [1, 5] et peut être omise si (et seulement si) number_of_ratings est égal à zéro.
number_of_ratings	uint64 Nombre d'avis utilisés dans le calcul de 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	string URL de cette source multimédia. Google explore le contenu multimédia hébergé sur cette URL.
type	MediaType Type de source multimédia.
localized_caption	Text Légende de l'élément multimédia conforme aux normes i18n. Seul le format texte brut est accepté. Tout élément HTML est supprimé. (facultatif)
attribution	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 (deprecated)	string Cet élément a été abandonné. Obsolète. Utilisez plutôt localized_caption.

Attribution

Informations sur l'attribution associée à l'élément multimédia.

Champs
localized_text	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 (deprecated)	string Cet élément a été abandonné. 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	ServiceAvailability 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	string ID facultatif d'un membre du personnel fournissant le service. Ce champ identifie le membre du personnel pour tous les marchands, services et enregistrements de disponibilité. Il doit également être stable au fil du temps pour permettre une corrélation avec les réservations passées. Ce champ doit être présent si staff_name est défini.
staff_name	string Nom facultatif d'un membre du personnel fournissant le service. Ce champ sera présenté aux utilisateurs effectuant une réservation. Il doit être lisible et ne pas être un identifiant opaque. Ce champ doit être présent si staff_id est défini.
room_id	string ID facultatif de la salle dans laquelle est fourni le service. Ce champ identifie la salle pour tous les marchands, services et enregistrements de disponibilité. Il doit également être stable au fil du temps pour permettre une corrélation avec les réservations passées. Ce champ doit être présent si room_name est défini.
room_name	string Nom facultatif de la salle où est fourni le service. Ce champ sera présenté aux utilisateurs effectuant une réservation. Il doit être lisible et ne pas être un identifiant opaque. (facultatif, mais obligatoire si "room_id" est présent) Dans la section "Restauration", un nom de salle ne doit être utilisé que pour les zones de places assises telles que le bar ou la terrasse. Il ne doit pas être utilisé pour les menus à prix fixe, les activités spéciales ou toute autre valeur qui ne correspond pas à une salle (réservation ou dîner, par exemple). Nous vous recommandons vivement de ne pas associer de salle à la zone de places assises par défaut.
party_size	int32 Applicable uniquement au secteur de la restauration : nombre de personnes pouvant être incluses dans la réservation de ce créneau. Un restaurant peut être associé à plusieurs créneaux en même temps, chacun spécifiant un party_size différent, si par exemple 2, 3 ou 4 personnes peuvent être assis pour la même réservation.
room_description	Text Facultatif. Description localisée de la pièce. Si elle est définie, une valeur par défaut doit être fournie. Il est préférable de fournir également les langues courantes pour le pays du marchand. (facultatif)

SchedulingRules

Règles de planification d'un service.

Champs
min_advance_online_canceling	int64 Délai de préavis minimal en secondes nécessaire pour annuler un rendez-vous en ligne. (facultatif)
late_cancellation_fee (deprecated)	Price Cet élément a été abandonné. Frais facturés en cas d'annulation dans le délai de préavis minimal.
noshow_fee (deprecated)	Price Cet élément a été abandonné. Frais de non-présentation facturés lorsque l'utilisateur n'a pas annulé la réservation.
admission_policy	AdmissionPolicy 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	CancellationPolicy Modalités d'annulation associées aux règles de planification. (obligatoire pour le secteur des activités à découvrir)
Champ d'union min_booking_buffer. Durée (en secondes) entre le moment où la dernière réservation peut être effectuée et le début ou la fin du créneau de disponibilité. 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 sera sélectionnée et l'autre ignorée. Nous ne pouvons pas prédire de manière fiable quelle valeur sera choisie. Exemples : Une coupe de cheveux qui doit être réservée au moins une heure avant l'heure de début. 'scheduling_rules{ min_advance_booking: 3600 ...}` Un musée pour lequel le dernier billet peut être acheté 30 minutes avant la fermeture : 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}' Un billet de cinéma qui doit être acheté avant l'heure de début du film. 'scheduling_rules{ ...}' (laisser ce champ vide) (facultatif) La valeur de min_booking_buffer peut être l'une des suivantes :
min_advance_booking	int64 Durée (en secondes) entre le moment où la dernière réservation peut être effectuée et le début du créneau de disponibilité.
min_booking_buffer_before_end_time	int64 Durée (en secondes) entre le moment où la dernière réservation peut être effectuée et la fin du créneau de disponibilité. Si ce champ est défini, le champ "admission_policy" doit être défini sur TIME_FLEXIBLE pour indiquer que les utilisateurs peuvent utiliser les billets achetés après le début du créneau.

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	string Nom de la ressource associée au service, au format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.
service_name	string Nom du service (par exemple, "Coupe de cheveux pour hommes"). Obsolète. Utilisez plutôt localized_service_name.
localized_service_name	Text Nom du service (par exemple, "Coupe de cheveux pour hommes"). Possibilité de fournir plusieurs versions linguistiques.
description	string Description du service, telle qu'elle sera présentée à l'utilisateur. Obsolète. Utilisez plutôt localized_description.
localized_description	Text Description du service, telle qu'elle sera présentée à l'utilisateur. Ce champ accepte à la fois le format texte brut et le format HTML. Vous pouvez créer à cet endroit des mises en page personnalisées avec des en-têtes, des paragraphes, des listes et des balises d'expressions (autrement dit, avec des éléments de mise en page non présents dans les sections texte brut). Pour garantir la meilleure expérience utilisateur possible, tenez compte des instructions et des remarques suivantes : Balises de mise en forme HTML compatibles : Balises d'en-tête : <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Ces balises peuvent être utilisées pour l'affichage de titres et de sous-titres. Par exemple, <h1>Itinéraire</h1> permet d'afficher le texte intégré entre les balises comme le titre le plus important de la section. Notez que le système ignore tout autre élément HTML (balise, style ou attribut) inclus à l'intérieur des balises ci-dessus. Par exemple, le système traite de la même manière <h1 style=".."> et <h1>. Seul le texte brut est conservé. Balise de paragraphe : <p> Vous pouvez utiliser cette balise pour mettre en évidence une introduction détaillée ou tout autre contenu. À l'exception des balises <br>, <strong> et <em>, le système ignore tout autre élément (balise, style ou attribut) inclus à l'intérieur des balises de paragraphe. Pour plus de détails, lisez la section ci-dessous concernant les balises d'expressions. Balises de création de listes : <ul>, <ol>, <li> La balise <ul> peut être utilisée avec la balise <li> pour afficher des listes à puces, et la balise <ol> peut être utilisée avec la balise <li> pour afficher des listes numérotées. Ces formats sont utiles pour l'affichage de listes de contrôle, d'horaires ou toute autre liste adaptée à vos cas d'utilisation. Exemple : Pour afficher une liste des caractéristiques d'une croisière : <ol> <li>Magnifique vue sur l'océan et possibilité de jouer avec la faune sauvage.</li> <li>Services et organisation de voyage soigneusement conçus.</li> <li>Prix le plus bas garanti.</li> </ol> Notez que seuls les tags <li> enfants de <ul> ou <ol> seront convertis. Tous les autres éléments enfants seront supprimés. En outre, le système ignore tous les autres éléments (balises, attributs et styles) inclus à l'intérieur des balises. Il ne conserve que le texte brut. Balise de création d'une division : {div} Le système analyse toutes les balises compatibles insérées au sein de la balise {div} en tenant compte des règles indiquées ci-dessus. La seule balise {div} n'entraîne pas nécessairement un regroupement ou un retrait du texte. En outre, tous les attributs et styles internes sont ignorés. Balises d'expressions : <br>, <strong>, <em> Seules ces trois balises sont acceptées. Vous pouvez utiliser la balise <br> pour créer des sauts de ligne au sein de paragraphes, et la balise <strong> ou <em> pour mettre des contenus textuels en évidence. Le système ignorera toute autre balise d'expressions. Balises non compatibles : Les balises <html>, <header> et <body> ne sont pas autorisées. Toutes les autres balises qui n'ont pas été mentionnées ci-dessus (par exemple, <table>, <td>...) ne sont pas acceptées. Le système supprime les URL, les ancres et les liens, et ne les présente jamais aux utilisateurs finaux. Si vous souhaitez utiliser des photos pour enrichir l'expérience utilisateur, utilisez le champ "related_media" ci-dessous pour envoyer vos URL de photos. Remarques importantes : Essayez de ne pas utiliser d'autres balises que celles mentionnées ci-dessus, car le système supprimera tout contenu inséré au sein de balises non compatibles, ce qui entraînera une mauvaise expérience utilisateur. Essayez d'éviter les structures imbriquées (plus de trois niveaux de titres ou des listes imbriquées, par exemple). Pour une meilleure expérience utilisateur, structurez votre contenu de manière simple et claire. N'hésitez pas à contacter l'équipe Réserver avec Google si les mises en page actuellement acceptées par le système ne sont pas suffisantes pour vos cas d'utilisation. La taille maximale recommandée est de 32 000 caractères.
price	Price Prix du service.
price_interpretation	PriceInterpretation Décrit de quelle manière le prix est interprété et présenté à l'utilisateur. Peut être utilisé par tous les secteurs pour configurer l'affichage du prix du service, à l'exception des catégories de la restauration et À voir, à faire.
rules	SchedulingRules Règles applicables à la réservation/l'annulation d'un rendez-vous.
prepayment_type	PrepaymentType Indique si un prépaiement est requis, facultatif ou non accepté.
prepayment_terms	PrepaymentTerms Conditions relatives à la finalisation du prépaiement.
form[] (deprecated)	ServiceIntakeForm Cet élément est obsolète. Obsolète. Référez-vous désormais aux éléments intake_form et per_ticket_intake_form.
intake_form	ServiceIntakeForm Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. (facultatif)
per_ticket_intake_form	ServiceIntakeForm Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. Ce formulaire doit être rempli une fois pour chaque billet réservé par l'utilisateur. (facultatif)
tax_rate	TaxRate Taux de taxe appliqué au service. S'il est présent, ce champ remplace tout tax_rate défini au niveau du marchand. Un message vide (autrement dit, tax_rate { }) réinitialise le taux de taxe appliqué à zéro.
payment_option_id[]	string Liste d'ID faisant référence aux options de paiement pouvant être utilisées pour le paiement de ce service. Les options de paiement réelles sont définies au niveau du marchand et peuvent également s'appliquer à plusieurs marchands.
deposit	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	NoShowFee Définit les frais de non-présentation pouvant éventuellement être facturés à l'utilisateur. Remplace les frais de non-présentation éventuellement définis au niveau du service. Un message vide entraîne la suppression de tous frais de non-présentation définis au niveau du service. (facultatif)
require_credit_card	RequireCreditCard Indique si l'utilisateur doit fournir une carte de crédit pour réserver ce service. Ce champ peut être remplacé par celui défini au niveau de la disponibilité. (facultatif)
action_link[]	ActionLink Lien d'action associé à ce service. Si un lien d'action existe, son type (voir ci-dessous) doit être défini au niveau du service.
type	ServiceType Type prédéfini du service. (facultatif)
ticket_type[]	TicketType Types de billets pouvant être réservés/achetés pour ce service (si les billets sont acceptés). (facultatif)
related_media[]	RelatedMedia Photos associées à ce service. Google explore et stocke les contenus multimédias de manière à optimiser leur affichage auprès des utilisateurs finaux. (facultatif)
service_attribute_value_id[]	ServiceAttributeValueId Valeurs facultatives des attributs de service qui s'appliquent à ce service. Aucune ou plusieurs valeurs peuvent être définies pour chaque attribut de service défini au niveau du marchand correspondant. (facultatif)
waitlist_rules	WaitlistRules Règles d'inscription à la liste d'attente.
ticketing_vertical_specific_data	TicketingVerticalSpecificData Informations supplémentaires propres au secteur de la vente de billets pour des événements. (facultatif)
integration_type	IntegrationType Niveau d'intégration que nous acceptons pour ce service. (Facultatif) Ne concerne pas les partenaires complétant l'intégration de démarrage. En effet, l'intégration de bout en bout est toujours désactivée dans ce cas.
per_order_fee	PerOrderFee Frais facturés au niveau de la commande pour l'achat de ce service. (facultatif)
tours_and_activities_content	ToursAndActivitiesContent Champs de contenu spécifiques aux visites guidées et aux activités.
location[]	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	Rating Note globale attribuée à ce service par les utilisateurs, en tenant compte de l'ensemble des avis.
home_service_data	HomeServiceData Informations supplémentaires propres au secteur des services à domicile. (facultatif)
virtual_session	VirtualSession Facultatif. Informations sur la session virtuelle. Il est nécessaire pour activer les services virtuels.
direct_merchant_payment	DirectMerchantPayment Facultatif. Informations supplémentaires à ajouter si le service exige que l'utilisateur paie directement le marchand. REMARQUE IMPORTANTE : RwG ne sera pas impliqué dans cette transaction. Ce champ est obligatoire si virtual_session est défini et que le service n'est pas sans frais ou que prepayment_type n'est pas défini sur REQUIRED.
uri_template	UriTemplate Facultatif. Modèle facultatif spécifiant comment Google doit générer des URL vers un site externe.

PrepaymentTerms

Informations spécifiques sur la date à laquelle le prépaiement est effectué.

Champs
charge_timing	ChargeTiming Date à laquelle le débit aura lieu par rapport à la date de l'achat.
charge_time_before_start_time_sec	int64 Durée, en secondes, avant l'heure de début du service pour laquelle l'utilisateur est facturé. Ce champ ne doit être défini que lorsque ChargeTiming est défini sur CHARGE_LATER.

ChargeTiming

Énumération permettant de spécifier le moment où le débit aura lieu par rapport à la date d'achat.

Enums
CHARGE_TIMING_UNSPECIFIED	Non utilisé.
CHARGE_NOW	Le client sera facturé immédiatement.
CHARGE_LATER	Des frais seront facturés au client 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	Commande de repas, qui peut être en livraison ou à emporter, ou les deux.
SERVICE_TYPE_FOOD_DELIVERY	Livraison de repas.
SERVICE_TYPE_FOOD_TAKEOUT	Plats à 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 propose des rendez-vous en ligne pour un cours ou une séance 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 concerné. Il peut s'agir d'une livraison ou d'un 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	string Identifiant qui définit cet attribut de service de manière unique parmi tous les autres attributs de service associés au même marchand (par exemple, "account-type").
attribute_name	string Nom de cet attribut, tel qu'il sera présenté à l'utilisateur (par exemple "Type de compte").
value[]	Value Toutes les valeurs pouvant être utilisées pour cet attribut du service.

Value

Représente une valeur pouvant être utilisée pour un attribut particulier du service.

Champs
value_id	string Identifiant qui définit cette valeur du service de manière unique parmi toutes les autres valeurs associées au même marchand (par exemple, "personal").
value_name	string Nom de la valeur, tel qu'il sera présenté à l'utilisateur (par exemple, "Personnel").

ServiceAttributeValueId

Identifie une valeur particulière d'un attribut de service à appliquer à un service.

Champs
attribute_id	string ID d'un attribut, tel que défini dans Merchant.service_attribute (par exemple, "service-type").
value_id	string Identifiant de la valeur de cet attribut, par exemple "coupe de cheveux". Doit correspondre à un identifiant value_id dans la définition de l'attribut de service.

ServiceAvailability

Liste de disponibilités et à qui/quand les appliquer

Champs
name	string Nom de la ressource du service auquel appliquer ce paramètre. Au format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.
start_time_restrict	Timestamp Nous traitons les entités de disponibilité éventuellement fournies comme un instantané complet de [start_time_restrict, end_time_restrict). Autrement dit, le système supprime toute disponibilité existante si la condition suivante est remplie : start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict Si un message "duration" (durée) est défini, la condition est encore plus exigeante : availability.duration == duration_restrict Si un message "resources_restrict" est défini, la condition est plus exigeante encore : availability.resources.staff_id == resources_restrict.staff_id && availability.resources.room_id == resources_restrict.room_id Ces champs sont généralement utilisés pour fournir une mise à jour complète de la disponibilité pour une période donnée. Si vous définissez la valeur start_time_restrict, mais pas la valeur end_time_restrict, le système en conclut que toutes les heures commencent à start_time_restrict.
end_time_restrict	Timestamp Si vous définissez la valeur end_time_restrict, mais pas la valeur start_time_restrict, le système en conclut que toutes les heures sont incluses jusqu'à la fin de end_time_restrict.
duration_restrict	Duration Lorsque la durée est définie, toute mise à jour de la disponibilité est limitée aux créneaux de cette durée.
resources_restrict	Resources Lorsque resources_restrict est défini, toute mise à jour est limitée à cet ensemble de ressources. Tous les champs des identifiants de ressources doivent correspondre exactement.
availability[]	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[]	ServiceIntakeFormField Champs qui seront présentés à l'utilisateur.
first_time_customers (deprecated)	bool Cet élément a été abandonné. 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 (deprecated)	bool Cet élément a été abandonné. 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	string Chaîne provenant d'un partenaire agrégateur qui identifie de manière unique un champ de formulaire. Cet identifiant doit être identique à celui indiqué dans la réponse du champ de formulaire correspondant, et doit être unique à la fois pour les formulaires au niveau du service et pour les formulaires d'enregistrement au niveau du billet. (obligatoire)
type	FieldType Type de ce champ.
label	string Texte présenté à l'utilisateur pour ce champ. Obsolète. Utilisez plutôt localized_label.
localized_label	Text Texte présenté à l'utilisateur pour ce champ. Le champ peut être fourni dans différents paramètres régionaux. (obligatoire)
value[]	string Définissez ce champ uniquement 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[]	Text Définissez cette valeur uniquement si le type de champ est MULTIPLE_CHOICE, CHECKBOXES ou DROPDOWN. Utilisé pour énumérer les choix possibles.
is_required	bool Indique si l'utilisateur doit fournir une réponse pour ce champ.
allow_custom_answer	bool Indique si une valeur personnalisée est autorisée en plus des réponses prédéfinies. Cela ne s'applique que lorsque le type de champ est LOCATION_SEARCH. (facultatif)
additional_option[]	Text Options supplémentaires fournies en plus des valeurs indiquées. Ne s'applique que lorsque le type de champ est LOCATION_SEARCH. Par exemple, en plus de la liste des établissements fournie, une autre option disponible peut être "Je contacterai le fournisseur plus tard". (facultatif)
ticket_type_restrict[]	string Si cette question ne doit être affichée que lorsque l'utilisateur réserve certains types de billets, ce champ doit être défini comme l'ensemble des ID de types de billets applicables. Laissez le champ vide si la question est toujours applicable.
hint	Text Texte d'aide pour la saisie, qui s'affiche sous forme d'espace réservé. Cela ne s'applique que lorsque 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

int32 Taux de taxe en millionièmes de 1 %, ce qui donne une précision de six décimales. Par exemple, si le taux de taxe est de 7,253 %, ce champ doit être défini sur 7253000. Si ce champ n'est pas défini ou est défini sur 0, le prix total facturé à un utilisateur pour tout service fourni par ce marchand correspond au prix exact spécifié dans le champ Service.price. Le prix du service est considéré comme étant exonéré de taxes applicables ou comme incluant déjà ces taxes. Les taxes ne sont donc pas présentées à l'utilisateur sur une ligne distincte. Si ce champ est défini sur une valeur supérieure à 0, le prix total facturé à un utilisateur pour tout service fourni par ce marchand inclut le prix du service, ainsi que la taxe calculée à l'aide du taux fourni dans ce champ. Les fractions de la plus petite unité monétaire (par exemple, les fractions d'un centime) sont arrondies au pair le plus proche. Les taxes sont présentées à l'utilisateur sur une ligne distincte.

Terms

Ensemble de règles et consignes présentées à l'utilisateur souhaitant effectuer une réservation via Réserver avec Google.

Champs
url	string URL facultative vers les conditions d'utilisation.
text	string Texte à afficher auprès de l'utilisateur. Pour les nouvelles intégrations, utilisez localized_text ci-dessous.
localized_text	Text Texte localisé à afficher auprès de l'utilisateur.

Text

Une charge utile de texte qui peut être localisé. Certains champs de texte peuvent contenir du contenu balisé.

Champs
value	string Valeur textuelle dans des paramètres régionaux inconnus. Obligatoire si (et seulement si) localized_value est vide. Les paramètres régionaux définis pour cette valeur peuvent dépendre du partenaire ou du fournisseur de services. Le système ne s'attend pas nécessairement à une langue spécifique.
localized_value[]	LocalizedString 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	string L'identifiant du billet permet de différencier les types de billets utilisés pour le même service. Il doit être unique au niveau du service.
short_description	string Description courte de ce TicketType. Cette description peut être présentée à l'utilisateur (par exemple, "adulte", "enfant", "senior", "rang J", etc. Obligatoire. Chaque type de billet doit comporter une description destinée à l'utilisateur. Obsolète. Utilisez plutôt localized_short_description.
localized_short_description	Text Une brève description de ce TicketType conforme aux normes i18n. Cette description peut être présentée à l'utilisateur (par exemple, "adulte", "enfant", "senior", "rang J", etc. Obligatoire. Chaque type de billet doit comporter une description destinée à l'utilisateur. Des valeurs distinctes peuvent être fournies pour chaque paramètre régional.
price	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	PerTicketFee Frais supplémentaires appliqués à l'achat de ce billet. (facultatif)
price_display_type	PriceDisplayType Facultatif. Type d'affichage du prix prédéterminé d'un seul billet de ce type.
option_description	string 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	Text Description de toute option supplémentaire auquel ce type de billet est éventuellement associé. Des valeurs distinctes peuvent être fournies pour chaque paramètre régional. L'ajout d'autres options est utile lorsque le type de billet représente plusieurs dimensions. Exemple 1 : Dans le cas d'un billet d'entrée pour lequel différents types ont été définis ("adulte", "enfant" et la langue comme option supplémentaire), le système s'attend à la liste TicketType suivante : - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adulte" } localized_option_description { value: "anglais" } } - { ticketTypeId: "ticket_type_2" localized_short_description { value: "adulte" } localized_option_description { value: "espagnol" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "enfant" } localized_option_description { value: "anglais" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "enfant" } localized_option_description { value: "espagnol" } } Exemple 2 : Dans le cas d'un service de location de kayaks pour un nombre variable d'heures avec offre de location facultative d'un sac étanche, short_description pourrait être "3 heures" et option_description pourrait être soit "avec sac étanche" ou "sans sac étanche" : - { ticketTypeId: "ticket_type_1" localized_short_description { value: "2 heures" } localized_option_description { value: "anglais" } } - { ticketTypeId: "ticket_type_2" localized_short_description { value: "2 heures" } localized_option_description { value: "espagnol" } } - { ticketTypeId: "ticket_type_3" localized_short_description { value: "3 heures" } localized_option_description { value: "anglais" } } - { ticketTypeId: "ticket_type_4" localized_short_description { value: "3 heures" } localized_option_description { value: "espagnol" } } (Facultatif) Si ce champ est défini pour un des types de billets du service, le système s'attend à ce qu'il soit défini également pour tous les autres types de billets (envisagez d'utiliser une option_description par défaut). Par exemple, [{ticket_type_1, adulte, anglais}, {ticket_type_1, adulte, ''}] n'est pas une liste valide. Seules les deux balises de mise en forme HTML et sont acceptées. Ces balises sont utiles pour les options présentant un titre et une description détaillée. Par exemple : "Loges premium . Bénéficiez d'une loge privée, avec sièges rembourrés, télévision privée, et service de restauration et de boissons sur place. Vue pittoresque sur le terrain."
inventory_type	InventoryType Facultatif. Type d'inventaire prédéterminé d'un seul billet de ce type.

InventoryType

Type d'inventaire prédéterminé d'un seul billet de ce type.

Enums
INVENTORY_TYPE_UNSPECIFIED	Le type d'inventaire n'est pas spécifié.
INVENTORY_TYPE_PRIMARY	Inventaire principal.
INVENTORY_TYPE_VERIFIED_RESALE	Inventaire de revente validé.
INVENTORY_TYPE_RESALE	Inventaire destiné à la revente
INVENTORY_TYPE_AGGREGATOR	Inventaire de l'agrégateur. Un agrégateur (par exemple, www.bandsintown.com) signifie que le partenaire fournit des informations sur les événements et les billets. mais les billets ne sont pas vendus directement par le partenaire. Le vendeur de billets peut être un vendeur principal, un revendeur validé ou un revendeur. Nous ne faisons plus la différence entre les types d'inventaire des partenaires de premier niveau et ignorons le type d'inventaire des vendeurs de billets dans un agrégateur.

PriceDisplayType

Indique le format du prix affiché sur la page de destination.

Ce champ est ignoré pour l'inventaire sans lien sortant.

Ce champ permet aux surfaces Google d'afficher le même format de prix que celui utilisé par la page de destination du service. Des formats de prix cohérents améliorent le taux de conversion et réduisent la confusion.

Enums
PRICE_DISPLAY_TYPE_UNSPECIFIED	Le type d'affichage du prix n'est pas spécifié. Google déterminera le format à afficher.
PRICE_DISPLAY_TYPE_BASE	Le prix indiqué sur la page de destination est le prix de base.
PRICE_DISPLAY_TYPE_ALL_IN	Le prix affiché sur la page de destination inclut tous les frais et taxes.

TicketingVerticalSpecificData

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

Champs
event_category	EventCategory 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	string URL de l'événement sur le site Web du partenaire. (facultatif)
entity[]	Entity Liste d'entités associées à l'événement. (facultatif)
event_attendance_mode	AttendanceMode Obligatoire. Type de participation à l'événement.
event_virtual_location_url[]	string Facultatif. URL où l'événement peut être regardé.
event_organizer	Text Facultatif. Organisateur qui héberge l'événement.
event_organizer_url	string Facultatif. URL de l'organisateur de l'événement.
event_organizer_type	OrganizerType Facultatif. Type d'organisateur.
event_source_url[]	string Obligatoire. URL des pages où se trouvent les informations ou les descriptions de l'événement.
event_state	EventState Facultatif. État de l'événement.
brand_name	Text Facultatif. Nom de marque localisé.
event_creator	EventCreator Facultatif. Informations sur le créateur 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	string Identifiant unique de l'entité dans la base de données du partenaire. (facultatif)
name	string Nom de l'entité. (obligatoire)
url	string URL de la page Web qui décrit l'entité sans ambiguïté. Il s'agit de la page éventuellement associée à l'entité sur le site Web du partenaire. Pour d'autres URL publiques concernant l'entité, utilisez relevant_url dans public_identification_data. (facultatif)
entity_type	EntityType Type d'entité. (facultatif)
entity_role	EntityRole Rôle de l'entité pendant l'événement. (facultatif)
public_identification_data	PublicIdentificationData 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.

EventCreator

Informations sur le créateur de l'événement. Ne concerne que les plates-formes qui incluent des événements de contenu généré par les utilisateurs.

Champs
name	string Facultatif. Nom du créateur de l'événement. Aucune restriction de caractères.

EventState

État de l'événement.

Enums
EVENT_STATE_UNSPECIFIED	Non spécifié.
SCHEDULED	L'événement est programmé.
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 un organisateur qui est une personne.
ORGANIZATION	Pour un organisateur qui est une organisation.

PublicIdentificationData

Identifiants, pages Web ou toute autre source publique référençant une entité.

Champs
relevant_url[]	string URL publique d'une page Web dédiée uniquement au sujet. Il peut s'agir de sites Web officiels, de discogs, de plates-formes sur les réseaux sociaux, de pages Wikipédia ou Imdb (par exemple, https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan). (facultatif)
musicbrainz_id	string Identifiant musicbrainz de 36 caractères de l'artiste ou d'autres entités musicales, le cas échéant. Voir https://musicbrainz.org/doc/MusicBrainz_Identifier. (facultatif)

TimeRange

Une période ouvert-fermé, autrement dit [start_time, end_time].

Champs
start_time	Timestamp Seuil inférieur de la plage de dates.
end_time	Timestamp 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	map<string, string> Une configuration de tokenisation comporte généralement un paramètre tokenization_parameter dont la clé est "gateway" et dont la valeur est le nom de la société de traitement des paiements. Les autres paramètres dépendent du processeur. Pour en savoir plus, consultez la documentation Google Pay. Exemple avec Braintree : tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" } Exemple avec Stripe : tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" } Exemple avec Adyen : tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }
billing_information_format	BillingInformationFormat Indiquez dans le jeton de paiement les informations bancaires de l'utilisateur telles que saisies dans Google Pay avec son mode de paiement (voir ci-dessus). Si vous laissez ce champ vide, le système en déduit que la valeur est MIN.

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[]	Text Liste de temps forts présentée à l'utilisateur.
inclusions[]	Text Liste d'inclusions présentée à l'utilisateur.
exclusions[]	Text Liste d'exclusions présentée à l'utilisateur.
must_know[]	Text Liste de remarques importantes visible par l'utilisateur (à utiliser pour des détails tels que des restrictions d'âge ou d'autres conditions qui rendent ce service inapproprié).

UnsupportedPartySizeOption

Options pour les parties hors de portée.

Champs
Champ d'union kind. Options disponibles pour les parties hors zone. kind ne peut être qu'un des éléments suivants :
call_merchant	CallMerchant Les groupes dont la taille est hors limites peuvent appeler l'établissement. Un message prédéfini s'affiche pour l'utilisateur. Exemple de texte à afficher : "Pour les groupes de plus de {waitlist_rules.max_party_size}, veuillez appeler le restaurant au {phone}." CallMerchant doit être défini, mais sera vide.

UpdateAdsAccountLinkRequest

Message de requête pour AdsAccountLinkingService.UpdateAdsAccountLink.

Champs
ads_account_link	AdsAccountLink Obligatoire. L'association au compte Ads à modifier. Le champ name de AdsAccountLink permet d'identifier AdsAccountLink à mettre à jour. Format : partners/{partner}/adsAccountLinks/{ads_account_link}
update_mask	FieldMask Facultatif. Liste des champs à mettre à jour.

UpdateBookingRequest

Demande de mise à jour d'une réservation google.maps.booking.v1alpha.Booking

Champs
update_mask	FieldMask Masque de champ de tous les champs de la réservation à mettre à jour
booking	Booking Réservation à modifier
booking_failure	BookingFailure 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	Merchant Nouvelles données du marchand.
update_mask	FieldMask Champs spécifiques à mettre à jour pour le marchand.

UpdateOrderRequest

Demande de mise à jour d'une commande google.maps.booking.v1alpha.Order

Champs
update_mask	FieldMask Masque de champ de tous les champs de la commande à mettre à jour
order	Order La commande à modifier

UpdateServiceRequest

Demande de mise à jour d'un Service.

Champs
service	Service Les nouvelles données du service.
update_mask	FieldMask Champs spécifiques à mettre à jour pour le service.

UriTemplate

Modèle indiquant comment Google doit générer des URL vers des sites externes.

Champs

uri_template

string Facultatif. Le modèle d'URI doit respecter la norme RFC6570. Pour en savoir plus, consultez https://datatracker.ietf.org/doc/html/rfc6570. Compatible avec les modèles de niveau 2. Ces paramètres seront résolus en fonction des valeurs spécifiées dans leurs entités respectives. Paramètres disponibles pour le lien externe de réservation de restaurant : 1) (obligatoire) {availability_slot_start_seconds} :: renseigné à partir du champ start_sec du flux de disponibilités 2) (obligatoire) {resources_party_size} :: renseigné à partir du champ party_size du flux de disponibilités 3) (facultatif) {availability_slot_duration_seconds} :: renseigné à partir du champ duration_sec du flux de disponibilités 4) (facultatif) {availability_slot_availability_tag} :: renseigné à partir du champ availability_tag du flux de disponibilités Exemple d'utilisation : http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} Avec : * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&num_guests=2

UserPurchaseRestriction

Définit une limite concernant les utilisateurs pouvant acheter une option de paiement.

Champs
new_to_merchant	bool Option de paiement réservée aux utilisateurs n'ayant jamais effectué d'achat auprès du marchand en question.
new_to_payment_option	bool Option de paiement réservée aux utilisateurs n'ayant jamais acheté l'option de paiement en question auparavant.

VirtualSession

Informations sur la session virtuelle/en ligne. Par exemple, un cours de yoga en ligne, un cours de cuisine virtuel, etc.

Champs
session_instructions	Text Instructions sur la configuration de ce cours virtuel. Si le partenaire n'inclut pas l'URL de la vidéo dans la réservation, ce texte doit indiquer quand l'URL de la vidéo sera partagée avec l'utilisateur. par exemple, "L'URL Zoom vous sera envoyée par e-mail 30 minutes avant le début du cours." (recommandé)
session_requirements	Text Conditions requises pour la session virtuelle donnée. Par exemple, tapis de yoga, ustensiles de cuisine, etc. (recommandé)
virtual_platform_info	VirtualPlatformInfo Informations sur la plate-forme virtuelle utilisée lors de cette session. (Requis pour activer les services virtuels)
is_session_prerecorded	bool Obligatoire. Définissez cette valeur 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	Platform Plate-forme utilisée pour la session virtuelle.
other_platform_name	Text Nom de la plate-forme si elle est définie sur "AUTRE". (Obligatoire si la plate-forme est définie sur "AUTRE")

Plate-forme

Énumération indiquant la plate-forme virtuelle utilisée par le marchand.

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	Zoom Video Communications.
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	int32 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	int32 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	bool Si la valeur est "true", l'utilisateur peut envoyer une demande de texte supplémentaire à forme libre lorsqu'il rejoint la liste d'attente pour ce service.
above_max_party_size_options[]	UnsupportedPartySizeOption Définissez des options pour les groupes dont la taille est supérieure à la valeur max_party_size définie. Laissez ce champ vide si vous ne souhaitez pas proposer d'autres options pour rejoindre une liste d'attente aux groupes plus importants.