- Ressource: Service
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition (Erstattungsbedingung)
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType:
- PerTicketFee
- RelatedMedia
- MediaType
- Attribution
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Entität
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- Standort
- LocationType
- Bewertung
- HomeServiceData
- VirtualSession
- VirtualPlatformInfo
- Platform
- DirectMerchantPayment
- Methoden
Ressource: Service
Informationen zu einer Dienstleistung, die vom Händler angeboten wird, z. B. ein Haarschnitt.
JSON-Darstellung |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
Felder | |
---|---|
name |
Der Name der Dienstressource im Format |
serviceName |
Der Name der Dienstleistung, z. B. "Herrenschnitt". Eingestellt. Verwende stattdessen "localizedServiceName". |
localizedServiceName |
Der Name der Dienstleistung, z. B. "Herrenschnitt". Möglicherweise in mehreren Sprachen. |
description |
Die für den Nutzer sichtbare Beschreibung der Dienstleistung. Eingestellt. Verwende stattdessen "localizedDescription". |
localizedDescription |
Die für den Nutzer sichtbare Beschreibung der Dienstleistung. In diesem Feld wird sowohl die Nur-Text- als auch die HTML-ähnliche Formatierung unterstützt. Im Gegensatz zu Nur-Text-Abschnitten können hier benutzerdefinierte Layouts mit Tags für Überschriften, Absätze, Listen und Wortgruppen erstellt werden. Bitte lies dir die folgenden Informationen sorgfältig durch, um eine optimale Nutzererfahrung zu gewährleisten. Unterstützte HTML-ähnliche Formatierungstags: Überschriftentags: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Absatztag: <p> Listentags: <ul>, <ol>, <li> Aufteilungstag: <div> Wortgruppentags: <br>, <strong>, <em>: Nicht unterstützte Tags:
Wichtige Hinweise:
|
price |
Der Preis der Dienstleistung. |
priceInterpretation |
Beschreibt, wie der Preis interpretiert und dem Nutzer angezeigt wird. Kann von jeder Branche außer "Gastronomie" und "Mögliche Aktivitäten" verwendet werden, um zu konfigurieren, wie der Preis der Dienstleistung angezeigt wird. |
rules |
Regeln zum Buchen/Stornieren von Terminen |
prepaymentType |
Gibt an, ob eine Vorauszahlung erforderlich, optional oder nicht unterstützt wird. |
prepaymentTerms |
Bedingungen für den Zeitpunkt der Vorauszahlung. |
form[] |
Veraltet. Bitte verwende intakeForm und perTicketIntakeForm. |
intakeForm |
Ein Formular, über das bei der Buchung der Dienstleistung zusätzliche Informationen vom Nutzer angefordert werden. (optional) |
perTicketIntakeForm |
Ein Formular, über das bei der Buchung der Dienstleistung zusätzliche Informationen vom Nutzer angefordert werden. Es muss für jedes Ticket, das der Nutzer bucht, einmal ausgefüllt werden. (optional) |
taxRate |
Der Steuersatz der Dienstleistung. Falls vorhanden, überschreibt dieses Feld einen auf Händlerebene festgelegten Steuersatz (taxRate). Bei einer leeren Nachricht (z. B. "tax_rate { }") wird der angewendete Steuersatz auf null zurückgesetzt. |
paymentOptionId[] |
Eine Liste mit IDs für die Zahlungsoptionen, die verwendet werden können, um für die Dienstleistung zu zahlen. Die tatsächlichen Zahlungsoptionen werden auf Händlerebene festgelegt und können für mehrere Händler genutzt werden. |
deposit |
Definiert, wie dem Nutzer eine Anzahlung berechnet werden kann. Überschreibt die Anzahlung auf Dienstleistungsebene, falls eine angegeben wurde. Wenn du hier eine leere Deposit-Nachricht festlegst, werden alle Anzahlungen auf Dienstleistungsebene entfernt. (optional) |
noShowFee |
Definiert eine Gebühr bei Nichterscheinen, die dem Nutzer berechnet werden kann. Überschreibt die Gebühr bei Nichterscheinen auf Dienstleistungsebene, falls eine angegeben wurde. Wenn du hier eine leere NoShowFee-Nachricht festlegst, werden alle Gebühren bei Nichterscheinen auf Dienstleistungsebene entfernt. (optional) |
requireCreditCard |
Gibt an, ob der Nutzer Kreditkartendaten angeben muss, um diese Dienstleistung zu buchen. Dieses Feld kann auf Verfügbarkeitsebene überschrieben werden. (optional) |
actionLink[] |
Ein Aktionslink für diese Dienstleistung. Wenn ein Aktionslink vorhanden ist, muss der Typ (siehe unten) in der Dienstleistung festgelegt werden. |
type |
Der vordefinierte Typ dieser Dienstleistung. (optional) |
ticketType[] |
Arten von Tickets, die für diese Dienstleistung gebucht/gekauft werden können, sofern Tickets unterstützt werden. (optional) |
relatedMedia[] |
Fotos für diese Dienstleistung. Google crawlt und speichert sie, damit sie bestmöglich für Endnutzer dargestellt werden. (optional) |
serviceAttributeValueId[] |
Werte für Dienstleistungsattribute für diese Dienstleistung (optional). Jede Dienstleistung kann null oder mehr Werte für jedes Dienstleistungsattribute haben, das im entsprechenden Händler definiert ist. (optional) |
waitlistRules |
Regeln für die Aufnahme in die Warteliste |
ticketingVerticalSpecificData |
Spezifische Zusatzinformationen für die Veranstaltungsticketbranche (optional) |
integrationType |
Unterstützte Integrationstiefe für diese Dienstleistung. (optional) Für Partner mit der Startintegration nicht relevant. End-to-End ist für diese Partner immer deaktiviert. |
perOrderFee |
Gebühren auf Bestellebene für den Kauf dieser Dienstleistung (optional) |
toursAndActivitiesContent |
Spezifische Inhaltsfelder für Touren und Aktivitäten. |
location[] |
Orte für diese Dienstleistung. WICHTIGE HINWEISE: Wenn im Rahmen der Dienstleistung mehrere Orte besucht werden oder die START_LOCATION sich von der VISITED_LOCATION unterscheidet, muss START_LOCATION angegeben werden. Beispiele: - Bei einer geführten Fahrradtour zu drei Orten muss der Startort angegeben werden. - Eine Bustour, bei der Sie in der Hotellobby abgehalten werden und anschließend zum besuchten Veranstaltungsort aufbrechen Der Besprechungsort muss angegeben werden. |
rating |
Nutzerbewertung für diesen Dienst als aggregierter Messwert für alle Rezensionen. |
homeServiceData |
Zusätzliche Informationen speziell für die Branche „Haushaltsdienstleistungen“. (optional) |
virtualSession |
Optional. Informationen zur virtuellen Sitzung. Es ist erforderlich, um virtuelle Dienste zu aktivieren. |
directMerchantPayment |
Optional. Zusätzliche Informationen, die hinzugefügt werden müssen, wenn der Nutzer im Rahmen des Dienstes direkt an den Händler zahlen muss. WICHTIGER HINWEIS: RwG ist an dieser Transaktion nicht beteiligt. Sie ist erforderlich, wenn „virtualSession“ definiert ist und der Dienst nicht kostenlos ist oder „prepaymentType“ NICHT auf REQUIRED gesetzt ist. |
PriceInterpretation
Beschreibt, wie ein Preis interpretiert und dem Nutzer angezeigt werden soll
Enums | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED |
Keine Vorgabe für die Interpretation des Preises. Standardmäßig wird EXAKT_AMOUNT festgelegt. |
EXACT_AMOUNT |
Der Preis soll als spezifischer Wert interpretiert werden. Beispiele: 20 € für einen Yogakurs; 15 € für einen Kinderhaarschnitt |
STARTS_AT |
Der Preis einer Dienstleistung variiert, es ist aber ein Mindestpreis bekannt, der Nutzern angezeigt wird. Nutzer können Auswahlen treffen, durch die sich der Preis erhöht. Für jede Dienstleistung, für die diese "PriceInterpretation" verwendet wird, muss als "PrepaymentType" NOT_SUPPORTED festgelegt sein. Beispiele: 30 € für die Hundefellpflege, aber durch zusätzliche Auswahlmöglichkeiten kann sich der Preis erhöhen |
NOT_DISPLAYED |
Der Preis einer Dienstleistung variiert und Nutzer sehen im Voraus keine Preisinformationen. Hinweis: Für jede Dienstleistung, für die diese "PriceInterpretation" verwendet wird, muss als "PrepaymentType" NOT_SUPPORTED festgelegt sein. Außerdem muss "Price" leer sein. Beispiel: eine Beratung für eine Haushaltsdienstleistung |
SchedulingRules
Die Planungsregeln für eine Dienstleistung
JSON-Darstellung |
---|
{ "minAdvanceOnlineCanceling": string, "lateCancellationFee": { object ( |
Felder | |
---|---|
minAdvanceOnlineCanceling |
Die Mindestzeit in Sekunden, vor der ein Termin online storniert werden kann (optional) |
lateCancellationFee |
Die Gebühr, die erhoben wird, wenn ein Termin innerhalb der Mindestzeit storniert wird. |
noshowFee |
Die Gebühr, die erhoben wird, wenn ein Nutzer nicht erscheint, ohne zu stornieren. |
admissionPolicy |
Die Einlassrichtlinie für diese Dienstleistung. Ist das Feld nicht festgelegt, wird standardmäßig TIME_STRICT verwendet. (optional) |
cancellationPolicy |
Stornierungsrichtlinien für Planungsregeln (für "Mögliche Aktivitäten" erforderlich) |
Union-Feld Wenn "min_advance_booking" festgelegt ist, ergibt sich die Zeit für letzte Buchungen aus (<slot start time> − "min_advance_booking"). Wenn "min_booking_buffer_before_end_time" festgelegt ist, ergibt sich die Zeit für letzte Buchungen aus (<slot end time> − "min_booking_buffer_before_end_time"). Für "min_booking_buffer_before_end_time" darf nur ein positiver Wert festgelegt werden. Sind beide nicht festgelegt, kann der Slot bis zu seiner Startzeit gebucht werden. Sind beide Felder festgelegt, wird nur ein Wert ausgewählt, während der andere ignoriert wird. Wir können nicht zuverlässig vorhersagen, welcher Wert ausgewählt wird. Beispiele:
|
|
minAdvanceBooking |
Die Dauer (in Sekunden) von der letzten Buchung bis zum Beginn des verfügbaren Slots. |
minBookingBufferBeforeEndTime |
Die Dauer (in Sekunden) bis zur Endzeit des verfügbaren Slots, bis zu der Buchungen möglich sind. Wenn dieses Feld festgelegt ist, muss das Feld "admissionPolicy" auf TIME_FLEXIBLE gesetzt werden, um anzugeben, dass Nutzer die gekauften Tickets nach dem Start der Slots verwenden können. |
AdmissionPolicy
Die Einlassrichtlinie für diese Dienstleistung
Enums | |
---|---|
ADMISSION_POLICY_UNSPECIFIED |
Nicht verwendet |
TIME_STRICT |
Kunden müssen zur Startzeit des Slots anwesend sein. Es wird erwartet, dass die Dienstleistung zur Endzeit des Slots endet. Beispiele für TIME_STRICT-Anwendungsfälle: * eine Tour, die um 9:00 Uhr beginnt (alle Teilnehmer müssen pünktlich da sein) und gegen 12:00 Uhr endet * ein Frisörtermin am Samstag um 15:00 Uhr, der etwa 30 Minuten dauert * ein Fitnesskurs von 18:00 bis 20:00 Uhr |
TIME_FLEXIBLE |
Kunden können zwischen der Start- und Endzeit des Slots beliebig eintreffen, um die Buchung in Anspruch zu nehmen. Beispiele für TIME_FLEXIBLE-Anwendungsfälle: * Museumstickets, die am Kauftag jederzeit verwendet werden können * Nachmittagseintritt für einen Freizeitpark, der von 12:00 bis 21:00 Uhr genutzt werden kann |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION |
Kunden müssen zur Startzeit des Slots anwesend sein, können aber jederzeit gehen. Beispiel: Ein Museum, das Tickets mit festen Einlasszeiten verkauft. Bei einem Ticket für 10:00 Uhr muss der Besucher genau um diese Zeit im Museum sein. Die Startzeit der Slots dieser Dienstleistung ist die festgelegte Einlasszeit. Mit der Endzeit wird aber nur der verfügbare Slot für die Buchung angegeben. |
CancellationPolicy
Stornierungsrichtlinien für eine Dienstleistung
JSON-Darstellung |
---|
{
"refundCondition": [
{
object ( |
Felder | |
---|---|
refundCondition[] |
Keine oder mehr Erstattungsbedingungen, die für die Richtlinie gelten. |
RefundCondition
Definiert eine einzelne Erstattungsbedingung. Mehrere Erstattungsbedingungen können zusammen verwendet werden, um "Erstattungsschritte" als verschiedene Zeiträume vor der Startzeit der Dienstleistung zu beschreiben.
JSON-Darstellung |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
Felder | |
---|---|
minDurationBeforeStartTime |
Zeit vor der Startzeit, bis zu der der Kunde eine Erstattung für einen Teil der in Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
refundPercent |
Der Prozentsatz im Bereich von <0 bis 100>, der erstattet werden kann, solange die Buchung mindestens |
PrepaymentType
Optionen zum Angeben der Vorauszahlungsart
Enums | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
Standardmäßig gehen wir von NOT_SUPPORTED aus. |
REQUIRED |
Der Nutzer muss zum Zeitpunkt der Buchung für die Dienstleistung zahlen. |
OPTIONAL |
Der Nutzer kann zum Zeitpunkt der Buchung oder später für die Dienstleistung zahlen, eine Vorauszahlung ist für die Buchung aber nicht erforderlich. |
NOT_SUPPORTED |
Die Vorauszahlung wird für diese Dienstleistung nicht unterstützt. |
PrepaymentTerms
Spezifische Informationen dazu, wann die Vorauszahlung abgeschlossen ist.
JSON-Darstellung |
---|
{
"chargeTiming": enum ( |
Felder | |
---|---|
chargeTiming |
Wann die Abbuchung im Verhältnis zum Kaufzeitpunkt erfolgt. |
chargeTimeBeforeStartTimeSec |
Zeit in Sekunden vor der Startzeit des Dienstes, zu der dem Nutzer die Zahlung in Rechnung gestellt wird. Dieses Feld sollte nur festgelegt werden, wenn ChargeTiming CHARGE_LATER ist. |
ChargeTiming
Aufzählung, die angibt, wann die Gebühr relativ zum Kaufzeitpunkt erfolgt.
Enums | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
nicht in Verwendung. |
CHARGE_NOW |
Der Kunde wird sofort belastet. |
CHARGE_LATER |
Der Kunde wird später belastet. |
ServiceIntakeForm
Definiert ein Eingabeformular, über das die vom Händler angebotene Dienstleistung angepasst wird.
JSON-Darstellung |
---|
{
"field": [
{
object ( |
Felder | |
---|---|
field[] |
Felder, die dem Nutzer angezeigt werden. |
firstTimeCustomers |
Ist es auf "true" gesetzt, wird das Formular Neukunden angezeigt. Veraltet. Diese Funktion wird für Eingabeformulare nicht unterstützt. |
returningCustomers |
Ist es auf "true" gesetzt, wird das Formular Bestandskunden angezeigt. Veraltet. Diese Funktion wird für Eingabeformulare nicht unterstützt. |
ServiceIntakeFormField
Definiert ein Feld, das in einem Eingabeformular (ServiceIntakeForm) enthalten ist.
JSON-Darstellung |
---|
{ "id": string, "type": enum ( |
Felder | |
---|---|
id |
Ein String von einem Aggregator, mit dem ein Formularfeld eindeutig identifiziert wird. Diese ID muss mit der ID in der Antwort im entsprechenden Formularfeld übereinstimmen und für die Eingabeformulare auf Dienstleistungs- und Ticketebene eindeutig sein. (Pflichtfeld) |
type |
Der Typ dieses Felds. |
label |
Der Text, der dem Nutzer für dieses Feld angezeigt wird. Eingestellt. Verwende stattdessen |
localizedLabel |
Der Text, der dem Nutzer für dieses Feld angezeigt wird. Das Feld kann in mehreren Sprachen angegeben werden. (erforderlich) |
value[] |
Legen Sie diesen Wert nur fest, wenn der Feldtyp LOCATION_SEARCH ist. Verwende im Feld "location" die "locationId", um den Wert für den Ort anzugeben. |
choiceText[] |
Wird nur festgelegt, wenn der Feldtyp MULTIPLE_CHOICE, CHECKBOXES oder DROPDOWN ist. Wird zur Aufzählung möglicher Auswahlmöglichkeiten verwendet. |
isRequired |
Gibt an, ob ein Nutzer eine Antwort in diesem Feld benötigt. |
allowCustomAnswer |
Gibt an, ob ein benutzerdefinierter Wert neben vordefinierten Antworten zulässig ist. Dies gilt nur, wenn der Feldtyp LOCATION_SEARCH ist. (optional) |
additionalOption[] |
Zusätzliche Optionen, die zusätzlich zu den angegebenen Werten angegeben werden. Gilt nur, wenn der Feldtyp LOCATION_SEARCH ist. Neben der bereitgestellten Standortliste kann beispielsweise die Option „Ich wende mich später an den Lieferanten“ an. (optional) |
ticketTypeRestrict[] |
Wenn diese Frage nur angezeigt werden soll, wenn der Nutzer bestimmte Tickettypen bucht, sollte dieses Feld auf die entsprechenden Tickettyp-IDs gesetzt werden. Lass das Feld leer, wenn die Frage immer angezeigt werden soll. |
hint |
Der Hinweistext für die Eingabe, der als Textplatzhalter angezeigt wird. Dies gilt nur, wenn der Feldtyp SHORT_ANSWER oder PARAGRAPH ist. (optional) |
FieldType
Optionen zum Angeben des Feldtyps
Enums | |
---|---|
FIELD_TYPE_UNSPECIFIED |
Felder ohne Typ oder mit unbekanntem Typ werden ignoriert. |
SHORT_ANSWER |
Ein einzeiliges Eingabefeld für Text |
PARAGRAPH |
Ein mehrzeiliges Eingabefeld für Text |
MULTIPLE_CHOICE |
Eine Reihe von Optionsfeldern, bei denen eine Option ausgewählt werden muss |
CHECKBOXES |
Ein oder mehrere aufgezählte Elemente mit Kästchen |
DROPDOWN |
Eine Auswahl aus einem Drop-down |
BOOLEAN |
Eine Ja/Nein-Schaltfläche |
LOCATION_SEARCH |
Ein Suchfeld, das die Suche nach einem passenden Standort anhand der Nutzereingabe aus der angegebenen Standortliste unterstützt |
ServiceType
Vordefinierte Dienstleistungstypen
Enums | |
---|---|
SERVICE_TYPE_UNSPECIFIED |
Nicht verwendet |
SERVICE_TYPE_DINING_RESERVATION |
Restaurantreservierung |
SERVICE_TYPE_FOOD_ORDERING |
Essensbestellungen können entweder Lieferung oder Essen zum Mitnehmen oder beides sein. |
SERVICE_TYPE_FOOD_DELIVERY |
Lebensmittellieferung. |
SERVICE_TYPE_FOOD_TAKEOUT |
Essen zum Mitnehmen. |
SERVICE_TYPE_EVENT_TICKET |
Veranstaltungsticket |
SERVICE_TYPE_TRIP_TOUR |
Reisetour |
SERVICE_TYPE_APPOINTMENT |
Dienstleistung mit Terminen oder Kursen. Empfohlen für (1) Gesundheit und Fitness, (2) Wellness und Beauty und (3) Finanzberatung und Gutachterdienstleistungen. Informationen zu den unterstützten Dienstleistungstypen findest du unter https://developers.google.com/maps-booking/guides/end-to-end-integration/overview. |
SERVICE_TYPE_ONLINE_APPOINTMENT |
Anbieter von Onlineterminen für virtuelle Kurse oder Sitzungen. Muss festgelegt werden, wenn virtuelle Servicebuchungen aktiviert werden. |
SERVICE_TYPE_SHOPPING |
Ein Dienst, über den Nutzer bei einem bestimmten Händler einkaufen können. Es kann „Lieferung“ oder „Abholung“ sein. |
TicketType
"TicketType" wird verwendet, um Tickets zu unterscheiden, die aufgrund unterschiedlicher Nutzertypen, Dienstleistungsattribute oder Optionen/Zusätze unterschiedliche Preise und/oder Verfügbarkeiten haben.
Ein Ticket ist die kleinste Einheit, die für eine Dienstleistung gebucht werden kann, z. B. ein Platz bei einer Raftingtour, einmal Eintritt ins Museum oder der ganztägige Verleih eines Doppelkajaks.
JSON-Darstellung |
---|
{ "ticketTypeId": string, "shortDescription": string, "localizedShortDescription": { object ( |
Felder | |
---|---|
ticketTypeId |
Die Ticket-ID wird verwendet, um zwischen verschiedenen Tickettypen derselben Dienstleistung zu unterscheiden. Sie muss nur innerhalb einer Dienstleistung eindeutig sein. |
shortDescription |
Eine kurze Beschreibung dieses Tickettyps (TicketType). Sie kann für den Nutzer sichtbar sein, z. B. "Erwachsener", "Kind", "Rentner" oder "Reihe J". Pflichtfeld. Jeder Tickettyp muss eine Beschreibung haben, die der Nutzer sehen kann. Eingestellt. Verwende stattdessen "localizedShortDescription". |
localizedShortDescription |
Eine kurze Beschreibung dieses Tickettyps (TicketType) mit i18n-Unterstützung. Sie kann für den Nutzer sichtbar sein, z. B. "Erwachsener", "Kind", "Rentner" oder "Reihe J". Pflichtfeld. Jeder Tickettyp muss eine Beschreibung haben, die der Nutzer sehen kann. Für jede Sprache können separate Werte angegeben werden. |
price |
Der Preis für ein einzelnes Ticket dieses Typs ohne Steuern. Der Steuersatz der Dienstleistung wird auf die dazugehörigen Tickets angewendet. |
perTicketFee |
Zusätzliche Gebühren für den Kauf dieses Tickets (optional) |
optionDescription |
Beschreibung zusätzlicher Optionen für diesen Tickettyp. Eingestellt. Verwende stattdessen "localizedOptionDescription". |
localizedOptionDescription |
Beschreibung zusätzlicher Optionen für diesen Tickettyp. Für jede Sprache können separate Werte angegeben werden. Zusätzliche Optionen sind nützlich, wenn der Tickettyp mehrere Ebenen hat. Beispiel 1: Bei einer Eintrittskarte mit verschiedenen Typen ("Erwachsener"/"Kind") und Sprache als zusätzlicher Option würde das so aussehen: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "Erwachsener" } localizedOptionDescription { value: "Deutsch" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "Erwachsener" } localizedOptionDescription { value: "Englisch" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "Kind" } localizedOptionDescription { value: "Deutsch" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "Kind" } localizedOptionDescription { value: "Englisch" } } Beispiel 2: Bei einem mehrstündigen Kajakverleih mit Trockensäcken als Zusatzoption könnte "shortDescription " auf "3 Stunden" und "optionDescription " auf "mit Trockensack" oder "ohne Trockensack" gesetzt sein: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 Stunden" } localizedOptionDescription { value: "ohne Trockensack" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 Stunden" } localizedOptionDescription { value: "mit Trockensack" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 Stunden" } localizedOptionDescription { value: "ohne Trockensack" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 Stunden" } localizedOptionDescription { value: "mit Trockensack" } } Optional. Wenn dieses Feld jedoch für einen Tickettyp innerhalb der Dienstleistung festgelegt ist, wird erwartet, dass es auch für alle anderen Tickettypen festgelegt ist (eine standardmäßige "optionDescription" kann verwendet werden). Beispielsweise ist [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] keine gültige Liste. Es werden nur zwei HTML-Formatierungstags unterstützt: und |
PerTicketFee
Gebühren, die für jedes vom Nutzer gekaufte Ticket bezahlt werden müssen
JSON-Darstellung |
---|
{ "serviceCharge": { object ( |
Felder | |
---|---|
serviceCharge |
Eine zusätzliche Gebühr für eine Dienstleistung. |
facilityFee |
Eine Gebühr für den Veranstaltungsort |
taxes |
Steuern pro Ticket. |
RelatedMedia
Fotos für diese Dienstleistung. Google crawlt sie, um sicherzustellen, dass sie korrekt für Endnutzer dargestellt werden. (optional)
JSON-Darstellung |
---|
{ "url": string, "type": enum ( |
Felder | |
---|---|
url |
Die URL der Medienquelle. Google crawlt die Fotos, die unter dieser URL gehostet werden. |
type |
Der Typ dieser Medienquelle. |
localizedCaption |
Bildunterschrift des Fotos mit i18n-Unterstützung. Nur Text ist zulässig. Alle HTML-Komponenten werden entfernt. (optional) |
attribution |
Angaben zur Quelle des Fotos. Das Feld muss festgelegt werden, wenn die Quellenangaben zusammen mit dem Foto angezeigt werden sollen, um den Fotografen oder die Agentur zu nennen. (optional) |
caption |
Verwende stattdessen "localizedCaption". |
MediaType
Optionen für die Art der Medienquelle. Es werden nur Fotos unterstützt. Bitte wende dich an das "Mit Google reservieren"-Team, wenn du andere Medien verwenden möchtest.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Nicht verwendet |
PHOTO |
Gibt an, dass das Medium, das über die URL bereitgestellt wird, ein Foto ist. |
Attribution
Quellenangabe für das Foto
JSON-Darstellung |
---|
{
"localizedText": {
object ( |
Felder | |
---|---|
localizedText |
Der Text, in dem der Fotograf oder die Agentur genannt wird (mit i18n-Unterstützung). Er wird zusammen mit dem Foto angezeigt. Für dieses Feld kann nur unformatierter Text verwendet werden. HTML-Komponenten werden entfernt. Quellenangaben über Hyperlinks werden nicht unterstützt. |
text |
Verwende stattdessen "localizedText". |
ServiceAttributeValueId
Gibt einen bestimmten Wert eines Dienstleistungsattributs an, das auf eine Dienstleistung angewendet werden soll
JSON-Darstellung |
---|
{ "attributeId": string, "valueId": string } |
Felder | |
---|---|
attributeId |
ID eines in „Merchant.service_attribute“ definierten Attributs, z.B. „service-type“. |
valueId |
ID des Werts für dieses Attribut, z. B. "Haarschnitt". Muss einer "valueId" in der Definition des Dienstleistungsattributs entsprechen. |
WaitlistRules
Aufnahmeregeln für die Warteliste
JSON-Darstellung |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
Felder | |
---|---|
minPartySize |
Erforderlich. Für Dienstleistungen mit Wartelistenfunktionen muss eine positive Ganzzahl angegeben werden. Wenn es für die Dienstleistung oder den Händler keine Wartelistenfunktion gibt, darf das Feld nicht ausgefüllt werden. |
maxPartySize |
Erforderlich. Für Dienstleistungen mit Wartelistenfunktionen muss eine positive Ganzzahl angegeben werden. Wenn es für die Dienstleistung oder den Händler keine Wartelistenfunktion gibt, darf das Feld nicht ausgefüllt werden. |
supportsAdditionalRequest |
Wenn „true“ festgelegt ist, kann der Nutzer eine zusätzliche Textanfrage im freien Format senden, wenn er sich auf die Warteliste für diesen Dienst setzt. |
aboveMaxPartySizeOptions[] |
Lege Optionen für Partys fest, die größer als der festgelegte maxPartySize-Wert sind. Lass das Feld leer, wenn größere Gruppen keine alternativen Optionen für die Aufnahme in eine Warteliste erhalten sollen. |
UnsupportedPartySizeOption
Optionen für Parteien, die außerhalb des zulässigen Bereichs liegen.
JSON-Darstellung |
---|
{
"callMerchant": {
object ( |
Felder | |
---|---|
callMerchant |
Personen außerhalb des Bereichs können bei dem Unternehmen anrufen. Dem Nutzer wird eine vordefinierte Mitteilung angezeigt. Angezeigter Beispieltext: "Rufe für Gruppen, die größer als {waitlistRules.max_party_size} sind, unter der Telefonnummer {phone} im Restaurant an." CallMerchant muss angegeben werden, ist aber leer. |
CallMerchant
Leere Nachricht, die in „Nicht unterstütztePartySizeOption“ verwendet werden soll. Mit dieser Einstellung wird Nutzern die Option angezeigt, das Unternehmen für eine Buchung anzurufen.
TicketingVerticalSpecificData
Spezifische Zusatzinformationen für die Veranstaltungsticketbranche
JSON-Darstellung |
---|
{ "eventCategory": enum ( |
Felder | |
---|---|
eventCategory |
Die Kategorie der Veranstaltung. Sie wird nur festgelegt, wenn die Veranstaltung zu einer der vordefinierten Kategorien gehört. (optional) |
eventUrl |
Die URL der Veranstaltung auf der Website des Partners (optional) |
entity[] |
Eine Liste von Entitäten, die sich auf die Veranstaltung beziehen (optional) |
eventAttendanceMode |
Erforderlich. Die Art der Teilnahme. |
eventVirtualLocationUrl[] |
Optional. URL, unter der das Ereignis angesehen werden kann. |
eventOrganizer |
Optional. Organisator der Veranstaltung |
eventOrganizerUrl |
Optional. URL des Organisators, der den Termin hostet. |
eventOrganizerType |
Optional. Der Typ des Organisators. |
eventSourceUrl[] |
Erforderlich. URL der Seiten, auf denen die Veranstaltungsinformationen oder -beschreibungen zu finden sind. |
eventState |
Optional. Status des Ereignisses. |
EventCategory
Eine Untergruppe von Veranstaltungskategorien, für die wir die Produkterfahrung anpassen. Hinweis: Es soll keine universelle Ontologie für Veranstaltungen sein.
Optionen | |
---|---|
EVENT_CATEGORY_UNSPECIFIED |
Nicht angegeben. Nicht verwenden. |
EVENT_CATEGORY_CONCERT |
Konzerte |
EVENT_CATEGORY_SPORTS |
Sportveranstaltungen |
EVENT_CATEGORY_THEATRE |
Theateraufführungen |
EVENT_CATEGORY_EXHIBITS |
Ausstellungen |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
Workshops und Kurse |
Entität
Eine Entität mit Bezug zur Veranstaltung
JSON-Darstellung |
---|
{ "id": string, "name": string, "url": string, "entityType": enum ( |
Felder | |
---|---|
id |
Eindeutige ID der Entität in der Datenbank des Partners (optional) |
name |
Name der Entität (Pflichtfeld) |
url |
URL der Webseite, auf der die Entität eindeutig beschrieben wird. Das ist die Webseite für die Entität auf der Website des Partners, falls vorhanden. Verwende für andere öffentliche URLs für die Entität "relevantUrl" in "publicIdentificationData". (optional) |
entityType |
Der Typ der Entität (optional) |
entityRole |
Die Rolle der Entität in der Veranstaltung (optional) |
publicIdentificationData |
Öffentliche Referenzen der Entität (optional) |
EntityType
Der Typ der Entität Hinweis: Es soll keine universelle Ontologie sein.
Enums | |
---|---|
ENTITY_TYPE_UNSPECIFIED |
Nicht angegeben. Nicht verwenden. |
ENTITY_TYPE_PERFORMER |
Die Entität stellt den Künstler oder die Gruppe dar, der bzw. die bei einem Konzert oder einer Veranstaltung auftritt. Nur relevant, wenn die Veranstaltungskategorie CONCERT oder THEATRE ist. |
ENTITY_TYPE_PLAYER |
Die Entität stellt die Sportmannschaft oder den Spieler bei der Veranstaltung dar. Nur relevant, wenn die Veranstaltungskategorie SPORTS ist. |
ENTITY_TYPE_CONCERT_TOUR |
Die Entität stellt die Tour dar, zu der diese Veranstaltung gehört. Nur relevant, wenn die Veranstaltungskategorie CONCERT ist. |
ENTITY_TYPE_SPORTS_SERIES |
Die Entität stellt ein Sportturnier dar, zu dem diese Veranstaltung gehört. Nur relevant, wenn die Veranstaltungskategorie SPORTS ist. |
ENTITY_TYPE_PLAY |
Die Entität stellt die Art der Vorführung dar (z. B. Musik, Comedy oder Ballett), die bei der Veranstaltung dargeboten wird. Nur relevant, wenn die Veranstaltungskategorie THEATRE ist. |
EntityRole
Die Rolle der Entität in der Veranstaltung
Enums | |
---|---|
ENTITY_ROLE_UNSPECIFIED |
Nicht angegeben |
ENTITY_ROLE_HEADLINER |
Die Entität stellt einen Headliner oder Hauptkünstler bei der Veranstaltung dar. |
ENTITY_ROLE_SUPPORTER |
Die Entität stellt einen unterstützenden Künstler bei der Veranstaltung dar, etwa eine Vorband. |
ENTITY_ROLE_HOME_TEAM |
Die Entität stellt die Heimmannschaft bei der (Sport-)Veranstaltung dar. |
ENTITY_ROLE_AWAY_TEAM |
Die Entität stellt die Gastmannschaft bei der (Sport-)Veranstaltung dar. |
PublicIdentificationData
IDs, Webseiten oder andere öffentliche Quellen, die auf eine Entität verweisen
JSON-Darstellung |
---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
Felder | |
---|---|
relevantUrl[] |
Öffentliche URL einer Webseite, die nur für das Thema bestimmt ist. Das können u. a. Seiten auf offiziellen Websites, Discogs, sozialen Netzwerken, Wikipedia oder IMDb sein. Beispiele: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959 oder https://twitter.com/acmilan. (optional) |
musicbrainzId |
Die 36-stellige MusicBrainz-ID von Interpreten oder anderen Musikentitäten, falls zutreffend. Siehe https://musicbrainz.org/doc/MusicBrainz_Identifier. (optional) |
AttendanceMode
Die Art der Teilnahme.
Enums | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED |
Nicht angegeben. |
ONLINE |
Für virtuelle Veranstaltungen |
PHYSICAL |
Für Veranstaltungen |
PHYSICAL_ONLINE_MIXED |
Für physische und virtuelle Veranstaltungen |
OrganizerType
Der Typ des Organisators.
Enums | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
Nicht angegeben. |
PERSON |
Für Organisatoren, die eine Person sind. |
ORGANIZATION |
Für den Organisator, der zu einer Organisation gehört. |
EventState
Status des Ereignisses.
Enums | |
---|---|
EVENT_STATE_UNSPECIFIED |
Nicht angegeben. |
SCHEDULED |
Die Veranstaltung ist geplant. |
RESCHEDULED |
Die Veranstaltung wurde verschoben. |
CANCELLED |
Der Termin wurde abgesagt. |
POSTPONED |
Die Veranstaltung wurde verschoben. |
IntegrationType
Die unterstützte Integrationstiefe
Enums | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
Die Standardeinstellung ist END_TO_END. |
INTEGRATION_TYPE_END_TO_END |
Vollständige Integration, die eine End-to-End-Buchung über Google ermöglicht |
INTEGRATION_TYPE_INVENTORY_ONLY |
Der Buchungsserver muss diese Dienstleistung nicht unterstützen. Es müssen nur Händler, Dienstleistungen und (optional) Verfügbarkeitsdaten gesendet werden. |
PerOrderFee
Gebühren, die einmal pro Bestellung bezahlt werden müssen, unabhängig von der Anzahl der Tickets.
JSON-Darstellung |
---|
{ "deliveryFee": { object ( |
Felder | |
---|---|
deliveryFee |
Eine Gebühr, die je nach Liefermethode variieren kann. |
processingFee |
Eine Gebühr für die Verarbeitung der Zahlungsmethode des Nutzers. |
ToursAndActivitiesContent
Spezifische Inhaltsfelder für Touren und Aktivitäten. Jedes Element im wiederkehrenden Feld muss unabhängig sein, um separates Rendering zu ermöglichen (z. B. als Aufzählungspunkt).
Es wird dringend empfohlen "ToursAndActivitiesContent" für Touren und Aktivitäten auszufüllen, es ist aber kein Pflichtfeld. In allen Feldern wird sowohl die Nur-Text- als auch die HTML-ähnliche Formatierung unterstützt. Unterstützte HTML-ähnliche Formatierungstags:
Wortgruppentags:
, , , : Nur die Tags oben werden unterstützt.
kann für Zeilenumbrüche in Absätzen verwendet werden, mit // lässt sich wichtiger Text hervorheben. Alle anderen Wortgruppentags werden ignoriert.
Alle anderen Tags und benutzerdefinierten Formate sind nicht zulässig und werden entfernt. URLs, Anchor-Tags und Links werden entfernt und Endnutzern nie angezeigt.
Wichtige Hinweise: * Dupliziere keine Daten, die bereits in den Feldern highlights
und exclusion
sowie anderen spezifischeren Feldern in der Dienstleistungsbeschreibung enthalten sind. * Verwende nur die oben genannten Tags. Inhalte innerhalb nicht unterstützter Tags werden entfernt und können die Nutzererfahrung beeinträchtigen.
JSON-Darstellung |
---|
{ "highlights": [ { object ( |
Felder | |
---|---|
highlights[] |
Die für den Nutzer sichtbare Liste der Highlights. |
inclusions[] |
Die für den Nutzer sichtbare Liste der Einschlüsse. |
exclusions[] |
Die für den Nutzer sichtbare Liste der Ausschlüsse. |
mustKnow[] |
Die für den Nutzer sichtbare Liste wichtiger Hinweise. Verwenden Sie sie für Details wie Altersbeschränkungen oder andere Bedingungen, die diesen Dienst ungeeignet machen. |
Standort
Geografische Informationen zu einem Standort
JSON-Darstellung |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
Felder | |
---|---|
placeId |
Die Place ID für einen Ort in der Google Places-Datenbank und auf Google Maps. Weitere Informationen zu Orts-IDs finden Sie unter https://developers.google.com/places/web-service/place-id. Ist sie angegeben, ordnet Google den Standort diesem Ort zu. |
name |
Der Name, die Telefonnummer, die URL und die geografischen Informationen des Standorts werden verwendet, um den Standort Orten zuzuordnen, die bereits in Google Maps vorhanden sind. Dieses Feld ist optional, kann aber in einigen Kontexten erforderlich sein. Eine „Service.location“ ohne Namen wird beispielsweise keiner Geschäftseinheit zugeordnet, auch wenn sie sich an derselben Adresse befindet. (optional) |
telephone |
Die öffentliche Telefonnummer des Standorts, einschließlich der Landesvorwahl und Vorwahl, z. B. +14567891234 (optional) |
url |
Die URL der öffentlichen Website des Standorts (optional) |
geo |
Die geografischen Informationen des Standorts, einschließlich Breitengrad, Längengrad und Adresse (optional) |
locationType |
Der Typ des Standorts. Er muss angegeben werden, wenn dieser Standort zu einer Dienstleistung gehört. |
locationId |
Eindeutige ID des Standorts innerhalb der Dienstleistung. Sie kann verwendet werden, um in anderen Dienstleistungsfeldern auf den Standort zu verweisen. Im benutzerdefinierten Eingabeformular können beispielsweise mehrere Standort-IDs verwendet werden, um Optionen für Abholorte anzugeben. Wenn das Feld festgelegt ist, sollte die ID innerhalb derselben Dienstleistung eindeutig sein. (optional) |
LocationType
Der Typ dieses Standorts
Enums | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
Standorttyp nicht angegeben |
VISITED_LOCATION |
Der Standort, der zum Erbringen der Dienstleistung aufgesucht wird |
START_LOCATION |
Der Standort, an dem diese Dienstleistung beginnt. Er dient auch als MEETING_LOCATION (Treffpunkt). |
END_LOCATION |
Der Standort, an dem diese Dienstleistung endet |
Rating
Die Bewertung für eine Entität
JSON-Darstellung |
---|
{ "value": number, "numberOfRatings": string } |
Felder | |
---|---|
value |
Durchschnittliche Bewertung (erforderlich, wenn "numberOfRatings" > 0 ist). Der Wert muss zwischen 1 und 5 liegen. Er darf nur dann weggelassen werden, wenn "numberOfRatings" null ist. |
numberOfRatings |
Anzahl der Bewertungen, die zur Berechnung des Werts verwendet werden (erforderlich). |
HomeServiceData
Für die Branche „Haushaltsdienstleistungen“ sind zusätzliche Informationen erforderlich.
JSON-Darstellung |
---|
{ "categoryType": string, "jobType": string } |
Felder | |
---|---|
categoryType |
Die übergeordnete Kategorie, zu der diese Haushaltsdienstleistungen gehört. Z. B. Klempner, Elektriker |
jobType |
Die Art der Dienstleistung unter der Kategorie, zu der die angegebene Haushaltsdienstleistung gehört. Beispiel: unclog_drain, install_faucet sind die Arten von Dienstleistungen in der Kategorie „Klempner“. |
VirtualSession
Informationen zu virtuellen/Online-Sitzungen. Z.B. Online-Yogakurs, virtueller Kochkurs usw.
JSON-Darstellung |
---|
{ "sessionInstructions": { object ( |
Felder | |
---|---|
sessionInstructions |
Anleitung zur Einrichtung dieses virtuellen Kurses. Wenn der Partner die Video-URL bei der Buchung nicht angibt, muss in diesem Text angegeben sein, wann die Video-URL mit dem Nutzer geteilt wird. z. B. „Die Zoom-URL wird 30 Minuten vor dem Kurs per E-Mail gesendet.“ (empfohlen) |
sessionRequirements |
Anforderungen für die jeweilige virtuelle Sitzung. Z. B. Yogamatte, Kochutensilien usw. (empfohlen) |
virtualPlatformInfo |
Informationen zur virtuellen Plattform, die in dieser Sitzung verwendet wird. (Zum Aktivieren virtueller Dienste erforderlich) |
isSessionPrerecorded |
Erforderlich. Setzen Sie diesen Wert auf „true“, wenn die virtuelle Sitzung nicht live ist und vorab aufgezeichnet wird. |
VirtualPlatformInfo
Informationen zur Plattform, die für diese virtuelle Sitzung verwendet wird.
JSON-Darstellung |
---|
{ "platform": enum ( |
Felder | |
---|---|
platform |
Für virtuelle Sitzung verwendete Plattform. |
otherPlatformName |
Der Name der Plattform, wenn für die Plattform OTHER festgelegt ist. (Erforderlich, wenn für die Plattform OTHER ausgewählt ist) |
Plattform
Aufzählung zur Angabe, welche virtuelle Plattform vom Händler verwendet wird.
Enums | |
---|---|
PLATFORM_UNSPECIFIED |
nicht in Verwendung. |
FLEXIBLE |
Der Händler kann die Videoplattform flexibel verwenden. |
GOOGLE_HANGOUTS |
Google Hangouts. |
GOOGLE_MEET |
Google Meet-Produkt |
ZOOM |
Zoom Video Communications |
SKYPE |
Skype |
YOUTUBE |
Livestreaming auf YouTube. |
OTHER |
Sollte festgelegt werden, wenn sich die verwendete Videoplattform von den hier genannten unterscheidet. |
DirectMerchantPayment
Informationen dazu, wie der Nutzer direkt beim Händler bezahlen kann, anstatt für die Dienstleistung über RwG im Voraus zu bezahlen.
JSON-Darstellung |
---|
{
"paymentMethods": [
{
object ( |
Felder | |
---|---|
paymentMethods[] |
Nutzern wird empfohlen, nur mit einer der unten aufgeführten Zahlungsmethoden zu bezahlen. |
Methoden |
|
---|---|
|
Erstellt eine neue Dienstleistung (Service ) eines Händlers, der vom angegebenen Aggregator verwaltet wird, und gibt sie zurück |
|
Löscht eine vorhandene Dienstleistung (Service ) eines Händlers, der über den angegebenen Aggregator verwaltet wird. |
|
Aktualisiert eine vorhandene Dienstleistung (Service ) eines Händlers, der vom angegebenen Aggregator verwaltet wird, und gibt sie zurück |