Package google.maps.booking.v1alpha

Index

AdsAccountLinkingService

Dienst zum Verwalten der Kontoverknüpfung zwischen Google Ads und dem Partner Center.

BookingNotification

Empfängt Benachrichtigungen zu Terminen von externen Planungspartnern. Der Partner muss entweder "UpdateBooking" oder "UpdateOrder" aufrufen, je nachdem, ob er buchungsbasierte RPCs wie "CreateBooking" und "CheckAvailability" oder bestellbasierte RPCs wie "CreateOrder" und "CheckOrderFulfillability" verwendet.

UpdateBooking

rpc UpdateBooking(UpdateBookingRequest) returns (Booking)

Aktualisiert eine vorhandene Bestellung (Booking)

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Order)

Aktualisiert eine vorhandene Bestellung (Order)

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking

Feed

Verarbeitungsstatus für hochgeladene Feeds externer Aggregatoren abrufen

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

Ruft den Status eines zuvor hochgeladenen Feeds vom angegebenen Aggregator ab und gibt ihn zurück

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
ListStatus

rpc ListStatus(ListStatusRequest) returns (ListStatusResponse)

Ruft die Status mehrerer zuvor hochgeladener Händler-, Dienstleistungs- oder Verfügbarkeitsfeeds vom angegebenen Aggregator ab und gibt sie zurück

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking

InvalidationService

Empfängt Anfragen zur Ressourcenannullierung von externen Partnern.

InvalidateResource

rpc InvalidateResource(InvalidateResourceRequest) returns (Empty)

Macht eine vorhandene Ressource ungültig.

Anfragen werden ignoriert, wenn die angeforderte Ressource nicht den Google-Dienst abonniert hat.

Unterstützte Ressourcentypen: – Abholung

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking

InventoryStatus

Inventar und Abgleichsstatus hochgeladener Händler abrufen

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

MerchantStatus von Merchant abrufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
ListMerchantStatuses

rpc ListMerchantStatuses(ListMerchantStatusesRequest) returns (ListMerchantStatusesResponse)

Listet alle MerchantStatus eines Partners auf, die die Filterbedingungen erfüllen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking

InventoryUpdate

Empfängt Inventaraktualisierungen von externen Aggregatoren

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords(BatchDeleteGenericRecordsRequest) returns (Empty)

Löscht Einträge des angegebenen Feedtyps. Führt nur eine einfache Validierung (z. B. eine fehlerhafte Anfrage) durch, anschließend wird sofort eine entsprechende Antwort an den Partner zurückgegeben. Google führt asynchron eine Validierung der Geschäftslogik der Anfrage durch. Dieser Batch-Aufruf garantiert nicht die Atomarität.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
BatchPushGenericRecord

rpc BatchPushGenericRecord(BatchPushGenericRecordRequest) returns (Empty)

Fügt Datensätze des angegebenen Feedtyps ein und/oder aktualisiert sie. Es wird nur eine grundlegende Validierung durchgeführt (z. B. fehlerhafte Anfragen), nach der dem Partner sofort eine entsprechende Antwort zurückgegeben wird. Google führt asynchron eine Validierung der Geschäftslogik der Anfrage durch. Dieser Batch-Aufruf garantiert nicht die Atomarität.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability(BatchReplaceServiceAvailabilityRequest) returns (BatchReplaceServiceAvailabilityResponse)

Ersetzt die Verfügbarkeit (Availability) vorhandener Dienstleistungen (Services). Dieser Batch-Aufruf garantiert nicht die Atomarität. Nur erfolgreich aktualisierte verfügbare Slots werden zurückgegeben.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
CreateMerchant

rpc CreateMerchant(CreateMerchantRequest) returns (Merchant)

Erstellt einen neuen Händler (Merchant), der vom angegebenen Aggregator verwaltet wird, und gibt ihn zurück

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
CreateService

rpc CreateService(CreateServiceRequest) returns (Service)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
DeleteMerchant

rpc DeleteMerchant(DeleteMerchantRequest) returns (Empty)

Löscht einen vorhandenen Händler (Merchant), der vom angegebenen Aggregator verwaltet wird. Alle Dienstleistungen des Händlers und seine Verfügbarkeit werden ebenfalls deaktiviert. Wenn du den Händler später wieder hinzufügst, werden dieselben Dienstleistungen und verfügbaren Slots angezeigt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Empty)

Löscht eine vorhandene Dienstleistung (Service) eines Händlers, der über den angegebenen Aggregator verwaltet wird. Die gesamte Verfügbarkeit der Dienstleistung wird ebenfalls gelöscht.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
ReplaceServiceAvailability

rpc ReplaceServiceAvailability(ReplaceServiceAvailabilityRequest) returns (ServiceAvailability)

Ersetzt die Verfügbarkeit (Availability) einer vorhandenen Dienstleistung (Service) eines Händlers, der vom angegebenen Aggregator verwaltet wird, und gibt sie zurück

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
UpdateMerchant

rpc UpdateMerchant(UpdateMerchantRequest) returns (Merchant)

Aktualisiert einen vorhandenen Händler Merchant, der über den angegebenen Aggregator verwaltet wird, und gibt ihn zurück

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking
UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Service)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking

ActionLinkType

Vordefinierter Aktionstyp für einen ActionLink.

Optionen

EventMetadata

Zusätzliche Informationen zum Aktionslink, die nur für die Veranstaltungsbranche gelten.

Felder
surface

Surface

Vordefinierte Ereignisoberfläche, die mit einem ActionLink verknüpft ist. Diese Option wird nur für die Branche „Ereignisse“ verwendet.

Plattform/Oberfläche

Vordefinierte Ereignisoberfläche, die mit einem ActionLink verknüpft ist. Diese Option wird nur für die Branche „Ereignisse“ verwendet.

Enums
SURFACE_UNSPECIFIED Die Oberfläche ist nicht angegeben.
SURFACE_YOUTUBE Über den Aktionslink kannst du ein Veranstaltungsticket in YouTube buchen.
SURFACE_ADS Der ActionLink ist ein Klick auf eine Anzeige für das Ereignis.

ActionPlatform

Die Plattform, auf der die Aktion ausgeführt wird. Webanwendung ist das allgemeine Fallback. Es wird empfohlen, mindestens einen ActionLink mit ACTION_PLATFORM_WEB_APPLICATION zu verwenden. Links mit Android und iOS als Plattform werden nur im jeweiligen System verwendet.

Optionen
ACTION_PLATFORM_UNSPECIFIED Die Plattform wurde nicht angegeben.
ACTION_PLATFORM_WEB_APPLICATION Die Plattform für die Aktion ist das Web im Allgemeinen.
ACTION_PLATFORM_MOBILE_WEB Die Plattform für die Aktion ist das Web auf Mobilgeräten.
ACTION_PLATFORM_ANDROID Die Plattform für die Aktion ist Android OS.
ACTION_PLATFORM_IOS Die Plattform für die Aktion ist iOS.

Status

Status der Google Ads-Kontoverknüpfung.

Enums
STATE_UNSPECIFIED Unbekannter Status.
LINKED Das Konto ist zwischen dem Partnercenter und dem Google Ads-Portal verknüpft.
PENDING Für das Konto fehlt noch die Genehmigung im Partner Center oder im Google Ads-Portal.
DELETED Kontoverknüpfung wurde gelöscht.
REJECTED Die Anfrage zur Kontoverknüpfung wird entweder vom Partnercenter oder vom Google Ads-Portal abgelehnt.

Hinweis

Hinweise, die dem Nutzer bei der Buchung über „Mit Google reservieren“ angezeigt werden.

Felder
text

Text

Benutzerdefinierte Nachricht, die dem Nutzer bei der Buchung über "Mit Google reservieren" angezeigt wird.

Verfügbarkeit

Ein verfügbarer Slot für die Dienstleistung des Händlers mit der Zeit und Anzahl der Plätze.

Felder
start_time

Timestamp

Startzeit des Slots (Zeitblocks).

duration

Duration

Dauer des Slots.

spots_total

int64

Anzahl der Gesamtplätze und der freien Plätze dieser Verfügbarkeit. Beispiele:

  • Yogakurs mit insgesamt 10 Plätzen, davon 3 gebucht: availability {spots_total: 10, spots_open: 7 ...}
  • Stuhlmassage, komplett ausgebucht: availability {spots_total: 1, spots_open: 0 ...}

Hinweis: Wenn Anfragen mit dem unten definierten Komprimierungsformat für die Verfügbarkeit gesendet werden, werden diese beiden Felder abgeleitet.

  • Für eine Serie sind spots_total=1 und spots_open=1 erforderlich.
  • Eine "ScheduleException" liegt bei spots_total=1 und spots_open=0 vor.
spots_open

int64

Anzahl der freien Plätze.

availability_tag

string

Ein optionaler nicht durchsichtiger String zur Identifizierung dieses verfügbaren Slots. Ist dieses Feld konfiguriert, wird es in Anfragen zum Buchen/Aktualisieren/Stornieren von Terminen aufgenommen.

resources

Resources

Optionale Ressourcen, mit denen dieser verfügbare Slot von anderen unterschieden wird, wenn der Dienstleistung verschiedene Mitarbeiter oder Räume zugewiesen sind.

Beispiel: Ein Yogakurs, der mit zwei Kursleitern angeboten wird:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }
payment_option_id[]

string

Eine Liste mit IDs für die Zahlungsoptionen, die für die Zahlung für diesen Slot verwendet werden können. Die tatsächlichen Zahlungsoptionen werden auf Händlerebene festgelegt und können für mehrere Händler genutzt werden.

Dieses Feld überschreibt alle "payment_option_ids", die in der Dienstleistungsnachricht angegeben werden. Die hier angegebenen "payment_option_ids" müssen NICHT in der Dienstleistungsnachricht enthalten sein. Sie müssen aber auf Händlerebene definiert werden.

recurrence

Recurrence

Die Serieninformationen für die Verfügbarkeit. Sie stellen mehr als eine Startzeit dar. Eine Serie muss Termine für einen Arbeitstag enthalten.

schedule_exception[]

ScheduleException

Gibt an, wann die Dienstleistung nicht verfügbar ist. Wenn du die Anzahl der "schedule_exception"-Nachrichten begrenzen möchtest, kannst du nebeneinanderliegende Ausnahmen zusammenziehen.

deposit

Deposit

Optionale Anzahlung für diese Verfügbarkeit. Überschreibt die Anzahlung auf Dienstleistungsebene, falls eine angegeben wurde.

no_show_fee

NoShowFee

Optionale Gebühr bei Nichterscheinen für diese Verfügbarkeit. Überschreibt die Gebühr bei Nichterscheinen auf Dienstleistungsebene, falls eine angegeben wurde.

prepayment

Prepayment

Optional. Optionale Informationen zur Vorauszahlung für diese Verfügbarkeit.

require_credit_card

RequireCreditCard

Gibt an, ob der Nutzer Kreditkartendaten angeben muss, um diesen verfügbaren Slot zu buchen. Wenn der Wert nicht festgelegt ist, wird er von der Dienstleistungsebene übernommen, sofern er dort festgelegt ist. (optional)

ticket_type_id[]

string

Gibt eine Liste der unterstützten Tickettypen für diesen verfügbaren Slot an. Wenn dieses Feld nicht festgelegt ist, sind alle Tickettypen der übergeordneten Dienstleistung für diesen Slot verfügbar. Die Werte dieses Felds müssen in der übergeordneten Dienstleistung definiert werden. Beispiele:

  • Dienstleistung mit vier Tickettypen: TicketType {ticket_type_id: "adult_1" short_description: "Erwachsene, wochentags"} TicketType {ticket_type_id: "adult_2" short_description: "Erwachsene, Wochenende"} TicketType {ticket_type_id: "youth_1" short_description: "Jugendliche, wochentags"} TicketType {ticket_type_id: "youth_2" short_description: "Jugendliche, Wochenende"}

So wird das Inventar an Wochentagen dargestellt: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. So wird das Inventar am Wochenende dargestellt: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

  • Dienstleistung mit drei Tickettypen: TicketType {ticket_type_id: "adult" short_description: "Erwachsene"} TicketType {ticket_type_id: "youth" short_description: "Jugendliche"} TicketType {ticket_type_id: "senior" short_description: "Senioren"}

Um anzugeben, dass alle drei Tickettypen für diesen Slot verfügbar sind, verwendest du entweder availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} oder "availability {...}". Du darfst "ticket_type_id" dann in diesem Slot nicht festlegen.

(optional)

duration_requirement

DurationRequirement

Die Dauer und/oder Endzeit der Zeitfenster muss angegeben werden. Dieses Feld wird ignoriert, wenn der Slot nicht verfügbar ist. Wird nicht in der Kategorie „Mögliche Aktivitäten“ verwendet. (optional)

scheduling_rule_overrides

SchedulingRuleOverrides

Regeln für die Verfügbarkeitsplanung. Wenn Felder ausgefüllt sind, überschreiben sie alle entsprechenden Planungsregeln (SchedulingRules) auf Dienstleistungsebene.

confirmation_mode

ConfirmationMode

Der Bestätigungsmodus, der beim Buchen dieser Verfügbarkeit verwendet wird. Buchungsanfragen für Verfügbarkeiten mit dem Bestätigungsmodus CONFIRMATION_MODE_SYNCHRONOUS müssen sofort bestätigt oder abgelehnt werden. Buchungsanfragen für Verfügbarkeiten mit dem Bestätigungsmodus CONFIRMATION_MODE_ASYNCHRONOUS müssen entweder sofort abgelehnt oder mit dem Status PENDING erstellt werden.

linkout_required_reason

LinkoutRequiredReason

Optional. Der Grund, warum für diesen Slot ein Linkout erforderlich ist. Wenn festgelegt, muss die Händlerressource für diesen Slot eine gültige LinkoutTemplate haben. (optional)

ConfirmationMode

Die Bestätigungsmodi, die beim Buchen von Verfügbarkeiten verwendet werden.

Optionen
CONFIRMATION_MODE_UNSPECIFIED Der Bestätigungsmodus wurde nicht angegeben. Es wird von einer synchronen Bestätigung ausgegangen.
CONFIRMATION_MODE_SYNCHRONOUS Buchungen für diese Verfügbarkeit werden synchron bestätigt.
CONFIRMATION_MODE_ASYNCHRONOUS Buchungen für diese Verfügbarkeit werden asynchron bestätigt.

DurationRequirement

Dieser Enum gibt an, welche Anforderungen der Nutzer erfüllen muss, um die Dauer/Endzeit der angeforderten Zeiträume zu bestätigen oder aufzurufen.

Enums
DURATION_REQUIREMENT_UNSPECIFIED Die Verarbeitung der Endzeit ist nicht angegeben. Das ist die Standardeinstellung.
DO_NOT_SHOW_DURATION Die Endzeit wird dem Nutzer nicht angezeigt.
MUST_SHOW_DURATION Das Ende muss dem Nutzer angezeigt werden, bevor ein Termin vereinbart werden kann.

LinkoutRequiredReason

Der Grund, warum ein Slot eine Linkout-Erfahrung hat.

Enums
LINKOUT_REQUIRED_REASON_UNSPECIFIED Standardwert: Nicht verwenden, entspricht „Unbekannt“.
PAYMENT_REQUIRED Für die Buchung eines Slots ist eine Zahlung auf der Partnerplattform erforderlich.

Wiederholung

"Recurrence"-Nachrichten sind optional, ermöglichen jedoch eine kompaktere Darstellung verfügbarer Slots, die sich regelmäßig wiederholen. Sie stellen normalerweise den Arbeitsplan eines Tages dar. "ScheduleException"-Nachrichten werden dann verwendet, um gebuchte/nicht verfügbare Zeiträume während des Arbeitstages darzustellen.

Voraussetzungen:

  1. Durch die Erweiterung von verfügbaren Slots oder Serien dürfen KEINE identischen Slots generiert werden. Wenn IDs, "start_time", Dauer und Ressourcen übereinstimmen, werden die Slots als identisch betrachtet.
  2. Das Standardformat für die Verfügbarkeit und Serien dürfen NICHT innerhalb der Slots einer einzelnen Dienstleistung kombiniert werden. Serien bieten sich für Händler/Dienstleistungen mit Terminen an. Das Standardformat ist auf Händler/Dienstleistungen mit Kursen ausgerichtet, die regelmäßig stattfinden.
  3. Serien dürfen nicht länger als 24 Stunden dauern.
Felder
repeat_until

Timestamp

Der Zeitstempel der Zeit (UTC), bis zu der die Verfügbarkeit wiederholt wird.

repeat_every

Duration

Definiert die Zeit zwischen aufeinanderfolgenden verfügbaren Slots.

Beispiel: Eine Verfügbarkeit mit einer Dauer (duration) von 20 Minuten, einer Startzeit (start_time) von 9:00 Uhr und Wiederholungen, die alle 30 Minuten (repeat_every) bis 11:00 Uhr (repeat_until) beginnen, führt zu folgenden Slots: 9:00 bis 9:20 Uhr, 9:30 bis 9:50 Uhr, 10:00 bis 10:20 Uhr, 10:30 bis 10:50 Uhr und 11:00 bis 11:20 Uhr. (Pflichtfeld)

ScheduleException

"ScheduleException"-Nachrichten stellen gebuchte/nicht verfügbare Zeiträume während des Arbeitstages dar. Sie sind Ausnahmen der oben beschriebenen Serien. Wenn Slots gebucht werden, muss die Liste der Ausnahmen mit den Zeiträumen aktualisiert werden, die nun nicht mehr verfügbar sind. Die Serie selbst darf nicht geändert werden.

Felder
time_range

TimeRange

Der Zeitraum der Ausnahme. Alle Slots in der Serie, die mit der Start- und/oder Endzeit dieses festen Zeitraums überlappen, werden als nicht verfügbar angesehen.

Beispiel: Angenommen, für eine Serie sind eine Dauer (duration) von 20 Minuten, eine Startzeit (start_time) von 9:00 Uhr und Wiederholungen, die alle 30 Minuten (repeat_every) bis 11:00 Uhr (repeat_until) beginnen, festgelegt. Hier würde eine Ausnahme (ScheduleException) mit dem Zeitraum (time_range) 9:45 bis 11:00 Uhr dazu führen, dass folgende Slots nicht verfügbar sind: 9:30 bis 9:50 Uhr, 10:00 bis 10:20 Uhr und 10:30 bis 10:50 Uhr.

Da der Zeitraum eine Start- und Endzeit hat, wirkt sich die Ausnahme nicht auf den Slot aus, der um 11:00 Uhr beginnt.

SchedulingRuleOverrides

Planungsregeln auf Verfügbarkeitsebene

Felder
last_bookable_sec

int64

Die Zeit (in Sekunden), bis zu der dieser Slot gebucht werden kann. Der Zeitstempel muss vor dem Wert für "startSec" des Slots liegen, der einzuhalten ist. Wenn Nutzer auch nach der Startzeit noch buchen können, verwende stattdessen "SchedulingRules.min_booking_before_end_time" auf Dienstleistungsebene. Falls vorhanden, werden alle Werte in "min_booking_buffer" der Planungsregeln (SchedulingRules) der Dienstleistung überschrieben.

first_bookable_sec

int64

Die Zeit (in Sekunden), ab der dieser Slot gebucht werden kann. Der Zeitstempel muss vor dem Wert für "startSec" oder "lastBookableSec" (falls angegeben) des Slots liegen.

last_online_cancellable_sec

int64

Falls festgelegt, die letzte Zeit (in Sekunden seit der Unix-Epoche), bis zu der dieser Termin über „Mit Google reservieren“ storniert werden kann. Dieses Feld überschreibt alle Kündigungsregeln auf Dienstleistungsebene. (optional)

BatchDeleteGenericRecordsRequest

Batchanfrage zum Löschen von Einträgen des angegebenen Feedtyps.

Felder
parent

string

Ressourcenname im Format partners/{partner_id}/feeds/{feed_name}.

records[]

GenericDeleteRecord

Zu löschende Einträge. Pro API-Aufruf sind maximal 1.000 Einträge zulässig.

BatchPushGenericRecordRequest

Die Batchanfrage zum Einfügen und/oder Aktualisieren von Einträgen des Feedtyps, der in der Anfrage-URL angegeben ist.

Felder
parent

string

Ressourcenname im Format partners/{partner_id}/feeds/{feed_name}.

records[]

GenericRecord

Einträge, die eingefügt und/oder aktualisiert werden sollen. Pro API-Aufruf sind maximal 1.000 Einträge zulässig.

BatchReplaceServiceAvailabilityRequest

Die Batch-Anfrage zum Ersetzen der verfügbaren Slots mehrerer Dienstleistungen (Service).

Felder
parent

string

Format von partners/{partner_id}.

extended_service_availability[]

ExtendedServiceAvailability

Die erweiterte Verfügbarkeit der Dienstleistung, mit der die vorhandenen verfügbaren Slots ersetzt werden.

BatchReplaceServiceAvailabilityResponse

Die Batch-Antwort zum Ersetzen der verfügbaren Slots mehrerer Dienstleistungen (Service). Nur erfolgreich aktualisierte verfügbare Slots werden zurückgegeben.

Felder
extended_service_availability[]

ExtendedServiceAvailability

Die erfolgreich aktualisierten Nachrichten zur erweiterten Verfügbarkeit der Dienstleistung, mit denen die vorhandenen verfügbaren Slots ersetzt wurden.

Booking

Eine Buchung für einen Inventar-Slot

Felder
name

string

Ressourcenname der Buchung: partners/{partner ID}/bookings/{booking ID}

merchant_id

string

ID des Händlers für den Slot

service_id

string

ID der Dienstleistung des Händlers

start_time

Timestamp

Startzeit des Slots (Zeitblocks).

duration

Duration

Dauer des Slots.

client_information

ClientInformation

Personenbezogene Daten des Kunden, der den Termin bucht

status

BookingStatus

Status der Buchung

payment_information

PaymentInformation

Informationen zu Zahlungstransaktionen, die sich auf die Buchung beziehen.

party_size

int64

Personenzahl der Buchung

BookingFailure

Statusdaten, die Aufschluss darüber geben, warum die asynchrone Verarbeitung einer Buchung fehlgeschlagen ist. Mit "BookingFailure" sollen in erster Linie Fehler in der Geschäftslogik erfasst werden.

Felder
cause

Cause

Der Grund, warum die Buchung fehlgeschlagen ist (Pflichtfeld)

rejected_card_type

CreditCardType

(nur erforderlich, wenn der Grund PAYMENT_ERROR_CARD_TYPE_REJECTED ist)

description

string

In diesem optionalen Feld kann der Partner zusätzliche Angaben zu Debugging-Zwecken machen. (optional)

payment_failure

PaymentFailureInformation

Informationen zu Zahlungsfehlern

Cause

Optionen für Fehlerursachen

Optionen
CAUSE_UNSPECIFIED Standardwert: Nicht verwenden; entspricht "Unbekannter Fehler"
SLOT_UNAVAILABLE Der referenzierte verfügbare Slot ist nicht mehr verfügbar.
SLOT_ALREADY_BOOKED_BY_USER Der Nutzer hat bereits einen Termin für den referenzierten verfügbaren Slot gebucht.
LEASE_EXPIRED Die Lease (falls vorhanden) ist abgelaufen und kann nicht mehr für die angeforderte Buchung verwendet werden.
OUTSIDE_CANCELLATION_WINDOW Aufgrund von Zeitbeschränkungen in den Stornierungsrichtlinien des Händlers ist die angeforderte Stornierung derzeit nicht möglich.
PAYMENT_ERROR_CARD_TYPE_REJECTED Bei der Verarbeitung der Zahlung ist ein Fehler aufgetreten, weil der angegebene Kreditkartentyp vom Händler nicht akzeptiert wurde. Der Kreditkartentyp muss in "rejected_card_type" angegeben werden.
PAYMENT_ERROR_CARD_DECLINED Bei der Verarbeitung der Zahlung ist ein Fehler aufgetreten, weil die angegebene Kreditkarte abgelehnt wurde.
PAYMENT_OPTION_NOT_VALID Bei Paketen oder Mitgliedschaften, die für die Buchung verwendet wurden, ist ein Fehler aufgetreten. Möglicherweise sind sie aufgebraucht oder abgelaufen.
PAYMENT_ERROR Bei der Verarbeitung der Zahlung für diese Buchung ist ein Fehler aufgetreten. Verwende diesen Wert, um einen allgemeinen zahlungsbezogenen Fehler anzugeben, wenn der Fehler keinem bestimmten oben angegebenen Zahlungsfehler entspricht.
USER_CANNOT_USE_PAYMENT_OPTION Der Nutzer darf die angegebene Zahlungsoption nicht verwenden, z. B. ein Nutzer, der zum zweiten Mal den Preis für Neueinsteiger auswählt.
BOOKING_ALREADY_CANCELLED Eine Buchung, die der Nutzer stornieren wollte, ist bereits storniert.
BOOKING_NOT_CANCELLABLE Eine Buchung, die der Nutzer stornieren wollte, kann nicht storniert werden.
OVERLAPPING_RESERVATION Der Nutzer hat eine bestehende Reservierung, die zu nahe bei dieser Reservierung liegt.
USER_OVER_BOOKING_LIMIT Die Buchung ist fehlgeschlagen, weil der Nutzer das Limit für Buchungen pro Nutzer des Aggregators überschritten hat.
PAYMENT_REQUIRES_3DS1

Lege diese Option fest, wenn die Transaktion nach einer abgelehnten Zahlung wiederholt werden soll, diesmal aber nach der 3DS1-Challenge/Response-Authentifizierung. Am Fehlerstatus der aktuellen Transaktion ändert sich dadurch nichts. Die Wiederholung ist ein komplett eigenständiger Vorgang.

Wenn das die Fehlerursache ist, MUSS "payment_failure.3DS1_parameters" festgelegt werden. Andernfalls wird die aktuelle Ursache wie PAYMENT_ERROR behandelt.

PaymentFailureInformation

Informationen zu Zahlungsfehlern

Felder
threeds1_parameters

ThreeDS1Parameters

Parameter, die von einem RwG-Aggregator verwendet werden, um ein 3DS1-Authentifizierungsprotokoll mit dem Nutzer zu initiieren. Wird ignoriert, wenn "BookingFailure.cause" nicht auf PAYMENT_REQUIRES_3DS1 gesetzt ist.

ThreeDS1Parameters

Parameter, über die angefordert wird, dass RwG eine 3DS1-Bestätigung durchführt.

Die Parameter beruhen auf der EMVCo-Beschreibung des 3DS1-Protokolls.

Felder
acs_url

string

Die URL, von der ein Formular geladen wird, das dem Nutzer zur Authentifizierung angezeigt wird.

pa_req

string

Eine "PaymentAuthentication"-Anfrage. Wird an das ACSUrl-Formular gesendet, falls angegeben.

transaction_id

string

Eine vom ACS-Anbieter verwendete Kennung. Wird an das ACSUrl-Formular gesendet, sofern angegeben.

md_merchant_data

string

Händlerdaten Wird an das ACSUrl-Formular gesendet, falls angegeben.

BookingStatus

Status einer Buchung

Optionen
BOOKING_STATUS_UNSPECIFIED Nicht angegeben
CONFIRMED Die Buchung wurde bestätigt.
PENDING_MERCHANT_CONFIRMATION Die Buchung wartet auf die Bestätigung des Händlers, bevor sie in den Status CONFIRMED wechseln kann. Diese Option wird derzeit NICHT unterstützt.
PENDING_CLIENT_CONFIRMATION Die Buchung wartet auf die Bestätigung des Kunden, bevor sie in den Status CONFIRMED wechseln kann. Diese Option wird derzeit NICHT unterstützt.
CANCELED Die Buchung wurde im Namen des Nutzers storniert.
NO_SHOW Der Kunde ist nicht zum Termin erschienen.
NO_SHOW_PENALIZED Der Kunde ist nicht zum Termin erschienen und hat damit gegen die Stornierungsrichtlinien verstoßen.
FAILED Die Buchung konnte aufgrund eines Verarbeitungsfehlers nicht abgeschlossen werden.
DECLINED_BY_MERCHANT Die Buchung wurde vom Händler asynchron abgelehnt.

CallMerchant

Dieser Typ hat keine Felder.

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.

CancellationPolicy

Stornierungsrichtlinien für eine Dienstleistung

Felder
refund_condition[]

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.

Felder
min_duration_before_start_time

Duration

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

refund_percent

uint32

Der Prozentsatz im Bereich von <0 bis 100>, der erstattet werden kann, solange die Buchung mindestens min_duration_before_start_time 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.

ClientInformation

Personenbezogene Daten der Person, die eine Buchung vornimmt

Felder
given_name

string

Vorname des Kunden

family_name

string

Familienname des Kunden

address

PostalAddress

Adresse des Kunden

telephone

string

Telefonnummer des Kunden

email

string

E-Mail-Adresse des Kunden

CreateAdsAccountLinkRequest

Anfragenachricht für AdsAccountLinkingService.CreateAdsAccountLink

Felder
parent

string

Erforderlich. Die übergeordnete Ressource, in der diese Google Ads-Kontoverknüpfung erstellt wird. Dies entspricht der Konto-ID des Partnercenters. Format: partners/{partner}

CreateMerchantRequest

Die Anfrage zum Erstellen eines Händlers (Merchant)

Felder
parent

string

Der Name der übergeordneten Ressource für den Partner, dem dieser Händler gehört, im Format partners/{partner_id}.

merchant_id

string

Die Händler-ID, die für diesen Händler verwendet werden soll.

merchant

Merchant

Der zu erstellende Händler.

CreateServiceRequest

Die Anfrage zum Erstellen einer neuen Dienstleistung (Service)

Felder
parent

string

Der Name der übergeordneten Ressource für den Händler, dem diese Dienstleistung zugeordnet ist, im Format partners/{partner_id}/merchants/{merchant_id}.

service_id

string

Die Dienstleistungs-ID, die für diesen Dienst verwendet werden soll.

service

Service

Der zu erstellende Dienst.

CreditCardRestrictions

Einschränkungen für die von diesem Händler akzeptierten Kreditkartentypen

Felder
credit_card_type[]

CreditCardType

Eine Liste der unterstützten Kreditkarten. Ist das Feld leer, werden keine Kreditkarten unterstützt.

CreditCardType

Ein Kreditkartentyp

Optionen
CREDIT_CARD_TYPE_UNSPECIFIED Nicht verwendet
VISA Visa-Kreditkarte
MASTERCARD Mastercard-Kreditkarte
AMERICAN_EXPRESS American Express-Kreditkarte
DISCOVER Discover-Kreditkarte
JCB JCB-Kreditkarte

DeleteAdsAccountLinkRequest

Anfragenachricht für AdsAccountLinkingService.DeleteAdsAccountLink.

Felder
name

string

Erforderlich. Der Name der zu löschenden Google Ads-Kontoverknüpfung. Format: partners/{partner}/adsAccountLinks/{ads_account_link}

DeleteMerchantRequest

Die Anfrage zum Löschen eines Händlers (Merchant)

Felder
name

string

Der Ressourcenname des zu löschenden Händlers im Format "partners/{partner_id}/merchants/{merchant_id}"

DeleteServiceRequest

Die Anfrage zum Löschen einer Dienstleistung (Service)

Felder
name

string

Der Ressourcenname der zu löschenden Dienstleistung im Format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Deposit

Eine Anzahlung, die der Nutzer zahlen muss oder mit der seine Kreditkarte belastet wird

Felder
deposit

Price

Anzahlungsbetrag

min_advance_cancellation_sec

int64

Wird die Buchung nicht bis zu dieser Zeit storniert, wird die Anzahlung fällig.

deposit_type

PriceType

Definiert, wie die Anzahlung aus der Verfügbarkeit ermittelt wird.

DirectMerchantPayment

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

Felder
payment_methods[]

Text

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

DurationRange

Wrapper für einen Zeitraum, der begrenzt oder unbegrenzt sein kann. Es muss entweder „min_duration“ oder „max_duration“ angegeben werden.

Felder
min_duration

Duration

Mindestdauer.

max_duration

Duration

Maximale Dauer.

EconomicOperator

Informationen zum wirtschaftlichen Betreiber des Dienstleisters.

Felder
text

Text

Erforderlich. Name, Adresse, Telefonnummer und E-Mail-Adresse des Wirtschaftsbeteiligten, definiert als Hersteller, bevollmächtigter Vertreter, Importeur, Händler, Auftragsverarbeiter oder jede andere natürliche oder juristische Person, die Verpflichtungen im Zusammenhang mit der Herstellung, Bereitstellung oder Inbetriebnahme von Produkten unterliegt. Frei formatierte Stringdarstellung des economic_operator. Diese Informationen können formatiert sein mit „ und "\n".

ExtendedServiceAvailability

Eine Liste der Verfügbarkeiten und auf wen/wann sie angewendet werden sollen

Felder
merchant_id

string

In diesem Pflichtfeld muss angegeben werden, zu welchem Händler die Verfügbarkeitsnachrichten unten gehören.

service_id

string

Das ist ein Pflichtfeld, mit dem angegeben wird, zu welchem Dienst die Verfügbarkeitsnachrichten unten gehören.

start_time_restrict

Timestamp

Sofern angegeben, betrachten wir die angegebenen Entitäten für die Verfügbarkeit als vollständige Übersicht von [start_time_restrict, end_time_restrict]. Das heißt, alle vorhandenen Verfügbarkeiten werden gelöscht, wenn die folgende Bedingung erfüllt ist:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Wenn eine Nachricht für die Dauer festgelegt ist, wird die Bedingung weiter eingeschränkt:

  availability.duration == duration_restrict

Wenn eine "resources_restrict"-Nachricht festgelegt ist, wird die Bedingung weiter eingeschränkt:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Diese Felder werden normalerweise verwendet, um eine vollständige Aktualisierung der Verfügbarkeiten in einem bestimmten Zeitraum bereitzustellen.

Wenn "start_time_restrict" festgelegt ist, "end_time_restrict" aber nicht, wird das als immer ab "start_time_restrict" ausgelegt.

end_time_restrict

Timestamp

Wenn "end_time_restrict" festgelegt ist, "start_time_restrict" aber nicht, wird dies als immer bis "end_time_restrict" ausgelegt.

duration_restrict

Duration

Wenn die Dauer festgelegt wird, werden nur die Verfügbarkeiten mit übereinstimmender Dauer aktualisiert.

resources_restrict

Resources

Wenn "resources_restrict" festgelegt wird, werden nur die entsprechenden Ressourcen aktualisiert. Die ID-Felder der Ressourcen müssen alle genau übereinstimmen.

availability[]

Availability

Die neue Liste der Verfügbarkeiten.

FeedStatistics

Statistiken, die während der Verarbeitung eines hochgeladenen Feeds abgerufen werden

Felder
new_items

int64

Neu hinzugefügte Elemente aus diesem Feed. Das können je nach Art des Feeds Händler, Dienstleistungen oder verfügbare Slots sein.

existing_items

int64

Vorhandene Elemente, die bei Bedarf mit neuen Informationen aus dem Feed aktualisiert werden.

deleted_items

int64

Elemente, die in diesem Feed nicht mehr vorhanden sind und daher entfernt wurden.

FeedStatus

Der Status eines Feeds, der von der Plattform des Aggregators hochgeladen wurde

Felder
name

string

Der Name der Ressource "Feed" im Format

  • partners/{partner_id}/feeds/merchants/{file_name}
  • partners/{partner_id}/feeds/services/{file_name}
  • partners/{partner_id}/feeds/availability/{file_name}
state

State

Der Verarbeitungsstatus dieses Feeds.

error_details

string

Für Menschen lesbarer String mit weiteren Details, falls dieser Feed nicht verarbeitet werden konnte.

statistics

FeedStatistics

Statistiken speziell für diesen Feed.

State

Optionen zum Angeben des Verarbeitungsstatus eines Feeds

Optionen
STATE_UNSPECIFIED Standardwert (nicht verwendet)
IN_PROGRESS Der Feed wird noch verarbeitet.
SUCCESS Der Feed wurde verarbeitet.
FAILURE Bei der Verarbeitung des Feeds ist ein Fehler aufgetreten.

FoodOrderingMetadata

Metadaten für Aktionslinks für Essensbestellungen.

Felder
fee_details[]

FeeDetails

Details zu den Gebühren, die dem Nutzer zusätzlich zur Gesamtsumme des Artikels berechnet werden. Wird für verschiedene Arten von Gebühren wie Servicegebühren, Liefergebühren usw. wiederholt.

advance_order_details

AdvanceOrderDetails

Details zum erweiterten Bestellsupport, auch als „Vorab bestellen“ bezeichnet, bei dem Nutzer eine Bestellung später als derzeit ausführen können.

Union-Feld fulfillment_duration_options. Dauer der Abwicklung der Bestellung ab Bestellbestätigung. Bei Bestellungen mit Lieferung: Zeitspanne bis zur Lieferung der Speisen. Bei Bestellungen zum Abholen wird die Zeit genannt, bis das Essen zur Abholung bereit ist. Für fulfillment_duration_options ist nur einer der folgenden Werte zulässig:
fulfillment_lead_time_duration

Duration

Feste Dauer. Beispiel: 30 Min.

fulfillment_lead_time_duration_range

DurationRange

Einen Zeitraum. Beispiele: * 30 Minuten bis 45 Minuten * Mehr als 30 Minuten * Weniger als 50 Minuten

AdvanceOrderDetails

Support für Vorbestellungen.

Felder
is_supported

bool

"True", wenn Vorabbestellungen unterstützt werden. (erforderlich)

FeeDetails

Gebührendetails

Felder
type

FeeType

Gebührentyp. (erforderlich)

fee_amount

FeeAmount

Gebührenbetrag entweder in der Währungseinheit, als Prozentsatz des Warenkorbwerts oder in einer Kombination aus beidem (erforderlich)

FeeAmount

FeeAmount Beispiele: * Pauschalgebühr: 0 € (keine Gebühr), 1,5 € * Pauschalgebühr – Spanne: 1,0 € (Minimum), 3,0 € (Maximum), 5,0–6,0 € * Prozentsatz der Warenkorbgröße: 15,5 %, 10–20 %, 10 % (Minimum), 15 % (Maximum) * Kombination aus Spanne und Prozentsatz: 25,5 % und 2,5 € (Minimum), 25,5 % und 4,5 € (Maximum), 10 % und 1,5–2,5 €, 10,5–20 % und 2,5–3,5 €

Felder
cart_percentage

QuantitativeValue

Gebühr in Prozent des Warenkorbwerts. Es wird ein Bereich (begrenzt und unbegrenzt) oder ein fester Prozentsatz unterstützt. Der Wert muss zwischen 0 und 100 liegen. Beispiele: * Fester Wert 5,5% * Mindestens 5,5% * Höchstens 5,5% * 4,5% bis 5,5%

Union-Feld amount_options. Optionen zum Angeben eines Geldbetrags. Für amount_options ist nur einer der folgenden Werte zulässig:
amount

Money

Fester Betrag. Beispiel: 3,50 €.

amount_range

MoneyRange

Betragsbereich Beispiele: * 3,5 bis 5,5 € * Mindestens 3,5 € * Maximal 5,5 €

amount_unknown

bool

Unbekannter Betrag.

FeeType

Gebührentyp.

Enums
FEE_TYPE_UNSPECIFIED Gebührentyp nicht angegeben.
DELIVERY Für Liefergebühren.
SERVICE Für Servicegebühren.

FulfillmentOption

Die Option für die Abwicklung eines Online-Aktionslinks.

Felder
fulfillment_type

FulfillmentType

Erforderlich. Der Auftragsausführungstyp.

available_day[]

AvailableDay

Erforderlich. Eine Liste der Tage, an denen diese Auftragsausführungsmethode verfügbar ist (vorzugsweise mindestens zwei).

fee_details

FeeDetails

Erforderlich. Gebührendetails für die Auftragsausführungsmethode.

minimum_order

Price

Erforderlich. Mindestbestellwert für die mit dem ActionLink verknüpfte Ausführungsmethode.

AvailableDay

Verfügbarkeit auf Tagesebene.

Felder
fulfillment_date

Date

Erforderlich. Ein verfügbares Datum für eine Ausführungsmethode. Es wird davon ausgegangen, dass sich das Produkt in der Zeitzone des Händlers befindet.

last_ordering_time

Timestamp

Erforderlich. Unix-Zeitstempel. Das letzte Mal, an dem ein Nutzer bis zum fulfillment_date bestellen und Artikel erhalten konnte. Mit anderen Worten: Nach „last_ordering_time“ wird „fulfillment_date“ nicht mehr als verfügbar angezeigt.

Wenn das fulfillment_date beispielsweise 2020-08-10:- ist, bedeutet der Wert für last_ordering_time 2020-08-10 18:00, dass ein Kunde die Bestellung bis 18:00 Uhr am selben Tag aufgeben muss, um seine Bestellung am 10.08.2020 zu erhalten. - Der Wert für last_ordering_time 2020-08-08 20:00 bedeutet, dass ein Kunde die Bestellung am 10.08.2020 bis zwei Tage vorher aufgeben muss, um seine Bestellung zu erhalten.

FeeDetails

Gebührendetails für die mit dem Aktionslink verknüpfte Auftragsausführungsmethode.

Felder
Union-Feld fee_details. Gebührenmodell für die Auftragsausführungsmethode. Für fee_details ist nur einer der folgenden Werte zulässig:
no_fee

NoFee

Für die Auftragsausführungsmethode fallen keine Gebühren an.

base_fee

MinimumFee

Die Grundgebühr für die Auftragsausführung.

fixed_fee

FixedFee

Die mit der Ausführungsmethode verbundene feste Gebühr.

FixedFee

Die für die mit der Aktionsverknüpfung verknüpfte Ausführungsmethode erforderliche feste Gebühr.

Felder
amount

Price

Erforderlich. Der Betrag der festen Gebühr für die Auftragsausführungsmethode.

FulfillmentType

Der Ausführungstyp, der einem Aktionslink zugeordnet ist.

Enums
FULFILLMENT_TYPE_UNSPECIFIED Der Ausführungstyp ist nicht angegeben.
FULFILLMENT_TYPE_DELIVERY Die Art der Auftragsausführung ist Lieferung.
FULFILLMENT_TYPE_PICKUP Die Art der Auftragsausführung ist „Abholung“.

MinimumFee

Die Mindestgebühr, die für die mit dem Aktionslink verknüpfte Auftragsausführungsmethode erforderlich ist.

Felder
base_fee_amount

Price

Erforderlich. Der Grundgebühr für die Auftragsausführungsmethode.

Keine Gebühr

Dieser Typ hat keine Felder.

Für die mit dem Aktionslink verknüpfte Auftragsausführungsmethode fallen keine Gebühren an.

GenericDeleteRecord

Eintrag des in der URL-Anfrage angegebenen Feedtyps, der gelöscht werden soll.

Felder
delete_time

Timestamp

Erforderlich. Anhand dieses Zeitstempels wird die Reihenfolge bestimmt, in der ein Löschen auf das Inventar angewendet wird.

Union-Feld record_type. Verschiedene Feedtypen (ndjson, protobasiert usw.) kapseln Partner können einen vollständigen Datensatz bereitstellen, ähnlich wie in einem Feed oder in der BatchPush API. Partner haben auch die Möglichkeit, nur die wesentlichen Felder eines Eintrags anzugeben, die zur eindeutigen Identifizierung erforderlich sind. Für record_type ist nur einer der folgenden Werte zulässig:
data_record

bytes

Für nicht auf Proto basierende Feeds.

proto_record

Any

Für protobasierte Feeds.

GenericRecord

Eintrag des in der URL-Anfrage angegebenen Feedtyps.

Felder
generation_timestamp

Timestamp

Erforderlich. Dieser Zeitstempel wird verwendet, um die korrekte Reihenfolge der Inventaraktualisierungen sicherzustellen.

Union-Feld record_type. Verschiedene Feedtypen (ndjson, protobasiert usw.) kapseln Für record_type ist nur einer der folgenden Werte zulässig:
data_record

bytes

Für nicht auf Proto basierende Feeds.

proto_record

Any

Für protobasierte Feeds.

GeoCoordinates

Die geografischen Daten eines Standorts, einschließlich Breitengrad, Längengrad und Adresse

Felder
latitude

double

Breitengrad in Grad (optional)

longitude

double

Längengrad in Grad (optional)

Union-Feld addresses. Die Adresse für einen Standort, entweder strukturiert oder unstrukturiert. Für addresses ist nur einer der folgenden Werte zulässig:
address

PostalAddress

Postanschrift des Standorts (bevorzugt).

unstructured_address

string

Als Fallback kann auch eine unstrukturierte Adresse angegeben werden, z. B. "1600 amphitheatre parkway mountain view, ca 94043".

GetAdsAccountLinkRequest

Anfragenachricht für AdsAccountLinkingService.GetAdsAccountLink

Felder
name

string

Erforderlich. Der Name der abzurufenden Google Ads-Kontoverknüpfung. Format: partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

Die Anfrage zum Abrufen eines MerchantStatus

Felder
name

string

Erforderlich. Ressourcenname im Format „partners/{partner_id}/merchants/{merchant_id}/status“.

GetStatusRequest

Die Anfrage zum Abrufen des Status für einen bestimmten Feed, der von der Plattform des Aggregators hochgeladen wurde

Felder
name

string

Der Name der Ressource "Feed" im Format

  • partners/{partner_id}/feeds/merchants/{file_name}
  • partners/{partner_id}/feeds/services/{file_name}
  • partners/{partner_id}/feeds/availability/{file_name}

HomeServiceData

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

Felder
category_type

string

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

job_type

string

Die Art der Dienstleistung unter der Kategorie, zu der der angegebene Dienst zu Hause gehört. Beispielsweise sind „unclog_drain“ und „install_faucet“ die Jobtypen in der Kategorie „Heizung und Sanitär“.

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.

InvalidateResourceRequest

Anfrage zur Ungültigmachung einer Ressource.

Felder
resource_id

string

Der Name der Ressource, die ungültig gemacht werden soll.

Der Name einer Abholressource sollte beispielsweise das Format partners/{partner_id}/pickups/{pickup_id} haben. Implementierungen MÜSSEN im Cache gespeicherte Versionen der identifizierten Ressource entfernen.

LineItem

Eine Position in einer Bestellung – die Buchung einer einzelnen Dienstleistung in einem bestimmten Slot

Felder
service_id

string

ID der Dienstleistung des Händlers.

start_sec

int64

Beginn des Slots in Sekunden der UTC-Zeit seit Unix-Epoche.

duration_sec

int64

Dauer des Slots in Sekunden.

tickets[]

OrderedTickets

Anzahl der Tickets sortiert nach Tickettyp.

price

Price

Der Gesamtpreis dieser Position ohne Steuern.

status

BookingStatus

Der Status der Werbebuchung.

OrderedTickets

Die Anzahl der bestellten Tickets nach Tickettyp

Felder
ticket_id

string

ID eines Tickettyps.

count

int32

Anzahl der für diesen Typ bestellten Tickets.

ListMerchantStatusesRequest

Die Anfrage zum Abrufen einer Liste von MerchantStatus

Felder
parent

string

Erforderlich. Das übergeordnete Element, das dieser Sammlung von Händlerstatus zugewiesen ist. Format: partners/{partner_id}/merchants

page_size

int32

Erforderlich. Die maximale Anzahl der Elemente, die zurückzugeben sind. Der Server kann die Seitengröße jedoch reduzieren.

page_token

string

Optional. Der Wert „nextPageToken“, der gegebenenfalls von einer vorherigen ListMerchantStatusResponse zurückgegeben wurde.

booking_inventory_status_restrict

BookingInventoryStatus

Optional. Optionale Einschränkung, um Ergebnisse nach Buchungsinventarstatus zu filtern.

waitlist_inventory_status_restrict

WaitlistInventoryStatus

Optional. Optionale Einschränkung zum Filtern der Ergebnisse nach dem Status des Wartelisteninventars.

geo_match_restrict

GeoMatchingStatus

Optional. Optionale Einschränkung zum Filtern von Ergebnissen nach dem Status des geografischen Abgleichs.

BookingInventoryStatus

End-to-End-Buchungsinventarstatus

Enums
BOOKING_INVENTORY_STATUS_UNSPECIFIED Nicht angegeben.
NO_VALID_FUTURE_INVENTORY Der Händler hat in den nächsten 30 Tagen kein Buchungsinventar.
HAS_VALID_FUTURE_INVENTORY Der Händler hat Buchungsinventar für die nächsten 30 Tage.

GeoMatchingStatus

Status des geografischen Abgleichs des Händlers.

Enums
GEO_MATCHING_STATUS_UNSPECIFIED Nicht angegeben.
GEO_UNMATCHED Für den Händler gibt es keine geografischen Übereinstimmungen.
GEO_MATCHED Der Händler hat eine geografische Übereinstimmung.

WaitlistInventoryStatus

Umfassender Wartelisteninventarstatus.

Enums
WAITLIST_INVENTORY_STATUS_UNSPECIFIED Nicht angegeben.
NO_VALID_WAITLIST_SERVICE Für den Händler gibt es keine Warteliste, die einen Dienst unterstützt.
HAS_VALID_WAITLIST_SERVICE Der Händler hat einen Dienst, der eine Warteliste unterstützt.

ListMerchantStatusesResponse

Die Antwort auf die Liste MerchantStatus.

Felder
merchant_statuses[]

MerchantStatus

Liste der Händlerstatus, die die Filterbedingungen erfüllen.

next_page_token

string

Token zum Abrufen der nächsten Seite mit Ergebnissen. Ist die Liste leer, gibt es keine Ergebnisse mehr.

ListStatusRequest

Die Anfrage zum Abrufen der Status für mehrere Feeds, die von der Plattform des Aggregators hochgeladen wurden

Felder
name

string

Der Name der Ressource "Feed" im Format

  • partners/{partner_id}/feeds/merchants
  • partners/{partner_id}/feeds/services
  • partners/{partner_id}/feeds/availability
page_size

int32

Die maximale Anzahl der Elemente, die zurückzugeben sind.

page_token

string

Der Wert next_page_token wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.

state_restrict

State

Optionale Einschränkung, um Ergebnisse nach Feedstatus zu filtern.

time_range_restrict

TimeRange

Optionale Einschränkung, um Ergebnisse nach Ober- und Untergrenze zu filtern. Wenn "start_time" nicht festgelegt ist, wird standardmäßig der Beginn der Unixzeit verwendet. Wenn "end_time" nicht festgelegt ist, wird standardmäßig die aktuelle Zeit verwendet.

ListStatusResponse

Die Anfrage zum Abrufen der Status für mehrere Feeds, die von der Plattform des Aggregators hochgeladen wurden

Felder
status[]

FeedStatus

Umgekehrte chronologische Statusliste für hochgeladene Feeds. Die maximale Anzahl der zurückgegebenen Elemente beruht auf dem Feld "page_size" in der Anfrage.

next_page_token

string

Token zum Abrufen der nächsten Seite mit Ergebnissen. Ist die Liste leer, gibt es keine Ergebnisse mehr.

LocalizedString

Instanz eines Strings in einer Sprache

Felder
locale

string

IETF BCP 47-Sprachcode, z. B. "en", "mas", "zh-Hant", "de-CH-1901" (siehe http://www.w3.org/International/article/language-tags/)

value

string

Nachricht in der oben stehenden Sprache (UTF-8).

Location

Geografische Informationen zu einem Standort

Felder
place_id

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

GeoCoordinates

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

location_type

LocationType

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

location_id

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

Merchant

Informationen zu einem Händler, der sich auf der Plattform des Aggregators befindet

Felder
name

string

Der Name der Händlerressource im Format partners/{partner_id}/merchants/{merchant_id}.

merchant_name

string

"merchant_name", "telephone", "url" und "geo" werden verwendet, um Partnerinventar mit Händlern abzugleichen, die bereits in Google Maps vorhanden sind. Diese Informationen werden nicht angezeigt.

Der Name des Händlers.

telephone

string

Die öffentliche Telefonnummer des Händlers, einschließlich Landesvorwahl und Vorwahl, z.B. +14567891234.

url

string

Die URL der öffentlichen Website des Händlers.

geo

GeoCoordinates

Die geografischen Informationen des Händlers, einschließlich Breitengrad, Längengrad und Adresse.

category

string

Die Kategorie des Unternehmens auf der Plattform des Aggregators.

num_bookings_30d
(deprecated)

int64

Dieses Feld wurde eingestellt.

tax_rate_basis_points
(deprecated)

uint32

Der Steuersatz des Händlers in Basispunkten (ein Hundertstel Prozent). Beträgt der Steuersatz beispielsweise 7,5 %, muss das Feld auf 750 gesetzt werden.

Ist das Feld nicht konfiguriert oder auf 0 gesetzt, entspricht der Gesamtpreis, der einem Nutzer für eine von diesem Händler angebotene Dienstleistung berechnet wird, genau dem in "Service.price" angegebenen Preis. Es wird dann davon ausgegangen, dass der Preis der Dienstleistung von den anwendbaren Steuern befreit ist oder diese bereits darin enthalten sind. Steuern werden dem Nutzer nicht als separate Position angezeigt.

Wenn dieses Feld auf einen Wert ungleich null gesetzt ist, setzt sich der Gesamtpreis, der einem Nutzer für eine von diesem Händler angebotene Dienstleistung berechnet wird, aus dem Preis der Dienstleistung und der Steuer zusammen, die anhand des hier angegebenen Steuersatzes berechnet wird. Brüche der kleinsten Währungseinheit (z. B. Brüche eines Cents) werden auf die nächste Ganzzahl (z. B. den nächsten Cent) gerundet. Steuern werden dem Nutzer als separate Position angezeigt.

Dieses Feld wurde eingestellt. Bitte verwende stattdessen "tax_rate".

tax_rate

TaxRate

Der Steuersatz des Händlers. Falls vorhanden, überschreibt dieses Feld das Feld "tax_rate_basis_points", das eingestellt wurde. Bei einer leeren Nachricht (z. B. "tax_rate { }") wird der angewendete Steuersatz auf null zurückgesetzt.

payment_restrictions

PaymentRestrictions

Einschränkungen für die von diesem Händler akzeptierten Zahlungsmethoden. Ist dieses Feld nicht festgelegt, wird davon ausgegangen, dass es keine Einschränkungen gibt.

payment_option[]

PaymentOption

Die Zahlungsoptionen, die für diesen Händler verfügbar sind. Die zulässigen Zahlungsoptionen für die einzelnen Dienstleistungen des Händlers können individuell eingeschränkt werden.

payment_processor_config
(deprecated)

PaymentProcessorConfig

Konfiguration für einen Abwickler tokenisierter Zahlungen, sofern der Händler das unterstützt

tokenization_config

TokenizationConfig

Konfiguration für einen Abwickler tokenisierter Zahlungen, sofern der Händler das unterstützt

terms

Terms

Die spezifischen Nutzungsbedingungen des Händlers, die der Nutzer sieht, wenn er eine Dienstleistung über "Mit Google reservieren" bucht. Die Nutzungsbedingungen des Aggregators werden dem Nutzer immer angezeigt. Sie dürfen hier nicht angegeben werden.

brand_id

string

Ein nicht transparenter String, mit dem die Marke angegeben wird, die Nutzer sehen, wenn die Partner angezeigt werden. In diesem Feld können Partner mit mehreren kundenseitigen Marken Händler für alle Marken im selben Feed angeben.

Eine Marke besteht aus kundenseitigen Eigenschaften wie Name, Logo, Nutzungsbedingungen und Datenschutzerklärung.

Wenn es nur eine kundenseitige Partnermarke gibt, muss das Feld nicht festgelegt werden und kann ignoriert werden.

Wenn der Partner…

nicht mehrere kundenseitige Marken hat? --> Ignoriere das Feld.

mehrere Marken konfiguriert hat?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Achtung: Die meisten Partner müssen dieses Feld nicht festlegen. Soll es verwendet werden, muss sich der Partner mit uns in Verbindung setzen, um separate Marken zu konfigurieren, einschließlich der Standardmarke.

matching_hints

MerchantMatchingHints

Tipps für die Zuordnung eines Händlers zu einem Ort auf Google Maps. Hinweis: Die meisten Partner müssen dieses Feld nicht festlegen. Google ordnet die Händler anhand der Angaben oben Orten auf Google Maps zu. (optional)

service_attribute[]

ServiceAttribute

Definitionen für Attribute, mit denen die Dienstleistungen dieses Händlers beschrieben werden (optional)

waitlist_advisement

Advisement

Optional. Allgemeine Hinweise eines bestimmten Händlers für einen Nutzer, der sich über „Mit Google reservieren“ auf eine Warteliste setzt. Einzelne Textfelder in der Empfehlung sollten auf 100 Byte beschränkt sein.

economic_operator

EconomicOperator

Optional. Informationen zum Wirtschaftstreibenden, die mit diesem Händler verknüpft sind und für die Einhaltung der gesetzlichen Bestimmungen erforderlich sind. (optional)

MerchantMatchingHints

Tipps für die Zuordnung eines Händlers zu einem Ort auf Google Maps

Felder
place_id

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.

MerchantStatus

Der Status eines Händlers auf der Plattform „Mit Google reservieren“.

Felder
name

string

Der Name der Ressource „Händlerstatus“ im Format partners/{partner_id}/merchants/{merchant_id}/status

merchant_name

string

Name des Händlers, der von Partnern angegeben wurde.

input_geo_info

GeoCoordinates

Partner haben geografische Daten des Händlers zur Verfügung gestellt.

processing_status

ProcessingStatus

Verarbeitungsstatus des Händlers.

booking_status

BookingStatus

Status, der sich auf die End-to-End-Buchungsintegration bezieht.

waitlist_status

WaitlistStatus

Status, der sich auf die Wartelistenintegration bezieht.

geo_match

PlaceInfo

Übereinstimmender geografischer Ort dieses Händlers Das Feld ist leer, wenn der Händler keine geografische Zuordnung hat.

local_services_match

LocalServicesMatchInfo

Lokale Dienstleistungen dieses Händlers. Ist leer, wenn es sich nicht um einen Händler für lokale Dienstleistungen handelt oder er keinem Anbieter zugeordnet ist.

direct_urls[]

DirectUrl

Eine Liste von URLs zur Darstellung des Inhalts des aktuellen Händlerinventars. Das bedeutet nicht, dass das Inventar tatsächlich ausgeliefert wird. Die URL kann von den öffentlich sichtbaren URLs abweichen.

BookingStatus

Status, der sich auf die End-to-End-Buchungsintegration bezieht.

Felder
has_valid_future_inventory

bool

„Wahr“, wenn der Händler in den nächsten 30 Tagen Inventar hat. Es ist nicht garantiert, dass Anzeigen für den Händler ausgeliefert werden.

DirectUrl

URL, unter der der Händler angezeigt wird.

Felder
type

UrlType

Typ dieser URL.

url

string

URL, unter der dieser Händler angezeigt werden kann.

UrlType

Typ der angezeigten URL.

Enums
URL_TYPE_UNSPECIFIED Nicht angegeben.
BOOKING End-to-End-Buchungs-URL.
WAITLIST Vollständige Wartelisten-URL.
LOCAL_SERVICES URL für Google Lokale Dienstleistungen

LocalServicesMatchInfo

Die Informationen zu lokalen Dienstleistungen von Google stimmen überein (nur für Anbieter von lokalen Dienstleistungen festgelegt).

Felder
matched_providers[]

MatchedProvider

Übereinstimmende Dienstanbieter Ein Händler kann mit mehreren Dienstanbietern abgeglichen werden.

MatchedProvider

Lokaler Dienstleister.

Felder
customer_id

int64

Externe Kundennummer für Google Lokale Dienstleistungen.

categories[]

string

Lokale Dienstleistungen (Branchen) Beispiel: "Klempner" und „carpet_cleaning“.

PlaceInfo

Informationen zu einem übereinstimmenden Ort.

Felder
name

string

Name des Orts.

formatted_address

string

Formatierte Adresse in der Landessprache.

place_id

string

Google Place-ID dieses Orts Kann verwendet werden, um eine Google Maps-URL zu erstellen oder weitere Details zum Ort abzurufen. Ein Beispiel für die Verwendung finden Sie unter https://developers.google.com/places/web-service/place-id.

ProcessingStatus

Verarbeitungsstatus des Händlers

Enums
PROCESSING_STATUS_UNSPECIFIED Status nicht angegeben.
IN_PROGRESS Der Händler ist bei Madden eingegangen, wird aber noch verarbeitet. Für Händler mit diesem Status ist kein anderer Status angegeben.
COMPLETED Andere Status des Händlers wurden berechnet.

WaitlistStatus

Status, der sich auf die Wartelistenintegration bezieht.

Felder
has_valid_waitlist_service

bool

„True“, wenn der Händler einen Wartelistendienst hat. Es ist nicht garantiert, dass Anzeigen für den Händler ausgeliefert werden.

MoneyRange

Wrapper für einen Bereich von Geldbeträgen, der begrenzt oder unbegrenzt sein kann. Es muss entweder „min_amount“ oder „max_amount“ angegeben werden.

Felder
min_amount

Money

Mindestbetrag

max_amount

Money

Höchstbetrag.

NoShowFee

Eine Gebühr, die einem Nutzer in Rechnung gestellt werden kann, wenn er zu einer Buchung nicht erscheint.

Felder
fee

Price

Der Betrag, der dem Nutzer in Rechnung gestellt werden kann, wenn er zu einer Reservierung nicht erscheint.

fee_type

PriceType

Definiert, wie die Gebühr aus der Verfügbarkeit ermittelt wird.

Order

Eine Bestellung für Dienstleistungstermine bei einem Händler:

Felder
name

string

Ressourcenname der Bestellung: partners/{partner ID}/orders/{order ID}

client_information

ClientInformation

Personenbezogene Daten des Kunden, der die Bestellung aufgibt

payment_information

PaymentInformation

Informationen zu Zahlungstransaktionen, die sich auf die Bestellung beziehen.

merchant_id

string

Die ID des Händlers, zu dem alle Dienstleistungen in dieser Bestellung gehören.

item[]

LineItem

Die Positionen in dieser Bestellung.

OrderOnlineMetadata

Metadaten für einen Link zu einer Online-Aktionsbestellung.

Felder
fulfillment_option[]

FulfillmentOption

Verfügbare Optionen für die Auftragsausführung für einen Link zu einer Onlinebestellung.

PaymentInformation

Zahlungsdetails, die sich auf eine Buchung beziehen

Felder
prepayment_status

PrepaymentStatus

Vorauszahlungsstatus der Buchung. Wenn "prepayment_status" auf PREPAYMENT_PROVIDED oder PREPAYMENT_REFUNDED gesetzt ist, enthält "payment_transaction_id" die zugehörige eindeutige Transaktions-ID.

payment_transaction_id

string

Eindeutige ID für eine Zahlungstransaktion der Buchung. Wenn nicht zutreffend, ist das Feld leer.

PaymentOption

Eine Zahlungsoption, die zum Bezahlen von Dienstleistungen eines Händlers verwendet werden kann. Zahlungsoptionen können für mehrere Händler verwendet werden (z. B. Händler derselben Kette).

Felder
payment_option_id

string

Mit dieser ID wird die Zahlungsoption ermittelt.

Die ID gilt für den gesamten Aggregator. Wenn du einen Wert für mehrere Händler verwendest, können Nutzer mit der entsprechenden Zahlungsoption für Dienstleistungen all dieser Händler bezahlen.

Wird ein Wert für eine Zahlungsoption unter einem Händler aktualisiert, werden auch alle anderen Zahlungsoptionen mit derselben ID unter anderen Händlern aktualisiert. Daher sollten alle Zahlungsoptionen mit derselben ID immer auf identische Werte aktualisiert werden.

name

string

Der Name der Zahlungsoption. Er kann für den Nutzer sichtbar sein.

description

string

Eine Beschreibung der Zahlungsoption. Sie kann für den Nutzer sichtbar sein.

price

Price

Der Preis der Zahlungsoption.

tax_rate

TaxRate

Der Steuersatz für die Zahlungsoption. Falls vorhanden, überschreibt dieses Feld das Feld "tax_rate" für den Händler oder die Dienstleistung. Bei einer leeren Nachricht (z. B. "tax_rate { }") wird der angewendete Steuersatz auf null zurückgesetzt.

payment_option_type

PaymentOptionType

Der Typ der Zahlungsoption. Einmalige Nutzung für Einmalbuchungen, Mehrfachnutzung für Pakete und unbegrenzt für Mitgliedschaften.

session_count

int64

Die Anzahl der Sitzungen, für die die Zahlungsoption verwendet werden kann. Nur gültig für Mehrfachbuchungen/Pakete, bei denen der Wert größer als 1 sein sollte.

purchase_interval

TimeRange

Die Zahlungsoption kann innerhalb dieses Zeitraums erworben werden.

valid_interval

TimeRange

Die Zahlungsoption kann innerhalb dieses Zeitraums verwendet werden (z. B. ein Sonderpreis für Januar 2017). Falls vorhanden, werden hierdurch "valid_duration" und "activation_type" überschrieben.

valid_duration

Duration

Gültigkeitsdauer der Zahlungsoption (z. B. 30-Tage-Mitgliedschaft).

activation_type

ActivationType

Legt fest, wie das Gültigkeitsstartdatum für diese Zahlungsoption ermittelt wird.

user_restriction

UserPurchaseRestriction

Beschränkt die zum Kauf dieser Zahlungsoption berechtigten Nutzer. Kann verwendet werden, um eine Zahlungsoption auf eine Untergruppe von Nutzern zu beschränken. Wenn das Feld nicht festgelegt ist, sind alle Nutzer zum Kauf berechtigt.

ActivationType

Definiert, wie das Startdatum der Gültigkeit ermittelt wird.

Optionen
ACTIVATION_TYPE_UNSPECIFIED Nicht verwendet
ACTIVATION_ON_PURCHASE Die Gültigkeit beginnt mit dem Kauf.
ACTIVATION_ON_FIRST_USE Die Gültigkeit beginnt, wenn die Zahlungsoption zum ersten Mal verwendet wird.

PaymentOptionType

Art der Zahlungsoption

Optionen
PAYMENT_OPTION_TYPE_UNSPECIFIED Nicht verwendet
PAYMENT_OPTION_SINGLE_USE Die Zahlungsoption kann nur einmal verwendet werden.
PAYMENT_OPTION_MULTI_USE Die Zahlungsoption kann verwendet werden, wenn die Anzahl der Sitzungen größer als 0 ist.
PAYMENT_OPTION_UNLIMITED Die Zahlungsoption kann innerhalb des gültigen Zeitraums verwendet werden. Anzahl der Sitzungen wird hier nicht unterstützt.

PaymentProcessorConfig

Eine Konfiguration für einen Zahlungsabwickler, die pro Händler eingerichtet wird

Felder
processor

Processor

Definiert den Zahlungsabwickler, für den diese Konfiguration gilt.

public_key

string

Der Schlüssel, mit dem dieser Händler beim Zahlungsabwickler zugeordnet wird.

Informationen zu Stripe: https://stripe.com/docs/dashboard#api-keys Informationen zu Braintree: https://articles.braintreepayments.com/control-panel/important-gateway-credentials

version

string

Die API-Versionsnummer, die zusammen mit den Zahlungsanforderungen an den Zahlungsabwickler gesendet wird.

Processor

Definiert einen bestimmten Zahlungsabwickler

Optionen
PROCESSOR_UNSPECIFIED Nicht verwendet
PROCESSOR_STRIPE Konfiguration für Zahlungen über Stripe
PROCESSOR_BRAINTREE Konfiguration für Zahlungen über Braintree

PaymentRestrictions

Einschränkungen für die von diesem Händler akzeptierten Zahlungsmethoden

Felder
credit_card_restrictions

CreditCardRestrictions

Einschränkungen für die von diesem Händler akzeptierten Kreditkarten. Wenn dieses Feld nicht festgelegt ist, wird davon ausgegangen, dass alle Kreditkarten zulässig sind. Hinweis: Die Liste der Karten, die von "CreditCardType" unterstützt werden, wird im Laufe der Zeit erweitert. Wenn du das Feld leer lässt, werden also in Zukunft Änderungen erforderlich.

PerOrderFee

Gebühren, die einmal pro Bestellung bezahlt werden müssen, unabhängig von der Anzahl der Tickets

Felder
delivery_fee

Price

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

processing_fee

Price

Eine Verarbeitungsgebühr für die Zahlungsmethode des Nutzers.

PerTicketFee

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

Felder
service_charge

Price

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

facility_fee

Price

Eine Gebühr für den Veranstaltungsort.

taxes

Price

Steuern pro Ticket.

PostalAddress

Adresse eines Kunden oder Unternehmens

Felder
address_country

string

Das Land, angegeben mit seinem Ländercode gemäß ISO 3166-1 ALPHA-2, z.B. „USA“ (erforderlich)

address_locality

string

Der Ort, z. B. "Mountain View" (Pflichtfeld)

address_region

string

Die Region, z. B. "CA". Dieses Feld ist nur in Ländern erforderlich, in denen die Region normalerweise Teil der Adresse ist. (optional)

postal_code

string

Die Postleitzahl, z. B. "94043" (Pflichtfeld)

street_address

string

Die Adresse, z. B. "1600 Amphitheatre Pkwy" (erforderlich)

Vorauszahlung

Eine Zahlung, die dem Nutzer im Rahmen seiner Reservierung in Rechnung gestellt werden kann.

Felder
price_info

PriceInfo

Container für Preisdetails.

PrepaymentStatus

Vorauszahlungsstatus einer Buchung

Optionen
PREPAYMENT_STATUS_UNSPECIFIED Nicht angegeben. Wird standardmäßig auf PREPAYMENT_NOT_PROVIDED gesetzt.
PREPAYMENT_PROVIDED Die Buchungsgebühr wurde im Voraus bezahlt.
PREPAYMENT_NOT_PROVIDED Die Buchungsgebühr wurde nicht im Voraus bezahlt.
PREPAYMENT_REFUNDED Der Status für die Buchungsgebühr war zuvor PREPAYMENT_PROVIDED, die Vorauszahlung wurde aber inzwischen erstattet.

Price

Der Preis für eine Dienstleistung oder eine Gebühr

Felder
price_micros

int64

Der Preis in Mikroeinheiten der Währung. Brüche der kleinsten Währungseinheit (z. B. Brüche eines Cents) werden auf die nächste Ganzzahl (z. B. den nächsten Cent) gerundet. Beispielsweise werden 2,5 Cent auf 3 Cent, 3,5 Cent auf 4 Cent, 0,5 Cent auf 0 Cent und 2,51 Cent auf 3 Cent gerundet.

currency_code

string

Währung des Preises gemäß ISO 4217

pricing_option_tag

string

Ein optionaler, nicht transparenter String für die Preisoption, die dem erweiterten Preis zugewiesen ist.

PriceInfo

Container für Preisdetails.

Felder
price_type

PriceType

Definiert, wie der Preis oder die Preisspanne angewendet wird (pro Person oder fest)

Union-Feld price_options. Bei Preisoptionen kann entweder ein genauer Preis oder eine Spanne angegeben werden. Für price_options ist nur einer der folgenden Werte zulässig:
price

Price

Der Preis für eine Dienstleistung oder eine Gebühr

price_range

PriceRange

Die Ober- und/oder Untergrenze für einen Dienst oder eine Gebühr.

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

PriceRange

Wrapper für einen Geldbetrag, der als unbegrenzt behandelt wird, sofern nicht beide Werte festgelegt sind. Es muss entweder „min_amount“ oder „max_amount“ angegeben werden.

Felder
min_price

Price

Mindestbetrag

max_price

Price

Höchstbetrag. Muss immer größer als „min_price“ sein.

PriceType

Definiert, wie ein Gesamtpreis aus einer Verfügbarkeit ermittelt wird

Optionen
FIXED_RATE_DEFAULT

Der Preis ist ein fester Betrag. Das ist der Standardwert, wenn das Feld nicht festgelegt ist.

Beispiele: eine Anzahlung in Höhe von 50 € für eine Tischreservierung oder 20 €, wenn man nicht zu einem gebuchten Yogakurs erscheint

PER_PERSON

Der angegebene Preis gilt pro Person. Der Gesamtpreis ergibt sich aus der Gruppengröße, die in den Ressourcen als "price_micros * party_size" definiert ist. Für einen PER_PERSON-Preis muss in den Verfügbarkeitsressourcen auch eine Gruppengröße angegeben werden. Andernfalls wird von einer Gruppengröße von einer Person ausgegangen.

Beispiele: 10 € pro Person für Eintrittskarten für ein Museum

QuantitativeValue

Ummantelung für einen numerischen Wert, der ein Bereich oder ein fester Wert sein kann. QuantitativeValue Beispiele: * Singularwert: value: 10.5 * Begrenzter Bereich: value_range {min_value: 5.5, max_value 10.5} * Untere Grenze: value_range {min_value: 5.5} * Obere Grenze: value_range {max_value: 10.5}

Felder
Union-Feld value_options. (erforderlich) value_options kann nur einer der folgenden Werte sein:
value

double

Ein einzelner Wert. Beispiel: 5,6

value_range

RangeValue

Ein Wertebereich, der auch offen oder begrenzt sein kann. Beispiele: * Mindestens 5,5 * Höchstens 5,5 * 5,5 bis 6,5

RangeValue

Wertebereich, in dem min_value < max_value. Es muss mindestens eines der folgenden Elemente angegeben werden: min_value oder max_value.

Felder
min_value

double

Minimalwert.

max_value

double

Höchstwert.

Bewertung

Die Bewertung für eine Entität

Felder
value

double

Durchschnittliche Bewertung (erforderlich, wenn die Anzahl der Bewertungen größer als 0 ist). Der Wert muss zwischen 1 und 5 liegen. Er darf nur dann weggelassen werden, wenn die Anzahl der Bewertungen null ist.

number_of_ratings

uint64

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

RelatedMedia

Fotos für diese Dienstleistung. Google crawlt sie, um sicherzustellen, dass sie korrekt für Endnutzer dargestellt werden. (optional)

Felder
url

string

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

type

MediaType

Typ dieser Medienquelle.

localized_caption

Text

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

attribution

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

Attribution

Quellenangabe für das Foto

Felder
localized_text

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

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.

ReplaceServiceAvailabilityRequest

Die Anfrage zum Ersetzen der Verfügbarkeit einer Dienstleistung (Service)

Felder
service_availability

ServiceAvailability

Die Dienstverfügbarkeit, mit der die vorhandenen Dienstverfügbarkeit ersetzt werden.

RequireCreditCard

Definiert, ob eine Kreditkarte erforderlich ist, um einen Termin zu buchen

Optionen
REQUIRE_CREDIT_CARD_UNSPECIFIED Es wurde nicht explizit angegeben, ob eine Kreditkarte erforderlich ist. Das Verhalten ist mit dem von CONDITIONAL identisch.
REQUIRE_CREDIT_CARD_CONDITIONAL Google benötigt für die Buchung eine Kreditkarte, wenn eine der folgenden Bedingungen erfüllt ist: * Für die Verfügbarkeit ist ein Preis festgelegt und "prepayment_type" ist auf REQUIRED gesetzt. * "no_show_fee" ist festgelegt. * Das Feld für die Anzahlung ist festgelegt.
REQUIRE_CREDIT_CARD_ALWAYS Unabhängig von anderen Feldwerten ist immer eine Kreditkarte erforderlich, um diese Verfügbarkeit zu buchen.

Resources

Ressourcen werden verwendet, um verfügbare Slots voneinander zu unterscheiden, wenn der Dienstleistung verschiedene Mitarbeiter oder Räume zugewiesen sind. Für dieselbe Dienstleistung und denselben Zeitraum können mehrere Slots gleichzeitig verfügbar sein, wenn ihnen unterschiedliche Ressourcen zugewiesen sind.

Felder
staff_id

string

Optionale ID für einen Mitarbeiter, der die Dienstleistung erbringt. Mit diesem Feld wird der Mitarbeiter über alle Händler, Dienstleistungen und verfügbaren Slots hinweg identifiziert. Es muss auch im Laufe der Zeit konstant bleiben, damit eine Zuordnung zu früheren Buchungen möglich ist. Es ist ein Pflichtfeld, wenn "staff_name" festgelegt ist.

staff_name

string

Optionaler Name eines Mitarbeiters, der die Dienstleistung erbringt. Nutzer, die eine Buchung vornehmen, sehen dieses Feld. Es muss für Menschen lesbar sein (kein nicht transparenter String). Es ist ein Pflichtfeld, wenn "staff_id" festgelegt ist.

room_id

string

Eine optionale ID für den Raum, in dem die Dienstleistung erbracht wird. Mit diesem Feld wird der Raum über alle Händler, Dienstleistungen und verfügbaren Slots hinweg identifiziert. Es muss auch im Laufe der Zeit konstant bleiben, damit eine Zuordnung zu früheren Buchungen möglich ist. Es ist ein Pflichtfeld, wenn "room_name" festgelegt ist.

room_name

string

Ein optionaler Name für den Raum, in dem die Dienstleistung erbracht wird. Nutzer, die eine Buchung vornehmen, sehen dieses Feld. Es muss für Menschen lesbar sein (kein nicht transparenter String). (Optional, aber erforderlich, wenn „room_id“ vorhanden ist) Im Bereich „Dining“ sollte ein Raumname nur für Sitzbereiche wie die Bar oder den Patio verwendet werden. Er darf nicht für Menüs zu Festpreisen, besondere Aktivitäten oder andere Werte (z. B. Reservierung oder Abendessen) verwendet werden. Es wird dringend empfohlen, dass dem Standardsitzbereich kein Raum zugeordnet ist.

party_size

int32

Gilt nur für die Gastronomie: Die Anzahl der Personen, für die während dieses Slots Platz ist. Für ein Restaurant kann es mehrere Slots gleichzeitig geben, die alle einen anderen Wert für "party_size" haben, z. B. wenn an einem Tisch 2, 3 oder 4 Gäste Platz haben.

room_description

Text

Optional. Lokalisierte Beschreibung des Chatrooms. Wenn festgelegt, muss ein Standardwert angegeben werden. Es wird empfohlen, auch gängige Sprachen für die Region des Händlers anzugeben. (optional)

SchedulingRules

Die Planungsregeln für eine Dienstleistung

Felder
min_advance_online_canceling

int64

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

late_cancellation_fee
(deprecated)

Price

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

noshow_fee
(deprecated)

Price

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

admission_policy

AdmissionPolicy

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

cancellation_policy

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:

min_advance_booking

int64

Die Dauer (in Sekunden) ab der letzten Buchung bis zum Beginn des verfügbaren Slots.

min_booking_buffer_before_end_time

int64

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

Service

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

Felder
name

string

Der Name der Dienstressource im Format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

service_name

string

Der Name der Dienstleistung, z. B. "Herrenschnitt". Das Feld wurde eingestellt. Verwende stattdessen "localized_service_name".

localized_service_name

Text

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

description

string

Die für den Nutzer sichtbare Beschreibung der Dienstleistung. Das Feld wurde eingestellt. Verwende stattdessen "localized_description".

localized_description

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

Price

Der Preis der Dienstleistung.

price_interpretation

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

SchedulingRules

Regeln zum Buchen/Stornieren von Terminen

prepayment_type

PrepaymentType

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

prepayment_terms

PrepaymentTerms

Bedingungen für die Abwicklung der Vorauszahlung.

form[]
(deprecated)

ServiceIntakeForm

Verworfen. Bitte verwende „intake_form“ und „per_ticket_intake_form“.

intake_form

ServiceIntakeForm

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

per_ticket_intake_form

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)

tax_rate

TaxRate

Der Steuersatz der Dienstleistung. Falls vorhanden, überschreibt dieses Feld einen auf Händlerebene festgelegten Steuersatz (tax_rate). Bei einer leeren Nachricht (z. B. "tax_rate { }") wird der angewendete Steuersatz auf null zurückgesetzt.

payment_option_id[]

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

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)

no_show_fee

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)

require_credit_card

RequireCreditCard

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

type

ServiceType

Der vordefinierte Typ dieser Dienstleistung. (optional)

ticket_type[]

TicketType

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

related_media[]

RelatedMedia

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

service_attribute_value_id[]

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)

waitlist_rules

WaitlistRules

Aufnahmeregeln für die Warteliste

ticketing_vertical_specific_data

TicketingVerticalSpecificData

Spezifische Zusatzinformationen für die Veranstaltungsticketbranche (optional)

integration_type

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.

per_order_fee

PerOrderFee

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

tours_and_activities_content

ToursAndActivitiesContent

Spezifische Inhaltsfelder für Touren und Aktivitäten.

location[]

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

Rating

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

home_service_data

HomeServiceData

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

virtual_session

VirtualSession

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

direct_merchant_payment

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 „virtual_session“ definiert ist und der Dienst nicht kostenlos ist oder „prepayment_type“ NICHT auf REQUIRED gesetzt ist.

uri_template

UriTemplate

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

PrepaymentTerms

Spezifische Informationen zum Zeitpunkt der Vorauszahlung.

Felder
charge_timing

ChargeTiming

Wann die Abbuchung im Verhältnis zum Kaufzeitpunkt erfolgt.

charge_time_before_start_time_sec

int64

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 Dem Kunden wird später der Betrag in Rechnung gestellt.

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.

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 Dienst mit Onlineterminen für Kurse oder Sitzungen, die vollständig virtuell sind. Muss festgelegt werden, wenn virtuelle Servicebuchungen aktiviert werden.
SERVICE_TYPE_SHOPPING Dienst, mit dem Nutzer beim angegebenen Händler einkaufen können. Das kann entweder eine Lieferung oder eine Abholung sein.

ServiceAttribute

Diese Attribute sind von Partnern definierte Kategorien, die die Dienstleistungen eines Händlers beschreiben. Beispielsweise kann eine Bank ein Dienstleistungsattribut "Kontotyp" mit den möglichen Werten "Privat" und "Geschäftlich" definieren, während ein Friseursalon ein Attribut "Art der Leistung" mit den möglichen Werten "Haarschnitt", "Farbe" oder "Styling" definieren kann.

Felder
attribute_id

string

Eine Kennung, mit der dieses Dienstleistungsattribut für einen Händler von anderen unterschieden wird, z. B. „Kontotyp“.

attribute_name

string

Ein für den Nutzer sichtbarer Name für das Attribut, z. B. „Kontotyp“.

value[]

Value

Alle möglichen Werte für dieses Dienstleistungsattribut.

Value

Stellt einen möglichen Wert für ein bestimmtes Dienstleistungsattribut dar

Felder
value_id

string

Eine Kennzeichnung, die diesen Wert für dieses Dienstleistungsattribut unter anderen eindeutig identifiziert, z.B. „persönlich“.

value_name

string

Ein für den Nutzer sichtbarer Name für den Wert, z.B. „Persönlich“.

ServiceAttributeValueId

Gibt einen bestimmten Wert eines Dienstleistungsattributs an, das auf eine Dienstleistung angewendet werden soll

Felder
attribute_id

string

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

value_id

string

ID des Werts für dieses Attribut, z. B. "Haarschnitt". Muss einer "value_id" in der Definition des Dienstleistungsattribut entsprechen.

ServiceAvailability

Eine Liste der Verfügbarkeiten und auf wen/wann sie angewendet werden sollen

Felder
name

string

Der Ressourcenname der Dienstleistung, auf die die Verfügbarkeit angewendet werden soll, im Format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

start_time_restrict

Timestamp

Sofern angegeben, betrachten wir die angegebenen Entitäten für die Verfügbarkeit als vollständige Übersicht von [start_time_restrict, end_time_restrict]. Das heißt, alle vorhandenen Verfügbarkeiten werden gelöscht, wenn die folgende Bedingung erfüllt ist:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Wenn eine Nachricht für die Dauer festgelegt ist, wird die Bedingung weiter eingeschränkt:

  availability.duration == duration_restrict

Wenn eine "resources_restrict"-Nachricht festgelegt ist, wird die Bedingung weiter eingeschränkt:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Diese Felder werden normalerweise verwendet, um eine vollständige Aktualisierung der Verfügbarkeiten in einem bestimmten Zeitraum bereitzustellen.

Wenn "start_time_restrict" festgelegt ist, "end_time_restrict" aber nicht, wird das als immer ab "start_time_restrict" ausgelegt.

end_time_restrict

Timestamp

Wenn "end_time_restrict" festgelegt ist, "start_time_restrict" aber nicht, wird dies als immer bis "end_time_restrict" ausgelegt.

duration_restrict

Duration

Wenn die Dauer festgelegt wird, werden nur die Verfügbarkeiten mit übereinstimmender Dauer aktualisiert.

resources_restrict

Resources

Wenn "resources_restrict" festgelegt wird, werden nur die entsprechenden Ressourcen aktualisiert. Die ID-Felder der Ressourcen müssen alle genau übereinstimmen.

availability[]

Availability

Die neue Liste der Verfügbarkeiten.

ServiceIntakeForm

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

Felder
field[]

ServiceIntakeFormField

Felder, die dem Nutzer angezeigt werden.

first_time_customers
(deprecated)

bool

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

returning_customers
(deprecated)

bool

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

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

FieldType

Der Typ dieses Feldes.

label

string

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

localized_label

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 "location_id", um den Wert für den Ort anzugeben.

choice_text[]

Text

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

is_required

bool

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

allow_custom_answer

bool

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)

additional_option[]

Text

Zusätzliche Optionen, die zusätzlich zu den angegebenen Werten verfügbar sind. 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)

ticket_type_restrict[]

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

Text

Der Eingabehinweis, 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

TaxRate

Ein Steuersatz, der angewendet wird, wenn dem Nutzer eine Dienstleistung in Rechnung gestellt wird. Er kann pro Händler oder pro Dienstleistung festgelegt werden.

Felder
micro_percent

int32

Ein Steuersatz in Millionstel Prozent, was einer Genauigkeit von 6 Dezimalstellen entspricht. Wenn der Steuersatz beispielsweise 7,253 % beträgt, muss dieses Feld auf 7253000 gesetzt werden.

Ist das Feld nicht konfiguriert oder auf 0 gesetzt, entspricht der Gesamtpreis, der einem Nutzer für eine von diesem Händler angebotene Dienstleistung berechnet wird, genau dem in "Service.price" angegebenen Preis. Es wird dann davon ausgegangen, dass der Preis der Dienstleistung von den anwendbaren Steuern befreit ist oder diese bereits darin enthalten sind. Steuern werden dem Nutzer nicht als separate Position angezeigt.

Wenn dieses Feld auf einen Wert ungleich null gesetzt ist, setzt sich der Gesamtpreis, der einem Nutzer für eine von diesem Händler angebotene Dienstleistung berechnet wird, aus dem Preis der Dienstleistung und der Steuer zusammen, die anhand des hier angegebenen Steuersatzes berechnet wird. Brüche der kleinsten Währungseinheit (z. B. Brüche eines Cents) werden auf die nächste Ganzzahl (z. B. den nächsten Cent) gerundet. Steuern werden dem Nutzer als separate Position angezeigt.

Terms

Regeln und Richtlinien, die der Nutzer sieht, wenn er eine Buchung über "Mit Google reservieren" vornehmen möchte.

Felder
url

string

Optional: Die URL zu den Nutzungsbedingungen.

text

string

Der Text, den der Nutzer sieht. Verwenden Sie für neue Integrationen das Feld "localized_text" unten.

localized_text

Text

Der lokalisierte Text, den der Nutzer sieht.

Text

Der Text (eventuell lokalisiert). Einige Textfelder können Markup-Inhalte enthalten.

Felder
value

string

Textwert in einer unbekannten Sprache. Nur erforderlich, wenn localized_value leer ist. Die Sprache für diesen Wert kann vom Partner oder Dienstanbieter abhängen. Es sollte keine bestimmte Sprache vorausgesetzt werden.

localized_value[]

LocalizedString

Textwerte pro Sprache (optional)

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.

Felder
ticket_type_id

string

Die Ticket-ID wird verwendet, um zwischen verschiedenen Tickettypen für denselben Service zu unterscheiden, und muss nur innerhalb eines Service eindeutig sein.

short_description

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

localized_short_description

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

Price

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

per_ticket_fee

PerTicketFee

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

price_display_type

PriceDisplayType

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

option_description

string

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

localized_option_description

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: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "Erwachsener" } localized_option_description { value: "Deutsch" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "Erwachsener" } localized_option_description { value: "Englisch" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "Kind" } localized_option_description { value: "Deutsch" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "Kind" } localized_option_description { value: "Englisch" } }

Beispiel 2: Bei einem mehrstündigen Kajakverleih mit Trockensäcken als Zusatzoption könnte "short_description" auf "3 Stunden" und "option_description" auf "mit Trockensack" oder "ohne Trockensack" gesetzt sein: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 Stunden" } localized_option_description { value: "Deutsch" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 Stunden" } localized_option_description { value: "Englisch" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 Stunden" } localized_option_description { value: "Deutsch" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 Stunden" } localized_option_description { value: "Englisch" } }

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

inventory_type

InventoryType

Optional. Vordefinierter Inventartyp eines einzelnen Tickets dieses Typs.

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 Weiterverkaufsinventar bestätigt
INVENTORY_TYPE_RESALE Wiederverkauf von Inventar
INVENTORY_TYPE_AGGREGATOR Aggregator-Inventar.

PriceDisplayType

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

Bei Inventar ohne Verknüpfung wird dieses Feld ignoriert.

Mit diesem Feld kann auf Google-Plattformen dasselbe Preisformat angezeigt werden, das vom Dienst 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.

TicketingVerticalSpecificData

Spezifische Zusatzinformationen für die Veranstaltungsticketbranche

Felder
event_category

EventCategory

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

event_url

string

Die URL der Veranstaltung auf der Website des Partners (optional)

entity[]

Entity

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

event_attendance_mode

AttendanceMode

Erforderlich. Die Art der Teilnahme an der Veranstaltung.

event_virtual_location_url[]

string

Optional. URL, unter der die Veranstaltung angesehen werden kann.

event_organizer

Text

Optional. Der Organisator, der die Veranstaltung hostet.

event_organizer_url

string

Optional. URL des Organisators, der den Termin veranstaltet.

event_organizer_type

OrganizerType

Optional. Der Typ des Organisators.

event_source_url[]

string

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

event_state

EventState

Optional. Status des Ereignisses.

brand_name

Text

Optional. Der lokalisierte Markenname.

event_creator

EventCreator

Optional. Informationen zum Ersteller des Termins.

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.

Entität

Eine Entität mit Bezug zur Veranstaltung

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 "relevant_url" in "public_identification_data". (optional)

entity_type

EntityType

Der Typ der Entität (optional)

entity_role

EntityRole

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

public_identification_data

PublicIdentificationData

Öffentliche Referenzen der Entität (optional)

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.

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.

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

EventCreator

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

Felder
name

string

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

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.

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.

PublicIdentificationData

IDs, Webseiten oder andere öffentliche Quellen, die auf eine Entität verweisen

Felder
relevant_url[]

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)

musicbrainz_id

string

Die 36-stellige MusicBrainz-ID von Interpreten oder anderen Musikentitäten, falls zutreffend. Siehe https://musicbrainz.org/doc/MusicBrainz_Identifier. (optional)

TimeRange

Ein Zeitraum mit Start und Ende [start_time bis end_time]

Felder
start_time

Timestamp

Die Untergrenze des Zeitraums.

end_time

Timestamp

Die Obergrenze des Zeitraums.

TokenizationConfig

Eine Konfiguration für die Tokenisierung des Zahlungsabwicklers, die pro Händler eingerichtet wird

Felder
tokenization_parameter

map<string, string>

Eine Tokenisierungskonfiguration hat in der Regel einen "tokenization_parameter". Sein Schlüssel ist "gateway" und sein Wert der Name des Abwicklers.

Die übrigen Parameter richten sich nach dem Abwickler. Weitere Informationen findest du in der Dokumentation zu Google Pay.

Beispiel für Braintree: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Beispiel für Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Beispiel für Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

billing_information_format

BillingInformationFormat

Das Zahlungstoken muss die Zahlungsinformationen des Nutzers enthalten, die in Google Pay mit seinem Zahlungsmittel angegeben wurden (siehe oben). Bleibt das Feld leer, entspricht das der Angabe von MIN.

BillingInformationFormat

Der Teil der Rechnungsadresse, der vom Nutzer angefordert wird und im Token enthalten ist. Die Werte aus Optionen entsprechen Parametern in der Google Pay API (siehe https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).

Optionen
BILLING_INFORMATION_FORMAT_UNSPECIFIED Nicht angegeben. Die Standardeinstellung ist MIN.
MIN Name, Ländercode und Postleitzahl (Google Pay-Standardeinstellung)
FULL Name, Adresse, Ort, Region, Ländercode und Postleitzahl

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.

Felder
highlights[]

Text

Die für den Nutzer sichtbare Liste der Highlights.

inclusions[]

Text

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

exclusions[]

Text

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

must_know[]

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.

UnsupportedPartySizeOption

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

Felder
Union-Feld kind. Verfügbare Optionen für Partys, die außerhalb der Reichweite liegen. Für kind ist nur einer der folgenden Werte zulässig:
call_merchant

CallMerchant

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

UpdateAdsAccountLinkRequest

Anfragenachricht für AdsAccountLinkingService.UpdateAdsAccountLink

Felder
update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder.

UpdateBookingRequest

Anfrage zur Aktualisierung einer Buchung (google.maps.booking.v1alpha.Booking)

Felder
update_mask

FieldMask

Feldmaske aller Buchungsfelder, die aktualisiert werden sollen

booking

Booking

Die zu aktualisierende Buchung

booking_failure

BookingFailure

Wenn die Verarbeitung einer asynchron bestätigten Buchungsanfrage fehlschlägt und der Buchungsstatus zu FAILED geändert wird, sollte in diesem Feld der Fehler in der Geschäftslogik angezeigt werden. Beispielsweise kann der Nutzer zu dieser Zeit schon eine Reservierung haben. Das Feld darf nur beim Aktualisieren des Buchungsstatus auf FAILED gesetzt werden. Ansonsten wird es ignoriert.

UpdateMerchantRequest

Die Anfrage zum Aktualisieren eines Händlers (Merchant)

Felder
merchant

Merchant

Die neuen Händlerdaten

update_mask

FieldMask

Die Felder, die für den Händler aktualisiert werden sollen.

UpdateOrderRequest

Anfrage zur Aktualisierung einer Bestellung (google.maps.booking.v1alpha.Order)

Felder
update_mask

FieldMask

Feldmaske aller Bestellfelder, die aktualisiert werden sollen

order

Order

Die zu aktualisierende Bestellung

UpdateServiceRequest

Die Anfrage zum Aktualisieren einer Dienstleistung (Service)

Felder
service

Service

Die neuen Dienstdaten.

update_mask

FieldMask

Die Felder, die für die Dienstleistung aktualisiert werden sollen.

UriTemplate

Eine Vorlage, die angibt, wie Google URLs zu einer externen Website generieren soll.

Felder
uri_template

string

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

5 verfügbare Parameter für Linkout zum Restaurantreservierung: 1) (erforderlich) {availability_slot_start_seconds} :: ausgefüllt aus dem Feld „start_sec“ im Verfügbarkeitsfeed 2) (erforderlich) {availability_slot_duration_seconds} :: ausgefüllt aus dem Feld „duration_sec“ im Verfügbarkeitsfeed 3) (optional) {resources_party_size} :: aus dem Feld „availability_tag“ im Verfügbarkeitsfeed: „availability_id“ im Verfügbarkeitsfeed: „availability_id“

Beispielverwendung: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&amp;num_guests=2

UserPurchaseRestriction

Beschränkt die zum Kauf einer Zahlungsoption berechtigten Nutzer.

Felder
new_to_merchant

bool

Eine Zahlungsoption, die nur von Nutzern erworben werden kann, die noch nie bei demselben Händler etwas gekauft haben.

new_to_payment_option

bool

Eine Zahlungsoption, die nur von Nutzern erworben werden kann, die diese Zahlungsoption noch nie zuvor gekauft haben.

VirtualSession

Informationen zu virtuellen oder Online-Sitzungen. Beispiel: Online-Yogakurs, virtueller Kochkurs usw.

Felder
session_instructions

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 dem Kurs per E-Mail verschickt.“ (Empfohlen)

session_requirements

Text

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

virtual_platform_info

VirtualPlatformInfo

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

is_session_prerecorded

bool

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.

Felder
platform

Platform

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

other_platform_name

Text

Der Name der Plattform, wenn die Plattform auf „ANDERS“ festgelegt ist. (Erforderlich, wenn „Plattform“ auf „SONST“ 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 Sollte festgelegt werden, wenn die verwendete Videoplattform von der hier genannten abweicht.

WaitlistRules

Aufnahmeregeln für die Warteliste

Felder
min_party_size

int32

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.

max_party_size

int32

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.

supports_additional_request

bool

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.

above_max_party_size_options[]

UnsupportedPartySizeOption

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