REST Resource: inventory.partners.merchants.services

Zasób: usługa

Informacje o usłudze świadczonej przez sprzedawcę, np. strzyżenie.

Zapis JSON 
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
Pola
name

string

Nazwa zasobu usługi w formacie partners/{partner_id}/merchants/{merchantId}/services/{serviceId}.
serviceName

string

Nazwa usługi, np. „Strzyżenie męskie”. Wycofany. Zamiast niego używaj nazwy usługi w języku docelowym.
localizedServiceName

object (Text)

Nazwa usługi, np. „Strzyżenie męskie”. Prawdopodobnie w kilku lokalizacjach.
description

string

Opis usługi widoczny dla użytkownika. Wycofano, użyj zamiast tego localizedDescription.
localizedDescription

object (Text)

Opis usługi widoczny dla użytkownika.

To pole obsługuje formatowanie w postaci zwykłego tekstu i w formacie HTML. W przeciwieństwie do zwykłych sekcji możesz tu tworzyć niestandardowe układy za pomocą nagłówków, akapitów, list i niektórych tagów fraz. Aby zapewnić użytkownikom jak najlepsze wrażenia, przeczytaj uważnie poniższe instrukcje i notatki.

Obsługiwane tagi formatowania podobne do tagów HTML:

Tagi nagłówka: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Tagi nagłówka można używać do wyświetlania tytułów i podtytułów. Na przykład kod <h1>Itinerary</h1> spowoduje wyświetlenie tekstu wstawianego jako najważniejszy nagłówek sekcji. Pamiętaj, że wszystkie wewnętrzne tagi HTML, style i atrybuty zostaną zignorowane. Na przykład element <h1 style=".."> będzie traktowany tak samo jak element <h1>. Zachowany zostanie tylko sam tekst.

Tag akapitu: <p>
Tag akapitu może być używany do wyróżnienia szczegółowego wprowadzenia lub treści. Wszystkie tagi wewnętrzne, style i atrybuty zostaną zignorowane, z kilkoma wyjątkami: <br>, <strong> i <em>. Więcej informacji znajdziesz w sekcji tagu wyrażenia poniżej.

Tagi list: <ul>, <ol>, <li>
Tag <ul> można używać z tagiem <li>, aby wyświetlać nieuporządkowane listy, a tag <ol> można używać z tagiem <li>, aby wyświetlać uporządkowane listy. To dobry sposób na wyświetlanie list kontrolnych, harmonogramów lub innych list, które pasują do Twoich potrzeb.
Przykład: aby wyświetlić listę funkcji wycieczki statkiem:
<ol>
<li>Wspaniały widok na ocean i możliwość obcowania z dziką przyrodą.</li>
<li>Starannie opracowane usługi i usługi podróżnicze.</li>
<li>Gwarantowana najniższa cena.</li>
</ol>
Pamiętaj, że tylko elementy <li> pod tagami <ul> lub <ol> zostaną przekonwertowane. Wszystkie pozostałe elementy zostaną pominięte. Wszystkie tagi wewnętrzne, atrybuty i style zostaną zignorowane. Zachowujemy tylko zawartość tekstową.

Tag podziału: <div>
Wszystkie obsługiwane tagi wewnętrzne tagu <div> zostaną przeanalizowane zgodnie z powyższymi regułami, co oznacza, że sam tag <div> nie oznacza żadnego grupowania ani wcięcia. Wszystkie atrybuty i style wewnętrzne są ignorowane.

Tagi frazy: <br>, <strong>, <em>:
Obsługiwane są tylko 3 wymienione powyżej tagi. Tag <br> służy do dzielenia wierszy w akapitach, a tagi <strong>/<em> do wyróżniania ważnego tekstu. Pozostałe tagi frazy zostaną zignorowane.

Nieobsługiwane tagi:

  • Tagi <html>, <header> i <body> są niedozwolone.
  • Nieobsługiwane są żadne inne tagi (np. <table>, <td>…). Wszystkie adresy URL, kotwy i linki zostaną usunięte i nigdy nie będą widoczne dla użytkowników końcowych.
    Jeśli chcesz użyć zdjęć, aby zapewnić użytkownikom bogatsze wrażenia, wyślij adresy URL zdjęć, korzystając z pola „relatedMedia” poniżej.

Ważne informacje:

  • Staraj się nie używać innych tagów poza wymienionymi powyżej obsługiwanymi, ponieważ treści w nieobsługiwanych tagach zostaną usunięte, co może negatywnie wpłynąć na komfort użytkowników.
  • Unikaj głęboko zagnieżdżonych struktur, np. nagłówków na więcej niż 3 poziomach lub zagnieżdżonych list. Utrzymanie prostej i płaskiej struktury pomaga zapewnić lepsze wrażenia użytkowników.
  • Jeśli obecnie obsługiwane układy nie wystarczają do Twoich zastosowań, skontaktuj się z zespołem Zarezerwuj z Google.
  • Zalecana maksymalna długość to 32 tys. znaków.
price

object (Price)

Cena usługi.
priceInterpretation

enum (PriceInterpretation)

Opisuje, jak cena jest interpretowana i wyświetlana użytkownikowi. Może być używany przez dowolną branżę oprócz gastronomii i Atrakcji, aby skonfigurować wyświetlanie ceny usługi.
rules

object (SchedulingRules)

Zasady rezerwacji i anulowania spotkań
prepaymentType

enum (PrepaymentType)

Określ, czy przedpłata jest wymagana, opcjonalna czy nieobsługiwana.
prepaymentTerms

object (PrepaymentTerms)

Warunki dotyczące momentu, w którym płatność w wysokości zaliczki zostanie zrealizowana.
form[]
(deprecated)

object (ServiceIntakeForm)

Rola wycofana. Użyj elementów intakeForm i perTicketIntakeForm.
intakeForm

object (ServiceIntakeForm)

formularz z prośbą o dodatkowe informacje od użytkownika podczas rezerwacji tej usługi; (opcjonalnie)
perTicketIntakeForm

object (ServiceIntakeForm)

formularz z prośbą o dodatkowe informacje od użytkownika podczas rezerwacji tej usługi; Formularz musi zostać wypełniony raz w przypadku każdego biletu, który użytkownik rezerwuje. (opcjonalnie)
taxRate

object (TaxRate)

Stawka podatku od usługi. Jeśli występuje, to pole zastępuje dowolną stawkę podatku ustawioną na poziomie sprzedawcy. Pusty komunikat (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki podatku do 0.
paymentOptionId[]

string

Lista identyfikatorów odnoszących się do opcji płatności, których można używać do opłacania tej usługi. Rzeczywiste opcje płatności są definiowane na poziomie sprzedawcy i mogą być udostępniane wielu sprzedawcom.
deposit

object (Deposit)

Określa, jak depozyt może zostać pobrany od użytkownika. zastępuje depozyt na poczet usługi, jeśli został on podany; Ustawienie pustego komunikatu depozytu powoduje usunięcie depozytu na poziomie usługi. (opcjonalnie)
noShowFee

object (NoShowFee)

Określa opłatę za niestawienie się, która może zostać naliczona użytkownikowi. Zastępuje opłatę za niestawienie się na spotkaniu, jeśli została określona. Ustawienie pustego komunikatu NoShowFee powoduje usunięcie wszelkich opłat za brak udziału na poziomie usługi. (opcjonalnie)
requireCreditCard

enum (RequireCreditCard)

Wskazuje, czy użytkownik musi podać dane karty kredytowej, aby zarezerwować tę usługę. To pole można zastąpić na poziomie dostępności. (opcjonalnie)
type

enum (ServiceType)

Wstępnie zdefiniowany typ tej usługi. (opcjonalnie)
ticketType[]

object (TicketType)

Typy biletów, które można zarezerwować/kupić w ramach tej usługi (jeśli są obsługiwane). (opcjonalnie)
relatedMedia[]

object (RelatedMedia)

zdjęcia związane z tą usługą, Google będzie indeksować i przechowywać te pliki multimedialne, aby wyświetlać je użytkownikom w jak najbardziej efektywny sposób. (opcjonalnie)
serviceAttributeValueId[]

object (ServiceAttributeValueId)

Wartości atrybutów usługi, które mają zastosowanie do tej usługi (opcjonalnie). Każda usługa może mieć 0 lub więcej wartości dla każdego atrybutu usługi zdefiniowanego w odpowiednim sprzedawcy. (opcjonalnie)
waitlistRules

object (WaitlistRules)

Zasady dołączania do listy oczekujących
ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

Dodatkowe informacje unikalne dla kategorii biletów na wydarzenia. (opcjonalnie)
integrationType

enum (IntegrationType)

Głębokość integracji obsługiwanej przez tę usługę. (opcjonalnie) Nie ma zastosowania w przypadku partnerów z integracją startera. W przypadku tych partnerów szyfrowanie end-to-end będzie zawsze wyłączone.
perOrderFee

object (PerOrderFee)

Opłaty na poziomie zamówienia za zakup tej usługi. (opcjonalnie)
toursAndActivitiesContent

object (ToursAndActivitiesContent)

Pola treści dotyczące wycieczek i atrakcji.
location[]

object (Location)

Lokalizacje powiązane z tą usługą. WAŻNE UWAGI: jeśli w związku z tą usługą odwiedzono wiele lokalizacji lub START_LOCATION różni się od VISITED_LOCATION, należy podać parametr START_LOCATION. Przykład: – wycieczka rowerowa z przewodnikiem, która obejmuje 3 miejsca docelowe. Musisz podać miejsce początkowe. – wycieczka autobusowa, która rozpoczyna się w holu hotelu, a potem uczestnicy udają się do zwiedzanego obiektu. Musisz podać lokalizację spotkania.
rating

object (Rating)

Ocena użytkowników tego serwisu jako dane zbiorcze obejmujące wszystkie opinie.
homeServiceData

object (HomeServiceData)

Dodatkowe informacje dotyczące usług domowych. (opcjonalnie)
virtualSession

object (VirtualSession)

Opcjonalnie: Informacje o sesji wirtualnej. Jest to wymagane do włączenia usług wirtualnych.
directMerchantPayment

object (DirectMerchantPayment)

Opcjonalnie: Dodatkowe informacje, które należy dodać, jeśli usługa wymaga, aby użytkownik zapłacił bezpośrednio sprzedawcy. WAŻNA UWAGA: RwG nie będzie uczestniczyć w tej transakcji. Jest wymagany, jeśli zdefiniowano virtualSession i usługa nie jest bezpłatna lub prepaymentType NIE jest ustawiony jako REQUIRED.
uriTemplate

object (UriTemplate)

Opcjonalnie: Opcjonalny szablon określający, jak Google ma generować adresy URL do witryny zewnętrznej.

PriceInterpretation

Opisuje, jak należy interpretować i wyświetlać użytkownikowi cenę.

Wartości w polu enum
PRICE_INTERPRETATION_UNSPECIFIED Interpretacja ceny nie została określona, domyślnie jest to EXACT_AMOUNT.
EXACT_AMOUNT

Gdy cena powinna być interpretowana jako konkretna wartość.

Przykłady: 20 PLN za zajęcia jogi; 15 PLN za strzyżenie dziecka
STARTS_AT

gdy cena usługi jest zmienna, ale minimalna cena jest znana i wyświetlana konsumentom; Konsumenci mogą podejmować decyzje, które powodują wzrost ceny.

Pamiętaj, że każda usługa, która korzysta z tego typu interpretacji ceny, musi używać typu płatności PrepaymentType NOT_SUPPORTED.

Przykłady: 30 PLN za strzyżenie psa, ale dodatkowe opcje mogą zwiększyć cenę
NOT_DISPLAYED

gdy cena usługi jest zmienna i nie wyświetla się konsumentom wcześniej żadnych informacji o cenie;

Pamiętaj, że każda usługa, która używa tej interpretacji ceny, musi używać typu przedpłaty NOT_SUPPORTED, a wartość ceny musi być pusta.

Przykłady: konsultacje dotyczące usługi dla domu

SchedulingRules

Reguły planowania usługi.

Zapis JSON 
{
  "minAdvanceOnlineCanceling": string,
  "lateCancellationFee": {
    object (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
Pola
minAdvanceOnlineCanceling

string (int64 format)

Minimalny okres zapowiedzi w sekundach wymagany do anulowania zarezerwowanego spotkania online. (opcjonalnie)
lateCancellationFee
(deprecated)

object (Price)

Opłata za anulowanie w okresie minimalnego okresu zapowiedzi.
noshowFee
(deprecated)

object (Price)

Opłata za niestawienie się bez anulowania.
admissionPolicy

enum (AdmissionPolicy)

zasady dotyczące przyjęcia, które obowiązują w przypadku tej usługi; Jeśli nie jest ustawione, przyjmuje wartość domyślną TIME_STRICT. (opcjonalnie)
cancellationPolicy

object (CancellationPolicy)

Zasady anulowania reguł harmonogramu. (wymagany w przypadku listy zadań)

Pole unii min_booking_buffer. Czas (w sekundach) od momentu, w którym można dokonać ostatniej rezerwacji, do momentu rozpoczęcia lub zakończenia przedziału dostępności.

Jeśli ustawiona jest wartość „min_advance_booking”, ostatni możliwy do rezerwacji czas jest obliczany jako (<slot start time> - "min_advance_booking"). Jeśli ustawiona jest wartość „min_booking_buffer_before_end_time”, ostatni możliwy do zarezerwowania czas jest obliczany jako (<slot end time> - "min_booking_buffer_before_end_time"). Pamiętaj, że wartość parametru „min_booking_buffer_before_end_time” musi być dodatnia. Jeśli żadne z tych pól nie jest skonfigurowane, można rezerwować slot do czasu jego rozpoczęcia. Jeśli oba pola są ustawione, zostanie wybrana tylko jedna wartość, a druga zostanie zignorowana. Nie możemy jednak przewidzieć, która wartość zostanie wybrana.

Przykłady:

  • strzyżenie, które musi zostać zarezerwowane co najmniej 1 godzinę przed rozpoczęciem; 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Muzeum, w którym ostatni bilet można kupić 30 minut przed zamknięciem: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • Bilet do kina, który należy kupić przed czasem rozpoczęcia. 'scheduling_rules{ ...}' (pozostaw to pole puste) (opcjonalnie) min_booking_buffer może mieć tylko jedną z tych wartości:
minAdvanceBooking

string (int64 format)

Czas (w sekundach) od momentu, gdy można dokonać ostatniej rezerwacji, do momentu rozpoczęcia okresu dostępności.
minBookingBufferBeforeEndTime

string (int64 format)

Czas (w sekundach) od momentu, w którym można dokonać ostatniej rezerwacji, do momentu zakończenia okresu dostępności. Jeśli to pole jest ustawione, pole „admissionPolicy” musi mieć wartość TIME_FLEXIBLE, aby wskazać, że użytkownicy mogą korzystać z zakupionych biletów po rozpoczęciu slotów.

AdmissionPolicy

Zasady dotyczące dostępu do tej usługi.

Wartości w polu enum
ADMISSION_POLICY_UNSPECIFIED Nieużywane.
TIME_STRICT Klienci muszą być obecni w czasie rozpoczęcia sesji, a usługa powinna zakończyć się w czasie jej zakończenia. Przykłady zastosowań TIME_STRICT: * Wycieczka, która rozpoczyna się o 9:00 i wymaga, aby wszyscy uczestnicy przybyli na czas, a wracają około 12:00. * Rezerwacja fryzjera w sobotę o 15:00, która potrwa około 30 minut. * Zajęcia fitness od 18:00 do 20:00.
TIME_FLEXIBLE

Klienci mogą przybyć w dowolnym momencie między czasem rozpoczęcia a zakończenia rezerwacji, aby skorzystać z rezerwacji.

Przykłady zastosowań TIME_FLEXIBLE: * bilet do muzeum, który można wykorzystać w dowolnym momencie w dniu zakupu. * Popołudniowy wstęp do parku rozrywki, który można wykorzystać od 12:00 do 21:00.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Klienci muszą przybyć do sprzedawcy w czasie rozpoczęcia rezerwacji, ale mogą go opuścić w dowolnym momencie.

Na przykład w przypadku biletu wstępu do muzeum na godzinę 10:00 użytkownik musi być w muzeum o tej porze. Godzina rozpoczęcia przedziałów dostępności dla tej usługi to wyznaczona godzina rozpoczęcia. Czas zakończenia jest jednak używany tylko jako klucz do identyfikacji przedziału czasu dostępności do rezerwacji.

CancellationPolicy

Zasady anulowania usługi.

Zapis JSON 
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
Pola
refundCondition[]

object (RefundCondition)

Zero lub więcej warunków zwrotu środków obowiązujących w ramach zasad.

RefundCondition

Określa pojedynczy warunek zwrotu środków. Wiele warunków zwrotu środków może być używanych razem, aby opisać „kroki zwrotu środków” jako różne okresy przed czasem rozpoczęcia usługi.

Zapis JSON 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
Pola
minDurationBeforeStartTime

string (Duration format)

Czas, który upłynął od rozpoczęcia okresu, do którego klient może otrzymać zwrot części kosztów usługi określonych w refundPercent. Gdy wartość wynosi 0 (domyślnie), usługę można anulować w dowolnym momencie.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".
refundPercent

integer (uint32 format)

Odsetek, który może zostać zwrócony, o ile rezerwacja usługi zostanie anulowana co najmniej minDurationBeforeStartTime godzin przed rozpoczęciem usługi, w zakresie [0, 100]. Gdy wartość wynosi 0 (domyślnie), usługa nie podlega zwrotowi. Gdy wartość tego parametru wynosi 100, usługa jest w pełni zwracana.

PrepaymentType

Typ enumeracji wskazujący typ przedpłaty.

Wartości w polu enum
PREPAYMENT_TYPE_UNSPECIFIED Domyślnie zakładamy, że przedpłata to NOT_SUPPORTED.
REQUIRED Użytkownik musi zapłacić za tę usługę w momencie rezerwacji.
OPTIONAL Użytkownik może wybrać opcję wstępnej zapłaty za tę usługę w momencie rezerwacji lub później, ale nie jest to wymagane, aby dokonać rezerwacji.
NOT_SUPPORTED W przypadku tej usługi przedpłata nie jest obsługiwana.

PrepaymentTerms

Szczegółowe informacje o tym, kiedy płatność wstępna została zrealizowana.

Zapis JSON 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Pola
chargeTiming

enum (ChargeTiming)

Kiedy zostanie naliczona opłata w zależności od czasu zakupu.
chargeTimeBeforeStartTimeSec

string (int64 format)

Czas w sekundach przed rozpoczęciem usługi, za który użytkownik jest obciążany opłatą. To pole należy ustawić tylko wtedy, gdy pole ChargeTiming ma wartość CHARGE_LATER.

ChargeTiming

Enum określający, kiedy opłata zostanie pobrana w zależności od czasu zakupu.

Wartości w polu enum
CHARGE_TIMING_UNSPECIFIED Nieużywane.
CHARGE_NOW Klient zostanie obciążony natychmiast.
CHARGE_LATER Klient zostanie obciążony później.

ServiceIntakeForm

Określa formularz przyjęcia, który dostosowuje usługę świadczoną przez sprzedawcę.

Zapis JSON 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
Pola
field[]

object (ServiceIntakeFormField)

Pola, które będą wyświetlane użytkownikowi.
firstTimeCustomers
(deprecated)

boolean

Jeśli to pole ma wartość Prawda, formularz będzie wyświetlany nowym klientom. Rola wycofana. Ta funkcja nie jest obsługiwana w przypadku formularzy rejestracyjnych.
returningCustomers
(deprecated)

boolean

Jeśli to pole ma wartość Prawda, formularz będzie wyświetlany powracającym klientom. Rola wycofana. Ta funkcja nie jest obsługiwana w przypadku formularzy rejestracyjnych.

ServiceIntakeFormField

Definiuje pole, które jest uwzględniane w formularzu ServiceIntakeForm.

Zapis JSON 
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
Pola
id

string

Ciąg znaków od partnera agregatora, który jednoznacznie identyfikuje pole formularza. Ten identyfikator powinien być taki sam jak identyfikator w odpowiednim polu odpowiedzi formularza i musi być unikalny na poziomie usługi oraz na poziomie formularza przyjmowania zgłoszeń. (wymagane)
type

enum (FieldType)

Typ tego pola.
label

string

Tekst wyświetlany użytkownikowi w tym polu. Wycofane. Zamiast tego używaj elementu localizedLabel.
localizedLabel

object (Text)

Tekst wyświetlany użytkownikowi w tym polu. Pole może być podawane w różnych lokalizacjach. (wymagane)
value[]

string

Ustaw tylko wtedy, gdy typ pola to LOCATION_SEARCH. Aby określić wartość lokalizacji, użyj atrybutu „locationId” w polu „location”.
choiceText[]

object (Text)

Ustaw, jeśli typ pola to MULTIPLE_CHOICE, CHECKBOXES lub DROPDOWN. Służy do wyliczania możliwych opcji.
isRequired

boolean

Wskazuje, czy użytkownik musi podać odpowiedź w tym polu.
allowCustomAnswer

boolean

Wskazuje, czy oprócz wstępnie zdefiniowanych odpowiedzi dozwolona jest wartość niestandardowa. Jest to możliwe tylko wtedy, gdy typ pola to LOCATION_SEARCH. (opcjonalnie)
additionalOption[]

object (Text)

dodatkowe opcje oprócz podanych wartości; Dotyczy tylko pola typu LOCATION_SEARCH. Przykładowo oprócz podanej listy lokalizacji dostępna może być opcja „Skontaktuję się z dostawcą później”. (opcjonalnie)
ticketTypeRestrict[]

string

Jeśli to pytanie powinno się wyświetlać tylko wtedy, gdy użytkownik rezerwuje określone typy biletów, to pole powinno być ustawione jako zbiór odpowiednich identyfikatorów typów biletów. Pozostaw to pole puste, jeśli pytanie jest zawsze stosowane.
hint

object (Text)

Tekst podpowiedzi, który wyświetla się jako obiekt tekstowy. Dotyczy to tylko pól typu SHORT_ANSWER lub PARAGRAPH. (opcjonalnie)

FieldType

Enum określający typ pola.

Wartości w polu enum
FIELD_TYPE_UNSPECIFIED Pola o nieokreślonym lub nieznanym typie zostaną zignorowane.
SHORT_ANSWER Jednowierszowe pole tekstowe.
PARAGRAPH Wielowierszowe pole tekstowe.
MULTIPLE_CHOICE Zestaw przycisków opcji, z których należy wybrać jedną z wielu opcji.
CHECKBOXES Co najmniej 1 wyliczony element z polami wyboru.
DROPDOWN Wybór z menu.
BOOLEAN Przycisk tak/nie.

ServiceType

Wstępnie zdefiniowane typy usług.

Wartości w polu enum
SERVICE_TYPE_UNSPECIFIED Nieużywane.
SERVICE_TYPE_DINING_RESERVATION rezerwacja stolika w restauracji.
SERVICE_TYPE_FOOD_ORDERING Zamawianie jedzenia, które może obejmować dostawę lub odbiór osobisty.
SERVICE_TYPE_FOOD_DELIVERY dostawa jedzenia,
SERVICE_TYPE_FOOD_TAKEOUT Jedzenie na wynos.
SERVICE_TYPE_EVENT_TICKET Bilet na wydarzenie.
SERVICE_TYPE_TRIP_TOUR Omówienie podróży.
SERVICE_TYPE_APPOINTMENT Usługa, która zapewnia spotkania lub zajęcia. Zalecane dla: (1) zdrowia i kondycji fizycznej, (2) spa i urody oraz (3) konsultacji i oceny finansowej. Informacje o obsługiwanych typach usług: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT Usługa, która umożliwia umówienie się na spotkanie online na zajęcia lub sesję, które będą w pełni wirtualne. Musi być ustawiony, jeśli włączasz rezerwacje usług wirtualnych.
SERVICE_TYPE_SHOPPING Usługa, która umożliwia użytkownikom robienie zakupów u określonego sprzedawcy. Może to być dostawa lub odbiór osobisty.

TicketType

TicketType służy do rozróżniania biletów o różnych cenach lub dostępności z powodu różnych typów użytkowników, różnych atrybutów usługi lub różnych opcji/dodatków.

Bilet to minimalna jednostka usługi, którą można zarezerwować, np. miejsce na spływ kajakowy, wstęp do muzeum czy wypożyczenie kajaka dwuosobowego na cały dzień.

Zapis JSON 
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
Pola
ticketTypeId

string

Identyfikator zgłoszenia służy do rozróżniania różnych typów zgłoszeń w ramach tej samej usługi i powinien być unikalny tylko w ramach tej usługi.
shortDescription

string

Krótki opis tego typu zgłoszenia.

Może być ona widoczna dla użytkownika, np. „dorosły”, „dziecko”, „weteran”, „rząd J” itp. Wymagane. Każdy typ biletu powinien mieć opis widoczny dla użytkownika. Wycofano. Użyj zamiast tego parametru localizedShortDescription.
localizedShortDescription

object (Text)

Krótki opis tego typu zgłoszenia z obsługą międzynarodową.

Może być ona widoczna dla użytkownika, np. „dorosły”, „dziecko”, „weteran”, „rząd J” itp. Wymagane. Każdy typ biletu powinien mieć opis widoczny dla użytkownika. Dla każdego regionu można podać osobne wartości.
price

object (Price)

Cena pojedynczego biletu tego typu bez podatków. Stawka podatku od usługi jest stosowana do biletów.
perTicketFee

object (PerTicketFee)

dodatkowe opłaty za zakup tego biletu; (opcjonalnie)
priceDisplayType

enum (PriceDisplayType)

Opcjonalnie: Wstępnie określony typ wyświetlania ceny pojedynczego biletu tego typu.
optionDescription

string

Opis dodatkowych opcji, które reprezentuje ten typ biletu (jeśli występują). Wycofane. Zamiast tego użyj localizedOptionDescription.
localizedOptionDescription

object (Text)

Opis dodatkowych opcji, które reprezentuje ten typ biletu (jeśli występują). Dla każdego regionu można podać osobne wartości.

Dodatkowe opcje są przydatne, gdy typ biletu reprezentuje wiele wymiarów.

Przykład 1.: bilet wstępu z różnymi typami „adult” (dorosły), „child” (dziecko) i język jako dodatkowa opcja. Oczekiwana lista typów biletów: – { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } – { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } – { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } – { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } }

Przykład 2.: wynajem kajaka na kilka godzin z opcjonalnym dodatkiem w postaci worka suchego. W tym przypadku shortDescription może być „3 godziny”, a optionDescription może być „z workiem suchym” lub „bez worka suchego”: – { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } – { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } – { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } – { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "spanish" } }

Opcjonalne, ale jeśli jakiekolwiek typy zgłoszeń w usłudze mają to pole ustawione, zakładamy, że wszystkie inne typy zgłoszeń również mają to pole ustawione (można użyć domyślnej opcji optionDescription). Przykład: [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] to nieprawidłowa lista.

Obsługiwane są tylko 2 tagi formatowania HTML: i 
. Są one przeznaczone do określania opcji za pomocą tytułu i szczegółowego opisu, na przykład: „Miejsca premium
Ta opcja obejmuje miejsca w prywatnych lożach, w tym w pełni wyściełane fotele, prywatne telewizory oraz obsługę kelnerską. Te miejsca zapewniają malownicze widoki na boisko”.
inventoryType

enum (InventoryType)

Opcjonalnie: Zdefiniowany z góry typ zasobów reklamowych pojedynczego biletu tego typu.

PerTicketFee

Opłaty, które należy uiścić za każdy bilet zakupiony przez użytkownika.

Zapis JSON 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
Pola
serviceCharge

object (Price)

Dodatkowa opłata za usługę.
facilityFee

object (Price)

Opłata, która trafia do obiektu.
taxes

object (Price)

Podatek od biletu.

PriceDisplayType

Wskazuje format ceny wyświetlany na stronie docelowej.

To pole jest ignorowane w przypadku zasobów reklamowych bez linków zewnętrznych.

To pole umożliwia Google wyświetlanie w swojej przestrzeni tego samego formatu ceny, który jest używany na stronie docelowej. Stałe formaty cen zwiększają współczynnik konwersji i zmniejszają ryzyko pomyłek.

Wartości w polu enum
PRICE_DISPLAY_TYPE_UNSPECIFIED Nieokreślony typ wyświetlania ceny. Google określi, który format wyświetlić.
PRICE_DISPLAY_TYPE_BASE Cena widoczna na stronie docelowej jest ceną podstawową.
PRICE_DISPLAY_TYPE_ALL_IN Cena widoczna na stronie docelowej obejmuje wszystkie opłaty i podatki.

InventoryType

Zdefiniowany z góry typ zasobów reklamowych pojedynczego biletu tego typu.

Wartości w polu enum
INVENTORY_TYPE_UNSPECIFIED Nieokreślony typ zasobów reklamowych.
INVENTORY_TYPE_PRIMARY Podstawowy asortyment.
INVENTORY_TYPE_VERIFIED_RESALE Zweryfikowany asortyment przeznaczony do odsprzedaży.
INVENTORY_TYPE_RESALE Zasoby reklamowe do dalszej sprzedaży.
INVENTORY_TYPE_AGGREGATOR Zasoby reklamowe agregatora.

RelatedMedia

zdjęcia związane z tą usługą, Google będzie indeksować te pliki multimedialne, aby zapewnić ich prawidłowe wyświetlanie użytkownikom. (opcjonalnie)

Zapis JSON 
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
Pola
url

string

Adres URL tego źródła multimediów. Google będzie indeksować multimedia hostowane pod tym adresem URL.
type

enum (MediaType)

Typ źródła multimediów.
localizedCaption

object (Text)

Tekst w mediach, który obsługuje i18n. Obsługiwany jest tylko zwykły tekst. Wszystkie komponenty HTML zostaną usunięte. (opcjonalnie)
attribution

object (Attribution)

informacje o źródle multimediów; Pamiętaj, że jeśli uznanie autorstwa jest wymagane do wyświetlania wraz z multimediami, aby uhonorować fotografa lub agencję, to pole musi być ustawione. (opcjonalnie)
caption
(deprecated)

string

Wycofana. Używaj zamiast niej localizedCaption.

MediaType

Enum określający typ źródła multimediów. Obsługiwane są tylko zdjęcia. Jeśli potrzebujesz obsługi innych multimediów niż zdjęcia, skontaktuj się z zespołem Rezerwacji z Google.

Wartości w polu enum
TYPE_UNSPECIFIED Nieużywane.
PHOTO Wskazuje, że media podane w adresie URL to zdjęcie.

Atrybucja

Informacje o źródle tych multimediów.

Zapis JSON 
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
Pola
localizedText

object (Text)

Tekst z podziękowaniami dla fotografa lub agencji obsługującej i18n. Ten tekst będzie wyświetlany razem ze źródłem multimediów. Pamiętaj, że w tym polu jest obsługiwany tylko tekst zwykły. Wszystkie elementy HTML zostaną usunięte (przypisywanie na podstawie hiperlinku nie jest obsługiwane).
text
(deprecated)

string

Wycofany, zalecamy użycie localizedText.

ServiceAttributeValueId

Identyfikuje określoną wartość atrybutu usługi, która ma zostać zastosowana do usługi.

Zapis JSON 
{
  "attributeId": string,
  "valueId": string
}
Pola
attributeId

string

Identyfikator atrybutu zdefiniowany w Merchant.service_attribute, np. „service-type”.
valueId

string

Identyfikator wartości tego atrybutu, np. „haircut”. Musi być zgodny z wartością identyfikatora w definicji atrybutu usługi.

WaitlistRules

Reguły dotyczące dołączania do listy oczekujących.

Zapis JSON 
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
Pola
minPartySize

integer

Wymagane. W przypadku usług, które udostępniają funkcję kolejki oczekujących, musi to być dodatnia liczba całkowita. Jeśli usługa lub sprzedawca nie udostępnia listy oczekujących, nie wypełniaj tego pola.
maxPartySize

integer

Wymagane. W przypadku usług, które udostępniają funkcję kolejki oczekujących, musi to być dodatnia liczba całkowita. Jeśli usługa lub sprzedawca nie udostępnia listy oczekujących, nie wypełniaj tego pola.
supportsAdditionalRequest

boolean

Jeśli wartość to Prawda, użytkownik będzie mógł wysłać dodatkową prośbę tekstową, gdy dołączy do listy oczekujących na tę usługę.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Ustaw opcje dla grup większych niż ustawiony parametr maxPartySize. Pozostaw puste, jeśli nie chcesz udostępniać innym grupom alternatywnych opcji dołączania do listy oczekujących.

UnsupportedPartySizeOption

Opcje dotyczące osób znajdujących się poza zasięgiem.

Zapis JSON 
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
Pola
Pole unii kind. Dostępne opcje dla osób, które są poza zasięgiem. kind może być tylko jednym z tych elementów:
callMerchant

object (CallMerchant)

Grupy, które nie mieszczą się w zakresie, mogą zadzwonić do firmy. Użytkownik zobaczy wstępnie zdefiniowany komunikat. Przykładowy tekst do wyświetlenia: „W przypadku grup składających się z ponad {waitlistRules.max_party_size} osób zadzwoń do restauracji pod numer {phone}”. CallMerchant musi być ustawiony, ale będzie pusty.

CallMerchant

Ten typ nie ma pól.

Pusty komunikat do użycia w sekcji UnsupportedPartySizeOption. Po ustawieniu tej opcji użytkownicy będą mogli zadzwonić do firmy, aby zarezerwować miejsce.

TicketingVerticalSpecificData

Dodatkowe informacje unikalne dla kategorii biletów na wydarzenia.

Zapis JSON 
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
Pola
eventCategory

enum (EventCategory)

Kategoria wydarzenia. Ustaw tylko wtedy, gdy zdarzenie mieści się w jednej z wstępnie zdefiniowanych kategorii. (opcjonalnie)
eventUrl

string

Adres URL wydarzenia na stronie partnera. (opcjonalnie)
entity[]

object (Entity)

Lista elementów powiązanych ze zdarzeniem. (opcjonalnie)
eventAttendanceMode

enum (AttendanceMode)

Wymagane. Typ uczestnictwa w wydarzeniu.
eventVirtualLocationUrl[]

string

Opcjonalnie: Adres URL, pod którym można obejrzeć wydarzenie.
eventOrganizer

object (Text)

Opcjonalnie: Organizator, który organizuje wydarzenie.
eventOrganizerUrl

string

Opcjonalnie: Adres URL organizatora, który prowadzi wydarzenie.
eventOrganizerType

enum (OrganizerType)

Opcjonalnie: Typ organizatora.
eventSourceUrl[]

string

Wymagane. Adres URL stron, na których można znaleźć informacje lub opisy wydarzeń.
eventState

enum (EventState)

Opcjonalnie: Stan zdarzenia.
brandName

object (Text)

Opcjonalnie: Zlokalizowana nazwa marki.
eventCreator

object (EventCreator)

Opcjonalnie: Informacje o twórcy zdarzenia.

EventCategory

Podzbiór kategorii zdarzeń, dla których dostosowujemy działanie usługi. Uwaga: nie jest to uniwersalna ontologia zdarzeń.

Wartości w polu enum
EVENT_CATEGORY_UNSPECIFIED Nie określono. Nie używać.
EVENT_CATEGORY_CONCERT Koncerty.
EVENT_CATEGORY_SPORTS wydarzenia sportowe,
EVENT_CATEGORY_THEATRE wydarzenia teatralne,
EVENT_CATEGORY_EXHIBITS wystawy.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES Warsztaty i zajęcia

Jednostka

Reprezentuje element powiązany ze zdarzeniem.

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

string

Unikalny identyfikator podmiotu w bazie danych partnera. (opcjonalnie)
name

string

Nazwa elementu. (wymagane)
url

string

Adres URL strony internetowej, która jednoznacznie opisuje dany podmiot. Strona w witrynie partnera, która dotyczy danej encji (jeśli istnieje); w przypadku innych publicznych adresów URL encji użyj atrybutu relevantUrl w atrybucie publicIdentificationData. (opcjonalnie)
entityType

enum (EntityType)

Typ encji. (opcjonalnie)
entityRole

enum (EntityRole)

Rola elementu w zdarzeniu. (opcjonalnie)
publicIdentificationData

object (PublicIdentificationData)

publiczne odniesienia do podmiotu; (opcjonalnie)

Typ encji

Typ elementu. Uwaga: nie jest to uniwersalna ontologia.

Wartości w polu enum
ENTITY_TYPE_UNSPECIFIED Nie określono. Nie używać.
ENTITY_TYPE_PERFORMER Podmiot reprezentuje wykonawcę lub zespół występujący na koncercie lub w programie. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to KONCERT lub TEATR.
ENTITY_TYPE_PLAYER Podmiot reprezentuje drużynę sportową lub zawodnika biorącego udział w wydarzeniu. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to SPORT.
ENTITY_TYPE_CONCERT_TOUR Element reprezentuje wycieczkę, do której należy to zdarzenie. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to KONCERT.
ENTITY_TYPE_SPORTS_SERIES Element reprezentuje turniej sportowy, do którego należy to zdarzenie. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to SPORT.
ENTITY_TYPE_PLAY Entia przedstawiają typ przedstawienia (np. musical, komedia, balet) wykonywanego podczas wydarzenia. Dotyczy tylko kategorii wydarzenia THEATRE.

EntityRole

Rola elementu w zdarzeniu.

Wartości w polu enum
ENTITY_ROLE_UNSPECIFIED Nie określono.
ENTITY_ROLE_HEADLINER Podmiot reprezentuje głównego wykonawcę lub głównego wykonawcę podczas wydarzenia.
ENTITY_ROLE_SUPPORTER Entia reprezentuje wykonawcę wspierającego podczas wydarzenia.
ENTITY_ROLE_HOME_TEAM Jednostka reprezentuje drużynę gospodarzy podczas wydarzenia (sportowego).
ENTITY_ROLE_AWAY_TEAM Obiekt reprezentuje drużynę gości na wydarzeniu (sportowym).

PublicIdentificationData

Identyfikatory, strony internetowe lub inne publiczne źródła, które odwołują się do danego podmiotu.

Zapis JSON 
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
Pola
relevantUrl[]

string

Publiczny adres URL dowolnej strony poświęconej tylko temu tematowi. Mogą to być oficjalne strony internetowe, discogs, platformy mediów społecznościowych, strony w Wikipedii lub imdb, np. https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (opcjonalnie)
musicbrainzId

string

36-znakowy identyfikator musicbrainz wykonawcy lub innych podmiotów muzycznych (w stosownych przypadkach). Więcej informacji znajdziesz na stronie https://musicbrainz.org/doc/MusicBrainz_Identifier. (opcjonalnie)

AttendanceMode

Typ uczestnictwa w wydarzeniu.

Wartości w polu enum
ATTENDANCE_MODE_UNSPECIFIED Nie określono.
ONLINE Wirtualne wydarzenia
PHYSICAL W przypadku wydarzeń bezpośrednich.
PHYSICAL_ONLINE_MIXED W przypadku wydarzeń zarówno fizycznych, jak i wirtualnych.

OrganizerType

Typ organizatora.

Wartości w polu enum
ORGANIZER_TYPE_UNSPECIFIED Nie określono.
PERSON W przypadku organizatora, który jest osobą fizyczną.
ORGANIZATION Organizator jest organizacją.

EventState

Stan zdarzenia.

Wartości w polu enum
EVENT_STATE_UNSPECIFIED Nie określono.
SCHEDULED Wydarzenie jest zaplanowane.
RESCHEDULED Wydarzenie zostało przełożone.
CANCELLED Wydarzenie zostało anulowane.
POSTPONED Wydarzenie zostało przełożone.

EventCreator

Informacje o twórcy zdarzenia. Dotyczy tylko platform, które obejmują zdarzenia dotyczące treści użytkowników.

Zapis JSON 
{
  "name": string
}
Pola
name

string

Opcjonalnie: Nazwa konta twórcy zdarzenia. Brak ograniczeń dotyczących znaków.

IntegrationType

Głębokość obsługiwanej integracji.

Wartości w polu enum
INTEGRATION_TYPE_UNSPECIFIED Wartość domyślna to END_TO_END.
INTEGRATION_TYPE_END_TO_END Pełna integracja umożliwiająca rezerwację przez Google.
INTEGRATION_TYPE_INVENTORY_ONLY Serwer rezerwacji nie musi obsługiwać tej usługi. Wystarczy wysłać dane o sprzedawcach, usługach i (opcjonalnie) dostępności.

PerOrderFee

Opłaty, które należy uiścić raz na zamówienie, niezależnie od liczby biletów.

Zapis JSON 
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
Pola
deliveryFee

object (Price)

Opłata, która może się różnić w zależności od metody dostawy.
processingFee

object (Price)

Opłata za przetworzenie formy płatności użytkownika.

ToursAndActivitiesContent

Pola treści dotyczące wycieczek i atrakcji. Każdy element w powtarzalnym polu powinien być niezależny, aby umożliwić oddzielne renderowanie (np. jako punkt wypunktowania).

Wypełnianie pola ToursAndActivitiesContent jest zdecydowanie zalecane w przypadku wycieczek i rozrywek, ale nie jest to wymagane. Wszystkie pola obsługują zwykły tekst i tekst podobny do kodu HTML na potrzeby podstawowego formatowania. Obsługiwane tagi formatowania podobne do tagów HTML:

Tagi frazy:
, , , : obsługiwane są tylko 3 wymienione wyżej tagi.
można użyć do dzielenia wierszy w akapitach, a // do wyróżniania ważnego tekstu. Pozostałe tagi frazy zostaną zignorowane.

Wszystkie inne tagi i niestandardowe style są niedozwolone i zostaną usunięte. Wszystkie adresy URL, kotwy i linki zostaną usunięte i nigdy nie będą widoczne dla użytkowników.

Ważne uwagi: * nie powielaj danych, które zostały już podane w polu highlights, exclusion i innych, bardziej szczegółowych polach w opisie usługi. * Unikaj używania innych tagów poza wymienionymi powyżej obsługiwanymi tagami, ponieważ zawartość tagów niedozwolonych zostanie usunięta, co może spowodować niechciane wrażenia użytkownika.

Zapis JSON 
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
Pola
highlights[]

object (Text)

Lista najciekawszych momentów widoczna dla użytkownika.
inclusions[]

object (Text)

Lista uwzględnień widoczna dla użytkownika.
exclusions[]

object (Text)

Wyświetlana użytkownikowi lista wykluczeń.
mustKnow[]

object (Text)

Lista ważnych informacji widocznych dla użytkownika. Używaj jej do podawania takich szczegółów jak ograniczenia wiekowe lub inne warunki, które sprawiają, że usługa nie jest odpowiednia.

Lokalizacja

Informacje geograficzne o lokalizacji.

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

string

Identyfikator miejsca w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz na stronie https://developers.google.com/places/web-service/place-id. Jeśli podasz ten adres, Google dopasuje lokalizację do tego miejsca.
name

string

Nazwa, numer telefonu, adres URL i dane geograficzne lokalizacji są używane do dopasowywania lokalizacji do miejsc już obecnych w Mapach Google.

To pole jest opcjonalne, ale może być wymagane w niektórych kontekstach. Na przykład usługa bez nazwy nie zostanie dopasowana do podmiotu gospodarczego, nawet jeśli znajduje się pod tym samym adresem. (opcjonalnie)
telephone

string

Numer telefonu publicznego lokalizacji, w tym kod kraju i kod kierunkowy, np. +14567891234. (opcjonalnie)
url

string

Adres URL witryny publicznej lokalizacji. (opcjonalnie)
geo

object (GeoCoordinates)

Informacje geograficzne o lokalizacji, w tym szerokość i długość geograficzną oraz adres. (opcjonalnie)
locationType

enum (LocationType)

Typ lokalizacji, który musi zostać podany, jeśli lokalizacja jest udostępniana w ramach usługi.
locationId

string

Unikalne odniesienie do lokalizacji w usłudze. Można go używać do odwoływania się do tej lokalizacji w innych polach usługi. Przykład: w formularzu niestandardowego zgłoszenia można użyć zestawu identyfikatorów lokalizacji, aby określić opcje lokalizacji odbioru. Jeśli jest ustawiony, identyfikator powinien być niepowtarzalny w ramach tej samej usługi. (opcjonalnie)

LocationType

Typ tej lokalizacji.

Wartości w polu enum
LOCATION_TYPE_UNSPECIFIED Nieokreślony typ lokalizacji.
VISITED_LOCATION Lokalizacja, do której dociera ta usługa.
START_LOCATION Lokalizacja, w której rozpoczyna się ta usługa, pełni też rolę MEETING_LOCATION.
END_LOCATION Miejsce, w którym kończy się ta usługa.

Ocena

Określa ocenę dla danej jednostki.

Zapis JSON 
{
  "value": number,
  "numberOfRatings": string
}
Pola
value

number

Wartość średniej oceny (wymagane, gdy numberOfRatings > 0). Wartość musi mieścić się w zakresie [1, 5] i może być pominięta tylko wtedy, gdy numberOfRatings jest równa 0.
numberOfRatings

string

Liczba ocen użytych do obliczenia wartości (wymagane).

HomeServiceData

Dodatkowe informacje wymagane w przypadku usług dla domu

Zapis JSON 
{
  "categoryType": string,
  "jobType": string
}
Pola
categoryType

string

Ogólna kategoria, do której należy ta usługa domowa. np. hydraulik, elektryk itp.
jobType

string

Typ zadania w ramach kategorii, do której należy dana usługa domowa. Przykład: unclog_drain, install_faucet to typy zleceń w kategorii hydraulik.

VirtualSession

Informacje o wirtualnej/on-line sesji. Przykład: zajęcia z jogi online, wirtualne zajęcia z gotowania itp.

Zapis JSON 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
Pola
sessionInstructions

object (Text)

Instrukcje konfiguracji zajęć wirtualnych. Jeśli partner nie podaje adresu URL filmu w ramach rezerwacji, tekst musi zawierać informację, kiedy adres URL filmu zostanie udostępniony użytkownikowi. np. „Adres URL Zoom zostanie wysłany e-mailem na 30 minut przed zajęciami”. (Zalecany)
sessionRequirements

object (Text)

Wymagania dotyczące danej sesji wirtualnej. np. mata do jogi, przybory kuchenne itp. (zalecane)
virtualPlatformInfo

object (VirtualPlatformInfo)

Informacje o wirtualnej platformie używanej w tej sesji. (wymagane do włączenia usług wirtualnych)
isSessionPrerecorded

boolean

Wymagane. Ustaw tę opcję jako Prawda, jeśli wirtualna sesja nie jest transmitowana na żywo, a nagrana wcześniej.

VirtualPlatformInfo

Informacje o platformie, która będzie używana podczas tej sesji wirtualnej.

Zapis JSON 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
Pola
platform

enum (Platform)

Platforma używana do wirtualnej sesji.
otherPlatformName

object (Text)

Nazwa platformy, jeśli jej wartość to INNE. (wymagany, jeśli w polu Platforma wybrano opcję INNE)

Platforma

Enum określający, z której platformy wirtualnej korzysta sprzedawca.

Wartości w polu enum
PLATFORM_UNSPECIFIED Nieużywane.
FLEXIBLE Sprzedawca może dowolnie wybrać platformę wideo.
GOOGLE_HANGOUTS Usługa Google Hangouts.
GOOGLE_MEET Usługa Google Meet.
ZOOM Zoom Video Communications.
SKYPE Skype.
YOUTUBE Transmisje na żywo w YouTube.
OTHER Należy ją ustawić, jeśli używana platforma wideo różni się od wymienionych tutaj.

DirectMerchantPayment

Informacje o tym, jak użytkownik może zapłacić bezpośrednio sprzedawcy zamiast z wyprzedzeniem zapłacić za usługę za pomocą RwG.

Zapis JSON 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
Pola
paymentMethods[]

object (Text)

Użytkownicy powinni płacić tylko za pomocą form płatności wymienionych poniżej.

UriTemplate

Szablon określający, jak Google ma generować adresy URL do witryny zewnętrznej.

Zapis JSON 
{
  "uriTemplate": string
}
Pola
uriTemplate

string

Opcjonalnie: Szablon URI musi być zgodny ze standardem RFC 6570 (https://datatracker.ietf.org/doc/html/rfc6570). Obsługuje szablony poziomu 2. Te parametry zostaną zastąpione wartościami określonymi w odpowiednich elementach.

5 dostępnych parametrów linku do rezerwacji w restauracji: 1) (wymagany) {availability_slot_start_seconds} :: wypełniany z pola startSec w pliku danych o dostępności 2) (wymagany) {availability_slot_duration_seconds} :: wypełniany z pola durationSec w pliku danych o dostępności 3) (opcjonalnie) {resources_party_size} :: wypełniany z pola partySize w pliku danych o dostępności 4) (opcjonalnie) {availability_availability_tag} :: wypełniany z pola availabilityTag w pliku danych o dostępności 5) (opcjonalnie) {resources_room_id} :: wypełniany z pola roomId w pliku danych o dostępności

Przykład użycia: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * startSec = 123456 * partySize = 2 https://example.com/book/restaurant?start=123456&num_guests=2

Metody

create

 Tworzy nowy element Service sprzedawcy zarządzanego przez określonego pośrednika i zwraca go.

delete

 Usuwa istniejącą Service sprzedawcy zarządzanego przez określonego agregatora.

patch

 Aktualizuje i zwraca istniejące Service sprzedawcy zarządzanego przez określonego pośrednika.