REST Resource: inventory.partners.merchants.services

Ressource : Service

Informations concernant un service fourni par le marchand (par exemple, "coupe de cheveux").

Représentation JSON 
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
Champs
name

string

Nom de la ressource associée au service, au format partners/{partner_id}/merchants/{merchantId}/services/{serviceId}.
serviceName

string

Nom du service (par exemple, "Coupe de cheveux pour hommes"). Obsolète. Utilisez désormais localizedServiceName.
localizedServiceName

object (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 désormais localizedDescription.
localizedDescription

object (Text)

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

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

Balises de mise en forme HTML compatibles :

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

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

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

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

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

Balises non compatibles :

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

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

object (Price)

Prix du service.
priceInterpretation

enum (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

object (SchedulingRules)

Règles applicables à la réservation/l'annulation d'un rendez-vous.
prepaymentType

enum (PrepaymentType)

Indique si un prépaiement est requis, facultatif ou non accepté.
prepaymentTerms

object (PrepaymentTerms)

Conditions relatives à la finalisation du prépaiement.
form[]
(deprecated)

object (ServiceIntakeForm)

Obsolète. Veuillez utiliser intakeForm et perTicketIntakeForm.
intakeForm

object (ServiceIntakeForm)

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

object (ServiceIntakeForm)

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

object (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[]

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

object (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

object (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

enum (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

enum (ServiceType)

Type prédéfini du service. (facultatif)
ticketType[]

object (TicketType)

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

object (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[]

object (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

object (WaitlistRules)

Règles d'inscription à la liste d'attente.
ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

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

enum (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

object (PerOrderFee)

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

object (ToursAndActivitiesContent)

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

object (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

object (Rating)

Note globale attribuée à ce service par les utilisateurs, en tenant compte de l'ensemble des avis.
homeServiceData

object (HomeServiceData)

Informations supplémentaires propres au secteur des services à domicile. (facultatif)
virtualSession

object (VirtualSession)

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

object (DirectMerchantPayment)

Facultatif. Informations supplémentaires à ajouter si le service exige que l'utilisateur paie directement le marchand. REMARQUE IMPORTANTE : RwG ne sera pas impliqué dans cette transaction. Obligatoire si virtualSession est défini et que le service n'est pas sans frais ou que prepaymentType n'est pas défini sur REQUIRED.
uriTemplate

object (UriTemplate)

Facultatif. Modèle facultatif spécifiant comment Google doit générer des URL vers un site externe.

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 (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
Champs
minAdvanceOnlineCanceling

string (int64 format)

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

object (Price)

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

object (Price)

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

enum (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

object (CancellationPolicy)

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

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

Si "min_advance_booking" est défini, la dernière heure pouvant être réservée est calculée comme suit : (<slot start time> - "min_advance_booking"). Si "min_booking_buffer_before_end_time" est défini, la dernière heure pouvant être réservée est calculée comme suit : (<slot end time> - "min_booking_buffer_before_end_time"). Notez que si elle est définie, la valeur de "min_booking_buffer_before_end_time" doit être positive. Si les deux valeurs ne sont pas définies, le créneau peut être réservé jusqu'à son heure de début. Si les deux champs sont définis, une seule valeur sera sélectionnée et l'autre ignorée. Nous ne pouvons pas prédire de manière fiable quelle valeur sera choisie.

Exemples :

  • Une coupe de cheveux qui doit être réservée au moins une heure avant l'heure de début. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Un musée pour lequel le dernier billet peut être acheté 30 minutes avant la fermeture : 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • Un billet de cinéma qui doit être acheté avant l'heure de début du film. 'scheduling_rules{ ...}' (laisser ce champ vide) (facultatif) La valeur de min_booking_buffer peut être l'une des suivantes :
minAdvanceBooking

string (int64 format)

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

string (int64 format)

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 (RefundCondition)
    }
  ]
}
Champs
refundCondition[]

object (RefundCondition)

Aucune, une ou plusieurs conditions de remboursement applicables aux conditions d'annulation.

RefundCondition

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

Représentation JSON 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
Champs
minDurationBeforeStartTime

string (Duration format)

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 refundPercent. Si la valeur est définie sur 0 (valeur par défaut), le service peut être annulé à tout moment.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
refundPercent

integer (uint32 format)

Pourcentage remboursable, à condition que la réservation du service soit annulée au moins minDurationBeforeStartTime 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é.

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

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

Représentation JSON 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Champs
chargeTiming

enum (ChargeTiming)

Date à laquelle le débit aura lieu par rapport à la date de l'achat.
chargeTimeBeforeStartTimeSec

string (int64 format)

Durée, en secondes, avant l'heure de début du service pour laquelle l'utilisateur est facturé. Ce champ ne doit être défini que lorsque ChargeTiming est défini sur CHARGE_LATER.

ChargeTiming

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

Enums
CHARGE_TIMING_UNSPECIFIED Non utilisé.
CHARGE_NOW Le client sera facturé immédiatement.
CHARGE_LATER Des frais seront facturés au client ultérieurement.

ServiceIntakeForm

Définit un formulaire d'enregistrement qui permet à l'utilisateur de personnaliser le service fourni par un marchand.

Représentation JSON 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
Champs
field[]

object (ServiceIntakeFormField)

Champs qui seront présentés à l'utilisateur.
firstTimeCustomers
(deprecated)

boolean

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
(deprecated)

boolean

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 (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
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

enum (FieldType)

Type de ce champ.
label

string

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

object (Text)

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

string

Définissez ce champ uniquement si le type de champ est LOCATION_SEARCH. Veuillez utiliser "locationId" dans le champ "location" pour spécifier la valeur du lieu.
choiceText[]

object (Text)

Définissez cette valeur uniquement si le type de champ est MULTIPLE_CHOICE, CHECKBOXES ou DROPDOWN. Utilisé pour énumérer les choix possibles.
isRequired

boolean

Indique si l'utilisateur doit fournir une réponse pour ce champ.
allowCustomAnswer

boolean

Indique si une valeur personnalisée est autorisée en plus des réponses prédéfinies. Cela ne s'applique que lorsque le type de champ est LOCATION_SEARCH. (facultatif)
additionalOption[]

object (Text)

Options supplémentaires fournies en plus des valeurs indiquées. Ne s'applique que lorsque le type de champ est LOCATION_SEARCH. Par exemple, en plus de la liste des établissements fournie, une autre option disponible peut être "Je contacterai le fournisseur plus tard". (facultatif)
ticketTypeRestrict[]

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

object (Text)

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

FieldType

Énumération pour indiquer le type de champ.

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

ServiceType

Types de services prédéfinis.

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

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 (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
Champs
ticketTypeId

string

L'identifiant du billet permet de différencier les types de billets utilisés pour le même service. Il doit être unique au niveau du service.
shortDescription

string

Description courte de ce TicketType.

Cette description peut être présentée à l'utilisateur (par exemple, "adulte", "enfant", "senior", "rang J", etc. Obligatoire. Chaque type de billet doit comporter une description destinée à l'utilisateur. Obsolète. Utilisez plutôt localizedShortDescription.
localizedShortDescription

object (Text)

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

Cette description peut être présentée à l'utilisateur (par exemple, "adulte", "enfant", "senior", "rang J", etc. Obligatoire. Chaque type de billet doit comporter une description destinée à l'utilisateur. Des valeurs distinctes peuvent être fournies pour chaque paramètre régional.
price

object (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

object (PerTicketFee)

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

enum (PriceDisplayType)

Facultatif. Type d'affichage du prix prédéterminé d'un seul billet de ce type.
optionDescription

string

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

object (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 : - { 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
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."
inventoryType

enum (InventoryType)

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

PerTicketFee

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

Représentation JSON 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
Champs
serviceCharge

object (Price)

Frais supplémentaires facturés pour un service.
facilityFee

object (Price)

Frais de location du site.
taxes

object (Price)

Taxes appliquées en fonction du billet.

PriceDisplayType

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

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

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

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

InventoryType

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

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

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 (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
Champs
url

string

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

enum (MediaType)

Type de source multimédia.
localizedCaption

object (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

object (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 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 (Text)
  },
  "text": string
}
Champs
localizedText

object (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 localizedText.

ServiceAttributeValueId

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

Représentation JSON 
{
  "attributeId": string,
  "valueId": string
}
Champs
attributeId

string

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

string

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 (UnsupportedPartySizeOption)
    }
  ]
}
Champs
minPartySize

integer

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

integer

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

boolean

Si la valeur est "true", l'utilisateur peut envoyer une demande de texte supplémentaire à forme libre lorsqu'il rejoint la liste d'attente pour ce service.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Définissez les options pour les parties dont la taille est supérieure à la valeur maxPartySize définie. Laissez ce champ vide si vous ne souhaitez pas proposer d'autres options pour rejoindre une liste d'attente aux groupes plus importants.

UnsupportedPartySizeOption

Options pour les parties hors de portée.

Représentation JSON 
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
Champs
Champ d'union kind. Options disponibles pour les parties hors zone. kind ne peut être qu'un des éléments suivants :
callMerchant

object (CallMerchant)

Les groupes dont la taille est hors limites peuvent appeler l'établissement. Un message prédéfini s'affiche pour l'utilisateur. Exemple de texte à afficher : "Pour les groupes de plus de {waitlistRules.max_party_size}, veuillez appeler le restaurant au {phone}." CallMerchant doit être défini, mais sera vide.

CallMerchant

Ce type ne comporte aucun champ.

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

TicketingVerticalSpecificData

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

Représentation JSON 
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
Champs
eventCategory

enum (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

string

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

object (Entity)

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

enum (AttendanceMode)

Obligatoire. Type de participation à l'événement.
eventVirtualLocationUrl[]

string

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

object (Text)

Facultatif. Organisateur qui héberge l'événement.
eventOrganizerUrl

string

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

enum (OrganizerType)

Facultatif. Type d'organisateur.
eventSourceUrl[]

string

Obligatoire. URL des pages où se trouvent les informations ou les descriptions de l'événement.
eventState

enum (EventState)

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

object (Text)

Facultatif. Nom de marque localisé.
eventCreator

object (EventCreator)

Facultatif. Informations sur le créateur 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 (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
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. En cas d'URL publique, utilisez relevantUrl dans publicIdentificationData. (facultatif)
entityType

enum (EntityType)

Type d'entité. (facultatif)
entityRole

enum (EntityRole)

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

object (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[]

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)
musicbrainzId

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)

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 un organisateur qui est une personne.
ORGANIZATION Pour un organisateur qui est une organisation.

EventState

État de l'événement.

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

EventCreator

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

Représentation JSON 
{
  "name": string
}
Champs
name

string

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

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 (Price)
  },
  "processingFee": {
    object (Price)
  }
}
Champs
deliveryFee

object (Price)

Frais pouvant varier selon le mode de livraison.
processingFee

object (Price)

Frais associé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 (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
Champs
highlights[]

object (Text)

Liste de temps forts présentée à l'utilisateur.
inclusions[]

object (Text)

Liste d'inclusions présentée à l'utilisateur.
exclusions[]

object (Text)

Liste d'exclusions présentée à l'utilisateur.
mustKnow[]

object (Text)

Liste de remarques importantes visible par l'utilisateur (à utiliser pour des détails tels que des restrictions d'âge ou d'autres conditions qui rendent ce service inapproprié).

Location

Données géographiques concernant un lieu.

Représentation JSON 
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
Champs
placeId

string

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

string

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

Ce champ est facultatif, mais peut être obligatoire dans certains contextes. Par exemple, un Service.location sans nom ne sera pas associé à une entité commerciale, même s'ils sont situés à la même adresse. (facultatif)
telephone

string

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

string

URL du site Web public du lieu. (facultatif)
geo

object (GeoCoordinates)

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

enum (LocationType)

Le type de lieu doit être fourni si ce lieu est fourni pour un service.
locationId

string

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

LocationType

Type de lieu.

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

Rating

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

Représentation JSON 
{
  "value": number,
  "numberOfRatings": string
}
Champs
value

number

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

string

Nombre d'avis utilisés dans le calcul de la valeur (obligatoire).

HomeServiceData

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

Représentation JSON 
{
  "categoryType": string,
  "jobType": string
}
Champs
categoryType

string

Catégorie de niveau supérieur à laquelle appartient ce service à domicile. Par exemple, plombier, électricien, etc.
jobType

string

Type de job dans la catégorie à laquelle appartient le service à domicile donné. Par exemple, "déboucher_canalisation" et "installer_robinet" sont des types de missions de la catégorie "plombier".

VirtualSession

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

Représentation JSON 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
Champs
sessionInstructions

object (Text)

Instructions sur la configuration de ce cours virtuel. Si le partenaire n'inclut pas l'URL de la vidéo dans la réservation, ce texte doit indiquer quand l'URL de la vidéo sera partagée avec l'utilisateur. par exemple, "L'URL Zoom vous sera envoyée par e-mail 30 minutes avant le début du cours." (recommandé)
sessionRequirements

object (Text)

Conditions requises pour la session virtuelle donnée. Par exemple, tapis de yoga, ustensiles de cuisine, etc. (recommandé)
virtualPlatformInfo

object (VirtualPlatformInfo)

Informations sur la plate-forme virtuelle utilisée lors de cette session. (Requis pour activer les services virtuels)
isSessionPrerecorded

boolean

Obligatoire. Définissez cette valeur sur "true" si la session virtuelle n'est pas en direct et est préenregistrée.

VirtualPlatformInfo

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

Représentation JSON 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
Champs
platform

enum (Platform)

Plate-forme utilisée pour la session virtuelle.
otherPlatformName

object (Text)

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

Plate-forme

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

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

DirectMerchantPayment

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

Représentation JSON 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
Champs
paymentMethods[]

object (Text)

Nous recommandons aux utilisateurs de payer uniquement avec les modes de paiement mentionnés ci-dessous.

UriTemplate

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

Représentation JSON 
{
  "uriTemplate": string
}
Champs
uriTemplate

string

Facultatif. Le modèle d'URI doit respecter la norme RFC6570. Pour en savoir plus, consultez https://datatracker.ietf.org/doc/html/rfc6570. Compatible avec les modèles de niveau 2. Ces paramètres seront résolus en fonction des valeurs spécifiées dans leurs entités respectives.

Paramètres disponibles pour le lien externe de réservation de restaurant : 1) (obligatoire) {availability_slot_start_seconds} :: renseigné à partir du champ "startSec" dans le flux de disponibilité 2) (obligatoire) {resources_party_size} :: renseigné à partir du champ "partySize" dans le flux de disponibilité 3) (facultatif) {availability_slot_duration_seconds} :: renseigné à partir du champ "durationSec" dans le flux de disponibilité 4) (facultatif) {availability_slot_availability_tag} :: renseigné à partir du champ "availabilityTag" dans le flux de disponibilité

Exemple d'utilisation : http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size}

Avec : * startSec = 123456 * partySize = 2

https://example.com/book/restaurant?start=123456&num_guests=2

Méthodes

create

 Crée une valeur Service pour un marchand géré par l'agrégateur spécifié, puis renvoie cette valeur.

delete

 Supprime une valeur Service existante associée à un marchand géré par l'agrégateur spécifié.

patch

 Met à jour une valeur Service existante associée à un marchand géré par l'agrégateur spécifié, puis renvoie cette valeur.