Package google.maps.booking.v1alpha

Index

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 champ d'application 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 champ d'application 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 champ d'application 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 la part 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 compatibles : Retrait

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/mapsbooking

InventoryStatus

Récupérer l'état de l'inventaire et 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)

Répertorie tous les MerchantStatus d'un partenaire qui remplissent les conditions de filtre.

Champs d'application des autorisations

Requiert le champ d'application 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é. n'effectue qu'une validation de base (comme une requête mal formée), après laquelle une réponse appropriée est immédiatement renvoyée au partenaire. Google valide la logique métier sur la requête de manière asynchrone. Cet appel par lot ne garantit pas l'atomicité.

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é. n'effectue qu'une validation de base (comme une requête mal formée), après laquelle une réponse appropriée est immédiatement renvoyée au partenaire. Google valide la logique métier sur la requête de manière asynchrone. Cet appel par lot ne garantit pas l'atomicité.

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 champ d'application 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 champ d'application 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 champ d'application 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 champ d'application 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 champ d'application 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 champ d'application 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 champ d'application 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 champ d'application OAuth suivant :

  • https://www.googleapis.com/auth/mapsbooking

ActionLinkType

Type d'action prédéterminé associé à un lien d'action.

Énumérations

ActionPlatform

Plate-forme sur laquelle l'action est effectuée. "Application Web" est la valeur utilisée par défaut. Il est recommandé de définir au moins un ActionLink avec la valeur ACTION_PLATFORM_WEB_APPLICATION. Les liens définissant Android ou iOS comme plate-forme ne sont utilisés que sur le système respectif.

Énumérations
ACTION_PLATFORM_UNSPECIFIED La plate-forme n'est pas spécifiée.
ACTION_PLATFORM_WEB_APPLICATION La plate-forme associée à l'action est le Web en général.
ACTION_PLATFORM_MOBILE_WEB La plate-forme associée à l'action est le Web mobile.
ACTION_PLATFORM_ANDROID La plate-forme associée à l'action est Android OS.
ACTION_PLATFORM_IOS La plate-forme associée à l'action est iOS.

Conseils

Conseils qui s'affichent lorsque l'utilisateur effectue une réservation via Réserver avec Google.

Champs
text

Text

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

Disponibilité

Un créneau de disponibilité du service du marchand, indiquant l'heure et le nombre de créneaux.

Champs
start_time

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

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.

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

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

scheduling_rule_overrides

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.

Mode de confirmation

Modes de confirmation utilisés lors de la réservation de créneaux de disponibilité.

Énumérations
CONFIRMATION_MODE_UNSPECIFIED Le mode de confirmation n'a pas été spécifié. La confirmation synchrone sera utilisée.
CONFIRMATION_MODE_SYNCHRONOUS Les réservations pour ce créneau de disponibilité seront confirmées de manière synchrone.
CONFIRMATION_MODE_ASYNCHRONOUS Les réservations pour ce créneau de disponibilité seront confirmées de manière asynchrone.

DurationRequirement

Cette énumération indique les conditions requises pour que l'utilisateur puisse prendre connaissance ou afficher la durée/l'heure de fin des emplacements demandés.

Enums
DURATION_REQUIREMENT_UNSPECIFIED Le traitement de l'heure de fin n'est pas spécifié. Il s'agit de la valeur par défaut.
DO_NOT_SHOW_DURATION L'heure de fin n'est pas visible par l'utilisateur.
MUST_SHOW_DURATION L'heure de fin doit être indiquée à l'utilisateur avant qu'un rendez-vous puisse être pris.

Récurrence

Les messages de récurrence sont facultatifs, mais ils permettent de représenter de façon plus compacte les créneaux de disponibilité qui se réitèrent. Ces messages correspondent généralement au planning d'une journée ouvrée. Les messages ScheduleException sont ensuite utilisés pour représenter des périodes réservées/non disponibles pendant la journée ouvrée.

Conditions requises :

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

BatchDeleteGenericRecordsRequest

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

Champs
parent

string

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

records[]

GenericDeleteRecord

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

BatchPushGenericRecordRequest

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

Champs
parent

string

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

records[]

GenericRecord

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

BatchReplaceServiceAvailabilityRequest

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

Champs
parent

string

Format 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 qui ont été utilisés pour remplacer les créneaux de disponibilité existants.

Booking

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

Champs
name

string

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

merchant_id

string

ID du marchand pour l'emplacement

service_id

string

ID du service 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 uniquement 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 charger 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

Message vide à utiliser dans UnsupportedPartySizeOption. Ce paramètre permettra aux utilisateurs d'appeler l'établissement pour effectuer une réservation.

CancellationPolicy

Modalités d'annulation d'un service.

Champs
refund_condition[]

RefundCondition

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

RefundCondition

Définit une seule condition de remboursement. Pour décrire les "étapes de remboursement", vous pouvez définir différentes périodes d'annulation avant l'heure de début du service et y associer différentes conditions de remboursement regroupées ensemble.

Champs
min_duration_before_start_time

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

CreateMerchantRequest

Demande de création d'un Merchant.

Champs
parent

string

Nom de la ressource parente 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 parente 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.

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 virement

min_advance_cancellation_sec

int64

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

deposit_type

PriceType

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

DirectMerchantPayment

Informations sur la manière dont l'utilisateur peut payer directement au marchand au lieu de prépayer le service via RwG.

Champs
payment_methods[]

Text

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

DurationRange

Wrapper pour une plage de durée qui peut être limitée ou illimitée. Veuillez indiquer au moins une durée (min_duration et max_duration)

Champs
min_duration

Duration

Durée minimale.

max_duration

Duration

Durée maximale.

ExtendedServiceAvailability

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

Champs
merchant_id

string

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

service_id

string

Ce champ obligatoire permet d'indiquer à quel service 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 selon les besoins à partir des informations plus récentes du flux.

deleted_items

int64

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

FeedStatus

État d'un flux importé par la plate-forme de l'agrégateur.

Champs
name

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 de l'article. Répéter pour différents types de frais, tels que les frais de service, les frais de livraison, etc.

advance_order_details

AdvanceOrderDetails

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

Champ d'union fulfillment_duration_options. Délai de traitement de la commande indiqué dans la confirmation de commande. Pour les commandes à livrer, délai avant la livraison du plat Pour les commandes à retirer, il s'agit du temps nécessaire pour que les plats soient prêts à être retirés. fulfillment_duration_options ne peut être qu'un des éléments suivants :
fulfillment_lead_time_duration

Duration

Durée fixe. Par exemple: 30 minutes.

fulfillment_lead_time_duration_range

DurationRange

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

AdvanceOrderDetails

Pour une assistance concernant les commandes à l'avance.

Champs
is_supported

bool

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

FeeDetails

Détails des frais.

Champs
type

FeeType

Type de frais. (obligatoire)

fee_amount

FeeAmount

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

FeeAmount

FeeAmount exemples: * Frais fixes: 0 USD (aucuns frais), 1,5 USD * Plage de frais fixes: 1 USD (minimum), 3 USD (maximum), 5-6 USD * Pourcentage de taille du panier: 15,5 %, 10 %-20 %, 10 % (minimum), 15 % (maximum) * Combinée de la plage et du pourcentage: 25 2,5 USD (minimum), 25,5 % et 4,5 USD (maximum), 10 % et 1,5-2,5 USD, 10,5%-20 % et 2,5-3,5 USD

Champs
cart_percentage

QuantitativeValue

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

Champ d'union amount_options. Options permettant de spécifier une valeur monétaire. amount_options ne peut être qu'un des éléments suivants :
amount

Money

Montant fixe. Exemple : 3,5 USD.

amount_range

MoneyRange

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

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 d'un lien d'action de commande en ligne.

Champs
fulfillment_type

FulfillmentType

Obligatoire. Type de traitement.

available_day[]

AvailableDay

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

fee_details

FeeDetails

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

minimum_order

Price

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

AvailableDay

Disponibilité au niveau de la journée.

Champs
fulfillment_date

Date

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

last_ordering_time

Timestamp

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

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

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

Aucuns frais pour la méthode de traitement.

base_fee

MinimumFee

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

fixed_fee

FixedFee

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

FixedFee

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

Champs
amount

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 minimaux 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 traitement.

NoFee

Aucuns frais ne sont requis pour la méthode de traitement associée au lien d'action.

GenericDeleteRecord

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

Champs
delete_time

Timestamp

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

Champ d'union record_type. Encapsuler différents types de flux (ndjson, proto-basé, etc.) Le partenaire peut fournir un enregistrement complet de la même manière qu'un enregistrement est fourni dans un flux ou avec l'API BatchPush. Les partenaires ont également la possibilité d'inclure uniquement les champs essentiels d'un enregistrement requis pour l'identifier de façon unique. record_type ne peut être qu'un des éléments suivants :
data_record

bytes

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

proto_record

Any

Pour les flux basés sur le protocole proto.

GenericRecord

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

Champs
generation_timestamp

Timestamp

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

Champ d'union record_type. Encapsuler différents types de flux (ndjson, proto-basé, etc.) record_type ne peut être qu'un des éléments suivants :
data_record

bytes

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

proto_record

Any

Pour les flux basés sur le protocole proto.

GeoCoordinates

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

Champs
latitude

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 (à privilégier).

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

GetMerchantStatusRequest

La requête pour obtenir un MerchantStatus

Champs
name

string

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

GetStatusRequest

Demande de récupération de l'état (Status) d'un flux spécifique importé par la plate-forme de l'agrégateur.

Champs
name

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

Des informations supplémentaires sont requises pour le secteur des services à domicile.

Champs
category_type

string

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

job_type

string

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

IntegrationType

Niveau d'intégration accepté.

Énumérations
INTEGRATION_TYPE_UNSPECIFIED La valeur par défaut est END_TO_END.
INTEGRATION_TYPE_END_TO_END Intégration complète permettant un processus de réservation de bout en bout via Google.
INTEGRATION_TYPE_INVENTORY_ONLY Le serveur de réservation n'a pas besoin d'être compatible avec ce service. Seuls les marchands, les services et (éventuellement) les données de disponibilité doivent être envoyés.

InvalidateResourceRequest

Requête d'invalidation d'une ressource.

Champs
resource_id

string

Nom de la ressource à invalider.

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

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) de 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.

ListMerchantStatusesRequest

Requête d'obtention d'une liste de MerchantStatus

Champs
parent

string

Obligatoire. Parent, qui possède cette collection d'états du 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. La valeur nextPageToken renvoyée par une 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 la réservation de l'inventaire.

waitlist_inventory_status_restrict

WaitlistInventoryStatus

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

geo_match_restrict

GeoMatchingStatus

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

BookingInventoryStatus

État de l'inventaire de réservation de bout en bout.

Enums
BOOKING_INVENTORY_STATUS_UNSPECIFIED Non spécifié.
NO_VALID_FUTURE_INVENTORY Le marchand ne dispose d'aucun inventaire de réservation pour les 30 prochains jours.
HAS_VALID_FUTURE_INVENTORY Le marchand a réservé un inventaire pour les 30 prochains jours.

GeoMatchingStatus

État de la mise en correspondance géographique du marchand.

Enums
GEO_MATCHING_STATUS_UNSPECIFIED Non spécifié.
GEO_UNMATCHED Aucune correspondance géographique n'est établie pour le marchand.
GEO_MATCHED Le marchand fait l'objet d'une correspondance géographique.

WaitlistInventoryStatus

État de l'inventaire de bout en bout sur liste d'attente

Enums
WAITLIST_INVENTORY_STATUS_UNSPECIFIED Non spécifié.
NO_VALID_WAITLIST_SERVICE Le marchand ne dispose pas d'un service prenant en charge la liste d'attente.
HAS_VALID_WAITLIST_SERVICE Le marchand dispose d'un service prenant en charge une liste d'attente.

ListMerchantStatusesResponse

Réponse à la liste MerchantStatus.

Champs
merchant_statuses[]

MerchantStatus

Liste des états des marchands qui remplissent les 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

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

time_range_restrict

TimeRange

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

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 utilisant les paramètres régionaux ci-dessus (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 ID de lieu, consultez la page https://developers.google.com/places/web-service/place-id. Si cet ID est fourni, Google met le lieu en correspondance avec cette adresse.

name

string

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

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

telephone

string

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

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

Type d'emplacement, doit être fourni si celui-ci 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. Exemple : Dans le formulaire d'enregistrement personnalisé, un ensemble d'identifiants de lieu peut être utilisé pour spécifier les options de lieu de prise en charge. S'il est défini, cet identifiant doit être unique au sein du même service. (facultatif)

LocationType

Type de lieu.

Énumérations
LOCATION_TYPE_UNSPECIFIED Type de lieu non spécifié.
VISITED_LOCATION Lieux visités dans le cadre de ce service.
START_LOCATION Le point de départ de ce service, également utilisé comme MEETING_LOCATION.
END_LOCATION Point d'arrivée de ce service.

Merchant

Informations sur un marchand figurant sur la plate-forme de l'agrégateur.

Champs
name

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 pays et l'indicatif régional, par exemple +14567891234.

url

string

URL du site Web public du marchand.

geo

GeoCoordinates

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

category

string

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

num_bookings_30d
(deprecated)

int64

Ce champ a été abandonné.

tax_rate_basis_points
(deprecated)

uint32

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

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

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

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

tax_rate

TaxRate

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

payment_restrictions

PaymentRestrictions

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

payment_option[]

PaymentOption

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

payment_processor_config
(deprecated)

PaymentProcessorConfig

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

tokenization_config

TokenizationConfig

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

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)

waitlist_advisement

Advisement

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

MerchantMatchingHints

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

Champs
place_id

string

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

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 indiqué par les partenaires.

input_geo_info

GeoCoordinates

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

processing_status

ProcessingStatus

État du traitement par le marchand.

booking_status

BookingStatus

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

waitlist_status

WaitlistStatus

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

geo_match

PlaceInfo

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

local_services_match

LocalServicesMatchInfo

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

direct_urls[]

DirectUrl

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

BookingStatus

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

Champs
has_valid_future_inventory

bool

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

DirectUrl

URL qui affiche le marchand.

Champs
type

UrlType

Type de cette URL.

url

string

URL susceptible d'afficher ce marchand.

UrlType

Type de l'URL affichée.

Enums
URL_TYPE_UNSPECIFIED Non spécifié.
BOOKING URL de réservation de bout en bout.
WAITLIST URL de la liste d'attente de bout en bout.
LOCAL_SERVICES URL Google Local Services.

LocalServicesMatchInfo

Informations sur la correspondance Google Local Services (définies uniquement pour les marchands Local Services).

Champs
matched_providers[]

MatchedProvider

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

MatchedProvider

Local Services - Fournisseur de services

Champs
customer_id

int64

Numéro client externe Google Local Services.

categories[]

string

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

PlaceInfo

Informations sur une adresse correspondante.

Champs
name

string

Nom du lieu.

formatted_address

string

Adresse au format approprié dans la langue locale.

place_id

string

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

ProcessingStatus

État du traitement par le marchand.

Enums
PROCESSING_STATUS_UNSPECIFIED État non spécifié.
IN_PROGRESS Madden a bien reçu le marchand, mais il est toujours en cours de traitement. Aucun autre état ne sera renseigné pour les marchands associés à cet état.
COMPLETED D'autres états du marchand ont été calculés.

WaitlistStatus

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

Champs
has_valid_waitlist_service

bool

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

MoneyRange

Enveloppe d'une plage de montants monétaires pouvant être limitées ou illimitées. Vous devez renseigner au moins l'un des champs "min_amount" et "max_amount".

Champs
min_amount

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 de la 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

Lignes de cette commande.

OrderOnlineMetadata

Métadonnées d'un lien d'action de commande 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 dans 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 la date de début de validité est déterminée pour 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é de traitement des paiements partenaire à 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 avec les demandes de paiement.

Processor

Définit une société partenaire de traitement des paiements particulière.

Énumérations
PROCESSOR_UNSPECIFIED Non utilisé
PROCESSOR_STRIPE Une configuration pour les paiements effectués avec Stripe.
PROCESSOR_BRAINTREE Une configuration pour les paiements effectués avec Braintree.

PaymentRestrictions

Restrictions concernant les modes de paiement que ce marchand accepte.

Champs
credit_card_restrictions

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 lié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 à payer sur le lieu/l'établissement

taxes

Price

Taxes par 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 "US" (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)

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 du prix 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.

PriceInterpretation

Décrit comment un prix doit être interprété et présenté à l'utilisateur.

Énumérations
PRICE_INTERPRETATION_UNSPECIFIED Interprétation du prix non spécifiée. Valeur par défaut : EXACT_AMOUNT.
EXACT_AMOUNT

Le prix doit être interprété comme une valeur spécifique.

Exemples : 20 € pour une séance de yoga ; 15 € pour une coupe de cheveux enfant

STARTS_AT

Le prix d'un service est variable, mais un prix minimum est spécifié et doit être présenté à l'utilisateur. Le prix peut alors augmenter en fonction des choix effectués par l'utilisateur.

Notez que pour tout service pour lequel vous utilisez PriceInterpretation, vous devez définir PrepaymentType sur NOT_SUPPORTED.

Exemples : 30 € pour un service de toilettage de chiens, mais le prix peut augmenter en fonction des choix effectués par le client.

NOT_DISPLAYED

Le prix d'un service est variable. Aucune information sur le prix n'est présentée à l'avance à l'utilisateur.

Notez que pour tout service pour lequel vous utilisez PriceInterpretation, vous devez définir PrepaymentType sur NOT_SUPPORTED, et la valeur de Price doit être vide.

Exemple : Une consultation pour un service à domicile

PriceType

Définit la manière dont un prix total est déterminé à partir d'une disponibilité.

Énumérations
FIXED_RATE_DEFAULT

Le prix correspond à un montant fixe. Si le champ n'est pas défini, cette valeur est utilisée par défaut.

Exemples : Un acompte de 50 € pour réserver une table ; 20 € de frais de non présentation pour un cours de yoga

PER_PERSON

Le prix indiqué est par personne, et le prix total est calculé en fonction du nombre de personnes spécifié dans Ressources (calcul price_micros * party_size). En cas de prix PER_PERSON, le nombre de personnes doit être également défini dans les ressources associées à la disponibilité. Si le nombre de personnes n'est pas défini, la valeur 1 est utilisée par défaut.

Exemple : 10 € par personne pour des billets d'entrée à un musée

QuantitativeValue

Enveloppe d'une valeur numérique pouvant être une plage ou une valeur fixe. Exemples QuantitativeValue: * Valeur singulière: value: 10.5 * Plage délimitée: value_range {min_value: 5.5, max_value 10.5} * Limite inférieure: value_range {min_value: 5.5} * Limite supérieure: value_range {max_value: 10.5}

Champs
Champ d'union value_options. (Obligatoire) value_options ne peut être que l'un des éléments suivants:
value

double

Valeur unique. Exemple: 5,6

value_range

RangeValue

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

RangeValue

Plage de valeurs telle que min_value < max_value Nécessite au moins l'un des éléments suivants : min_value et max_value.

Champs
min_value

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 de notes utilisées pour calculer la valeur (obligatoire).

RelatedMedia

Photos associées à ce service. Google explore ces éléments multimédias pour s'assurer qu'elles s'affichent correctement auprès des utilisateurs finaux. (facultatif)

Champs
url

string

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

type

MediaType

Type de cette 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

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

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 défini Il est fortement recommandé de ne pas associer de pièce au coin salon 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.

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

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

noshow_fee
(deprecated)

Price

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 est sélectionnée, tandis que l'autre est ignorée. Nous ne pouvons pas prédire de manière fiable quelle valeur est choisie.

Exemples :

  • 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 du 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 les animaux sauvages.</li>
<li>Organisation et services de voyage soigneusement conçus.</li>
<li>Prix le plus bas garanti.</li>
</ol>
Notez que seuls les <li> enfants de moins de <ul> ou <ol> sont convertis. Tous les autres éléments enfants seront supprimés. En outre, le système ignore tous les autres éléments (balises, attributs et styles) inclus à l'intérieur des balises. Il ne conserve que le texte brut.

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

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

Balises non compatibles :

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

Remarques importantes :

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

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 de réservation ou d'annulation de rendez-vous.

prepayment_type

PrepaymentType

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

prepayment_terms

PrepaymentTerms

Conditions relatives à la finalisation du prépaiement.

form[]
(deprecated)

ServiceIntakeForm

Obsolète. Veuillez utiliser 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)

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 pour s'inscrire sur 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

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

home_service_data

HomeServiceData

Informations supplémentaires spécifiques 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 nécessite que l'utilisateur paie directement au marchand. REMARQUE IMPORTANTE: RwG n'est pas impliqué dans cette transaction. Il est obligatoire si virtual_session est défini et que le service n'est pas sans frais ou si prepayment_type n'est PAS défini sur REQUIRED.

PrepaymentTerms

Des informations spécifiques sur la date à laquelle le prépaiement sera effectué.

Champs
charge_timing

ChargeTiming

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

charge_time_before_start_time_sec

int64

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

ChargeTiming

Énumération spécifiant le moment où le débit sera effectué par rapport à la date d'achat.

Enums
CHARGE_TIMING_UNSPECIFIED Non utilisé.
CHARGE_NOW Les frais sont immédiatement facturés au Client.
CHARGE_LATER Le client sera facturé ultérieurement.

PrepaymentType

Énumération pour indiquer le type de pré-paiement.

Énumérations
PREPAYMENT_TYPE_UNSPECIFIED Par défaut, nous partons du principe que le pré-paiement est NOT_SUPPORTED.
REQUIRED L'utilisateur doit payer ce service au moment de la réservation.
OPTIONAL L'utilisateur peut choisir de prépayer ce service au moment de la réservation ou ultérieurement, mais le paiement n'est pas requis pour effectuer la réservation.
NOT_SUPPORTED Le pré-paiement n'est pas accepté pour ce service.

ServiceType

Types de services prédéfinis.

Énumérations
SERVICE_TYPE_UNSPECIFIED Non utilisé.
SERVICE_TYPE_DINING_RESERVATION Réservation dans le secteur de la restauration.
SERVICE_TYPE_FOOD_ORDERING La commande de repas peut être la livraison de repas, la vente à emporter ou les deux.
SERVICE_TYPE_FOOD_DELIVERY Livraison de repas.
SERVICE_TYPE_FOOD_TAKEOUT Repas à emporter.
SERVICE_TYPE_EVENT_TICKET Billet pour un événement.
SERVICE_TYPE_TRIP_TOUR Visite guidée.
SERVICE_TYPE_APPOINTMENT Service qui propose des rendez-vous ou des cours. Recommandé pour les secteurs (1) de la santé et de la remise en forme, (2) des spas et soins beauté, et (3) des services conseil et évaluation financiers. Vous trouverez les types de service compatibles sur la page https://developers.google.com/maps-booking/guides/end-to-end-integration/overview.
SERVICE_TYPE_ONLINE_APPOINTMENT Service qui permet de prendre rendez-vous en ligne pour un cours ou une session entièrement virtuels. Doit être défini si vous activez les réservations de services virtuels.
SERVICE_TYPE_SHOPPING Service permettant aux utilisateurs d'effectuer des achats auprès du marchand donné. Il peut s'agir d'un service de livraison ou de retrait.

ServiceAttribute

Les attributs de service correspondent à des catégories définies par le partenaire. Elles décrivent les services d'un marchand. Par exemple, une banque peut définir un attribut de service "Account Type" avec les valeurs possibles "Personnel" et "Entreprise", tandis qu'un salon de coiffure peut définir un attribut de service "Service Type" avec les valeurs possibles "Coupe de cheveux", "Couleur" et "Style".

Champs
attribute_id

string

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

attribute_name

string

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

value[]

Value

Toutes les valeurs possibles pour cet attribut de service.

Value

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

Champs
value_id

string

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

value_name

string

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

ServiceAttributeValueId

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

Champs
attribute_id

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

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

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éfinir si et seulement si le type de champ est LOCATION_SEARCH. Veuillez utiliser l'identifiant "location_id" dans le champ "location" pour spécifier la valeur du créneau.

choice_text[]

Text

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

is_required

bool

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

allow_custom_answer

bool

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

additional_option[]

Text

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

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'indice pour la saisie, qui s'affiche sous la forme d'un espace réservé de texte. Cela ne s'applique que si le type de champ est SHORT_ANSWER ou PARAGRAPH. (facultatif)

FieldType

Énumération pour indiquer le type de champ.

Énumérations
FIELD_TYPE_UNSPECIFIED Le système ignore les champs dont le type n'est pas spécifié ou est inconnu.
SHORT_ANSWER Champ de saisie d'une ligne pour le texte.
PARAGRAPH Champ de saisie de plusieurs lignes pour le texte.
MULTIPLE_CHOICE Un ensemble de cases d'option nécessitant un choix parmi différentes options.
CHECKBOXES Un ou plusieurs éléments énumérés associés à des cases à cocher.
DROPDOWN Une sélection dans une liste déroulante.
BOOLEAN Un bouton Oui/Non.

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

Éventuellement, l'URL des 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é à présenter à l'utilisateur.

Text

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

Champs
value

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 proposés pour un même service. Il ne doit être unique qu'au sein d'un service.

short_description

string

Description courte de ce TicketType.

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

localized_short_description

Text

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

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

price

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)

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

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 de 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 sur lesquelles figurent les informations ou les descriptions de l'événement

event_state

EventState

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

AttendanceMode

Type de participation à l'événement.

Enums
ATTENDANCE_MODE_UNSPECIFIED Non spécifié.
ONLINE Pour les événements virtuels.
PHYSICAL Pour les événements physiques.
PHYSICAL_ONLINE_MIXED Pour les événements à la fois physiques et virtuels.

Entité

Représente une entité associée à l'événement.

Champs
id

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.

EventState

État de l'événement.

Enums
EVENT_STATE_UNSPECIFIED Non spécifié.
SCHEDULED L'événement est planifié.
RESCHEDULED L'événement est reprogrammé.
CANCELLED L'événement est annulé.
POSTPONED L'événement est reporté.

OrganizerType

Type d'organisateur.

Enums
ORGANIZER_TYPE_UNSPECIFIED Non spécifié.
PERSON Pour l'organisateur qui est une personne
ORGANIZATION Pour l'organisateur qui est une organisation.

PublicIdentificationData

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

Champs
relevant_url[]

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 des temps forts visible par l'utilisateur.

inclusions[]

Text

Liste d'inclusions visible par 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 limites d'âge ou d'autres conditions qui rendent ce service inapproprié.

UnsupportedPartySizeOption

Options pour les groupes hors de portée.

Champs
call_merchant

CallMerchant

Les personnes situées en dehors de la plage peuvent appeler l'entreprise. Un message prédéfini s'affiche. Exemple de texte à afficher : "Pour les groupes de plus de {waitlist_rules.max_party_size}, veuillez appeler le restaurant au {phone}." La valeur "CallMerchant" doit être définie, mais elle sera vide.

UpdateBookingRequest

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

Champs
update_mask

FieldMask

Masque de champ de tous les champs de la réservation à mettre à jour

booking

Booking

Réservation à mettre à jour

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

Données du nouveau 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 à mettre à jour

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.

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 même marchand.

new_to_payment_option

bool

Option de paiement qui ne peut être achetée que par les utilisateurs qui n'ont jamais acheté la même option de paiement auparavant.

VirtualSession

Informations sur la session virtuelle/en ligne. Exemple : Cours de yoga en ligne, cours de cuisine virtuels, etc.

Champs
session_instructions

Text

Instructions de configuration de ce cours virtuel. Si le partenaire n'indique pas l'URL de la vidéo lors de la réservation, ce texte doit indiquer à quel moment l'URL de la vidéo sera partagée avec l'utilisateur. Par exemple : "L'URL Zoom sera envoyée par courrier 30 minutes avant le cours." (recommandé)

session_requirements

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. (Obligatoire pour activer les services virtuels)

is_session_prerecorded

bool

Obligatoire. Définissez ce paramètre sur "true" si la session virtuelle n'est pas en direct et est préenregistrée.

VirtualPlatformInfo

Informations sur la plate-forme qui sera utilisée pour cette session virtuelle.

Champs
platform

Platform

Plate-forme utilisée pour la session virtuelle.

other_platform_name

Text

Nom de la plate-forme si elle est définie sur OTHER. (Obligatoire si la plate-forme est définie sur OTHER)

Plate-forme

Énumération indiquant la plate-forme virtuelle que le marchand utilisera.

Enums
PLATFORM_UNSPECIFIED Non utilisé.
FLEXIBLE Le marchand est flexible quant à la plate-forme vidéo qu'il utilise.
GOOGLE_HANGOUTS Produit Google Hangouts.
GOOGLE_MEET Produit Google Meet.
ZOOM Communications vidéo Zoom.
SKYPE Skype
YOUTUBE Diffusion en direct sur YouTube.
OTHER Doit être défini si la plate-forme vidéo utilisée est différente de celles mentionnées ici.

WaitlistRules

Règles applicables à l'inscription sur la liste d'attente

Champs
min_party_size

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 requête de texte supplémentaire à forme libre lorsqu'il s'inscrit sur la liste d'attente de ce service.

above_max_party_size_options[]

UnsupportedPartySizeOption

Définissez les options pour les groupes dont la taille dépasse le paramètre max_party_size défini. Laissez ce champ vide si des groupes plus importants ne doivent pas avoir d'autres options pour rejoindre une liste d'attente.