REST Resource: inventory.partners.merchants.services

Ressource: Service

Informationen zu einer Dienstleistung, die vom Händler angeboten wird, z. B. ein Haarschnitt.

JSON-Darstellung 
{
  "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)
  }
}
Felder
name

string

Der Name der Dienstressource im Format partners/{partner_id}/merchants/{merchantId}/services/{serviceId}.
serviceName

string

Der Name der Dienstleistung, z. B. "Herrenschnitt". Eingestellt. Verwende stattdessen "localizedServiceName".
localizedServiceName

object (Text)

Der Name der Dienstleistung, z. B. "Herrenschnitt". Möglicherweise in mehreren Sprachen.
description

string

Die für den Nutzer sichtbare Beschreibung der Dienstleistung. Eingestellt. Verwende stattdessen "localizedDescription".
localizedDescription

object (Text)

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>
Mit diesen Tags können Titel und Untertitel dargestellt werden. Bei <h1>Reiseplan</h1> wird der Inline-Text z. B. als wichtigste Überschrift des Abschnitts angezeigt. Alle HTML-Tags, -Formatierungen oder -Attribute innerhalb der Überschriftentags werden ignoriert. <h1 style=".."> wird z. B. wie <h1> behandelt. Nur reiner Text wird beibehalten.

Absatztag: <p>
Mit diesem Tag kannst du eine detaillierte Einleitung oder bestimmte Inhalte hervorheben. Mit Ausnahme von <br>, <strong> und <em> werden alle Tags, Formatierungen oder Attribute innerhalb der Absatztags ignoriert. Weitere Informationen findest du unten im Abschnitt zu Wortgruppentags.

Listentags: <ul>, <ol>, <li>
Das <ul>-Tag kann gemeinsam mit dem <li>-Tag verwendet werden, um unsortierte Listen anzuzeigen. Für sortierte Listen wird das <ol>-Tag mit <li> kombiniert. So können Checklisten, Zeitpläne oder andere Listen angezeigt werden, die deinen Anwendungsfällen entsprechen.
Beispiel: So können Sie eine Liste der Merkmale einer Kreuzfahrt anzeigen:
<ol>
<li>Wunderschöner Meerblick und die Möglichkeit, mit Wildtieren zu spielen.</li>
<li>Sorgfältig geplante Reisearrangements und ‑dienste.</li>
<li>Garantierter niedrigster Preis.</li>
</ol>
Hinweis: Nur <li>-Unterelemente unter <ul>- oder <ol>-Tags werden konvertiert. Alle anderen untergeordneten Elemente werden entfernt. Außerdem werden Tags, Formatierungen oder Attribute innerhalb der Listentags ignoriert. Nur reiner Text wird beibehalten.

Aufteilungstag: <div>
Alle unterstützten Tags innerhalb der <div>-Tags werden mit den oben angegebenen Regeln geparst. Das <div>-Tag selbst definiert keine Gruppierung und keinen Einzug. Außerdem werden alle Attribute und Formatierungen innerhalb der Tags ignoriert.

Wortgruppentags: <br>, <strong>, <em>:
Nur die drei Tags oben werden unterstützt. <br> kann für Zeilenumbrüche in Absätzen verwendet werden, mit <strong>/<em> lässt sich wichtiger Text hervorheben. Alle anderen Wortgruppentags werden ignoriert.

Nicht unterstützte Tags:

  • <html>-, <header>- und <body>-Tags sind nicht zulässig.
  • Tags, die oben nicht aufgeführt sind, werden nicht unterstützt (z. B. <table> oder <td>).
    URLs, Anchor-Tags und Links werden entfernt und Endnutzern nie angezeigt. Wenn du deine Inhalte mithilfe von Fotos ansprechender gestalten möchtest, verwende bitte das Feld "relatedMedia" unten, um die Foto-URLs zu senden.

Wichtige Hinweise:

  • Verwende nur die oben genannten Tags. Inhalte innerhalb nicht unterstützter Tags werden entfernt und können die Nutzererfahrung beeinträchtigen.
  • Vermeide stark verschachtelte Strukturen. Mehr als drei Überschriftenebenen oder verschachtelte Listen werden nicht empfohlen. Einfache Strukturen sind für Nutzer angenehmer.
  • Wenn die derzeit unterstützten Layouts für deine Anwendungsfälle nicht ausreichen, wende dich bitte an das "Mit Google reservieren"-Team.
  • Maximal werden 32.000 Zeichen empfohlen.
price

object (Price)

Der Preis der Dienstleistung.
priceInterpretation

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

object (SchedulingRules)

Regeln zum Buchen/Stornieren eines Termins
prepaymentType

enum (PrepaymentType)

Gibt an, ob eine Vorauszahlung erforderlich ist, optional möglich ist oder nicht unterstützt wird.
prepaymentTerms

object (PrepaymentTerms)

Bedingungen für die Abwicklung der Vorauszahlung.
form[]
(deprecated)

object (ServiceIntakeForm)

Verworfen. Verwende intakeForm und perTicketIntakeForm.
intakeForm

object (ServiceIntakeForm)

Ein Formular, über das bei der Buchung der Dienstleistung zusätzliche Informationen vom Nutzer angefordert werden. (optional)
perTicketIntakeForm

object (ServiceIntakeForm)

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

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

string

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

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

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

enum (RequireCreditCard)

Gibt an, ob der Nutzer Kreditkartendaten angeben muss, um diese Dienstleistung zu buchen. Dieses Feld kann auf Verfügbarkeitsebene überschrieben werden. (optional)
type

enum (ServiceType)

Der vordefinierte Typ dieser Dienstleistung. (optional)
ticketType[]

object (TicketType)

Arten von Tickets, die für diese Dienstleistung gebucht/gekauft werden können, sofern Tickets unterstützt werden. (optional)
relatedMedia[]

object (RelatedMedia)

Fotos für diese Dienstleistung. Google crawlt und speichert sie, damit sie bestmöglich für Endnutzer dargestellt werden. (optional)
serviceAttributeValueId[]

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

object (WaitlistRules)

Aufnahmeregeln für die Warteliste
ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

Spezifische Zusatzinformationen für die Veranstaltungsticketbranche (optional)
integrationType

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

object (PerOrderFee)

Gebühren auf Bestellebene für den Kauf dieser Dienstleistung (optional)
toursAndActivitiesContent

object (ToursAndActivitiesContent)

Spezifische Inhaltsfelder für Touren und Aktivitäten.
location[]

object (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. - Bei einer Busrundfahrt, deren Teilnehmer sich in einer Hotellobby treffen, bevor sie zum Zielort fahren. Der Besprechungsort muss angegeben werden.
rating

object (Rating)

Nutzerbewertung für diesen Dienst als aggregierter Messwert aller Rezensionen.
homeServiceData

object (HomeServiceData)

Zusätzliche Informationen speziell für die Branche für Dienstleistungen im Haushalt. (optional)
virtualSession

object (VirtualSession)

Optional. Informationen zur virtuellen Sitzung. Er ist erforderlich, um virtuelle Dienste zu aktivieren.
directMerchantPayment

object (DirectMerchantPayment)

Optional. Zusätzliche Informationen, die hinzugefügt werden müssen, wenn der Nutzer für den Dienst direkt an den Händler zahlen muss. WICHTIG: RwG ist an dieser Transaktion nicht beteiligt. Erforderlich, wenn „virtualSession“ definiert ist und der Dienst nicht kostenlos ist oder „prepaymentType“ NICHT auf „REQUIRED“ gesetzt ist.
uriTemplate

object (UriTemplate)

Optional. Eine optionale Vorlage, die angibt, wie Google URLs zu externen Websites generieren soll.

PriceInterpretation

Beschreibt, wie ein Preis interpretiert und dem Nutzer angezeigt werden soll

Optionen
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 (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.
}
Felder
minAdvanceOnlineCanceling

string (int64 format)

Die Mindestzeit in Sekunden, vor der ein Termin online storniert werden kann (optional)
lateCancellationFee
(deprecated)

object (Price)

Die Gebühr, die erhoben wird, wenn ein Termin innerhalb der Mindestzeit storniert wird.
noshowFee
(deprecated)

object (Price)

Die Gebühr, die erhoben wird, wenn ein Nutzer nicht erscheint, ohne zu stornieren.
admissionPolicy

enum (AdmissionPolicy)

Die Einlassrichtlinie für diese Dienstleistung. Ist das Feld nicht festgelegt, wird standardmäßig TIME_STRICT verwendet. (optional)
cancellationPolicy

object (CancellationPolicy)

Stornierungsrichtlinien für Planungsregeln (für "Mögliche Aktivitäten" erforderlich)

Union-Feld min_booking_buffer. Die Dauer (in Sekunden) bis zur Start- oder Endzeit des verfügbaren Slots, bis zu der Buchungen möglich sind.

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. Wenn beide Felder festgelegt sind, wird nur ein Wert ausgewählt und der andere ignoriert. Wir können nicht zuverlässig vorhersagen, welcher Wert ausgewählt wird.

Beispiele:

  • Ein Haarschnitt, der mindestens eine Stunde vor der Startzeit gebucht werden muss: "scheduling_rules{ min_advance_booking: 3600 ...}"

  • Ein Museum, in dem der Eintritt bis 30 Minuten vor Ende der Öffnungszeit möglich ist: "scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}"

  • Eine Kinokarte, die vor Filmbeginn gekauft werden muss: (optional) "scheduling_rules{ ...}" (Feld leer lassen). Für min_booking_buffer ist nur einer der folgenden Werte zulässig:
minAdvanceBooking

string (int64 format)

Die Dauer (in Sekunden) bis zur Startzeit des verfügbaren Slots, bis zu der Buchungen möglich sind.
minBookingBufferBeforeEndTime

string (int64 format)

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

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

object (RefundCondition)

Null oder mehr Erstattungsbedingungen für die Richtlinien

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

string (Duration format)

Zeit vor der Startzeit, bis zu der der Kunde eine Erstattung für einen Teil der in refundPercent angegebenen Kosten für die Dienstleistung erhält. Wenn der Wert auf 0 gesetzt ist (Standardeinstellung), kann die Dienstleistung jederzeit storniert werden.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
refundPercent

integer (uint32 format)

Der Prozentsatz im Bereich von <0 bis 100>, der erstattet werden kann, solange die Buchung mindestens minDurationBeforeStartTime vor der Startzeit der Dienstleistung storniert wird. Wenn der Wert auf 0 gesetzt ist (Standardeinstellung), ist keine Erstattung möglich. Ist er auf 100 gesetzt, kann die Dienstleistung vollständig erstattet werden.

PrepaymentType

Optionen zum Angeben der Vorauszahlungsart

Optionen
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 (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Felder
chargeTiming

enum (ChargeTiming)

Wann die Abbuchung im Verhältnis zum Kaufzeitpunkt erfolgt.
chargeTimeBeforeStartTimeSec

string (int64 format)

Zeit in Sekunden vor Beginn des Dienstes, zu der dem Nutzer die Zahlung in Rechnung gestellt wird. Dieses Feld sollte nur festgelegt werden, wenn „ChargeTiming“ auf „CHARGE_LATER“ gesetzt ist.

ChargeTiming

Enum, mit dem angegeben wird, wann die Abbuchung im Verhältnis zum Kaufzeitpunkt erfolgt.

Enums
CHARGE_TIMING_UNSPECIFIED Nicht verwendet
CHARGE_NOW Dem Kunden wird der Betrag sofort in Rechnung gestellt.
CHARGE_LATER Die Abbuchung erfolgt später.

ServiceIntakeForm

Definiert ein Eingabeformular, über das die vom Händler angebotene Dienstleistung angepasst wird.

JSON-Darstellung 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
Felder
field[]

object (ServiceIntakeFormField)

Felder, die dem Nutzer angezeigt werden.
firstTimeCustomers
(deprecated)

boolean

Ist es auf "true" gesetzt, wird das Formular Neukunden angezeigt. Eingestellt. Diese Funktion wird für Eingabeformulare nicht unterstützt.
returningCustomers
(deprecated)

boolean

Ist es auf "true" gesetzt, wird das Formular Bestandskunden angezeigt. Eingestellt. 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 (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
Felder
id

string

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

enum (FieldType)

Der Typ dieses Felds.
label

string

Der Text, der dem Nutzer für dieses Feld angezeigt wird. Eingestellt. Verwende stattdessen localizedLabel.
localizedLabel

object (Text)

Der Text, der dem Nutzer für dieses Feld angezeigt wird. Das Feld kann in mehreren Sprachen angegeben werden. (erforderlich)
value[]

string

Nur festlegen, wenn der Feldtyp LOCATION_SEARCH ist. Verwende im Feld "location" die "locationId", um den Wert für den Ort anzugeben.
choiceText[]

object (Text)

Nur festlegen, wenn der Feldtyp MULTIPLE_CHOICE, CHECKBOXES oder DROPDOWN ist. Wird verwendet, um mögliche Optionen aufzuzählen.
isRequired

boolean

Gibt an, ob eine Antwort für dieses Feld vom Nutzer erforderlich ist.
allowCustomAnswer

boolean

Gibt an, ob zusätzlich zu den vordefinierten Antworten ein benutzerdefinierter Wert zulässig ist. Das gilt nur, wenn der Feldtyp LOCATION_SEARCH ist. (optional)
additionalOption[]

object (Text)

Zusätzliche Optionen, die zusätzlich zu den angegebenen Werten verfügbar sind. Gilt nur, wenn der Feldtyp LOCATION_SEARCH ist. Zusätzlich zur Liste der angegebenen Standorte kann beispielsweise auch die Option „Ich kontaktiere den Lieferanten später“ verfügbar sein. (optional)
ticketTypeRestrict[]

string

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

object (Text)

Der Hinweistext für die Eingabe, der als Textplatzhalter angezeigt wird. Das gilt nur, wenn der Feldtyp SHORT_ANSWER oder PARAGRAPH ist. (optional)

FieldType

Optionen zum Angeben des Feldtyps

Optionen
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

ServiceType

Vordefinierte Dienstleistungstypen

Optionen
SERVICE_TYPE_UNSPECIFIED Nicht verwendet
SERVICE_TYPE_DINING_RESERVATION Restaurantreservierung
SERVICE_TYPE_FOOD_ORDERING Essensbestellungen, entweder Lieferung oder Abholung oder beides.
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 Dienstleistung, die einen Onlinetermin für einen Kurs oder eine Sitzung anbietet, die vollständig virtuell abgehalten wird. Muss festgelegt werden, wenn die Buchung virtueller Dienstleistungen aktiviert wird.
SERVICE_TYPE_SHOPPING Dienst, mit dem Nutzer beim angegebenen Händler einkaufen können. Es kann sich um Lieferung oder Abholung handeln.

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

string

Anhand der Ticket-ID wird zwischen verschiedenen Tickettypen derselben Dienstleistung unterschieden. Sie muss nur innerhalb einer Dienstleistung eindeutig sein.
shortDescription

string

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

object (Text)

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

object (Price)

Der Preis für ein einzelnes Ticket dieses Typs ohne Steuern. Der Steuersatz der Dienstleistung wird auf die dazugehörigen Tickets angewendet.
perTicketFee

object (PerTicketFee)

Zusätzliche Gebühren für den Kauf dieses Tickets (optional)
priceDisplayType

enum (PriceDisplayType)

Optional. Vordefinierter Preisanzeigetyp für ein einzelnes Ticket dieses Typs.
optionDescription

string

Beschreibung zusätzlicher Optionen für diesen Tickettyp. Eingestellt. Verwende stattdessen "localizedOptionDescription".
localizedOptionDescription

object (Text)

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
. Mit ihnen sollen Optionen mit einem Titel und einer detaillierten Beschreibung angegeben werden, z. B. "Premium-Sitzplätze
Bei dieser Option sitzen Sie in den privaten Logen mit gemütlich gepolsterten Sesseln, privaten Fernsehgeräten und Speisen und Getränken am Platz. Von dort kann das gesamte Spielfeld eingesehen werden."
inventoryType

enum (InventoryType)

Optional. Vordefinierter Inventartyp eines einzelnen Tickets dieses Typs.

PerTicketFee

Gebühren, die für jedes vom Nutzer gekaufte Ticket bezahlt werden müssen

JSON-Darstellung 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
Felder
serviceCharge

object (Price)

Eine zusätzliche Gebühr für eine Dienstleistung.
facilityFee

object (Price)

Eine Gebühr für den Veranstaltungsort/die Einrichtung.
taxes

object (Price)

Steuern pro Ticket.

PriceDisplayType

Gibt das Preisformat an, das auf der Landingpage angezeigt wird.

Dieses Feld wird für Inventar ohne Links ignoriert.

Mit diesem Feld kann auf Google-Plattformen dasselbe Preisformat verwendet werden, das auch auf der Landingpage verwendet wird. Einheitliche Preisformate verbessern die Conversion-Rate und reduzieren Verwirrung.

Enums
PRICE_DISPLAY_TYPE_UNSPECIFIED Der Preisanzeigetyp ist nicht angegeben. Google bestimmt, welches Format angezeigt wird.
PRICE_DISPLAY_TYPE_BASE Der auf der Landingpage angezeigte Preis ist der Basispreis.
PRICE_DISPLAY_TYPE_ALL_IN Der auf der Landingpage angezeigte Preis enthält alle Gebühren und Steuern.

InventoryType

Vordefinierter Inventartyp eines einzelnen Tickets dieses Typs.

Enums
INVENTORY_TYPE_UNSPECIFIED Der Inventartyp ist nicht angegeben.
INVENTORY_TYPE_PRIMARY Primäres Inventar
INVENTORY_TYPE_VERIFIED_RESALE Bestätigtes Inventar für den Weiterverkauf
INVENTORY_TYPE_RESALE Inventar für den Weiterverkauf
INVENTORY_TYPE_AGGREGATOR Aggregatorinventar

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

string

Die URL der Medienquelle. Google crawlt die Fotos, die unter dieser URL gehostet werden.
type

enum (MediaType)

Art der Medienquelle.
localizedCaption

object (Text)

Bildunterschrift des Fotos mit i18n-Unterstützung. Nur Text ist zulässig. Alle HTML-Komponenten werden entfernt. (optional)
attribution

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

string

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.

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

object (Text)

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

string

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

string

ID eines in „Merchant.service_attribute“ definierten Attributs, z.B. „service-type“.
valueId

string

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

integer

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

integer

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

boolean

Wenn dieses Feld auf „true“ gesetzt ist, kann der Nutzer eine zusätzliche Freitextanfrage senden, wenn er sich in die Warteliste für diese Dienstleistung aufnehmen lässt.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Legen Sie Optionen für Gruppen fest, die größer als die festgelegte maxPartySize sind. Lassen Sie dieses Feld leer, wenn größeren Gruppen keine alternativen Optionen zum Eintragen auf eine Warteliste angeboten werden sollen.

UnsupportedPartySizeOption

Optionen für Teilnehmer, die sich außerhalb der Reichweite befinden.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Verfügbare Optionen für Gruppen, die sich außerhalb der Reichweite befinden. Für kind ist nur einer der folgenden Werte zulässig:
callMerchant

object (CallMerchant)

Bei Gruppengrößen, die nicht in den Bereich fallen, können Sie das Unternehmen anrufen. Dem Nutzer wird eine vordefinierte Nachricht angezeigt. Beispiel für angezeigten Text: „Bei mehr als {waitlistRules.max_party_size} Personen müssen Sie das Restaurant unter {phone} anrufen.“ CallMerchant muss festgelegt sein, ist aber leer.

CallMerchant

Dieser Typ hat keine Felder.

Leere Nachricht, die in UnsupportedPartySizeOption verwendet werden soll. Wenn Sie diese Option festlegen, wird Nutzern die Möglichkeit angezeigt, das Unternehmen für eine Buchung anzurufen.

TicketingVerticalSpecificData

Spezifische Zusatzinformationen für die Veranstaltungsticketbranche

JSON-Darstellung 
{
  "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)
  }
}
Felder
eventCategory

enum (EventCategory)

Die Kategorie der Veranstaltung. Sie wird nur festgelegt, wenn die Veranstaltung zu einer der vordefinierten Kategorien gehört. (optional)
eventUrl

string

Die URL der Veranstaltung auf der Website des Partners (optional)
entity[]

object (Entity)

Eine Liste von Entitäten, die sich auf die Veranstaltung beziehen (optional)
eventAttendanceMode

enum (AttendanceMode)

Erforderlich. Die Art der Teilnahme an der Veranstaltung.
eventVirtualLocationUrl[]

string

Optional. URL, unter der sich das Ereignis ansehen lässt.
eventOrganizer

object (Text)

Optional. Der Organisator, der die Veranstaltung hostet.
eventOrganizerUrl

string

Optional. URL des Organisators, der die Veranstaltung hostet.
eventOrganizerType

enum (OrganizerType)

Optional. Der Typ des Organisators.
eventSourceUrl[]

string

Erforderlich. URL der Seiten, auf denen die Ereignisinformationen oder -beschreibungen zu finden sind.
eventState

enum (EventState)

Optional. Status des Ereignisses.
brandName

object (Text)

Optional. Der lokalisierte Markenname.
eventCreator

object (EventCreator)

Optional. Informationen zum Ersteller der Veranstaltung.

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

Entity

Eine Entität mit Bezug zur Veranstaltung

JSON-Darstellung 
{
  "id": string,
  "name": string,
  "url": string,
  "entityType": enum (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
Felder
id

string

Eindeutige ID der Entität in der Datenbank des Partners (optional)
name

string

Name der Entität (Pflichtfeld)
url

string

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

enum (EntityType)

Der Typ der Entität (optional)
entityRole

enum (EntityRole)

Die Rolle der Entität in der Veranstaltung (optional)
publicIdentificationData

object (PublicIdentificationData)

Öffentliche Referenzen der Entität (optional)

EntityType

Der Typ der Entität Hinweis: Es soll keine universelle Ontologie sein.

Optionen
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

Optionen
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[]

string

Ö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

string

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 an der Veranstaltung.

Enums
ATTENDANCE_MODE_UNSPECIFIED Nicht angegeben.
ONLINE Für virtuelle Veranstaltungen.
PHYSICAL Für Präsenzveranstaltungen.
PHYSICAL_ONLINE_MIXED Für Veranstaltungen, die sowohl physisch als auch virtuell stattfinden.

OrganizerType

Der Typ des Organisators.

Enums
ORGANIZER_TYPE_UNSPECIFIED Nicht angegeben.
PERSON Für Organisatoren, die natürliche Personen sind.
ORGANIZATION Für Organisatoren, die eine Organisation sind.

EventState

Status des Ereignisses.

Enums
EVENT_STATE_UNSPECIFIED Nicht angegeben.
SCHEDULED Die Veranstaltung ist geplant.
RESCHEDULED Die Veranstaltung wird verschoben.
CANCELLED Die Veranstaltung wurde abgesagt.
POSTPONED Die Veranstaltung wurde verschoben.

EventCreator

Informationen zum Ersteller der Veranstaltung. Nur relevant für Plattformen, die Ereignisse für von Nutzern erstellte Inhalte enthalten.

JSON-Darstellung 
{
  "name": string
}
Felder
name

string

Optional. Name des Erstellers des Ereignisses. Keine Zeichenbeschränkung.

IntegrationType

Die unterstützte Integrationstiefe

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

object (Price)

Eine Gebühr, die je nach Liefermethode variieren kann.
processingFee

object (Price)

Eine Verarbeitungsgebühr für die 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 (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
Felder
highlights[]

object (Text)

Die für den Nutzer sichtbare Liste der Highlights.
inclusions[]

object (Text)

Die für den Nutzer sichtbare Liste der eingeschlossenen Leistungen.
exclusions[]

object (Text)

Die für den Nutzer sichtbare Liste der ausgeschlossenen Leistungen.
mustKnow[]

object (Text)

Die für den Nutzer sichtbare Liste wichtiger Hinweise. Kann für Angaben wie Altersbeschränkungen oder andere Bedingungen verwendet werden, durch die die Dienstleistung ungeeignet ist.

Location

Geografische Informationen zu einem Standort

JSON-Darstellung 
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
Felder
placeId

string

Die Place ID für einen Ort in der Google Places-Datenbank und auf Google Maps. Weitere Informationen zu Place IDs findest du unter https://developers.google.com/places/web-service/place-id. Ist sie angegeben, ordnet Google den Standort diesem Ort zu.
name

string

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. Ein „Service.location“ ohne Namen wird beispielsweise nicht mit einem Rechtssubjekt abgeglichen, auch wenn sich beide an derselben Adresse befinden. (optional)
telephone

string

Die öffentliche Telefonnummer des Standorts, einschließlich der Landesvorwahl und Vorwahl, z. B. +14567891234 (optional)
url

string

Die URL der öffentlichen Website des Standorts (optional)
geo

object (GeoCoordinates)

Die geografischen Informationen des Standorts, einschließlich Breitengrad, Längengrad und Adresse (optional)
locationType

enum (LocationType)

Der Typ des Standorts. Er muss angegeben werden, wenn der Standort zu einer Dienstleistung gehört.
locationId

string

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 Standort-IDs beispielsweise 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

Optionen
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

number

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

string

Anzahl der Bewertungen, die der Berechnung des Werts zugrunde liegen (erforderlich)

HomeServiceData

Zusätzliche Informationen, die für die Branche „Haushaltsdienstleistungen“ angegeben werden müssen.

JSON-Darstellung 
{
  "categoryType": string,
  "jobType": string
}
Felder
categoryType

string

Die übergeordnete Kategorie, zu der dieser Haushaltsdienst gehört. z.B. Klempner, Elektriker usw.
jobType

string

Der Jobtyp in der Kategorie, zu der der jeweilige haushaltsnahe Dienst gehört. Beispielsweise sind „unclog_drain“ und „install_faucet“ die Jobtypen in der Kategorie „Heizung und Sanitär“.

VirtualSession

Informationen zur virtuellen/Onlinesitzung. Beispiel: Online-Yogakurs, virtueller Kochkurs usw.

JSON-Darstellung 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
Felder
sessionInstructions

object (Text)

Anleitung zum Einrichten dieser virtuellen Klasse. Wenn der Partner die Video-URL nicht mit der Buchung angibt, muss dieser Text enthalten, wann die Video-URL mit dem Nutzer geteilt wird. z. B. „Die Zoom-URL wird 30 Minuten vor Kursbeginn per E-Mail gesendet.“ (empfohlen)
sessionRequirements

object (Text)

Anforderungen für die jeweilige virtuelle Sitzung. z. B. Yogamatte, Kochutensilien usw. (empfohlen)
virtualPlatformInfo

object (VirtualPlatformInfo)

Informationen zur virtuellen Plattform, die in dieser Sitzung verwendet wird. (Erforderlich, um virtuelle Dienste zu aktivieren)
isSessionPrerecorded

boolean

Erforderlich. Legen Sie diesen Wert auf „wahr“ fest, wenn die virtuelle Sitzung nicht live, sondern vorab aufgezeichnet ist.

VirtualPlatformInfo

Informationen zur Plattform, die für diese virtuelle Sitzung verwendet wird.

JSON-Darstellung 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
Felder
platform

enum (Platform)

Plattform, die für die virtuelle Sitzung verwendet wird.
otherPlatformName

object (Text)

Der Name der Plattform, wenn die Plattform auf „ANDERS“ festgelegt ist. (Erforderlich, wenn „Plattform“ auf „ANDERS“ festgelegt ist)

Plattform

Aufzählung, die angibt, welche virtuelle Plattform vom Händler verwendet wird.

Enums
PLATFORM_UNSPECIFIED Nicht verwendet
FLEXIBLE Der Händler kann flexibel entscheiden, welche Videoplattform er verwendet.
GOOGLE_HANGOUTS Google Hangouts
GOOGLE_MEET Google Meet-Produkt
ZOOM Zoom Video Communications
SKYPE Skype.
YOUTUBE Livestreaming auf YouTube
OTHER Muss festgelegt werden, wenn die verwendete Videoplattform von den hier genannten abweicht.

DirectMerchantPayment

Informationen dazu, wie der Nutzer direkt an den Händler zahlen kann, anstatt den Dienst über RwG im Voraus zu bezahlen.

JSON-Darstellung 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
Felder
paymentMethods[]

object (Text)

Wir empfehlen Nutzern, nur über die unten aufgeführten Zahlungsmethoden zu bezahlen.

UriTemplate

Eine Vorlage, in der angegeben wird, wie Google URLs zu externen Websites generieren soll.

JSON-Darstellung 
{
  "uriTemplate": string
}
Felder
uriTemplate

string

Optional. Die URI-Vorlage muss RFC 6570 entsprechen. Weitere Informationen finden Sie unter https://datatracker.ietf.org/doc/html/rfc6570. Unterstützt Level-2-Vorlagen. Diese Parameter werden in die in den jeweiligen Entitäten angegebenen Werte aufgelöst.

5 verfügbare Parameter für den Link zur Reservierung von Essen und Getränken: 1) (erforderlich) {availability_slot_start_seconds} :: wird aus dem Feld „startSec“ im Verfügbarkeitsfeed übernommen 2) (erforderlich) {availability_slot_duration_seconds} :: wird aus dem Feld „durationSec“ im Verfügbarkeitsfeed übernommen 3) (optional) {resources_party_size} :: wird aus dem Feld „partySize“ im Verfügbarkeitsfeed übernommen 4) (optional) {availability_availability_tag} :: wird aus dem Feld „availabilityTag“ im Verfügbarkeitsfeed übernommen 5) (optional) {resources_room_id} :: wird aus dem Feld „roomId“ im Verfügbarkeitsfeed übernommen

Beispiel: 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

Methoden

create

 Erstellt eine neue Dienstleistung (Service) eines Händlers, der vom angegebenen Aggregator verwaltet wird, und gibt sie zurück

delete

 Löscht eine vorhandene Dienstleistung (Service) eines Händlers, der über den angegebenen Aggregator verwaltet wird

patch

 Aktualisiert eine vorhandene Dienstleistung (Service) eines Händlers, der vom angegebenen Aggregator verwaltet wird, und gibt sie zurück