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)
  }
}
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: Zeigen Sie eine Liste der Merkmale einer Kreuzfahrt:
<ol>
<li>Wunderbarer Blick auf das Meer und die Möglichkeit, Wildtiere zu erleben.</li>
<li>Sorgfältig gestaltete Reisebuchungen und Services</li>
<li>Garantierter günstigster Preis</li>
</ol>
Beachten Sie, dass nur <li> Kinder unter <ul> oder <ol> Tags konvertiert werden. 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 von Terminen

prepaymentType

enum (PrepaymentType)

Gibt an, ob eine Vorauszahlung erforderlich, optional oder nicht unterstützt wird.

prepaymentTerms

object (PrepaymentTerms)

Bedingungen für die Vorauszahlung.

form[]
(deprecated)

object (ServiceIntakeForm)

Verworfen. Bitte 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)

Regeln für die Aufnahme in 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 Bustour in der Hotellobby mit anschließender Besichtigung des Besuchs Der Besprechungsort muss angegeben werden.

rating

object (Rating)

Nutzerbewertung für diesen Dienst als aggregierter Messwert über alle Rezensionen.

homeServiceData

object (HomeServiceData)

Zusätzliche Informationen speziell für die Branche zu Haushaltsdienstleistungen. (optional)

virtualSession

object (VirtualSession)

Optional. Informationen zur virtuellen Sitzung. Es ist zum Aktivieren virtueller Dienste erforderlich.

directMerchantPayment

object (DirectMerchantPayment)

Optional. Zusätzliche Informationen, die hinzugefügt werden müssen, wenn der Nutzer für die Dienstleistung direkt beim Händler bezahlen muss. WICHTIGER HINWEIS: RwG ist an dieser Transaktion nicht beteiligt. Es 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

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, während der andere ignoriert wird. 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) ab der letzten Buchung bis zum Beginn des verfügbaren Slots.

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)

Keine oder mehr Erstattungsbedingungen für die Richtlinie.

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 zum Zeitpunkt der Vorauszahlung.

JSON-Darstellung
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Felder
chargeTiming

enum (ChargeTiming)

Zeitpunkt, zu dem die Abbuchung relativ zum Kaufzeitpunkt erfolgt

chargeTimeBeforeStartTimeSec

string (int64 format)

Zeit in Sekunden vor dem Start des Dienstes, die dem Nutzer mit der Zahlung in Rechnung gestellt wird. Dieses Feld sollte nur festgelegt werden, wenn ChargeTiming CHARGE_LATER ist.

ChargeTiming

Aufzählung, die angibt, wann die Belastung in Relation zum Kaufzeitpunkt erfolgt.

Enums
CHARGE_TIMING_UNSPECIFIED Nicht verwendet
CHARGE_NOW Der Betrag wird dem Kunden sofort in Rechnung gestellt.
CHARGE_LATER Dem Kunden wird später der Betrag in Rechnung gestellt.

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

Wird nur festgelegt, wenn der Feldtyp LOCATION_SEARCH ist. Verwende im Feld "location" die "locationId", um den Wert für den Ort anzugeben.

choiceText[]

object (Text)

Wird nur dann festgelegt, wenn der Feldtyp MULTIPLE_CHOICE, CHECKBOXES oder DROPDOWN ist. Wird verwendet, um mögliche Auswahlmöglichkeiten aufzulisten.

isRequired

boolean

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

allowCustomAnswer

boolean

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

additionalOption[]

object (Text)

Zusätzliche Optionen, die zusätzlich zu den angegebenen Werten bereitgestellt werden. Nur zutreffend, wenn der Feldtyp LOCATION_SEARCH ist. Beispiel: Neben der bereitgestellten Standortliste kann auch die Option „Ich kontaktiere den Lieferanten später“ lauten. (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. Dies gilt nur, wenn der Feldtyp SHORT_ANSWER oder PARAGRAPH lautet. (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 Essensbestellung, kann Lieferdienst, 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 Dienst mit Onlineterminen für Kurse oder Sitzungen, die vollständig virtuell sind. Muss festgelegt werden, wenn virtuelle Dienstbuchungen aktiviert werden.
SERVICE_TYPE_SHOPPING Dienst, mit dem Nutzer bei einem bestimmten Händler einkaufen können. Das kann entweder eine Lieferung oder eine 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 (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  }
}
Felder
ticketTypeId

string

Die Ticket-ID wird verwendet, um zwischen verschiedenen Tickettypen derselben Dienstleistung zu unterscheiden, und muss nur innerhalb eines Dienstes 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)

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

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.

taxes

object (Price)

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

Typ dieser 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 Attributs, wie in „Merchant.service_attribute“ definiert, z.B. „service-type“ an.

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

Ist sie auf „true“ gesetzt, kann der Nutzer eine zusätzliche Freitextanfrage senden, wenn er sich auf die Warteliste für diesen Dienst setzt.

aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Legen Sie Optionen für Gruppen fest, die größer sind als der angegebene Wert für „maxPartySize“. Lassen Sie dieses Feld leer, wenn größere Gruppen keine alternative Möglichkeit haben sollen, sich auf eine Warteliste zu setzen.

UnsupportedPartySizeOption

Optionen für Gruppen, die außerhalb der Reichweite liegen.

JSON-Darstellung
{
  "callMerchant": {
    object (CallMerchant)
  }
}
Felder
callMerchant

object (CallMerchant)

Wenn Gruppengrößen außerhalb des Bereichs liegen, kann das Unternehmen angerufen werden. Dem Nutzer wird eine vordefinierte Nachricht angezeigt. Beispieltext, der angezeigt werden soll: „Für Gruppen, die größer als {waitlistRules.max_party_size} sind, ruf bitte das Restaurant unter {phone} an.“ CallMerchant muss festgelegt sein, ist aber leer.

CallMerchant

Leere Nachricht zur Verwendung für „UntitledPartySizeOption“. Wenn Sie diese Einstellung festlegen, sehen Nutzer eine Option, über die sie das Unternehmen anrufen und eine Buchung vornehmen können.

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)
}
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 die Veranstaltung angesehen werden kann.

eventOrganizer

object (Text)

Optional. Organisator, der die Veranstaltung veranstaltet.

eventOrganizerUrl

string

Optional. URL des Organisators, der den Termin veranstaltet.

eventOrganizerType

enum (OrganizerType)

Optional. Der Typ des Organisators.

eventSourceUrl[]

string

Erforderlich. Die URLs der Seiten, auf denen die Veranstaltungsinformationen oder -beschreibungen zu finden sind.

eventState

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

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 physische 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 eine Organisation ist.

EventState

Status des Ereignisses.

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

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 Versandmethode variieren kann.

processingFee

object (Price)

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 (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 Einschlüsse.

exclusions[]

object (Text)

Die für den Nutzer sichtbare Liste der Ausschlüsse.

mustKnow[]

object (Text)

Die für den Nutzer sichtbare Liste wichtiger Hinweise. Kann für Details wie Altersbeschränkungen oder andere Bedingungen verwendet werden, die diesen Dienst ungeeignet machen.

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

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. Beispielsweise wird ein „Service.location“ ohne Namen keiner Geschäftseinheit zugeordnet, auch wenn sie sich unter 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 dieser Standort für einen Dienst angegeben wird.

locationId

string

Eindeutige ID des Standorts innerhalb der Dienstleistung. Sie kann verwendet werden, um in anderen Dienstleistungsfeldern auf den Standort zu verweisen. Beispiel: Im benutzerdefinierten Eingabeformular können 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

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 zur Berechnung des Werts verwendet werden (erforderlich).

HomeServiceData

Für die Branche "Haushaltsdienstleistungen" müssen zusätzliche Informationen angegeben werden.

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

string

Die übergeordnete Kategorie, zu der dieser Dienst zu Hause gehört. Beispiel: Klempner, Elektriker usw.

jobType

string

Die Art der Dienstleistung unter der Kategorie, zu der der angegebene Dienst zu Hause gehört. Beispiel: „unclog_drain“, „install_faucet“ sind die Arten der Dienstleistungen in der Kategorie „Klempner“.

VirtualSession

Informationen zu virtuellen oder Online-Sitzungen. 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 dieses virtuellen Kurses. Wenn der Partner bei der Buchung keine Video-URL 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 verschickt.“ (Empfohlen)

sessionRequirements

object (Text)

Anforderungen für die jeweilige virtuelle Sitzung. Beispiel: Yogamatte, Kochutensilien usw. (empfohlen)

virtualPlatformInfo

object (VirtualPlatformInfo)

Informationen zur in dieser Sitzung verwendeten virtuellen Plattform. (Erforderlich, um virtuelle Dienste zu aktivieren)

isSessionPrerecorded

boolean

Erforderlich. Setzen Sie diesen Wert auf „true“, wenn die virtuelle Sitzung nicht live und 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)

Für virtuelle Sitzungen verwendete Plattform.

otherPlatformName

object (Text)

Der Name der Plattform, wenn für die Plattform OTHER festgelegt wurde. (Erforderlich, wenn als Plattform OTHER 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 auswählen, welche Videoplattform er verwendet.
GOOGLE_HANGOUTS Google Hangouts.
GOOGLE_MEET Google Meet-Produkt.
ZOOM Zoom Video Communications.
SKYPE Skype
YOUTUBE Livestreaming auf YouTube
OTHER Sollte festgelegt werden, wenn die verwendete Videoplattform von der hier genannten abweicht.

DirectMerchantPayment

Informationen dazu, wie der Nutzer direkt an den Händler bezahlen kann, anstatt über RwG im Voraus für die Dienstleistung zu bezahlen.

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

object (Text)

Den Nutzern wird empfohlen, nur mit den unten aufgeführten Zahlungsmethoden zu bezahlen.

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