REST Resource: inventory.partners.merchants.services

Zasób: Service

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”. Wycofana. Zamiast niej używaj pola localizedServiceName.
localizedServiceName

object (Text)

Nazwa usługi, np. „Strzyżenie męskie”. Może być dostępny w kilku wersjach językowych.
description

string

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

object (Text)

Opis usługi widoczny dla użytkownika.

To pole obsługuje formatowanie w postaci zwykłego tekstu i HTML. W odróżnieniu od sekcji z zwykłym tekstem można tu tworzyć dostosowane układy, używając nagłówków, akapitów, list i niektórych tagów fraz. Aby zapewnić użytkownikom jak najlepsze wrażenia, uważnie przeczytaj poniższe instrukcje i uwagi.

Obsługiwane tagi formatowania podobne do HTML:

Tagi nagłówka: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Tagi nagłówka mogą służyć do wyświetlania tytułów i podtytułów. Na przykład <h1>Plan podróży</h1> wyświetli tekst w wierszu jako najważniejszy nagłówek sekcji. Pamiętaj, że wszystkie wewnętrzne tagi HTML, style i atrybuty zostaną zignorowane. Na przykład <h1 style=".."> będzie traktowany tak samo jak <h1>. Zachowany zostanie tylko czysty tekst.

Tag akapitu: <p>
 Tag akapitu może służyć 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 dotyczącej tagów fraz poniżej.

Tagi list: <ul>, <ol>, <li>
Tag <ul> można używać z tagiem <li> do wyświetlania list nieuporządkowanych, a tag <ol> można używać z tagiem <li> do wyświetlania list uporządkowanych. To dobry sposób na wyświetlanie list kontrolnych, harmonogramów i innych list, które pasują do Twoich przypadków użycia.
Przykład: aby wyświetlić listę funkcji wycieczki statkiem wycieczkowym:
<ol>
<li>Wspaniały widok na ocean i możliwość zabawy z dzikimi zwierzętami.</li>
<li>Starannie zaplanowane podróże i usługi.</li>
<li>Gwarancja najniższej ceny.</li>
</ol>
Pamiętaj, że konwertowane będą tylko elementy <li> pod tagami <ul> lub <ol>. Wszystkie pozostałe elementy podrzędne zostaną usunięte. Wszystkie wewnętrzne tagi, atrybuty i style zostaną zignorowane. Zachowamy tylko czystą treść tekstową.

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

Tagi fraz: <br>, <strong>, <em>:
Obsługiwane są tylko 3 wspomniane powyżej tagi. Znacznika <br> można używać do dzielenia wierszy w akapitach, a znaczników <strong>/<em> do wyróżniania ważnego tekstu. Pozostałe tagi fraz zostaną zignorowane.

Nieobsługiwane tagi:

  • Tagi <html>, <header> i <body> są niedozwolone.
  • Wszystkie inne tagi, które nie zostały wymienione powyżej, nie są obsługiwane (np. <table>, <td>...).
    Wszystkie adresy URL, kotwice i linki zostaną usunięte i nigdy nie będą wyświetlane użytkownikom. Jeśli chcesz użyć zdjęć, aby zapewnić użytkownikom bogate wrażenia, użyj pola „relatedMedia” poniżej, aby przesłać adresy URL zdjęć.

Ważne informacje:

  • Staraj się nie używać innych tagów niż wymienione powyżej, ponieważ zawartość nieobsługiwanych tagów zostanie usunięta, co może negatywnie wpłynąć na wrażenia użytkowników.
  • Unikaj głęboko zagnieżdżonych struktur, takich jak więcej niż 3 poziomy nagłówków lub zagnieżdżone listy. Płaska, prosta i nieskomplikowana struktura zapewnia lepsze wrażenia użytkownika.
  • Jeśli obecnie obsługiwane układy nie są wystarczające w Twoim przypadku, 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 w dowolnej kategorii z wyjątkiem Restauracji i Atrakcji do konfigurowania wyświetlania ceny usługi.
rules

object (SchedulingRules)

Zasady rezerwowania i anulowania spotkań.
prepaymentType

enum (PrepaymentType)

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

object (PrepaymentTerms)

Warunki dotyczące momentu zakończenia przedpłaty.
form[]
(deprecated)

object (ServiceIntakeForm)

Rola wycofana. Użyj intakeForm i perTicketIntakeForm.
intakeForm

object (ServiceIntakeForm)

formularz z prośbą o dodatkowe informacje od użytkownika, gdy rezerwuje on tę usługę. (opcjonalnie)
perTicketIntakeForm

object (ServiceIntakeForm)

formularz z prośbą o dodatkowe informacje od użytkownika, gdy rezerwuje on tę usługę. Ten formularz musi zostać wypełniony raz w przypadku każdego biletu, który rezerwuje użytkownik. (opcjonalnie)
taxRate

object (TaxRate)

Stawka podatku za usługę. Jeśli to pole występuje, zastępuje ono wszelkie wartości taxRate ustawione na poziomie sprzedawcy. Pusta wiadomość (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera.
paymentOptionId[]

string

Lista identyfikatorów odwołujących się do opcji płatności, których można użyć do zapłaty za tę usługę. Rzeczywiste opcje płatności są zdefiniowane na poziomie sprzedawcy i mogą być też udostępniane wielu sprzedawcom.
deposit

object (Deposit)

Określa, w jaki sposób można obciążyć użytkownika kaucją. Zastępuje kaucję za usługę, jeśli została określona. Ustawienie pustej wartości w przypadku wiadomości o wpłacie powoduje usunięcie wszelkich wpłat 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ę w przypadku usługi, jeśli została określona. Ustawienie pustego komunikatu NoShowFee usuwa wszelkie opłaty za niestawienie się 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)

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

object (RelatedMedia)

Zdjęcia związane z tą usługą. Google będzie indeksować i przechowywać multimedia, aby wyświetlać je użytkownikom w 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ć zero lub więcej wartości każdego atrybutu usługi zdefiniowanego przez odpowiedniego sprzedawcę. (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)

Poziom integracji, który obsługujemy w przypadku tej usługi. (opcjonalnie) Nie ma znaczenia w przypadku partnerów korzystających z integracji podstawowej. 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 z tą usługą jest powiązanych kilka odwiedzonych lokalizacji lub START_LOCATION różni się od VISITED_LOCATION, należy podać START_LOCATION. Przykład: – wycieczka rowerowa z przewodnikiem obejmująca 3 miejsca. Należy podać miejsce rozpoczęcia. – wycieczka autobusowa, która rozpoczyna się w lobby hotelu, a następnie udaje się do odwiedzanego miejsca; Musisz podać lokalizację spotkania.
rating

object (Rating)

Ocena użytkowników tej usługi jako zbiorcza wartość wszystkich opinii.
homeServiceData

object (HomeServiceData)

Dodatkowe informacje dotyczące branży 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 od użytkownika płatności bezpośrednio na rzecz sprzedawcy. WAŻNA UWAGA: RwG nie będzie uczestniczyć w tej transakcji. Jest wymagany, jeśli zdefiniowano virtualSession, a usługa nie jest bezpłatna lub prepaymentType NIE jest ustawiony na 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ć cenę użytkownikowi.

Wartości w polu enum
PRICE_INTERPRETATION_UNSPECIFIED Interpretacja ceny nieokreślona, domyślnie EXACT_AMOUNT.
EXACT_AMOUNT

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

Przykłady: 20 zł za zajęcia jogi, 15 zł za strzyżenie dziecka.
STARTS_AT

Gdy cena usługi jest zmienna, ale cena minimalna jest znana i wyświetlana klientom. Konsumenci mogą dokonywać wyborów, które zwiększają cenę.

Pamiętaj, że każda usługa, która korzysta z tego elementu PriceInterpretation, musi używać wartości PrepaymentType NOT_SUPPORTED.

Przykłady: 30 zł za pielęgnację psa, ale dodatkowe opcje mogą zwiększyć cenę.
NOT_DISPLAYED

Gdy cena usługi jest zmienna i nie jest wyświetlana konsumentom z wyprzedzeniem.

Pamiętaj, że każda usługa, która korzysta z tego elementu PriceInterpretation, musi używać elementu PrepaymentType o wartości NOT_SUPPORTED, a element Price musi być pusty.

Przykłady: konsultacja dotycząca usługi dla domu

SchedulingRules

Reguły harmonogramu 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 minimalnym okresie zapowiedzi.
noshowFee
(deprecated)

object (Price)

Opłata za niestawienie się bez anulowania rezerwacji.
admissionPolicy

enum (AdmissionPolicy)

Zasady dopuszczania, które mają zastosowanie do tej usługi. Jeśli nie jest ustawiony, przyjmuje się domyślnie TIME_STRICT. (opcjonalnie)
cancellationPolicy

object (CancellationPolicy)

Zasady anulowania reguł harmonogramu. (wymagany w przypadku atrakcji)

Pole zbiorcze 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 czasowego dostępności.

Jeśli ustawiona jest wartość „min_advance_booking”, ostatni czas, w którym można dokonać rezerwacji, jest obliczany jako (<godzina rozpoczęcia przedziału czasu> - „min_advance_booking”). Jeśli ustawiona jest wartość „min_booking_buffer_before_end_time”, ostatni czas, w którym można dokonać rezerwacji, jest obliczany jako (<czas zakończenia przedziału> – „min_booking_buffer_before_end_time”). Pamiętaj, że jeśli ustawiona jest wartość „min_booking_buffer_before_end_time”, musi być ona dodatnia. Jeśli obie te zasady są nieskonfigurowane, miejsce jest dostępne do rezerwacji do czasu rozpoczęcia przedziału. Jeśli oba pola są ustawione, zostanie wybrana tylko jedna wartość, a druga zostanie zignorowana. Nie możemy wiarygodnie przewidzieć, która wartość zostanie wybrana.

Przykłady:

  • Strzyżenie, które należy zarezerwować co najmniej 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 rozpoczęciem seansu. '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, w którym można dokonać ostatniej rezerwacji, do momentu rozpoczęcia przedziału dostępności.
minBookingBufferBeforeEndTime

string (int64 format)

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

AdmissionPolicy

Zasady dopuszczania w tej usłudze.

Wartości w polu enum
ADMISSION_POLICY_UNSPECIFIED Nieużywane.
TIME_STRICT Klienci muszą być obecni w momencie rozpoczęcia przedziału czasowego, a usługa powinna zakończyć się w momencie zakończenia przedziału. Przykłady zastosowań TIME_STRICT: * wycieczka, która rozpoczyna się o 9:00 i wymaga, aby wszyscy uczestnicy przybyli na czas, a kończy się około 12:00. * Rezerwacja strzyżenia na 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 godziną rozpoczęcia a zakończenia przedziału czasowego, aby skorzystać z tej rezerwacji.

Przykłady zastosowań TIME_FLEXIBLE: * bilet do muzeum, który można wykorzystać o dowolnej porze w dniu zakupu. * Wstęp do parku rozrywki po południu, z którego można korzystać od 12:00 do 21:00.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Klienci muszą przybyć do sprzedawcy o godzinie rozpoczęcia przedziału czasowego, ale mogą wyjść w dowolnym momencie.

Na przykład w przypadku biletu wstępu o wyznaczonej godzinie do muzeum na godzinę 10:00 użytkownik musi być w muzeum o tej godzinie. Godzina rozpoczęcia przedziałów dostępności dla tej usługi to wyznaczony czas wejścia. Godzina zakończenia jest jednak używana wyłącznie jako klucz do identyfikacji przedziału dostępności na potrzeby rezerwacji.

CancellationPolicy

Zasady anulowania usługi.

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

object (RefundCondition)

Zero lub więcej warunków zwrotu środków mających zastosowanie do zasad.

RefundCondition

Definiuje pojedynczy warunek zwrotu środków. Można użyć kilku warunków zwrotu środków, aby opisać „etapy zwrotu środków” jako różne okresy przed rozpoczęciem usługi.

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

string (Duration format)

Okres przed czasem rozpoczęcia, w którym klient może otrzymać zwrot części kosztów usługi określonych w refundPercent. Jeśli ta wartość wynosi 0 (domyślnie), usługę można anulować w dowolnym momencie.

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

integer (uint32 format)

Procent, który można zwrócić, o ile rezerwacja usługi zostanie anulowana co najmniej minDurationBeforeStartTime przed rozpoczęciem usługi, w zakresie [0, 100]. Gdy ustawiona jest wartość 0 (domyślnie), usługa nie podlega zwrotowi środków. Jeśli wartość wynosi 100, usługa podlega pełnemu zwrotowi środków.

PrepaymentType

Wyliczenie wskazujące typ przedpłaty.

Wartości w polu enum
PREPAYMENT_TYPE_UNSPECIFIED Domyślnie przyjmujemy, że przedpłata ma wartość NOT_SUPPORTED.
REQUIRED Użytkownik musi zapłacić za tę usługę w momencie rezerwacji.
OPTIONAL Użytkownik może zapłacić za tę usługę z góry w momencie rezerwacji lub później, ale nie jest to wymagane do dokonania rezerwacji.
NOT_SUPPORTED Przedpłata nie jest obsługiwana w przypadku tej usługi.

PrepaymentTerms

Szczegółowe informacje o tym, kiedy przedpłata zostanie zrealizowana.

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

enum (ChargeTiming)

Kiedy nastąpi obciążenie w stosunku do czasu zakupu.
chargeTimeBeforeStartTimeSec

string (int64 format)

Czas w sekundach przed rozpoczęciem usługi, za który użytkownikowi zostanie naliczona opłata. To pole powinno być ustawione tylko wtedy, gdy ChargeTiming ma wartość CHARGE_LATER.

ChargeTiming

Wyliczenie określające, kiedy nastąpi obciążenie w stosunku do czasu zakupu.

Wartości w polu enum
CHARGE_TIMING_UNSPECIFIED Nieużywane.
CHARGE_NOW Klient zostanie obciążony opłatą natychmiast.
CHARGE_LATER Opłata zostanie naliczona klientowi później.

ServiceIntakeForm

Określa formularz zgłoszeniowy, 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 wartość to „true”, ten formularz będzie wyświetlany klientom, którzy robią zakupy po raz pierwszy. Rola wycofana. Ta funkcja nie jest obsługiwana w przypadku formularzy zgłoszeniowych.
returningCustomers
(deprecated)

boolean

Jeśli wartość to „true”, ten formularz będzie wyświetlany powracającym klientom. Rola wycofana. Ta funkcja nie jest obsługiwana w przypadku formularzy zgłoszeniowych.

ServiceIntakeFormField

Definiuje pole, które jest uwzględnione 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 będącego agregatorem, który jednoznacznie identyfikuje pole formularza. Ten identyfikator powinien być taki sam jak identyfikator w odpowiedzi w odpowiednim polu formularza i musi być unikalny zarówno na poziomie usługi, jak i w przypadku formularzy zgłoszeń. (wymagane)
type

enum (FieldType)

Typ tego pola.
label

string

Tekst wyświetlany użytkownikowi w tym polu. Ta zasada została wycofana. Zamiast niej używaj zasady localizedLabel.
localizedLabel

object (Text)

Tekst wyświetlany użytkownikowi w tym polu. Pole może być podane w wielu językach. (wymagane)
value[]

string

Ustaw, jeśli typ pola to LOCATION_SEARCH. Aby określić wartość lokalizacji, użyj „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 wyborów.
isRequired

boolean

Określa, czy odpowiedź w tym polu jest wymagana od użytkownika.
allowCustomAnswer

boolean

Określa, czy oprócz wstępnie zdefiniowanych odpowiedzi dozwolona jest wartość niestandardowa. Ma to zastosowanie tylko wtedy, gdy typ pola to LOCATION_SEARCH. (opcjonalnie)
additionalOption[]

object (Text)

Dodatkowe opcje podane oprócz podanych wartości. Ma zastosowanie tylko wtedy, gdy typ pola to LOCATION_SEARCH. Oprócz podanej listy lokalizacji dostępna może być np. opcja „Skontaktuję się z dostawcą później”. (opcjonalnie)
ticketTypeRestrict[]

string

Jeśli to pytanie ma się wyświetlać tylko wtedy, gdy użytkownik rezerwuje określone typy biletów, to pole powinno zawierać zbiór odpowiednich identyfikatorów typów biletów. Jeśli pytanie zawsze ma zastosowanie, pozostaw to pole puste.
hint

object (Text)

Tekst podpowiedzi do wpisywania, który pojawia się jako obiekt zastępczy. Dotyczy to tylko sytuacji, gdy typ pola to SHORT_ANSWER lub PARAGRAPH. (opcjonalnie)

FieldType

Wyliczenie wskazujące typ pola.

Wartości w polu enum
FIELD_TYPE_UNSPECIFIED Pola o nieokreślonym lub nieznanym typie zostaną zignorowane.
SHORT_ANSWER Jednowierszowe pole do wprowadzania danych.
PARAGRAPH Wielowierszowe pole do wprowadzania danych tekstowych.
MULTIPLE_CHOICE Zestaw przycisków opcji, który wymaga wyboru jednej z wielu opcji.
CHECKBOXES Co najmniej 1 element z listy numerowanej 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 być dostarczane lub odbierane na wynos, albo jedno i drugie.
SERVICE_TYPE_FOOD_DELIVERY Dostawa jedzenia.
SERVICE_TYPE_FOOD_TAKEOUT jedzenie na wynos,
SERVICE_TYPE_EVENT_TICKET Bilet na wydarzenie.
SERVICE_TYPE_TRIP_TOUR Wycieczka.
SERVICE_TYPE_APPOINTMENT usługa, która umożliwia rezerwowanie wizyt lub zajęć; Zalecane w przypadku (1) usług związanych ze zdrowiem i fitness, (2) usług spa i kosmetycznych oraz (3) usług doradztwa i oceny finansowej. Listę obsługiwanych typów usług znajdziesz na stronie https://developers.google.com/maps-booking/guides/end-to-end-integration/overview.
SERVICE_TYPE_ONLINE_APPOINTMENT Usługa, która umożliwia rezerwację online zajęć lub sesji, 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 danego sprzedawcy. Może to być dostawa lub odbiór osobisty.

TicketType

Atrybut TicketType służy do rozróżniania biletów o różnych cenach lub dostępności ze względu na różne typy użytkowników, różne atrybuty usługi lub różne opcje/dodatki.

Bilet to minimalna jednostka, którą można zarezerwować w ramach usługi, np. miejsce na spływie kajakowym, wstęp do muzeum lub całodniowy wynajem dwuosobowego kajaka.

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 biletu służy do rozróżniania różnych typów biletów tej samej usługi i powinien być unikalny tylko w ramach usługi.
shortDescription

string

Krótki opis tego typu biletu.

Może być widoczny dla użytkownika, np. „osoba dorosła”, „dziecko”, „weteran”, „rząd J” itp. Wymagane, każdy typ biletu powinien mieć opis widoczny dla użytkownika. Wycofano. Zamiast tego użyj localizedShortDescription.
localizedShortDescription

object (Text)

Krótki opis tego typu biletu z obsługą internacjonalizacji.

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

object (Price)

Cena pojedynczego biletu tego typu bez podatków. Do biletów na usługę stosowana jest stawka podatku od usług.
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 dodatkowej opcji, którą reprezentuje ten typ biletu (jeśli dotyczy). Wycofano. Zamiast tego użyj localizedOptionDescription.
localizedOptionDescription

object (Text)

Opis dodatkowej opcji, którą reprezentuje ten typ biletu (jeśli dotyczy). Dla każdego ustawienia regionalnego 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 rodzajami „dorosły”, „dziecko” i językiem jako dodatkową opcją. Oczekiwana lista TicketType to: - { 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: wielogodzinny wynajem kajaka z opcjonalnym dodatkiem w postaci suchej torby. W tym przypadku pole shortDescription może mieć wartość „3 godziny”, a pole optionDescription może mieć wartość „z suchą torbą” lub „bez suchej torby”: - { 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 jakikolwiek typ biletu w usłudze ma ustawione to pole, oczekujemy, że wszystkie inne typy biletów również będą miały ustawione to pole (można użyć domyślnego opisu optionDescription). Na przykład [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] nie jest prawidłową listą.

Obsługiwane są tylko 2 tagi formatowania HTML: i 
. Służą one do określania opcji z tytułem i szczegółowym opisem, np. „Miejsca premium
Ta opcja obejmuje miejsca w lożach prywatnych z wygodnymi fotelami, prywatnymi telewizorami oraz obsługą zamówień jedzenia i napojów”. Z tych miejsc rozciąga się malowniczy widok na boisko”.
inventoryType

enum (InventoryType)

Opcjonalnie. Wstępnie określony typ zasobów reklamowych pojedynczego biletu tego typu.

PerTicketFee

Opłaty, które należy uiścić za każdy bilet kupiony 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)

podatki od biletu,

PriceDisplayType

Wskazuje format ceny wyświetlany na stronie docelowej.

To pole jest ignorowane w przypadku zasobów reklamowych bez linku wyjściowego.

To pole umożliwia wyświetlanie w usługach Google tego samego formatu ceny, który jest używany na stronie docelowej. Spójne formaty cen zwiększają współczynnik konwersji i zmniejszają zamieszanie.

Wartości w polu enum
PRICE_DISPLAY_TYPE_UNSPECIFIED Typ wyświetlania ceny nie został określony. Google określi, który format ma się wyświetlać.
PRICE_DISPLAY_TYPE_BASE Cena wyświetlana na stronie docelowej to cena podstawowa.
PRICE_DISPLAY_TYPE_ALL_IN Cena wyświetlana na stronie docelowej zawiera wszystkie opłaty i podatki.

InventoryType

Wstępnie określony typ zasobów reklamowych pojedynczego biletu tego typu.

Wartości w polu enum
INVENTORY_TYPE_UNSPECIFIED Typ zasobów reklamowych jest nieokreślony.
INVENTORY_TYPE_PRIMARY Podstawowe zasoby reklamowe.
INVENTORY_TYPE_VERIFIED_RESALE Zweryfikowany asortyment odsprzedaży.
INVENTORY_TYPE_RESALE zasoby reklamowe odsprzedawane;
INVENTORY_TYPE_AGGREGATOR zasoby reklamowe agregatora, Agregator (np. www.bandsintown.com) oznacza, że partner udostępnia informacje o wydarzeniach i biletach. Bilety nie są jednak sprzedawane bezpośrednio przez partnera. Sprzedawca biletów może być głównym dystrybutorem, zweryfikowanym sprzedawcą odsprzedającym bilety lub sprzedawcą odsprzedającym bilety. Obecnie rozróżniamy tylko typ zasobów reklamowych partnera najwyższego poziomu i ignorujemy rzeczywisty typ zasobów reklamowych sprzedawcy biletów w agregatorze.

RelatedMedia

Zdjęcia związane z tą usługą. Google będzie indeksować te media, aby mieć pewność, że są one prawidłowo wyświetlane 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 tego źródła multimediów.
localizedCaption

object (Text)

Napis do multimediów obsługujący internacjonalizację. Obsługiwany jest tylko zwykły tekst. Wszystkie komponenty HTML zostaną usunięte. (opcjonalnie)
attribution

object (Attribution)

Informacje o atrybucji źródła multimediów. Pamiętaj, że jeśli atrybucja jest wymagana do wyświetlania z multimediami, aby przypisać autorstwo fotografowi lub agencji, to pole musi być ustawione. (opcjonalnie)
caption
(deprecated)

string

Wycofano. Zalecamy używanie pola localizedCaption.

MediaType

Wyliczenie wskazujące typ tego źródła multimediów. Obsługiwane są tylko zdjęcia. Jeśli chcesz, aby obsługiwane były inne media niż zdjęcia, skontaktuj się z zespołem Zarezerwuj 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, który ma zawierać informacje o autorze zdjęcia lub agencji obsługującej internacjonalizację. Ten tekst będzie wyświetlany razem z mediami źródłowymi. Pamiętaj, że to pole obsługuje tylko zwykły tekst. Wszystkie komponenty HTML zostaną usunięte (atrybucja oparta na hiperlinkach nie jest obsługiwana).
text
(deprecated)

string

Wycofano. Zamiast tego używaj pola localizedText.

ServiceAttributeValueId

Określa konkretną 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. „strzyżenie”. Musi pasować do identyfikatora wartości 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 oferujących funkcję listy oczekujących musi to być dodatnia liczba całkowita. Jeśli usługa lub sprzedawca nie udostępnia funkcji listy oczekujących, to pole nie może być wypełnione.
maxPartySize

integer

Wymagane. W przypadku usług oferujących funkcję listy oczekujących musi to być dodatnia liczba całkowita. Jeśli usługa lub sprzedawca nie udostępnia funkcji listy oczekujących, to pole nie może być wypełnione.
supportsAdditionalRequest

boolean

Jeśli wartość to „true”, użytkownik będzie mógł wysłać dodatkową prośbę w formie dowolnego tekstu podczas dołączania do listy oczekujących na tę usługę.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Ustaw opcje dla grup większych niż ustawiony parametr maxPartySize. Pozostaw to pole puste, jeśli większe grupy nie powinny mieć alternatywnych opcji dołączenia do listy oczekujących.

UnsupportedPartySizeOption

Opcje dla grup, które są poza zakresem.

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 zbiorcze kind. Dostępne opcje dla osób, które są poza zasięgiem. kind może mieć tylko jedną z tych wartości:
callMerchant

object (CallMerchant)

Osoby, które chcą zarezerwować stolik dla liczby osób spoza zakresu, mogą zadzwonić do firmy. Użytkownikowi zostanie wyświetlony gotowy komunikat. Przykładowy tekst do wyświetlenia: „W przypadku grup składających się z więcej niż {waitlistRules.max_party_size} osób zadzwoń do restauracji pod numer {phone}”. Atrybut CallMerchant musi być ustawiony, ale będzie pusty.

CallMerchant

Ten typ nie ma pól.

Pusta wiadomość do użycia w przypadku opcji UnsupportedPartySizeOption. Ustawienie tej opcji spowoduje wyświetlenie użytkownikom opcji zadzwonienia do firmy w celu dokonania rezerwacji.

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. Ustawiane tylko wtedy, gdy zdarzenie należy do jednej ze wstępnie zdefiniowanych kategorii. (opcjonalnie)
eventUrl

string

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

object (Entity)

Lista podmiotów powiązanych z wydarzeniem. (opcjonalnie)
eventAttendanceMode

enum (AttendanceMode)

Wymagane. Rodzaj 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 organizuje wydarzenie.
eventOrganizerType

enum (OrganizerType)

Opcjonalnie. Typ organizatora.
eventSourceUrl[]

string

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

enum (EventState)

Opcjonalnie. Stan zdarzenia.
brandName

object (Text)

Opcjonalnie. Zlokalizowana nazwa marki.
eventCreator

object (EventCreator)

Opcjonalnie. Informacje o twórcy wydarzenia.

EventCategory

Podzbiór kategorii zdarzeń, w przypadku których dostosowujemy funkcje 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 podmiot 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 jednostki. (wymagane)
url

string

Adres URL strony internetowej, która jednoznacznie opisuje podmiot. Jest to strona internetowa w witrynie partnera, która dotyczy danego podmiotu (jeśli taka istnieje). W przypadku innych publicznych adresów URL podmiotu użyj pola relevantUrl w obiekcie publicIdentificationData. (opcjonalnie)
entityType

enum (EntityType)

Typ podmiotu. (opcjonalnie)
entityRole

enum (EntityRole)

Rola elementu w wydarzeniu. (opcjonalnie)
publicIdentificationData

object (PublicIdentificationData)

Publiczne odniesienia do podmiotu. (opcjonalnie)

Typ encji

Typ podmiotu. Uwaga: nie jest to ontologia uniwersalna.

Wartości w polu enum
ENTITY_TYPE_UNSPECIFIED Nie określono. Nie używać.
ENTITY_TYPE_PERFORMER Podmiot reprezentuje artystę lub grupę występującą na koncercie lub przedstawieniu. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to CONCERT lub THEATRE.
ENTITY_TYPE_PLAYER Podmiot reprezentuje drużynę sportową lub zawodnika na wydarzeniu. Ma zastosowanie tylko wtedy, gdy kategoria zdarzenia to SPORT.
ENTITY_TYPE_CONCERT_TOUR Obiekt reprezentuje wycieczkę, do której należy to zdarzenie. Dotyczy tylko kategorii zdarzenia CONCERT.
ENTITY_TYPE_SPORTS_SERIES Element reprezentuje turniej sportowy, do którego należy to wydarzenie. Ma zastosowanie tylko wtedy, gdy kategoria zdarzenia to SPORT.
ENTITY_TYPE_PLAY Encja reprezentuje rodzaj przedstawienia (np. musical, komedia, balet itp.) wystawianego podczas wydarzenia. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to THEATRE.

EntityRole

Rola elementu w wydarzeniu.

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

PublicIdentificationData

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

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

string

Publiczny adres URL dowolnej strony internetowej poświęconej wyłącznie danemu tematowi. Mogą to być oficjalne strony internetowe, Discogs, platformy mediów społecznościowych, Wikipedia 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 odpowiednich przypadkach). Zobacz https://musicbrainz.org/doc/MusicBrainz_Identifier. (opcjonalnie)

AttendanceMode

Rodzaj uczestnictwa w wydarzeniu.

Wartości w polu enum
ATTENDANCE_MODE_UNSPECIFIED Nie określono.
ONLINE W przypadku wydarzeń wirtualnych.
PHYSICAL W przypadku wydarzeń, podczas których uczestnicy spotykają się bezpośrednio ze sobą.
PHYSICAL_ONLINE_MIXED W przypadku wydarzeń, które odbywają się zarówno w formie fizycznej, jak i wirtualnej.

OrganizerType

Typ organizatora.

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

EventState

Stan zdarzenia.

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

EventCreator

Informacje o twórcy wydarzenia. Dotyczy tylko platform, które obejmują zdarzenia związane z treściami użytkowników.

Zapis JSON 
{
  "name": string
}
Pola
name

string

Opcjonalnie. Nazwa twórcy wydarzenia. Brak ograniczeń dotyczących znaków.

IntegrationType

Obsługiwana głębokość integracji.

Wartości w polu enum
INTEGRATION_TYPE_UNSPECIFIED Domyślna wartość to END_TO_END.
INTEGRATION_TYPE_END_TO_END Pełna integracja, która umożliwia kompleksową rezerwację za pomocą Google.
INTEGRATION_TYPE_INVENTORY_ONLY Serwer rezerwacji nie musi obsługiwać tej usługi. Wystarczy przesłać dane sprzedawców, usług 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 wyświetlania.
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 polu powtarzanym powinien być niezależny, aby można było go renderować oddzielnie (np. jako punkt).

Wypełnianie pola ToursAndActivitiesContent jest wysoce zalecane w przypadku wycieczek i atrakcji, ale nie jest bezwzględnie wymagane. Wszystkie pola obsługują zarówno zwykły tekst, jak i tekst podobny do HTML w przypadku podstawowego formatowania. Obsługiwane tagi formatowania podobne do HTML:

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

Wszystkie inne tagi i style niestandardowe są niedozwolone i zostaną usunięte. Wszystkie adresy URL, kotwice i linki zostaną usunięte i nigdy nie będą wyświetlane użytkownikom.

Ważne uwagi: * Nie duplikuj danych, które zostały już podane w polach highlights, exclusion i innych, bardziej szczegółowych, w opisie usługi. * Nie używaj innych tagów niż wymienione powyżej, ponieważ zawartość tagów nieobsługiwanych zostanie usunięta, co może negatywnie wpłynąć na wrażenia użytkowników.

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

object (Text)

Lista wyróżnionych informacji widoczna dla użytkownika.
inclusions[]

object (Text)

Lista włączeń widoczna dla użytkownika.
exclusions[]

object (Text)

Lista wykluczeń widoczna dla użytkownika.
mustKnow[]

object (Text)

Lista ważnych uwag widoczna dla użytkownika. Użyj jej, aby podać szczegóły, takie jak ograniczenia wiekowe lub inne warunki, które sprawiają, że ta usługa jest nieodpowiednia.

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 tę informację, Google dopasuje lokalizację do tego miejsca.
name

string

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

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

string

Publiczny numer telefonu lokalizacji wraz z kodem kraju i numerem kierunkowym, np. +14567891234. (opcjonalnie)
url

string

Adres URL publicznej witryny lokalizacji. (opcjonalnie)
geo

object (GeoCoordinates)

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

enum (LocationType)

Jeśli ta lokalizacja jest podana dla usługi, musisz podać jej typ.
locationId

string

Unikalny identyfikator lokalizacji w ramach usługi. Ten identyfikator może być używany do odwoływania się do tej lokalizacji w innych polach usługi. Na przykład w niestandardowym formularzu zgłoszeniowym można użyć zestawu identyfikatorów lokalizacji, aby określić opcje lokalizacji odbioru. Jeśli ten identyfikator jest ustawiony, powinien być unikalny 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, w której świadczona jest usługa.
START_LOCATION Lokalizacja, w której rozpoczyna się ta usługa, jest też MIEJSCEM_SPOTKANIA.
END_LOCATION Miejsce, w którym kończy się ta usługa.

Ocena

Określa ocenę jednostki.

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

number

Średnia wartość oceny (wymagana, gdy numberOfRatings > 0). Wartość musi mieścić się w zakresie [1, 5] i można ją pominąć tylko wtedy, gdy liczba ocen wynosi zero.
numberOfRatings

string

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

HomeServiceData

Dodatkowe informacje, które należy podać w przypadku usług dla domu.

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

string

Kategoria wyższego poziomu, do której należy ta usługa domowa. np. hydraulik, elektryk itp.
jobType

string

Typ zlecenia w kategorii, do której należy dana usługa domowa. Np. udrożnienie odpływu i montaż baterii to typy zleceń w kategorii hydraulik.

VirtualSession

Informacje o sesji wirtualnej lub online. np. zajęcia jogi online, wirtualne warsztaty kulinarne itp.

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

object (Text)

Instrukcje dotyczące konfiguracji zajęć wirtualnych. Jeśli partner nie dołączy do rezerwacji adresu URL filmu, w tym tekście musi być podana data, kiedy adres URL filmu zostanie udostępniony użytkownikowi. np. Adres URL Zoom zostanie wysłany 30 minut przed zajęciami. (Zalecane)
sessionRequirements

object (Text)

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

object (VirtualPlatformInfo)

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

boolean

Wymagane. Ustaw wartość „true”, jeśli sesja wirtualna nie jest prowadzona na żywo i został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 w przypadku sesji wirtualnej.
otherPlatformName

object (Text)

Nazwa platformy, jeśli jest ustawiona na INNE. (Wymagane, jeśli platforma ma wartość OTHER)

Platforma

Wyliczenie wskazujące, z której wirtualnej platformy korzysta sprzedawca.

Wartości w polu enum
PLATFORM_UNSPECIFIED Nieużywane.
FLEXIBLE Sprzedawca może korzystać z dowolnej platformy wideo.
GOOGLE_HANGOUTS usługi Google Hangouts.
GOOGLE_MEET usługi Google Meet.
ZOOM Zoom Video Communications.
SKYPE Skype.
YOUTUBE transmisje na żywo w YouTube;
OTHER Należy 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 płacić z góry za usługę za pomocą Zarezerwuj z Google.

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 RFC6570. Więcej informacji znajdziesz na stronie https://datatracker.ietf.org/doc/html/rfc6570. Obsługuje szablony poziomu 2. Te parametry zostaną przekształcone w wartości określone w odpowiednich elementach.

Dostępne parametry linku do rezerwacji w restauracji: 1) (wymagany) {availability_slot_start_seconds} – wypełniany na podstawie pola startSec w pliku danych o dostępności; 2) (wymagany) {resources_party_size} – wypełniany na podstawie pola partySize w pliku danych o dostępności; 3) (opcjonalny) {availability_slot_duration_seconds} – wypełniany na podstawie pola durationSec w pliku danych o dostępności; 4) (opcjonalny) {availability_slot_availability_tag} – wypełniany na podstawie pola availabilityTag 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}

Z wartościami: * startSec = 123456 * partySize = 2

https://example.com/book/restaurant?start=123456&num_guests=2

Metody

create

 Tworzy nowy obiekt Service sprzedawcy zarządzanego przez określonego agregatora i zwraca go.

delete

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

patch

 Aktualizuje istniejący obiekt Service sprzedawcy zarządzanego przez określonego agregatora i zwraca go.