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)
  }
}
Pola
name

string

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

serviceName

string

Nazwa usługi, np. „Fryzjer męski”. Wycofana. Zamiast niej użyj localizedServiceName.

localizedServiceName

object (Text)

Nazwa usługi, np. „Fryzjer męski”. Prawdopodobnie w kilku regionach.

description

string

Opis usługi widoczny dla użytkowników. Wycofano. Użyj atrybutu localizedDescription.

localizedDescription

object (Text)

Opis usługi widoczny dla użytkowników.

To pole obsługuje zarówno zwykły tekst, jak i format HTML. W przeciwieństwie do sekcji zwykłego tekstu, niestandardowe układy można tutaj tworzyć za pomocą nagłówków, akapitów, list i niektórych tagów do wyrażenia. Przeczytaj uważnie poniższe instrukcje i uwagi, aby zapewnić użytkownikom najlepsze wrażenia.

Obsługiwane tagi formatowania podobne do HTML:

Tagi nagłówka: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Do wyświetlania tytułów i podtytułów można używać tagów nagłówka. Na przykład <h1>Plan podróży</h1> spowoduje wyświetlenie wbudowanego tekstu jako najważniejszego nagłówka 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>. Zostanie zachowany tylko czysty tekst.

Tag akapitu: <p>
Służy do wyróżniania szczegółowego wprowadzenia lub treści. Wewnętrzne tagi, style i atrybuty będą ignorowane z kilkoma wyjątkami: <br>, <strong> i <em>. Więcej informacji znajdziesz w sekcji dotyczącej tagów frazy poniżej.

Wyświetl tagi: <ul>, <ol>, <li>
<ul> może być używany z tagiem <li> , aby wyświetlić listy nieuporządkowane, a <ol> można używać z <li> aby wyświetlić listy uporządkowane. To dobry sposób na wyświetlanie list kontrolnych, harmonogramów lub innych list, które pasują do Twoich przypadków.
Przykład: aby wyświetlić listę elementów dostępnych na rejsie wycieczkowym:
<ol>
<li>Wspaniały widok na ocean i zabawa na świeżym powietrzu.</li>
<li>Starannie zaprojektowane usługi transportowe i aranżacje.</li>
<li>Gwarantowana najniższa cena.</li>
</ol>
Pamiętaj, że tylko <li> dzieci poniżej <ul> lub <ol> . Pozostałe dzieci zostaną usunięte. Wszystkie wewnętrzne tagi, atrybuty i style również będą ignorowane. Zachowujemy tylko czysty tekst.

Tag podziału: <div>
Wszystkie obsługiwane tagi wewnętrzne tagu <div> zostanie analizowany zgodnie z podanymi wyżej regułami, sugerują, że <div> nie oznacza grupowania ani wcięć. Wszelkie atrybuty i style wewnętrzne również zostaną zignorowane.

Tagi wyrażeń: <br>, <strong>, <em>:
Obsługiwane są tylko trzy tagi wymienione powyżej. &lt;br&gt; można używać do podziału wierszy w akapitach, a znaki <strong>/<em> pozwalają wyróżnić ważny tekst. Pozostałe tagi do wyrażenia będą ignorowane.

Nieobsługiwane tagi:

  • <html>, <header> i <body> tagi są niedozwolone.
  • Inne tagi, które nie zostały wymienione powyżej, nie są obsługiwane (np. <table>, <td>...).
    Wszelkie adresy URL, kotwice i linki zostaną usunięte i nigdy nie będą wyświetlane użytkownikom. Jeśli chcesz wykorzystać zdjęcia, aby zapewnić użytkownikom dodatkowe wrażenia, skorzystaj z linku „relatedMedia”. poniżej, aby wysłać adresy URL zdjęć.

Ważne informacje:

  • Nie używaj innych tagów z wyjątkiem tych obsługiwanych powyżej, które są wymienione powyżej, ponieważ zawartość w nieobsługiwanych tagach zostanie usunięta i może negatywnie wpłynąć na wrażenia użytkownika.
  • Staraj się unikać głębokich zagnieżdżonych struktur, takich jak więcej niż 3 różne poziomy nagłówków lub listy zagnieżdżonych. Płaska, prosta i funkcjonalna struktura pomaga zapewnić użytkownikom lepsze wrażenia
    .
  • Jeśli obecnie obsługiwane układy nie są wystarczające do Twoich potrzeb, skontaktuj się z zespołem Zarezerwuj z Google.
  • Zalecany maksymalny rozmiar to 32 000 znaków.
price

object (Price)

Cena usługi.

priceInterpretation

enum (PriceInterpretation)

Określa, w jaki sposób cena jest interpretowana i wyświetlana użytkownikowi. Można go używać w dowolnej branży z wyjątkiem restauracji i Atrakcji, aby skonfigurować wyświetlanie ceny usługi.

rules

object (SchedulingRules)

Zasady rezerwacji lub anulowania spotkań.

prepaymentType

enum (PrepaymentType)

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

prepaymentTerms

object (PrepaymentTerms)

Warunki dotyczące terminu realizacji przedpłaty.

form[]
(deprecated)

object (ServiceIntakeForm)

Rola wycofana. Użyj intakeForm i perTicketIntakeForm.

intakeForm

object (ServiceIntakeForm)

Formularz prośby o podanie dodatkowych informacji od użytkownika podczas rezerwacji tej usługi. (opcjonalnie)

perTicketIntakeForm

object (ServiceIntakeForm)

Formularz prośby o podanie dodatkowych informacji od użytkownika podczas rezerwacji tej usługi. Ten formularz należy wypełnić raz w przypadku każdego biletu przez użytkownika. (opcjonalnie)

taxRate

object (TaxRate)

Stawka podatku usługi. Jeśli to pole jest obecne, zastępuje wszystkie stawki podatku ustawione na poziomie sprzedawcy. Pusty komunikat (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 opłacenia tej usługi. Rzeczywiste opcje płatności są zdefiniowane na poziomie sprzedawcy i mogą być udostępniane wielu sprzedawcom.

deposit

object (Deposit)

Określa sposób pobierania kaucji od użytkownika. Zastępuje wpłatę za usługę, jeśli została określona. Ustawienie w tym miejscu komunikatu o depozycie spowoduje 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ć pobrana od użytkownika. Zastępuje opłatę za niestawienie się, jeśli została określona. Ustawienie tej opcji na pustą wiadomość NoShowFee spowoduje usunięcie wszelkich opłat 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)

Typy biletów, które można zarezerwować lub kupić na tę usługę, jeśli bilety są obsługiwane. (opcjonalnie)

relatedMedia[]

object (RelatedMedia)

Zdjęcia powiązane z tą usługą. Google będzie indeksować i przechowywać treści multimedialne, by zapewnić jak najskuteczniejsze wyświetlanie ich użytkownikom. (opcjonalnie)

serviceAttributeValueId[]

object (ServiceAttributeValueId)

Wartości atrybutów usługi mające zastosowanie do tej usługi (opcjonalnie). Każda Usługa może mieć zero lub więcej wartości dla każdego atrybutu usługi zdefiniowanego u odpowiedniego 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)

Stopień integracji w ramach tej usługi. (Opcjonalnie) Nie dotyczy partnerów z integracją polecenia inicjującego. Kompleksowa usługa będzie zawsze wyłączona w przypadku tych partnerów.

perOrderFee

object (PerOrderFee)

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

toursAndActivitiesContent

object (ToursAndActivitiesContent)

Pola treści specyficzne dla wycieczek i aktywności.

location[]

object (Location)

Lokalizacje związane z tą usługą. WAŻNE UWAGI: jeśli z tą usługą związane jest wiele odwiedzonych lokalizacji lub START_LOCATION jest inna niż VISITED_LOCATION, należy podać START_LOCATION. Przykład: – Wycieczka rowerowa z przewodnikiem obejmująca 3 miejsca. Należy podać miejsce rozpoczęcia wycieczki. – Spotkanie z wycieczkami autobusowymi w hotelowym lobby, a następnie udać się na wizytę. Należy określić lokalizację spotkania.

rating

object (Rating)

Ocena użytkowników tej usługi jako dane zbiorcze ze wszystkich opinii.

homeServiceData

object (HomeServiceData)

Dodatkowe informacje unikalne dla branży usług dla domu. (opcjonalnie)

virtualSession

object (VirtualSession)

Opcjonalnie: Informacje o sesji wirtualnej. Jest wymagany do włączania 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: Firma RwG nie weźmie udziału w tej transakcji. Jest wymagane, jeśli zdefiniowano wirtualnąsesję, a usługa nie jest bezpłatna lub jeśli typ przedpłaty ma wartość REQUIRED nie jest ustawiona.

PriceInterpretation

Określa, jak cena powinna być interpretowana i wyświetlana użytkownikowi.

Wartości w polu enum
PRICE_INTERPRETATION_UNSPECIFIED Nie określono interpretacji ceny. Domyślna wartość to EXACT_AMOUNT.
EXACT_AMOUNT

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

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

STARTS_AT

Cena usługi jest zmienna, ale cena minimalna jest znana i wyświetlana klientom. Konsumenci mogą dokonać wyborów, które podniosą cenę.

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

Przykłady: 30 zł za strzyżenie psów, ale dodatkowe opcje mogą spowodować wzrost ceny

NOT_DISPLAYED

Gdy cena usługi jest zmienna i klienci z wyprzedzeniem nie widzą informacji o cenie.

Pamiętaj, że każda usługa, która korzysta z tej metody interpretacji ceny, musi używać typu PrepaymentType NOT_SUPPORTED i ceny musi być pusta.

Przykłady: konsultacja dotycząca usług 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)

Z minimalnym wyprzedzeniem (w sekundach) wymaganym 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 opłaty za korzystanie z danej usługi. Jeśli nie jest skonfigurowana, domyślna wartość to TIME_STRICT. (opcjonalnie)

cancellationPolicy

object (CancellationPolicy)

Zasady anulowania reguł planowania. (wymagane w przypadku Atrakcji)

Pole sumy min_booking_buffer. Czas (w sekundach) od momentu dokonania ostatniej rezerwacji do rozpoczęcia lub zakończenia przedziału dostępności.

Jeśli „min_advance_booking” , ostatni czas rezerwacji jest obliczany w ten sposób: (<czas rozpoczęcia boksu> – "min_advance_booking”). Jeśli „min_booking_buffer_before_end_time” , ostatni czas rezerwacji jest obliczany w ten sposób: (<czas zakończenia boksu> – "min_booking_buffer_before_end_time”). Zwróć uwagę, że wartość „min_booking_buffer_before_end_time” musi być liczbą dodatnią, jeśli jest ustawiona. Jeśli nie ustawisz obu tych ustawień, przedział można zarezerwować do czasu jego rozpoczęcia. Jeśli oba pola są ustawione, zostanie wybrana tylko jedna wartość, a druga zignorowana – nie możemy dokładnie przewidzieć, która wartość zostanie wybrana.

Przykłady:

  • Strzyżenie, które należy zarezerwować na co najmniej godzinę przed godziną rozpoczęcia. &#39;scheduling_rules{ min_advance_booking: 3600 ...}`

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

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

minAdvanceBooking

string (int64 format)

Czas (w sekundach) od momentu dokonania ostatniej rezerwacji do rozpoczęcia przedziału dostępności.

minBookingBufferBeforeEndTime

string (int64 format)

Czas (w sekundach) od momentu dokonania ostatniej rezerwacji do końca przedziału dostępności. Jeśli to pole jest ustawione, „admissionPolicy” należy ustawić wartość TIME_FLEXIBLE, aby wskazać, że użytkownicy mogą korzystać z zakupionych biletów po rozpoczęciu przedziałów.

AdmissionPolicy

Zasady akceptacji danej usługi.

Wartości w polu enum
ADMISSION_POLICY_UNSPECIFIED Nieużywane.
TIME_STRICT Klienci muszą być obecni w momencie rozpoczęcia przedziału dostępności, a usługa powinna zakończyć się po jego zakończeniu. Przykłady użycia funkcji TIME_STRICT: * Wycieczka, która zaczyna się o 9:00 i wymaga, aby wszyscy uczestnicy byli na miejscu, i powrót około 12:00. * Rezerwacja fryzjera o 15:00 w sobotę, która potrwa około 30 minut. * Zajęcia fitness od 18:00 do 20:00.
TIME_FLEXIBLE

Aby skorzystać z tej rezerwacji, klienci mogą przybyć w dowolnym momencie między godziną rozpoczęcia a zakończeniem przedziału dostępności.

Przykłady zastosowań TIME_FLEXIBLE: * Bilet do muzeum, którego można używać w dowolnym momencie w dniu zakupu. * Popołudniowy wstęp do parku rozrywki, z którego można korzystać w godzinach 12:00–21:00.

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Klienci muszą dotrzeć do sprzedawcy w momencie rozpoczęcia dostępności przedziału czasowego, ale mogą go opuścić w dowolnej chwili.

Przykład: w przypadku wstępu do muzeum bilet wstępu na godzinę na 10:00 wymaga, aby użytkownik trafił do muzeum o godzinie 10:00. Czas rozpoczęcia przedziałów dostępności dla tej usługi reprezentuje wyznaczony czas wejścia. Godzina zakończenia służy jednak wyłącznie do identyfikowania przedziału dostępności związanego z rezerwacją.

CancellationPolicy

Zasady anulowania usług.

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

object (RefundCondition)

brak lub więcej warunków zwrotu środków, które obowiązują w przypadku określonych zasad.

RefundCondition

Określa pojedynczy warunek zwrotu środków. Aby opisać „etapy zwrotu środków”, można użyć kilku warunków zwrotu środków. jako różne czasy trwania przed godziną rozpoczęcia usługi.

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

string (Duration format)

Okres przed godziną rozpoczęcia, do którego klient będzie mógł otrzymać zwrot części kosztów usługi określonej w refundPercent. Jeśli ustawisz wartość domyślną 0 (domyślnie), usługę można w każdej chwili anulować.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „s”. Przykład: "3.5s".

refundPercent

integer (uint32 format)

Procent kwoty zwrotu, o ile rezerwacja usługi zostanie anulowana co najmniej minDurationBeforeStartTime przed godziną rozpoczęcia usługi i mieści się w zakresie [0, 100]. Jeśli ma wartość 0 (wartość domyślna), usługa nie podlega zwrotowi środków. Gdy wartość wynosi 100, ta usługa podlega pełnym zwrotom.

PrepaymentType

Wartość enum określająca typ przedpłaty.

Wartości w polu enum
PREPAYMENT_TYPE_UNSPECIFIED Domyślnie zakładamy, że przedpłata NIE jest OBSŁUGIWANE.
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 za tę usługę.

PrepaymentTerms

Szczegółowe informacje o terminie realizacji przedpłaty.

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

enum (ChargeTiming)

Kiedy nastąpi obciążenie w zależności od czasu zakupu.

chargeTimeBeforeStartTimeSec

string (int64 format)

Czas w sekundach przed czasem uruchomienia usługi, przez który użytkownik jest obciążany płatnością. To pole należy ustawić tylko wtedy, gdy ChargeTiming ma wartość CHARGE_LATER.

ChargeTiming

Wartość enum umożliwiająca określenie, kiedy nastąpi obciążenie 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 Opłata zostanie naliczona później.

ServiceIntakeForm

Definiuje formularz odbioru, który pozwala dostosować 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 ma wartość prawda, ten formularz wyświetli się nowym klientom. Rola wycofana. Ta funkcja nie jest obsługiwana w przypadku formularzy przyjmowania zgłoszeń.

returningCustomers
(deprecated)

boolean

Jeśli ma wartość prawda, ten formularz będzie wyświetlany powracającym klientom. Rola wycofana. Ta funkcja nie jest obsługiwana w przypadku formularzy przyjmowania zgłoszeń.

ServiceIntakeFormField

Definiuje pole 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 agregatora, który jednoznacznie identyfikuje pole formularza. Powinien być taki sam jak identyfikator w odpowiedniej odpowiedzi w polu formularza i musi być niepowtarzalny zarówno na poziomie usługi, jak i w formularzach przyjmowania zgłoszeń. (wymagane)

type

enum (FieldType)

Typ tego pola.

label

string

Tekst w tym polu widoczny dla użytkownika. Wycofano. Zamiast niego używaj: localizedLabel.

localizedLabel

object (Text)

Tekst w tym polu widoczny dla użytkownika. To pole można podać w wielu językach. (wymagane)

value[]

string

Ustaw tylko wtedy, gdy typ pola to LOCATION_SEARCH. Użyj identyfikatora lokalizacji w „lokalizacji” w celu określenia wartości lokalizacji.

choiceText[]

object (Text)

Ustaw tylko wtedy, gdy 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 w uzupełnieniu wstępnie zdefiniowanych odpowiedzi dozwolona jest wartość niestandardowa. Ma to zastosowanie tylko wtedy, gdy typ pola to LOCATION_SEARCH. (opcjonalnie)

additionalOption[]

object (Text)

Oprócz podanych wartości dostępne są dodatkowe opcje. Ma zastosowanie tylko wtedy, gdy typ pola to LOCATION_SEARCH. Na przykład: oprócz podanej listy lokalizacji dostępna może być inna opcja „Skontaktuję się z dostawcą później”. (opcjonalnie)

ticketTypeRestrict[]

string

Jeśli to pytanie powinno być wyświetlane tylko wtedy, gdy użytkownik rezerwuje konkretne typy biletów, w tym polu należy ustawić odpowiednie identyfikatory. Pozostaw to pole puste, jeśli pytanie jest zawsze stosowane.

hint

object (Text)

Tekst podpowiedzi do danych wejściowych, który wyświetla się jako tekst zastępczy. Ma to zastosowanie tylko wtedy, gdy typem pola jest SHORT_ANSWER lub PARAGRAPH. (opcjonalnie)

FieldType

Enum, które wskazuje typ pola.

Wartości w polu enum
FIELD_TYPE_UNSPECIFIED Pola nieokreślonego lub nieznanego typu będą ignorowane.
SHORT_ANSWER Jednowierszowe pole do wprowadzania tekstu.
PARAGRAPH Wielowierszowe pole do wprowadzania tekstu.
MULTIPLE_CHOICE Zestaw przycisków, które wymagają jednego wyboru spośród wielu opcji.
CHECKBOXES Jeden lub więcej wymienionych elementów 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 w restauracji.
SERVICE_TYPE_FOOD_ORDERING Zamawianie jedzenia może odbywać się na zasadzie dowozu, na wynos lub w obu tych miejscach.
SERVICE_TYPE_FOOD_DELIVERY Dowóz jedzenia.
SERVICE_TYPE_FOOD_TAKEOUT Jedzenie na wynos.
SERVICE_TYPE_EVENT_TICKET Bilet na wydarzenie
SERVICE_TYPE_TRIP_TOUR Wycieczka w podróż.
SERVICE_TYPE_APPOINTMENT Usługa rezerwacji spotkań lub zajęć. Zalecane w przypadku: (1) usług zdrowotnych i fitnessowych, (2) usług spa i urody oraz (3) usług doradztwa finansowego i ocen. Listę obsługiwanych typów usług znajdziesz: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview.
SERVICE_TYPE_ONLINE_APPOINTMENT Usługa oferująca dostęp online do zajęć lub sesji, które są w pełni wirtualne. Ustawienie musi być skonfigurowane, jeśli włącza się rezerwowanie 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

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, atrybuty usług lub różne opcje bądź dodatki.

Bilet to minimalna jednostka, którą można zarezerwować w usłudze, np. miejsce na spływ, wstęp do muzeum, dwudniowa wynajem kajaków.

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

string

Identyfikator biletu służy do rozróżnienia typów biletów na tę samą usługę i powinien być niepowtarzalny w ramach danej usługi.

shortDescription

string

Krótki opis tego obiektu TicketType.

Może to być widoczny dla użytkownika, np. „adult”, „child”, „weteran”, „Row J” itd. Wymagany; każdy typ biletu powinien mieć opis, który będzie widoczny dla użytkownika. Wycofany. Zamiast niego użyj localizedShortDescription.

localizedShortDescription

object (Text)

Krótki opis tego typu TicketType z obsługą i18n.

Może to być widoczny dla użytkownika, np. „adult”, „child”, „weteran”, „Row J” itd. Wymagany; każdy typ biletu powinien mieć opis, który będzie widoczny dla użytkownika. Dla każdego języka można podać oddzielne wartości.

price

object (Price)

Cena pojedynczego biletu tego typu bez podatków. Do biletów naliczany jest podatek od Usługi.

perTicketFee

object (PerTicketFee)

Dodatkowe opłaty za zakup tego biletu. (opcjonalnie)

optionDescription

string

Opis dodatkowej opcji reprezentowanej przez ten typ biletu (jeśli dotyczy). Wycofana. Zamiast niej użyj elementu localizedOptionDescription.

localizedOptionDescription

object (Text)

Opis dodatkowej opcji reprezentowanej przez ten typ biletu (jeśli dotyczy). Dla każdego języka można podać oddzielne wartości.

Dodatkowe opcje są przydatne, gdy typ zgłoszenia odpowiada wielu wymiarom.

Przykład 1: bilet wstępu z różnymi typami atrybutów „dorośli” i „dzieci” i języka jako dodatkowej opcji, oczekiwana lista TicketType będzie wyglądała tak: - {ticketTypeId: "ticket_type_1" localizedShortDescription { value: "dla dorosłych" } localizedOptionDescription { value: "english" } } – {ticketTypeId: "ticket_type_2" localizedShortDescription { value: "dla dorosłych" } localizedOptionDescription { value: "hiszpański" } } – {ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } – {ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "hiszpański" }

Przykład 2: wielogodzinne wypożyczenie kajaka z opcjonalnym plusem suchej torby. Krótki opis może mieć wartość „3 godziny” a opcjaDescription może mieć wartość „z suchą torbą”. lub „bez suchej torby”: - {ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 godziny" } localizedOptionDescription { value: "english" } } – {ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 godziny" } localizedOptionDescription { value: "hiszpański" } } – {ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 godziny" } localizedOptionDescription { value: "english" } } – {ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 godziny" } localizedOptionDescription { value: "hiszpański" }

Opcjonalne, ale jeśli dowolny typ zgłoszenia w usłudze ma ustawione to pole, oczekujemy, że to pole będzie mieć również ustawione w przypadku wszystkich innych typów biletów (można użyć domyślnej opcjiDescription). Na przykład: [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] nie jest prawidłową listą.

Obsługiwane są tylko dwa tagi formatowania HTML: i
. Służą do określenia opcji z tytułem i szczegółowym opisem, np. „Miejsca premium
W tej opcji dostępne są miejsca do siedzenia przy prywatnych skrzyniach, w tym w pełni wyłożone fotelami, prywatne telewizory oraz obsługa posiłków i napojów. Z tych miejsc rozciąga się malowniczy widok na pole golfowe”.

PerTicketFee

Opłaty, które muszą zostać uiszczone za każdy zakupiony przez użytkownika bilet.

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

object (Price)

Naliczono dodatkową opłatę za usługę.

facilityFee

object (Price)

Opłata za wstęp na teren wydarzenia.

taxes

object (Price)

Podatki za bilet.

RelatedMedia

Zdjęcia powiązane z tą usługą. Google zindeksuje te multimedia, aby upewnić się, że są 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 zindeksuje multimedia przechowywane pod tym adresem URL.

type

enum (MediaType)

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

localizedCaption

object (Text)

Napisy do multimediów obsługujących i18n. Obsługiwany jest tylko zwykły tekst. Wszystkie komponenty HTML zostaną usunięte. (opcjonalnie)

attribution

object (Attribution)

Informacje o źródle mediów. Pamiętaj, że jeśli informacje o autorze utworu mają być widoczne w mediach w celu uznania autorstwa fotografa lub agencji, musisz ustawić to pole. (opcjonalnie)

caption
(deprecated)

string

Wycofany. Wolę używać localizedCaption.

MediaType

Enum, które wskazuje typ tego źródła multimediów. Obsługiwane są tylko zdjęcia. Jeśli potrzebujesz obsługi innych multimediów poza zdjęciami, skontaktuj się z zespołem Zarezerwuj z Google.

Wartości w polu enum
TYPE_UNSPECIFIED Nieużywane.
PHOTO Wskazuje, że multimedia dostarczone przez adres URL to zdjęcie.

Atrybucja

Informacje o autorze utworu.

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

object (Text)

Tekst w informacjach o fotografie lub agencji zajmującej się Twoją sprawą. Ten tekst będzie wyświetlany razem z multimediami źródłowymi. Pamiętaj, że w tym polu obsługiwany jest tylko zwykły tekst. Wszystkie komponenty HTML zostaną usunięte (atrybucja oparta na hiperlinkach nie jest obsługiwana).

text
(deprecated)

string

Wycofany. Wolę używać localizedText.

ServiceAttributeValueId

Określa konkretną wartość atrybutu usługi, która ma być zastosowana do usługi.

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

string

Identyfikator atrybutu określonego w atrybucie Merchant.service_attribute, np. „service-type”.

valueId

string

Identyfikator wartości tego atrybutu, np. „strzyżenie”. Musi pasować do identyfikatora valueId w definicji atrybutu usługi.

WaitlistRules

Zasady dotyczące dołączania do listy oczekujących.

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

integer

Wymagane. Wartość musi być dodatnią liczbą całkowitą w przypadku usług zapewniających funkcję listy oczekujących. Jeśli usługa lub sprzedawca nie udostępnia funkcji listy oczekujących, nie należy go podawać.

maxPartySize

integer

Wymagane. Wartość musi być dodatnią liczbą całkowitą w przypadku usług zapewniających funkcję listy oczekujących. Jeśli usługa lub sprzedawca nie udostępnia funkcji listy oczekujących, nie należy go podawać.

supportsAdditionalRequest

boolean

Jeśli wybrano opcję prawda, użytkownik będzie mógł wysyłać dodatkowe prośby tekstowe podczas dołączania do listy oczekujących na tę usługę.

aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Ustaw opcje dla grup większych niż określona wartość maxPartySize. Pozostaw puste, jeśli większe grupy nie powinny mieć alternatywnych opcji dołączania do listy oczekujących.

UnsupportedPartySizeOption

Opcje dla grup, które są poza zasięgiem.

Zapis JSON
{
  "callMerchant": {
    object (CallMerchant)
  }
}
Pola
callMerchant

object (CallMerchant)

Liczby osób spoza zakresu mogą dzwonić do firmy. Użytkownikowi zostanie wyświetlony wstępnie zdefiniowany komunikat. Przykładowy tekst do wyświetlenia: „W przypadku imprez większych niż {waitlistRules.max_party_size} zadzwoń do restauracji pod numer {phone}”. Wartość pola CallMerchant musi być ustawiona, ale będzie pusta.

CallMerchant

Pusta wiadomość do użycia w elemencie Nieobsługiwany rozmiarOption. Spowoduje to wyświetlanie użytkownikom opcji dzwonienia 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)
}
Pola
eventCategory

enum (EventCategory)

Kategoria wydarzenia. Ustaw tylko wtedy, gdy zdarzenie należy do jednej ze wstępnie zdefiniowanych kategorii. (opcjonalnie)

eventUrl

string

Adres URL zdarzenia na stronie partnera. (opcjonalnie)

entity[]

object (Entity)

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

eventAttendanceMode

enum (AttendanceMode)

Wymagane. Typ obecności na wydarzeniu.

eventVirtualLocationUrl[]

string

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

eventOrganizer

object (Text)

Opcjonalnie: Organizatorem wydarzenia.

eventOrganizerUrl

string

Opcjonalnie: Adres URL organizatora wydarzenia.

eventOrganizerType

enum (OrganizerType)

Opcjonalnie: Typ organizatora.

eventSourceUrl[]

string

Wymagane. Adresy URL stron, na których można znaleźć informacje o wydarzeniu lub jego opisy.

eventState

enum (EventState)

Opcjonalnie: Stan wydarzenia.

EventCategory

Podzbiór kategorii zdarzeń, w przypadku których dostosowujemy obsługę 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 elementu w bazie danych partnera. (opcjonalnie)

name

string

Nazwa elementu. (wymagane)

url

string

Adres URL strony internetowej, który jednoznacznie opisuje dany element. Jest to strona internetowa danego podmiotu w witrynie partnera; w przypadku innych publicznych adresów URL elementu użyj parametru relevantUrl w polu publicIdentificationData. (opcjonalnie)

entityType

enum (EntityType)

Typ elementu. (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 grupę występującą na koncercie lub widowisku. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to KONCERT lub TEMAT.
ENTITY_TYPE_PLAYER Element reprezentuje drużynę lub zawodnika sportowego, który bierze udział w wydarzeniu. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to SPORTS.
ENTITY_TYPE_CONCERT_TOUR Element reprezentuje wycieczkę, do której należy to wydarzenie. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to KONCERT.
ENTITY_TYPE_SPORTS_SERIES Element reprezentuje turniej sportowy, do którego należy to wydarzenie. Ma zastosowanie tylko wtedy, gdy kategoria wydarzenia to SPORTS.
ENTITY_TYPE_PLAY Jednostka reprezentuje rodzaj sztuky (np. musical, komedia, balet itp.) wykonywana podczas wydarzenia. Ma zastosowanie tylko wtedy, gdy kategoria zdarzenia to TEAT.

EntityRole

Rola elementu w zdarzeniu.

Wartości w polu enum
ENTITY_ROLE_UNSPECIFIED Nie określono.
ENTITY_ROLE_HEADLINER Element reprezentuje główną osobę lub główną wykonawczynię wydarzenia.
ENTITY_ROLE_SUPPORTER Element reprezentuje wykonawcę pomocniczego podczas wydarzenia.
ENTITY_ROLE_HOME_TEAM Element reprezentuje drużynę gospodarza podczas wydarzenia (sportowego).
ENTITY_ROLE_AWAY_TEAM Element reprezentuje drużynę wypadową podczas wydarzenia (sportowego).

PublicIdentificationData

Identyfikatory, strony internetowe i wszelkie inne źródła publiczne odnoszących się do danego podmiotu.

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

string

Publiczny adres URL dowolnej strony internetowej poświęconej tylko tematowi. Może to obejmować oficjalne strony internetowe, dyskoteki, platformy mediów społecznościowych, strony 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

Składający się z 36 znaków identyfikator wykonawcy lub innych podmiotów muzycznych (w stosownych przypadkach). Więcej informacji znajdziesz na https://musicbrainz.org/doc/MusicBrainz_Identifier. (opcjonalnie)

AttendanceMode

Typ obecności na wydarzeniu.

Wartości w polu enum
ATTENDANCE_MODE_UNSPECIFIED Nie określono.
ONLINE Wydarzenia wirtualne.
PHYSICAL Dotyczy wydarzeń fizycznych.
PHYSICAL_ONLINE_MIXED Dotyczy wydarzeń zarówno fizycznych, jak i wirtualnych.

OrganizerType

Typ organizatora.

Wartości w polu enum
ORGANIZER_TYPE_UNSPECIFIED Nie określono.
PERSON Dotyczy 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 zostało przełożone.
CANCELLED Wydarzenie zostało anulowane.
POSTPONED Wydarzenie zostało przełożone.

IntegrationType

Obsługiwana jest 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ę przez Google.
INTEGRATION_TYPE_INVENTORY_ONLY Serwer rezerwacji nie musi obsługiwać tej usługi. Należy przesyłać tylko dane dotyczące sprzedawców i usług oraz (opcjonalnie) dane o dostępności.

PerOrderFee

Opłaty, które należy uregulować raz za 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 specyficzne dla wycieczek i aktywności. Każdy element w polu powtarzanym powinien być niezależny, by można było go renderować (np. jako punktor).

Wypełnianie pól ToursAndActivitiesContent jest zdecydowanie zalecane w przypadku wycieczek i aktywności, ale nie jest wymagane. Wszystkie pola obsługują zarówno zwykły tekst, jak i tekst podobny do HTML. Obsługiwane tagi formatowania podobne do HTML:

Tagi wyrażeń:
, , , : obsługiwane są tylko trzy tagi wymienione powyżej. Za pomocą
możesz dzielić wiersze w akapitach, a // – do wyróżniania ważnych tekstów. Pozostałe tagi do wyrażenia będą ignorowane.

Wszystkie inne tagi oraz 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 powielaj danych podanych w polach highlights i exclusion oraz innych bardziej szczegółowych polach opisu usługi. * Unikaj używania innych tagów z wyjątkiem tych obsługiwanych powyżej, ponieważ zawartość w nieobsługiwanych tagach zostanie usunięta, co może negatywnie wpłynąć na wrażenia użytkownika.

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żytkowników.

inclusions[]

object (Text)

Lista uwzględnionych użytkowników widoczna dla użytkowników.

exclusions[]

object (Text)

Lista wykluczeń widoczna dla użytkowników.

mustKnow[]

object (Text)

Widoczna dla użytkownika lista ważnych uwag. Można ją wykorzystać do uzyskania takich informacji jak ograniczenia wiekowe lub inne warunki, które sprawiają, że dana 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 na Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz na stronie https://developers.google.com/places/web-service/place-id. Jeśli ta wartość zostanie podana, 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ż znajdujących się w Mapach Google.

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

telephone

string

Publiczny numer telefonu do danej lokalizacji wraz z numerami kierunkowymi i krajami, np. +14567891234. (opcjonalnie)

url

string

Adres URL publicznej witryny lokalizacji. (opcjonalnie)

geo

object (GeoCoordinates)

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

locationType

enum (LocationType)

Jeśli ta lokalizacja jest udostępniana w przypadku Usługi, należy podać typ lokalizacji.

locationId

string

Unikalne odwołanie do lokalizacji w usłudze. Ten identyfikator może być używany do odwoływania się do tej lokalizacji w innych polach dotyczących usługi. Na przykład: w niestandardowym formularzu odbioru można wykorzystać zestaw identyfikatorów lokalizacji, aby określić opcje miejsca odbioru. Jeśli jest ustawiony, ten identyfikator powinien być unikalny w ramach tej samej usługi. (opcjonalnie)

LocationType

Typ lokalizacji.

Wartości w polu enum
LOCATION_TYPE_UNSPECIFIED Nieokreślony typ lokalizacji.
VISITED_LOCATION Lokalizacja, w której odwiedzana jest ta usługa.
START_LOCATION Lokalizacja, w której usługa jest uruchamiana, służy też jako MEETING_LOCATION.
END_LOCATION Lokalizacja, w której kończy się działanie usługi.

Ocena

Określa ocenę encji.

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 wartość numberOfRatings wynosi 0.

numberOfRatings

string

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

HomeServiceData

W przypadku branży usług dla domu wymagane jest podanie dodatkowych informacji.

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

string

Kategoria ogólna, do której należy ta usługa dla domu. Na przykład: hydraulik, elektryk itp.

jobType

string

Typ zlecenia w kategorii, do której należy dana usługa dla domu. Na przykład: unclog_drain i install_faucet to typy zleceń w kategorii hydraulik.

VirtualSession

Informacje o sesji wirtualnej/online. Na przykład: Lekcje jogi online, wirtualne lekcje gotowania itp.

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

object (Text)

Instrukcje konfiguracji tych wirtualnych zajęć. Jeśli partner nie poda w rezerwacji adresu URL filmu, tekst ten musi zawierać informację o tym, kiedy adres URL filmu zostanie udostępniony użytkownikowi. np. „Adres URL powiększenia zostanie wysłany na 30 minut przed zajęciami”. (zalecana)

sessionRequirements

object (Text)

Wymagania danej sesji wirtualnej. Na przykład: 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 tę wartość na „prawda”, jeśli sesja wirtualna nie jest aktywna i została nagrana.

VirtualPlatformInfo

Informacje o platformie, która zostanie użyta w tej sesji wirtualnej.

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

enum (Platform)

Platforma używana na potrzeby sesji wirtualnej.

otherPlatformName

object (Text)

Nazwa platformy, jeśli jest ustawiona na INNA. (Wymagane, jeśli platforma jest ustawiona na OTHER)

Platforma

Wartość enum określająca, z której platformy wirtualnej będzie korzystał sprzedawca.

Wartości w polu enum
PLATFORM_UNSPECIFIED Nieużywane.
FLEXIBLE Sprzedawca może elastycznie określić swoją platformę wideo.
GOOGLE_HANGOUTS Usługa Google Hangouts.
GOOGLE_MEET Usługa Google Meet.
ZOOM Zoom Video Communications.
SKYPE Skype'a
YOUTUBE Transmitowanie na żywo w YouTube.
OTHER Tego ustawienia należy ustawić, jeśli używana platforma wideo różni się od wymienionej tutaj.

DirectMerchantPayment

Informacje o tym, jak użytkownik może zapłacić bezpośrednio sprzedawcy, zamiast płacić za usługę z góry przez RwG.

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

object (Text)

Zalecamy użytkownikom płacenie wyłącznie za pomocą form płatności opisanych poniżej.

Metody

create

Tworzy nową wartość Service dla sprzedawcy zarządzanego przez określonego pośrednika i zwraca go.

delete

Usuwa istniejące Service sprzedawcy zarządzanego przez określonego pośrednika.

patch

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