- Ressource : Service
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- PriceDisplayType
- InventoryType
- RelatedMedia
- MediaType
- Attribution
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Entity
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- EventCreator
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- Emplacement
- LocationType
- Rating
- HomeServiceData
- VirtualSession
- VirtualPlatformInfo
- Plate-forme
- DirectMerchantPayment
- UriTemplate
- 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 associée au service, au format |
service |
Nom du service (par exemple, "Coupe de cheveux pour hommes"). Obsolète. Utilisez désormais localizedServiceName. |
localized |
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. |
localized |
Description du service, telle qu'elle sera présentée à l'utilisateur. Ce champ accepte à la fois le format texte brut et le format HTML. Vous pouvez créer à cet endroit des mises en page personnalisées avec des en-têtes, des paragraphes, des listes et des balises d'expressions (autrement dit, avec des éléments de mise en page non présents dans les sections texte brut). Pour garantir la meilleure expérience utilisateur possible, tenez compte des instructions et des remarques suivantes : Balises de mise en forme HTML compatibles : Balises d'en-tête : <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Balise de paragraphe : <p> Balises de création de listes : <ul>, <ol>, <li> Balise de création d'une division : {div} Balises d'expressions : <br>, <strong>, <em> Balises non compatibles :
Remarques importantes :
|
price |
Prix du service. |
price |
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 applicables à la réservation/l'annulation d'un rendez-vous. |
prepayment |
Indique si un pré-paiement est requis, facultatif ou non accepté. |
prepayment |
Conditions concernant le moment où le prépaiement est effectué. |
form[] |
Obsolète. Veuillez utiliser intakeForm et perTicketIntakeForm. |
intake |
Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. (facultatif) |
per |
Un formulaire demandant des informations supplémentaires à l'utilisateur lorsqu'il réserve ce service. Ce formulaire doit être rempli une fois pour chaque billet réservé par l'utilisateur. (facultatif) |
tax |
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). |
payment |
Liste d'ID faisant référence aux options de paiement pouvant être utilisées pour le paiement de ce service. Les options de paiement réelles sont définies au niveau du marchand et peuvent également s'appliquer à plusieurs marchands. |
deposit |
Définit la manière dont un acompte peut être facturé à l'utilisateur. Remplace l'acompte éventuellement défini au niveau du service. Un message vide entraîne la suppression de tout acompte défini au niveau du service. (facultatif) |
no |
Définit les frais de non-présentation pouvant éventuellement être facturés à l'utilisateur. Remplace les frais de non-présentation éventuellement définis au niveau du service. Un message vide entraîne la suppression de tous frais de non-présentation définis au niveau du service. (facultatif) |
require |
Indique si l'utilisateur doit fournir une carte de crédit pour réserver ce service. Ce champ peut être remplacé par celui défini au niveau de la disponibilité. (facultatif) |
action |
Lien d'action associé à ce service. Si un lien d'action existe, son type (voir ci-dessous) doit être défini au niveau du service. |
type |
Type prédéfini du service. (facultatif) |
ticket |
Types de billets pouvant être réservés/achetés pour ce service (si les billets sont acceptés). (facultatif) |
related |
Photos associées à ce service. Google explore et stocke les contenus multimédias de manière à optimiser leur affichage auprès des utilisateurs finaux. (facultatif) |
service |
Valeurs facultatives des attributs de service qui s'appliquent à ce service. Aucune ou plusieurs valeurs peuvent être définies pour chaque attribut de service défini au niveau du marchand correspondant. (facultatif) |
waitlist |
Règles d'inscription à la liste d'attente. |
ticketing |
Informations supplémentaires propres au secteur de la vente de billets pour des événements. (facultatif) |
integration |
Niveau d'intégration que nous acceptons pour ce service. (Facultatif) Ne concerne pas les partenaires complétant l'intégration de démarrage. En effet, l'intégration de bout en bout est toujours désactivée dans ce cas. |
per |
Frais facturés au niveau de la commande pour l'achat de ce service. (facultatif) |
tours |
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 |
Note globale attribuée à ce service par les utilisateurs, en tenant compte de l'ensemble des avis. |
home |
Informations supplémentaires propres au secteur des services à domicile. (facultatif) |
virtual |
Facultatif. Informations sur la session virtuelle. Il est nécessaire pour activer les services virtuels. |
direct |
Facultatif. Informations supplémentaires à ajouter si le service exige que l'utilisateur paie directement au marchand. REMARQUE IMPORTANTE: RwG ne sera pas impliqué dans cette transaction. Il est obligatoire si virtualSession est défini et que le service n'est pas sans frais ou si prepaymentType n'est PAS défini sur REQUIRED. |
uri |
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 ( |
Champs | |
---|---|
min |
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. |
admission |
Règles d'admission applicables à ce service. Si aucune valeur n'est définie, la valeur par défaut est TIME_STRICT. (facultatif) |
cancellation |
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 sera sélectionnée, tandis que l'autre sera ignorée. Nous ne pouvons pas prédire de manière fiable quelle valeur sera choisie. Exemples :
|
|
min |
Durée (en secondes) entre le moment où la dernière réservation peut être effectuée et le début du créneau de disponibilité. |
min |
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 | |
---|---|
refund |
Aucune, une ou plusieurs conditions de remboursement applicables aux modalités 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 | |
---|---|
min |
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 " |
refund |
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
Informations spécifiques sur le moment où le prépaiement est effectué.
Représentation JSON |
---|
{
"chargeTiming": enum ( |
Champs | |
---|---|
charge |
Date de débit par rapport à la date d'achat. |
charge |
Durée, en secondes, avant l'heure de début du service pendant laquelle l'utilisateur est facturé. Ce champ ne doit être défini que lorsque ChargeTiming est défini sur CHARGE_LATER. |
ChargeTiming
Enumération permettant de spécifier quand la facturation aura lieu par rapport au moment de l'achat.
Enums | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
Non utilisé. |
CHARGE_NOW |
Le client sera facturé immédiatement. |
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 champ. |
label |
Texte présenté à l'utilisateur pour ce champ. Obsolète. Utilisez plutôt |
localized |
Texte présenté à l'utilisateur pour ce champ. Le champ peut être fourni dans différents paramètres régionaux. (obligatoire) |
value[] |
Définissez ce paramètre 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. |
choice |
Définissez cet attribut si et seulement si le type de champ est MULTIPLE_CHOICE, CHECKBOXES ou DROPDOWN. Utilisé pour énumérer les choix possibles. |
is |
Indique si l'utilisateur doit fournir une réponse pour ce champ. |
allow |
Indique si une valeur personnalisée est autorisée en plus des réponses prédéfinies. Cette option ne s'applique que lorsque le type de champ est LOCATION_SEARCH. (facultatif) |
additional |
Options supplémentaires fournies en plus des valeurs fournies. Ne s'applique que lorsque le type de champ est LOCATION_SEARCH. Par exemple, en plus de la liste des emplacements fournis, une autre option disponible peut être "Je contacterai le fournisseur plus tard". (facultatif) |
ticket |
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'invite pour la saisie, qui s'affiche sous forme d'espace réservé. Cette option ne s'applique que lorsque le type de champ est SHORT_ANSWER ou PARAGRAPH. (facultatif) |
FieldType
Énumération pour indiquer le type de champ.
Énumérations | |
---|---|
FIELD_TYPE_UNSPECIFIED |
Le système ignore les champs dont le type n'est pas spécifié ou est inconnu. |
SHORT_ANSWER |
Champ de saisie d'une ligne pour le texte. |
PARAGRAPH |
Champ de saisie de plusieurs lignes pour le texte. |
MULTIPLE_CHOICE |
Un ensemble de cases d'option nécessitant un choix parmi différentes options. |
CHECKBOXES |
Un ou plusieurs éléments énumérés associés à des cases à cocher. |
DROPDOWN |
Une sélection dans une liste déroulante. |
BOOLEAN |
Un bouton Oui/Non. |
LOCATION_SEARCH |
Champ de recherche permettant de trouver un lieu correspondant en fonction des données saisies par l'utilisateur dans la liste d'adresses fournie. |
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 en livraison ou à emporter, ou les deux à la fois. |
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 propose des 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 de la livraison ou du 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 | |
---|---|
ticket |
L'identifiant du billet permet de différencier les types de billets utilisés pour le même service. Il doit être unique au niveau du service. |
short |
Description courte de ce TicketType. Cela peut être visible par 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. |
localized |
Une brève description de ce TicketType conforme aux normes i18n. Cela peut être visible par 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 |
Prix d'un seul billet de ce type, hors taxes. Le taux de taxe défini au niveau du service est appliqué aux billets. |
per |
Frais supplémentaires appliqués à l'achat de ce billet. (facultatif) |
price |
Facultatif. Type d'affichage du prix prédéterminé d'un seul billet de ce type. |
option |
Description de toute option supplémentaire auquel ce type de billet est éventuellement associé. Obsolète. Utilisez plutôt localizedOptionDescription. |
localized |
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 |
inventory |
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 ( |
Champs | |
---|---|
service |
Frais supplémentaires facturés pour un service. |
facility |
Frais de location du site. |
taxes |
Taxes appliquées en fonction du billet. |
PriceDisplayType
Indique le format de prix affiché sur la page de destination.
Ce champ est ignoré pour l'inventaire sans lien externe.
Ce champ permet aux surfaces Google d'afficher le même format de prix que celui utilisé sur la page de destination. Les 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 affiché 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 de revente. |
INVENTORY_TYPE_AGGREGATOR |
Inventaire de l'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 ( |
Champs | |
---|---|
url |
URL de cette source multimédia. Google explore le contenu multimédia hébergé sur cette URL. |
type |
Type de cette source multimédia. |
localized |
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 | |
---|---|
localized |
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 | |
---|---|
attribute |
ID d'un attribut, tel que défini dans Merchant.service_attribute (par exemple, "service-type"). |
value |
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 | |
---|---|
min |
Obligatoire. Doit être un entier positif pour les services fournissant la fonctionnalité de liste d'attente. Ce champ ne doit pas être renseigné si le service ou le marchand ne propose pas la fonctionnalité de liste d'attente. |
max |
Obligatoire. Doit être un entier positif pour les services fournissant la fonctionnalité de liste d'attente. Ce champ ne doit pas être renseigné si le service ou le marchand ne propose pas la fonctionnalité de liste d'attente. |
supports |
Si la valeur est "true", l'utilisateur peut envoyer une demande de texte supplémentaire à forme libre lorsqu'il rejoint la liste d'attente pour ce service. |
above |
Définit les options pour les groupes de plus de membres que la valeur maxPartySize définie. Laissez cette option vide si les groupes plus importants ne doivent pas avoir d'autres options pour s'inscrire sur une liste d'attente. |
UnsupportedPartySizeOption
Options pour les parties hors de portée.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union kind . Options disponibles pour les parties hors portée. kind ne peut être qu'un des éléments suivants : |
|
call |
Les groupes de plus de 10 personnes 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 cette valeur, les utilisateurs pourront 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 | |
---|---|
event |
Catégorie de l'événement. À définir seulement lorsque l'événement appartient à l'une des catégories prédéfinies. (facultatif) |
event |
URL de l'événement sur le site Web du partenaire. (facultatif) |
entity[] |
Liste d'entités associées à l'événement. (facultatif) |
event |
Obligatoire. Type de participation à l'événement. |
event |
Facultatif. URL permettant de regarder l'événement. |
event |
Facultatif. Organisateur de l'événement. |
event |
Facultatif. URL de l'organisateur de l'événement. |
event |
Facultatif. Type de l'organisateur. |
event |
Obligatoire. URL des pages où vous trouverez les informations ou les descriptions de l'événement. |
event |
Facultatif. État de l'événement. |
brand |
Facultatif. Nom de la marque localisé. |
event |
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 ( |
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) |
entity |
Type d'entité. (facultatif) |
entity |
Rôle de l'entité pendant l'événement. (facultatif) |
public |
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 | |
---|---|
relevant |
URL publique d'une page Web dédiée uniquement au sujet. Il peut s'agir de sites Web officiels, de discogs, de plates-formes sur les réseaux sociaux, de pages Wikipédia ou Imdb (par exemple, https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan). (facultatif) |
musicbrainz |
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 physiques et virtuels |
OrganizerType
Type de l'organisateur.
Enums | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
Non spécifié. |
PERSON |
Pour l'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 planifié. |
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. Uniquement pertinent pour les plates-formes qui incluent des événements de contenu généré par les utilisateurs.
Représentation JSON |
---|
{ "name": string } |
Champs | |
---|---|
name |
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 ( |
Champs | |
---|---|
delivery |
Frais pouvant varier selon le mode de livraison. |
processing |
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 ( |
Champs | |
---|---|
highlights[] |
Liste de temps forts présentée à l'utilisateur. |
inclusions[] |
Liste d'inclusions visible par l'utilisateur. |
exclusions[] |
Liste d'exclusions visible par l'utilisateur. |
must |
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 ( |
Champs | |
---|---|
place |
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 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 il peut être obligatoire dans certains contextes. Par exemple, un Service.location sans nom ne sera pas mis en correspondance avec une entité commerciale, même s'ils se trouvent à la même adresse. (facultatif) |
telephone |
Numéro de téléphone public du lieu, y compris l'indicatif du pays et de la région (par exemple, +14567891234). (facultatif) |
url |
URL du site Web public du lieu. (facultatif) |
geo |
Données géographiques concernant le lieu, y compris la latitude, la longitude et l'adresse. (facultatif) |
location |
Type de lieu, doit être fourni si ce lieu est fourni pour un service. |
location |
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 |
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. |
number |
Nombre d'avis utilisés dans le calcul de la valeur (obligatoire). |
HomeServiceData
Informations supplémentaires requises pour le secteur des services à domicile
Représentation JSON |
---|
{ "categoryType": string, "jobType": string } |
Champs | |
---|---|
category |
Catégorie générale à laquelle appartient ce service pour la maison. Par exemple : plombier, électricien, etc. |
job |
Type de tâche dans la catégorie à laquelle appartient le service à domicile donné. Par exemple, les types de missions "déboucher_évier" et "installer_robinet" sont disponibles dans la catégorie "plombier". |
VirtualSession
Informations sur la session virtuelle/en ligne. (par exemple, cours de yoga en ligne, cours de cuisine virtuel, etc.)
Représentation JSON |
---|
{ "sessionInstructions": { object ( |
Champs | |
---|---|
session |
Instructions pour configurer cette classe virtuelle. Si le partenaire n'inclut pas l'URL de la vidéo avec 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 cours" (recommandé) |
session |
Exigences concernant la session virtuelle donnée. Par exemple, tapis de yoga, ustensiles de cuisine, etc. (recommandé) |
virtual |
Informations sur la plate-forme virtuelle utilisée dans cette session. (obligatoire pour activer les services virtuels) |
is |
Obligatoire. Définissez cette valeur sur "true" si la session virtuelle n'est pas en direct et qu'elle 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. |
other |
Nom de la plate-forme si la valeur "AUTRE" est définie. (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 peut choisir la plate-forme vidéo qu'il souhaite utiliser. |
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 au marchand au lieu de prépayer le service via RwG.
Représentation JSON |
---|
{
"paymentMethods": [
{
object ( |
Champs | |
---|---|
payment |
Nous recommandons aux utilisateurs de ne payer qu'avec les modes de paiement mentionnés ci-dessous. |
UriTemplate
Modèle spécifiant comment Google doit générer des URL vers un site externe.
Représentation JSON |
---|
{ "uriTemplate": string } |
Champs | |
---|---|
uri |
Facultatif. Le modèle d'URI doit respecter la RFC 6570. Pour en savoir plus, consultez la page 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. Cinq paramètres disponibles pour le lien vers la réservation de restaurant: 1) (obligatoire) {availability_slot_start_seconds} :: renseigné à partir du champ startSec dans le flux de disponibilités 2) (obligatoire) {availability_slot_duration_seconds} :: renseigné à partir du champ durationSec dans le flux de disponibilités 3) (facultatif) {resources_party_size} :: renseigné à partir du champ partySize dans le flux de disponibilités 4) (facultatif) {availability_availability_tag} :: renseigné à partir du champ availabilityTag dans le flux de disponibilités 5) (facultatif) {resources_room_id} :: renseigné à partir du champ roomId dans le flux de disponibilités Exemple d'utilisation: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * startSec = 123456 * partySize = 2 https://example.com/book/restaurant?start=123456&num_guests=2 |
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. |