- Ressource : Service
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- RelatedMedia
- MediaType
- Attribution
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Entity
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- Emplacement
- LocationType
- Rating
- HomeServiceData
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- VirtualSession
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- VirtualPlatformInfo
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Plate-forme
- DirectMerchantPayment
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Méthodes
Ressource : Service
Informations concernant un service fourni par le marchand (par exemple, "coupe de cheveux").
Représentation JSON |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
Champs | |
---|---|
name |
Nom de la ressource du service, au format |
serviceName |
Nom du service (par exemple, "Coupe de cheveux pour hommes"). Obsolète. Utilisez désormais localizedServiceName. |
localizedServiceName |
Nom du service (par exemple, "Coupe de cheveux pour hommes"). Possibilité de fournir plusieurs versions linguistiques. |
description |
Description du service, telle qu'elle sera présentée à l'utilisateur. Obsolète. Utilisez désormais localizedDescription. |
localizedDescription |
Description du service, telle qu'elle sera présentée à l'utilisateur. Ce champ accepte à la fois le format texte brut et le format HTML. Vous pouvez créer à cet endroit des mises en page personnalisées avec des en-têtes, des paragraphes, des listes et des balises d'expressions (autrement dit, avec des éléments de mise en page non présents dans les sections texte brut). Pour garantir la meilleure expérience utilisateur possible, tenez compte des instructions et des remarques suivantes : Balises de mise en forme HTML compatibles : Balises d'en-tête : <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Balise de paragraphe : <p> Balises de création de listes : <ul>, <ol>, <li> Balise de création d'une division : {div} Balises d'expressions : <br>, <strong>, <em> Balises non compatibles :
Remarques importantes :
|
price |
Prix du service. |
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 |
Règles de réservation ou d'annulation de rendez-vous. |
prepaymentType |
Indique si un pré-paiement est obligatoire, facultatif ou non accepté. |
prepaymentTerms |
Conditions relatives à la finalisation du prépaiement. |
form[] |
Obsolète. Veuillez utiliser intakeForm et perTicketIntakeForm. |
intakeForm |
Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. (facultatif) |
perTicketIntakeForm |
Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. Ce formulaire doit être rempli une fois pour chaque billet réservé par l'utilisateur. (facultatif) |
taxRate |
Taux de taxe appliqué au service. S'il est défini, ce champ remplace toute valeur taxRate définie au niveau du marchand. Un message vide (autrement dit, taxRate { }) réinitialise le taux de taxe appliqué (taxe égale à zéro). |
paymentOptionId[] |
Liste d'ID faisant référence aux options de paiement pouvant être utilisées pour le paiement de ce service. Les options de paiement réelles sont définies au niveau du marchand et peuvent également s'appliquer à plusieurs marchands. |
deposit |
Définit la manière dont un acompte peut être facturé à l'utilisateur. Remplace l'acompte éventuellement défini au niveau du service. Un message vide entraîne la suppression de tout acompte défini au niveau du service. (facultatif) |
noShowFee |
Définit les frais de non-présentation pouvant éventuellement être facturés à l'utilisateur. Remplace les frais de non-présentation éventuellement définis au niveau du service. Un message vide entraîne la suppression de tous frais de non-présentation définis au niveau du service. (facultatif) |
requireCreditCard |
Indique si l'utilisateur doit fournir une carte de crédit pour réserver ce service. Ce champ peut être remplacé par celui défini au niveau de la disponibilité. (facultatif) |
actionLink[] |
Lien d'action associé à ce service. Si un lien d'action existe, son type (voir ci-dessous) doit être défini au niveau du service. |
type |
Type prédéfini du service. (facultatif) |
ticketType[] |
Types de billets pouvant être réservés/achetés pour ce service (si les billets sont acceptés). (facultatif) |
relatedMedia[] |
Photos associées à ce service. Google explore et stocke les contenus multimédias de manière à optimiser leur affichage auprès des utilisateurs finaux. (facultatif) |
serviceAttributeValueId[] |
Valeurs facultatives des attributs de service qui s'appliquent à ce service. Aucune ou plusieurs valeurs peuvent être définies pour chaque attribut de service défini au niveau du marchand correspondant. (facultatif) |
waitlistRules |
Règles pour s'inscrire sur la liste d'attente. |
ticketingVerticalSpecificData |
Informations supplémentaires propres au secteur de la vente de billets pour des événements. (facultatif) |
integrationType |
Niveau d'intégration que nous acceptons pour ce service. (Facultatif) Ne concerne pas les partenaires complétant l'intégration de démarrage. En effet, l'intégration de bout en bout est toujours désactivée dans ce cas. |
perOrderFee |
Frais facturés au niveau de la commande pour l'achat de ce service. (facultatif) |
toursAndActivitiesContent |
Champs de contenu spécifiques aux visites guidées et aux activités. |
location[] |
Lieux associés à ce service. IMPORTANT : Si plusieurs visites de lieux sont associées à ce service, ou si START_LOCATION est différent de VISITED_LOCATION, START_LOCATION doit alors être spécifié. Exemples : – Une visite guidée de trois sites est organisée à vélo. Dans ce cas, vous devez spécifier le lieu de départ. – Une visite guidée en bus commence par se donner rendez-vous dans le foyer d'un hôtel avant de se diriger directement vers le lieu visité. Dans ce cas, vous devez spécifier le lieu de rendez-vous. |
rating |
La note des visiteurs pour ce service en tant que métrique globale pour tous les avis. |
homeServiceData |
Informations supplémentaires spécifiques au secteur des services à domicile. (facultatif) |
virtualSession |
Facultatif. Informations sur la session virtuelle. Il est nécessaire pour activer les services virtuels. |
directMerchantPayment |
Facultatif. Informations supplémentaires à ajouter si le service nécessite que l'utilisateur paie directement au marchand. REMARQUE IMPORTANTE: RwG n'est pas impliqué dans cette transaction. Il est obligatoire si virtualSession est défini et si le service n'est pas sans frais ou si prepaymentType n'est PAS défini sur REQUIRED. |
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 |
SchedulingRules
Règles de planification d'un service.
Représentation JSON |
---|
{ "minAdvanceOnlineCanceling": string, "lateCancellationFee": { object ( |
Champs | |
---|---|
minAdvanceOnlineCanceling |
Délai de préavis minimal en secondes nécessaire pour annuler un rendez-vous en ligne. (facultatif) |
lateCancellationFee |
Frais facturés en cas d'annulation dans le délai de préavis minimal. |
noshowFee |
Frais de non-présentation facturés lorsque l'utilisateur n'a pas annulé la réservation. |
admissionPolicy |
Règles d'admission applicables à ce service. Si aucune valeur n'est définie, la valeur par défaut est TIME_STRICT. (facultatif) |
cancellationPolicy |
Modalités d'annulation associées aux règles de planification. (obligatoire pour le secteur des activités à découvrir) |
Champ d'union Si "min_advance_booking" est défini, la dernière heure pouvant être réservée est calculée comme suit : (<slot start time> - "min_advance_booking"). Si "min_booking_buffer_before_end_time" est défini, la dernière heure pouvant être réservée est calculée comme suit : (<slot end time> - "min_booking_buffer_before_end_time"). Notez que si elle est définie, la valeur de "min_booking_buffer_before_end_time" doit être positive. Si les deux valeurs ne sont pas définies, le créneau peut être réservé jusqu'à son heure de début. Si les deux champs sont définis, une seule valeur est sélectionnée, tandis que l'autre est ignorée. Nous ne pouvons pas prédire de manière fiable quelle valeur est choisie. Exemples :
|
|
minAdvanceBooking |
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é. |
minBookingBufferBeforeEndTime |
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 "admissionPolicy" doit être défini sur TIME_FLEXIBLE afin d'indiquer que les billets achetés peuvent être utilisé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. |
CancellationPolicy
Modalités d'annulation d'un service.
Représentation JSON |
---|
{
"refundCondition": [
{
object ( |
Champs | |
---|---|
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.
Représentation JSON |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
Champs | |
---|---|
minDurationBeforeStartTime |
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 Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
refundPercent |
Pourcentage remboursable, à condition que la réservation du service soit annulée au moins |
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. |
PrepaymentTerms
Des informations spécifiques sur la date à laquelle le prépaiement sera effectué.
Représentation JSON |
---|
{
"chargeTiming": enum ( |
Champs | |
---|---|
chargeTiming |
Lorsque le débit interviendra en fonction de l'heure d'achat. |
chargeTimeBeforeStartTimeSec |
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. |
ServiceIntakeForm
Définit un formulaire d'enregistrement qui permet à l'utilisateur de personnaliser le service fourni par un marchand.
Représentation JSON |
---|
{
"field": [
{
object ( |
Champs | |
---|---|
field[] |
Champs qui seront présentés à l'utilisateur. |
firstTimeCustomers |
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. |
returningCustomers |
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.
Représentation JSON |
---|
{ "id": string, "type": enum ( |
Champs | |
---|---|
id |
Chaîne provenant d'un partenaire agrégateur qui identifie de manière unique un champ de formulaire. Cet identifiant doit être identique à celui indiqué dans la réponse du champ de formulaire correspondant, et doit être unique à la fois pour les formulaires au niveau du service et pour les formulaires d'enregistrement au niveau du billet. (obligatoire) |
type |
Type de ce champ. |
label |
Texte présenté à l'utilisateur pour ce champ. Obsolète. Utilisez plutôt |
localizedLabel |
Texte présenté à l'utilisateur pour ce champ. Le champ peut être fourni dans différents paramètres régionaux. (obligatoire) |
value[] |
À définir si et seulement si le type de champ est LOCATION_SEARCH. Veuillez utiliser "locationId" dans le champ "location" pour spécifier la valeur du lieu. |
choiceText[] |
Définissez ce paramètre uniquement si le type de champ est MULTIPLE_CHOICE, CHECKBOXES ou DROPDOWN. Permet d'énumérer les choix possibles. |
isRequired |
Indique si l'utilisateur doit répondre à ce champ. |
allowCustomAnswer |
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) |
additionalOption[] |
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) |
ticketTypeRestrict[] |
Si cette question ne doit être affichée que lorsque l'utilisateur réserve certains types de billets, ce champ doit être défini comme l'ensemble des ID de types de billets applicables. Laissez le champ vide si la question est toujours applicable. |
hint |
Texte d'indice pour la saisie, qui s'affiche sous la forme d'un espace réservé de texte. Cela ne s'applique que si le type de champ est SHORT_ANSWER ou PARAGRAPH. (facultatif) |
FieldType
Énumération pour indiquer le type de champ.
Énumérations | |
---|---|
FIELD_TYPE_UNSPECIFIED |
Le système ignore les champs dont le type n'est pas spécifié ou est inconnu. |
SHORT_ANSWER |
Champ de saisie d'une ligne pour le texte. |
PARAGRAPH |
Champ de saisie de plusieurs lignes pour le texte. |
MULTIPLE_CHOICE |
Un ensemble de cases d'option nécessitant un choix parmi différentes options. |
CHECKBOXES |
Un ou plusieurs éléments énumérés associés à des cases à cocher. |
DROPDOWN |
Une sélection dans une liste déroulante. |
BOOLEAN |
Un bouton Oui/Non. |
LOCATION_SEARCH |
Champ de recherche permettant de trouver un lieu correspondant en fonction des données saisies par l'utilisateur dans la liste d'adresses fournie. |
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. |
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.
Représentation JSON |
---|
{ "ticketTypeId": string, "shortDescription": string, "localizedShortDescription": { object ( |
Champs | |
---|---|
ticketTypeId |
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. |
shortDescription |
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 localizedShortDescription. |
localizedShortDescription |
Une brève description de ce TicketType conforme aux normes i18n. Il peut être visible par l'utilisateur, par exemple, "adult", "child", "veteran", "Row J", etc. Obligatoire, chaque type de billet doit avoir une description visible par l'utilisateur. Des valeurs distinctes peuvent être fournies pour chaque paramètre régional. |
price |
Prix d'un seul billet de ce type, hors taxes. Le taux de taxe défini au niveau du service est appliqué aux billets. |
perTicketFee |
Frais supplémentaires appliqués à l'achat de ce billet. (facultatif) |
optionDescription |
Description de toute option supplémentaire auquel ce type de billet est éventuellement associé. Obsolète. Utilisez plutôt localizedOptionDescription. |
localizedOptionDescription |
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 : - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adulte" } localizedOptionDescription { value: "anglais" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adulte" } localizedOptionDescription { value: "espagnol" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "enfant" } localizedOptionDescription { value: "anglais" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "enfant" } localizedOptionDescription { 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, shortDescription pourrait être "3 heures" et optionDescription pourrait être soit "avec sac étanche" ou "sans sac étanche" : - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 heures" } localizedOptionDescription { value: "anglais" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 heures" } localizedOptionDescription { value: "espagnol" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 heures" } localizedOptionDescription { value: "anglais" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 heures" } localizedOptionDescription { 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 optionDescription 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 |
PerTicketFee
Frais à payer pour chaque billet acheté par l'utilisateur.
Représentation JSON |
---|
{ "serviceCharge": { object ( |
Champs | |
---|---|
serviceCharge |
Frais supplémentaires facturés pour un service. |
facilityFee |
Frais à payer sur le lieu/l'établissement |
taxes |
Taxes par billet. |
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)
Représentation JSON |
---|
{ "url": string, "type": enum ( |
Champs | |
---|---|
url |
URL de cette source multimédia. Google explore le contenu multimédia hébergé sur cette URL. |
type |
Type de cette source multimédia. |
localizedCaption |
Légende de l'élément multimédia conforme aux normes i18n. Seul le format texte brut est accepté. Tout élément HTML est supprimé. (facultatif) |
attribution |
Informations sur l'attribution associée à la source de l'élément multimédia. Notez que ce champ doit être défini si l'attribution doit s'afficher avec l'élément multimédia (par exemple, pour ajouter un crédit photographique). (facultatif) |
caption |
Obsolète. Utilisez plutôt localizedCaption. |
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. |
Attribution
Informations sur l'attribution associée à l'élément multimédia.
Représentation JSON |
---|
{
"localizedText": {
object ( |
Champs | |
---|---|
localizedText |
Crédit photographique conforme aux normes i18n. Ce texte s'affiche avec la source de l'élément multimédia. Seul le format texte brut est accepté dans ce champ. Tout élément HTML est supprimé (l'attribution utilisant des liens hypertexte n'est pas acceptée). |
text |
Obsolète. Utilisez plutôt localizedText. |
ServiceAttributeValueId
Identifie une valeur particulière d'un attribut de service à appliquer à un service.
Représentation JSON |
---|
{ "attributeId": string, "valueId": string } |
Champs | |
---|---|
attributeId |
ID d'un attribut tel que défini dans "Merchant.service_attribute", par exemple "service-type". |
valueId |
Identifiant de la valeur de cet attribut, par exemple "coupe de cheveux". Doit correspondre à l'identifiant valueId inclus dans la définition de l'attribut de service. |
WaitlistRules
Règles applicables à l'inscription sur la liste d'attente
Représentation JSON |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
Champs | |
---|---|
minPartySize |
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. |
maxPartySize |
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. |
supportsAdditionalRequest |
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. |
aboveMaxPartySizeOptions[] |
Définissez les options pour les groupes dont la taille dépasse la valeur maxPartySize. Laissez ce champ vide si des groupes plus importants ne doivent pas avoir d'autres options pour rejoindre une liste d'attente. |
UnsupportedPartySizeOption
Options pour les groupes hors de portée.
Représentation JSON |
---|
{
"callMerchant": {
object ( |
Champs | |
---|---|
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 {waitlistRules.max_party_size}, veuillez appeler le restaurant au {phone}." La valeur "CallMerchant" doit être définie, mais elle sera vide. |
CallMerchant
Message vide à utiliser dans UnsupportedPartySizeOption. Ce paramètre permettra aux utilisateurs d'appeler l'établissement pour effectuer une réservation.
TicketingVerticalSpecificData
Informations supplémentaires propres au secteur de la vente de billets pour des événements.
Représentation JSON |
---|
{ "eventCategory": enum ( |
Champs | |
---|---|
eventCategory |
Catégorie de l'événement. À définir seulement lorsque l'événement appartient à l'une des catégories prédéfinies. (facultatif) |
eventUrl |
URL de l'événement sur le site Web du partenaire. (facultatif) |
entity[] |
Liste d'entités associées à l'événement. (facultatif) |
eventAttendanceMode |
Obligatoire. Type de participation à l'événement. |
eventVirtualLocationUrl[] |
Facultatif. URL où l'événement peut être regardé. |
eventOrganizer |
Facultatif. Organisateur de l'événement. |
eventOrganizerUrl |
Facultatif. URL de l'organisateur de l'événement. |
eventOrganizerType |
Facultatif. Type d'organisateur. |
eventSourceUrl[] |
Obligatoire. URL des pages sur lesquelles figurent les informations ou les descriptions de l'événement |
eventState |
Facultatif. État de l'événement. |
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. |
Entity
Représente une entité associée à l'événement.
Représentation JSON |
---|
{ "id": string, "name": string, "url": string, "entityType": enum ( |
Champs | |
---|---|
id |
Identifiant unique de l'entité dans la base de données du partenaire. (facultatif) |
name |
Nom de l'entité. (obligatoire) |
url |
URL de la page Web qui décrit l'entité sans ambiguïté. Il s'agit de la page éventuellement associée à l'entité sur le site Web du partenaire. En cas d'URL publique, utilisez relevantUrl dans publicIdentificationData. (facultatif) |
entityType |
Type d'entité. (facultatif) |
entityRole |
Rôle de l'entité pendant l'événement. (facultatif) |
publicIdentificationData |
Références publiques associées à l'entité. (facultatif) |
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". |
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. |
PublicIdentificationData
Identifiants, pages Web ou toute autre source publique référençant une entité.
Représentation JSON |
---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
Champs | |
---|---|
relevantUrl[] |
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) |
musicbrainzId |
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) |
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. |
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. |
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é. |
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. |
PerOrderFee
Frais à payer une fois par commande, quel que soit le nombre de billets.
Représentation JSON |
---|
{ "deliveryFee": { object ( |
Champs | |
---|---|
deliveryFee |
Frais pouvant varier selon le mode de livraison. |
processingFee |
Frais liés au traitement du mode de paiement de l'utilisateur. |
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.
Représentation JSON |
---|
{ "highlights": [ { object ( |
Champs | |
---|---|
highlights[] |
Liste des temps forts visible par l'utilisateur. |
inclusions[] |
Liste d'inclusions visible par l'utilisateur. |
exclusions[] |
Liste d'exclusions présentée à l'utilisateur. |
mustKnow[] |
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é. |
Location
Données géographiques concernant un lieu.
Représentation JSON |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
Champs | |
---|---|
placeId |
ID du lieu dans la base de données Google Adresses et sur Google Maps. Pour en savoir plus sur les ID de lieu, consultez la page https://developers.google.com/places/web-service/place-id. Si cet ID est fourni, Google met le lieu en correspondance avec cette adresse. |
name |
Le nom, le numéro de téléphone, l'URL et la zone géographique du lieu, utilisés pour mettre en correspondance le lieu avec des adresses déjà présentes sur Google Maps. Ce champ est facultatif, mais peut être obligatoire dans certains cas. Par exemple, un service Service.location sans nom ne sera pas mis en correspondance avec une entité commerciale, même si l'entité est située à la même adresse. (facultatif) |
telephone |
Numéro de téléphone public du lieu, y compris l'indicatif du pays et de la région (par exemple, +14567891234). (facultatif) |
url |
URL du site Web public du lieu. (facultatif) |
geo |
Données géographiques concernant le lieu, y compris la latitude, la longitude et l'adresse. (facultatif) |
locationType |
Type d'emplacement, doit être fourni si celui-ci est fourni pour un service. |
locationId |
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. |
Rating
Définit une note associée à une entité.
Représentation JSON |
---|
{ "value": number, "numberOfRatings": string } |
Champs | |
---|---|
value |
Note moyenne (obligatoire lorsque numberOfRatings est supérieur à 0). La valeur doit être comprise dans la plage [1, 5] et peut être omise si (et seulement si) la valeur numberOfRatings est nulle. |
numberOfRatings |
Nombre de notes utilisées pour calculer la valeur (obligatoire). |
HomeServiceData
Des informations supplémentaires sont requises pour le secteur des services à domicile.
Représentation JSON |
---|
{ "categoryType": string, "jobType": string } |
Champs | |
---|---|
categoryType |
Catégorie générale à laquelle ce service à domicile appartient. Exemple : plombier, électricien, etc. |
jobType |
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. |
VirtualSession
Informations sur la session virtuelle/en ligne. Exemple : Cours de yoga en ligne, cours de cuisine virtuels, etc.
Représentation JSON |
---|
{ "sessionInstructions": { object ( |
Champs | |
---|---|
sessionInstructions |
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é) |
sessionRequirements |
Conditions requises pour la session virtuelle donnée. Par exemple, tapis de yoga, ustensiles de cuisine, etc. (recommandé) |
virtualPlatformInfo |
Informations sur la plate-forme virtuelle utilisée lors de cette session. (Obligatoire pour activer les services virtuels) |
isSessionPrerecorded |
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.
Représentation JSON |
---|
{ "platform": enum ( |
Champs | |
---|---|
platform |
Plate-forme utilisée pour la session virtuelle. |
otherPlatformName |
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. |
DirectMerchantPayment
Informations sur la manière dont l'utilisateur peut payer directement au marchand au lieu de prépayer le service via RwG.
Représentation JSON |
---|
{
"paymentMethods": [
{
object ( |
Champs | |
---|---|
paymentMethods[] |
Les utilisateurs sont invités à ne payer que via les modes de paiement mentionnés ci-dessous. |
Méthodes |
|
---|---|
|
Crée une valeur Service pour un marchand géré par l'agrégateur spécifié, puis renvoie cette valeur. |
|
Supprime une valeur Service existante associée à un marchand géré par l'agrégateur spécifié. |
|
Met à jour une valeur Service existante associée à un marchand géré par l'agrégateur spécifié, puis renvoie cette valeur. |