Package google.maps.booking.v1alpha

Maksymalna sygnatura czasowa UTC (włącznie), do której powtarza się dostępność.

repeat_every

ExtendedServiceAvailability

Określa czas między kolejnymi przedziałami dostępności.

Przykład: dostępność z czasem trwania 20 min, powtarzaniem co 30 min, czasem rozpoczęcia 9:00 i czasem zakończenia 11:00 spowoduje utworzenie przedziałów czasowych 9:00–9:20, 9:30–9:50, 10:00–10:20, 10:30–10:50 i 11:00–11:20. (wymagane)

ScheduleException

Wiadomości ScheduleException reprezentują zarezerwowane lub niedostępne przedziały czasu w ciągu dnia pracy, które są wyjątkami od opisanego powyżej cyklu. W miarę rezerwowania terminów lista wyjątków powinna być aktualizowana, aby odzwierciedlać nowo niedostępne przedziały czasowe. Nie należy modyfikować samego cyklu.

Pola

Pola
`time_range`	`TimeRange` Zakres czasu wyjątku. Wszystkie terminy opisane przez powtarzanie, które pokrywają się z tym przedziałem czasu, będą uznawane za niedostępne. Przykład: jeśli powtarzanie określa czas trwania 20 minut, repeat_every 30 minut, start_time 9:00 i repeat_until 11:00, to ScheduleException z time_range 9:45–11:00 spowoduje niedostępność przedziałów czasowych 9:30–9:50, 10:00–10:20 i 10:30–10:50. Pamiętaj, że ponieważ zakres czasu jest zamknięto-otwarty, nie ma to wpływu na przedział czasu rozpoczynający się o godzinie 11:00.

time_range

TimeRange

Zakres czasu wyjątku. Wszystkie terminy opisane przez powtarzanie, które pokrywają się z tym przedziałem czasu, będą uznawane za niedostępne.

Przykład: jeśli powtarzanie określa czas trwania 20 minut, repeat_every 30 minut, start_time 9:00 i repeat_until 11:00, to ScheduleException z time_range 9:45–11:00 spowoduje niedostępność przedziałów czasowych 9:30–9:50, 10:00–10:20 i 10:30–10:50.

Pamiętaj, że ponieważ zakres czasu jest zamknięto-otwarty, nie ma to wpływu na przedział czasu rozpoczynający się o godzinie 11:00.

SchedulingRuleOverrides

Reguły harmonogramu poziomu dostępności.

Pola

Pola
`last_bookable_sec`	`int64` Ostatni moment (w sekundach), w którym można zarezerwować ten przedział czasowy. Ta sygnatura czasowa musi być wcześniejsza niż start_sec przedziału, aby była uwzględniana (jeśli użytkownicy mają mieć możliwość rezerwacji po godzinie rozpoczęcia, użyj SchedulingRules.min_booking_before_end_time na poziomie usługi). Jeśli jest obecny, zastąpi wszystko, co zostało określone w min_booking_buffer w SchedulingRules odpowiedniej usługi.
`first_bookable_sec`	`int64` Pierwszy moment (w sekundach), w którym można zarezerwować ten przedział czasu. Ta sygnatura czasowa musi być wcześniejsza niż start_sec przedziału lub last_bookable_sec, jeśli jest określona.
`last_online_cancellable_sec`	`int64` Jeśli jest ustawiona, ostatni czas (w sekundach od początku epoki systemu Unix), w którym można anulować konkretny przedział czasowy rezerwacji za pomocą funkcji Zarezerwuj z Google. To pole zastąpi wszystkie reguły anulowania na poziomie usługi. (opcjonalnie)

last_bookable_sec

int64

Ostatni moment (w sekundach), w którym można zarezerwować ten przedział czasowy. Ta sygnatura czasowa musi być wcześniejsza niż start_sec przedziału, aby była uwzględniana (jeśli użytkownicy mają mieć możliwość rezerwacji po godzinie rozpoczęcia, użyj SchedulingRules.min_booking_before_end_time na poziomie usługi). Jeśli jest obecny, zastąpi wszystko, co zostało określone w min_booking_buffer w SchedulingRules odpowiedniej usługi.

first_bookable_sec

int64

Pierwszy moment (w sekundach), w którym można zarezerwować ten przedział czasu. Ta sygnatura czasowa musi być wcześniejsza niż start_sec przedziału lub last_bookable_sec, jeśli jest określona.

last_online_cancellable_sec

int64

Jeśli jest ustawiona, ostatni czas (w sekundach od początku epoki systemu Unix), w którym można anulować konkretny przedział czasowy rezerwacji za pomocą funkcji Zarezerwuj z Google. To pole zastąpi wszystkie reguły anulowania na poziomie usługi. (opcjonalnie)

BatchDeleteGenericRecordsRequest

Żądanie zbiorcze usunięcia rekordów określonego typu pliku danych.

Pola

Pola
`parent`	`string` Nazwa zasobu w formacie `partners/{partner_id}/feeds/{feed_name}`.
`records[]`	`GenericDeleteRecord` Rekordy do usunięcia. W jednym wywołaniu interfejsu API można przesłać maksymalnie 1000 rekordów.

parent

string

Nazwa zasobu w formacie partners/{partner_id}/feeds/{feed_name}.

records[]

GenericDeleteRecord

Rekordy do usunięcia. W jednym wywołaniu interfejsu API można przesłać maksymalnie 1000 rekordów.

BatchPushGenericRecordRequest

Żądanie zbiorcze wstawienia lub zaktualizowania rekordów typu pliku danych określonego w adresie URL żądania.

Pola

Pola
`parent`	`string` Nazwa zasobu w formacie `partners/{partner_id}/feeds/{feed_name}`.
`records[]`	`GenericRecord` Rekordy do wstawienia lub zaktualizowania. W jednym wywołaniu interfejsu API można przesłać maksymalnie 1000 rekordów.

parent

string

Nazwa zasobu w formacie partners/{partner_id}/feeds/{feed_name}.

records[]

GenericRecord

Rekordy do wstawienia lub zaktualizowania. W jednym wywołaniu interfejsu API można przesłać maksymalnie 1000 rekordów.

BatchReplaceServiceAvailabilityRequest

Żądanie zbiorcze zastąpienia wielu przedziałów dostępności Service.

Pola

Pola
`parent`	`string` Format `partners/{partner_id}`.
`extended_service_availability[]`	`ExtendedServiceAvailability` Rozszerzona dostępność usługi, która zastępuje dotychczasowe przedziały czasowe dostępności.

parent

string

Format partners/{partner_id}.

extended_service_availability[]

Rozszerzona dostępność usługi, która zastępuje dotychczasowe przedziały czasowe dostępności.

BatchReplaceServiceAvailabilityResponse

Odpowiedź zbiorcza na zastąpienie wielu przedziałów dostępności Service. W tej wiadomości uwzględnione będą tylko pomyślnie zaktualizowane miejsca.

Pola

Pola
`extended_service_availability[]`	`ExtendedServiceAvailability` Komunikaty o zaktualizowanej dostępności usługi rozszerzonej, które zostały użyte do zastąpienia dotychczasowych przedziałów czasowych.

extended_service_availability[]

ExtendedServiceAvailability

Komunikaty o zaktualizowanej dostępności usługi rozszerzonej, które zostały użyte do zastąpienia dotychczasowych przedziałów czasowych.

Booking

Rezerwacja miejsca na reklamę

Pola
`name`	`string` Nazwa zasobu rezerwacji: `partners/{partner ID}/bookings/{booking ID}`
`merchant_id`	`string` Identyfikator sprzedawcy dla przedziału
`service_id`	`string` Identyfikator usługi sprzedawcy
`start_time`	`Timestamp` Godzina rozpoczęcia terminu spotkania
`duration`	`Duration` Czas trwania terminu spotkania
`client_information`	`ClientInformation` Dane osobowe klienta, który umawia spotkanie
`status`	`BookingStatus` Stan rezerwacji
`payment_information`	`PaymentInformation` Informacje o transakcjach płatniczych związanych z rezerwacją.
`party_size`	`int64` Liczba osób w rezerwacji

BookingFailure

Dane stanu, które asynchronicznie informują o przyczynie niepowodzenia przetwarzania rezerwacji. Błąd BookingFailure ma przede wszystkim rejestrować błędy logiki biznesowej.

Pola
`cause`	`Cause` Przyczyna niepowodzenia rezerwacji. (wymagane)
`rejected_card_type`	`CreditCardType` (wymagany tylko wtedy, gdy przyczyną jest PAYMENT_ERROR_CARD_TYPE_REJECTED)
`description`	`string` To pole opcjonalne służy partnerowi do podawania dodatkowych informacji wyłącznie na potrzeby debugowania. (opcjonalnie)
`payment_failure`	`PaymentFailureInformation` Informacje o nieudanych płatnościach.

Przyczyna

Wymień przyczyny niepowodzenia.

Wartości w polu enum
`CAUSE_UNSPECIFIED`	Wartość domyślna: nie używaj; oznacza „nieznany błąd”.
`SLOT_UNAVAILABLE`	Odwołanie do przedziału czasu nie jest już dostępne.
`SLOT_ALREADY_BOOKED_BY_USER`	Użytkownik zarezerwował już spotkanie w odniesieniu do danego przedziału czasu.
`LEASE_EXPIRED`	Umowa najmu (jeśli została podana) wygasła i nie można jej już używać do dokończenia rezerwacji.
`OUTSIDE_CANCELLATION_WINDOW`	Żądanej anulacji nie można obecnie wykonać ze względu na ograniczenia czasowe w zasadach anulowania sprzedawcy.
`PAYMENT_ERROR_CARD_TYPE_REJECTED`	Podczas przetwarzania płatności wystąpił błąd, ponieważ podany typ karty kredytowej nie jest akceptowany przez sprzedawcę. Typ karty kredytowej musi być podany w parametrze rejected_card_type.
`PAYMENT_ERROR_CARD_DECLINED`	Podczas przetwarzania płatności wystąpił błąd, ponieważ podana karta kredytowa została odrzucona.
`PAYMENT_OPTION_NOT_VALID`	Wystąpił błąd dotyczący pakietu lub subskrypcji użytych do opłacenia rezerwacji. Mogą nie być już dostępne żadne prawidłowe zastosowania, kupon mógł wygasnąć itp.
`PAYMENT_ERROR`	Podczas przetwarzania płatności za tę rezerwację wystąpił błąd. Użyj tej wartości, aby wskazać ogólny błąd związany z płatnością, tylko wtedy, gdy nie pasuje on do żadnego z powyższych błędów.
`USER_CANNOT_USE_PAYMENT_OPTION`	Użytkownik nie może skorzystać z danej opcji płatności (np. próbuje skorzystać z ceny dla nowych użytkowników po raz drugi).
`BOOKING_ALREADY_CANCELLED`	Rezerwacja, którą użytkownik próbował anulować, została już anulowana.
`BOOKING_NOT_CANCELLABLE`	Rezerwacji, którą użytkownik próbował anulować, nie można anulować.
`OVERLAPPING_RESERVATION`	Użytkownik ma już rezerwację, która jest zbyt blisko tego terminu.
`USER_OVER_BOOKING_LIMIT`	Nie udało się dokonać rezerwacji, ponieważ użytkownik przekroczył limit rezerwacji na użytkownika ustalony przez agregatora.
`PAYMENT_REQUIRES_3DS1`	Ustaw, kiedy płatność zostanie odrzucona, ponieważ prosisz o ponowną próbę transakcji, ale tym razem po przejściu weryfikacji 3DS1. Pamiętaj, że stan niepowodzenia bieżącej transakcji pozostanie niezmieniony. Ponowna próba będzie całkowicie odrębna. Jeśli to jest przyczyną niepowodzenia, należy ustawić parametr payment_failure.3DS1_parameters. Jeśli nie, bieżąca przyczyna zostanie potraktowana tak, jakby była to PAYMENT_ERROR.

PaymentFailureInformation

Informacje o nieudanych płatnościach.

Pola

Pola
`threeds1_parameters`	`ThreeDS1Parameters` Parametry używane przez agregatora RwG do inicjowania protokołu uwierzytelniania 3DS1 z użytkownikiem. Zostanie zignorowany, chyba że BookingFailure.cause ma wartość PAYMENT_REQUIRES_3DS1.

threeds1_parameters

ThreeDS1Parameters

Parametry używane przez agregatora RwG do inicjowania protokołu uwierzytelniania 3DS1 z użytkownikiem. Zostanie zignorowany, chyba że BookingFailure.cause ma wartość PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Parametry żądające od RwG przeprowadzenia weryfikacji 3DS1.

Parametry są ustawiane zgodnie z opisem protokołu 3DS1 opracowanym przez EMVCo.

Pola
`acs_url`	`string` Adres URL, z którego ma być wczytywany formularz do uwierzytelniania użytkownika.
`pa_req`	`string` Żądanie PaymentAuthentication. Jeśli zostanie podany, zostanie opublikowany w formularzu ACSUrl.
`transaction_id`	`string` Identyfikator używany przez dostawcę ACS. Jeśli zostanie podany, zostanie opublikowany w formularzu ACSUrl.
`md_merchant_data`	`string` dane sprzedawcy; Jeśli zostanie podany, zostanie opublikowany w formularzu ACSUrl.

BookingStatus

Stan rezerwacji

Wartości w polu enum
`BOOKING_STATUS_UNSPECIFIED`	Nie określono.
`CONFIRMED`	Rezerwacja została potwierdzona
`PENDING_MERCHANT_CONFIRMATION`	Rezerwacja oczekuje na potwierdzenie przez sprzedawcę, zanim będzie mogła przejść do stanu POTWIERDZONA (obecnie NIE jest to obsługiwane).
`PENDING_CLIENT_CONFIRMATION`	Rezerwacja oczekuje na potwierdzenie przez klienta, zanim będzie mogła przejść do stanu POTWIERDZONA (obecnie NIE jest obsługiwana).
`CANCELED`	Rezerwacja została anulowana w imieniu użytkownika.
`NO_SHOW`	Klient nie pojawił się na spotkaniu
`NO_SHOW_PENALIZED`	Klient nie pojawił się na spotkaniu, co jest niezgodne z zasadami anulowania.
`FAILED`	Nie udało się dokonać rezerwacji z powodu błędu przetwarzania.
`DECLINED_BY_MERCHANT`	Rezerwacja została asynchronicznie odrzucona przez sprzedawcę.

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.

CancellationPolicy

Zasady anulowania usługi.

Pola

Pola
`refund_condition[]`	`RefundCondition` Zero lub więcej warunków zwrotu środków mających zastosowanie do zasad.

refund_condition[]

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.

Pola

Pola
`min_duration_before_start_time`	`Duration` Okres przed czasem rozpoczęcia, w którym klient może otrzymać zwrot części kosztów usługi określonych w `refund_percent`. Jeśli ta wartość wynosi 0 (domyślnie), usługę można anulować w dowolnym momencie.
`refund_percent`	`uint32` Procent, który można zwrócić, o ile rezerwacja usługi zostanie anulowana co najmniej `min_duration_before_start_time` 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.

min_duration_before_start_time

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

refund_percent

uint32

Procent, który można zwrócić, o ile rezerwacja usługi zostanie anulowana co najmniej min_duration_before_start_time 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.

ClientInformation

Dane osobowe osoby dokonującej rezerwacji

Pola
`given_name`	`string` Imię klienta
`family_name`	`string` Nazwisko klienta
`address`	`PostalAddress` Adres klienta
`telephone`	`string` Numer telefonu klienta
`email`	`string` Adres e-mail klienta

CreateAdsAccountLinkRequest

Wiadomość z prośbą o wywołanie funkcji AdsAccountLinkingService.CreateAdsAccountLink.

Pola

Pola
`parent`	`string` Wymagane. Zasób nadrzędny, w którym zostanie utworzone to połączenie z kontem Google Ads. Jest to ten sam identyfikator co identyfikator konta w Centrum Partnerów. Format: partners/{partner}
`ads_account_link_id`	`string` Wymagane. Identyfikator, którego należy użyć w przypadku połączenia z kontem reklamowym. Jest on taki sam jak identyfikator klienta Google Ads. Szczegółowe informacje znajdziesz na stronie https://support.google.com/google-ads/answer/1704344. Format : xxx-xxx-xxxx.
`ads_account_link`	`AdsAccountLink` Wymagane. Obiekt AdsAccountLink do utworzenia.

parent

string

Wymagane. Zasób nadrzędny, w którym zostanie utworzone to połączenie z kontem Google Ads. Jest to ten sam identyfikator co identyfikator konta w Centrum Partnerów. Format: partners/{partner}

ads_account_link_id

string

Wymagane. Identyfikator, którego należy użyć w przypadku połączenia z kontem reklamowym. Jest on taki sam jak identyfikator klienta Google Ads. Szczegółowe informacje znajdziesz na stronie https://support.google.com/google-ads/answer/1704344. Format : xxx-xxx-xxxx.

ads_account_link

AdsAccountLink

Wymagane. Obiekt AdsAccountLink do utworzenia.

CreateMerchantRequest

Żądanie utworzenia Merchant.

Pola

parent

string

Nazwa zasobu nadrzędnego partnera, który jest właścicielem tego sprzedawcy, w formacie partners/{partner_id}.

merchant_id

string

Identyfikator sprzedawcy, którego chcesz użyć w przypadku tego sprzedawcy.

merchant

Merchant

Sprzedawca, który ma zostać utworzony.

CreateServiceRequest

Prośba o utworzenie nowego Service.

Pola

parent

string

Nazwa zasobu nadrzędnego sprzedawcy, który jest właścicielem tej usługi, w formacie partners/{partner_id}/merchants/{merchant_id}.

service_id

string

Identyfikator usługi, którego chcesz używać w tej usłudze.

service

Service

Usługa do utworzenia.

CreditCardRestrictions

Ograniczenia dotyczące typów kart kredytowych akceptowanych przez tego sprzedawcę.

Pola

credit_card_type[]

CreditCardType

Lista obsługiwanych kart kredytowych. Jeśli to pole jest puste, żadne karty kredytowe nie są obsługiwane.

CreditCardType

Typ karty kredytowej.

Wartości w polu enum
`CREDIT_CARD_TYPE_UNSPECIFIED`	Nieużywane.
`VISA`	karty kredytowej Visa;
`MASTERCARD`	karta kredytowa Mastercard;
`AMERICAN_EXPRESS`	karta kredytowa American Express;
`DISCOVER`	karta kredytowa Discover,
`JCB`	karta kredytowa JCB;

DeleteAdsAccountLinkRequest

Wiadomość z prośbą o usunięcie połączenia konta Google Ads.

Pola

name

string

Wymagane. Nazwa AdsAccountLink do usunięcia. Format: partners/{partner}/adsAccountLinks/{ads_account_link}

DeleteMerchantRequest

Prośba o usunięcie Merchant.

Pola

name

string

Nazwa zasobu sprzedawcy do usunięcia. W formacie partners/{partner_id}/merchants/{merchant_id}

DeleteServiceRequest

Prośba o usunięcie Service.

Pola

name

string

Nazwa zasobu usługi do usunięcia. W formacie partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Wpłata

Zaliczka, którą użytkownik może zostać obciążony lub która może zostać zablokowana na jego karcie kredytowej.

Pola

deposit

kwota wpłaty;

min_advance_cancellation_sec

int64

Minimalny okres anulowania rezerwacji z wyprzedzeniem, aby otrzymać zwrot zaliczki.

deposit_type

PriceType

Określa, w jaki sposób zaliczka jest określana na podstawie dostępności.

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.

Pola

payment_methods[]

Text

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

DurationRange

Klasa opakowująca zakres czasu trwania, który może być ograniczony lub nieograniczony. Wymagany jest co najmniej jeden z tych parametrów: min_duration lub max_duration.

Pola

min_duration

Minimalny czas trwania.

max_duration

Maksymalny czas trwania.

EconomicOperator

Informacje o podmiocie gospodarczym w przypadku agregatora.

Pola

text

Text

Wymagane. Imię i nazwisko, adres, numer telefonu i adres e-mail podmiotu gospodarczego, czyli producenta, upoważnionego przedstawiciela, importera, dystrybutora, dostawcy usług realizacji zamówień lub innej osoby fizycznej lub prawnej podlegającej obowiązkom związanym z produkcją produktów, udostępnianiem ich lub wprowadzaniem do użytku. Ciąg znaków w dowolnym formacie reprezentujący podmiot gospodarczy. Informacje te mogą być formatowane za pomocą znaków „ ” i „\n”.

ExtendedServiceAvailability

Lista dostępności i informacje o tym, do kogo i kiedy należy je zastosować.

Pola
`merchant_id`	`string` To pole jest wymagane, aby określić, do którego sprzedawcy należą poniższe wiadomości o dostępności.
`service_id`	`string` To pole jest wymagane, aby określić, do której usługi należą poniższe wiadomości o dostępności.
`start_time_restrict`	`Timestamp` Jeśli podasz te dane, uznamy, że podane jednostki dostępności stanowią pełny obraz stanu od [start_time_restrict, end_time_restrict). Oznacza to, że cała dotychczasowa dostępność zostanie usunięta, jeśli spełniony jest ten warunek: `start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict` Jeśli ustawiono wiadomość o czasie trwania, warunek jest dodatkowo ograniczony: `availability.duration == duration_restrict` Jeśli ustawiona jest wiadomość resources_restrict, warunek jest dodatkowo ograniczony: `availability.resources.staff_id == resources_restrict.staff_id && availability.resources.room_id == resources_restrict.room_id` Te pola służą zwykle do podawania pełnych informacji o dostępności w danym zakresie czasu. Ustawienie parametru start_time_restrict przy pozostawieniu parametru end_time_restrict bez ustawienia oznacza, że wszystkie godziny zaczynają się od parametru start_time_restrict.
`end_time_restrict`	`Timestamp` Ustawienie parametru end_time_restrict przy pozostawieniu parametru start_time_restrict bez ustawienia oznacza, że obowiązuje cały czas do momentu określonego w parametrze end_time_restrict.
`duration_restrict`	`Duration` Ustawienie czasu trwania dodatkowo ogranicza zakres aktualizacji tylko do dostępności o pasującym czasie trwania.
`resources_restrict`	`Resources` Ustawienie resources_restrict dodatkowo ogranicza zakres aktualizacji tylko do tego zestawu zasobów. Wszystkie pola identyfikatorów zasobów muszą być identyczne.
`availability[]`	`Availability` Nowa lista dostępności.

FeedStatistics

Statystyki uzyskane podczas przetwarzania przesłanego pliku danych.

Pola

new_items

int64

Nowo dodane produkty z tego pliku danych. W zależności od typu pliku danych mogą to być sprzedawcy, usługi lub przedziały czasowe.

existing_items

int64

Istniejące produkty, które w razie potrzeby są aktualizowane na podstawie nowszych informacji z pliku danych.

deleted_items

int64

Produkty, których nie ma już w tym pliku danych i które zostały w związku z tym usunięte.

FeedStatus

Stan pliku danych przesłanego przez platformę agregatora.

Pola
`name`	`string` Nazwa zasobu pliku danych w formacie `partners/{partner_id}/feeds/merchants/{file_name}` `partners/{partner_id}/feeds/services/{file_name}` `partners/{partner_id}/feeds/availability/{file_name}`
`state`	`State` Stan przetwarzania tego pliku danych.
`error_details`	`string` Ciąg znaków czytelny dla człowieka, który zawiera więcej szczegółów, jeśli nie udało nam się przetworzyć tego pliku danych.
`statistics`	`FeedStatistics` Statystyki dotyczące tego pliku danych.

Stan

Wyliczenie wskazujące stan przetwarzania pliku danych.

Wartości w polu enum
`STATE_UNSPECIFIED`	Wartość domyślna. Nieużywane.
`IN_PROGRESS`	Plik danych jest nadal przetwarzany.
`SUCCESS`	Plik danych został przetworzony.
`FAILURE`	Podczas przetwarzania pliku danych wystąpił błąd.

FoodOrderingMetadata

Metadane linków do działań związanych z zamawianiem jedzenia.

Pola
`fee_details[]`	`FeeDetails` Szczegóły opłat naliczonych użytkownikowi oprócz łącznej kwoty za produkt. Powtarzane dla różnych rodzajów opłat, takich jak opłata za usługę, opłata za dostawę itp.
`advance_order_details`	`AdvanceOrderDetails` Szczegóły dotyczące zaawansowanej obsługi zamówień, znanej też jako zamawianie z wyprzedzeniem, w przypadku której użytkownik może złożyć zamówienie do realizacji w późniejszym terminie.
Pole zbiorcze `fulfillment_duration_options`. Czas realizacji zamówienia od momentu potwierdzenia zamówienia. W przypadku zamówień z dostawą czas oczekiwania na dostarczenie jedzenia. W przypadku zamówień z odbiorem własnym czas oczekiwania na przygotowanie jedzenia. `fulfillment_duration_options` może mieć tylko jedną z tych wartości:
`fulfillment_lead_time_duration`	`Duration` Stały czas trwania. Przykład: 30 minut.
`fulfillment_lead_time_duration_range`	`DurationRange` Zakres czasu trwania. Przykłady: * 30–45 minut * ponad 30 minut * mniej niż 50 minut

AdvanceOrderDetails

Wsparcie dotyczące zamówień z wyprzedzeniem.

Pola

is_supported

bool

Wartość „prawda”, jeśli zamówienia z wyprzedzeniem są obsługiwane. (wymagane)

FeeDetails

Szczegóły opłaty.

Pola

type

FeeType

Typ opłaty. (wymagane)

fee_amount

FeeAmount

Kwota opłaty podana w walucie jednostki, jako odsetek wartości koszyka lub jako połączenie obu tych wartości. (wymagane)

FeeAmount

Przykłady wartości FeeAmount: * Opłata stała: 0 PLN (bez opłaty), 1,5 PLN * Przedział opłaty stałej: 1,0 PLN (minimum), 3,0 PLN (maksimum), 5,0–6,0 PLN * Procent wartości koszyka: 15,5%, 10–20%, 10% (minimum), 15% (maksimum) * Połączenie przedziału i procentu: 25,5% i 2,5 PLN (minimum), 25,5% i 4,5 PLN (maksimum), 10% i 1,5–2,5 PLN, 10,5–20% i 2,5–3,5 PLN

Pola
`cart_percentage`	`QuantitativeValue` Opłata jako procent wartości koszyka. Obsługuje zakres (ograniczony i nieograniczony) lub stały procent. Wartość powinna mieścić się w zakresie od 0 do 100. Przykłady: * Stała wartość 5,5% * Co najmniej 5,5% * Co najwyżej 5,5% * Od 4,5% do 5,5%
Pole zbiorcze `amount_options`. Opcje określania kwoty pieniężnej. `amount_options` może mieć tylko jedną z tych wartości:
`amount`	`Money` Ustalona kwota. Na przykład 3,50 PLN.
`amount_range`	`MoneyRange` Zakres kwoty. Przykłady: * 3,5–5,5 PLN * co najmniej 3,5 PLN * co najwyżej 5,5 PLN
`amount_unknown`	`bool` Nieznana kwota.

FeeType

Typ opłaty.

Wartości w polu enum
`FEE_TYPE_UNSPECIFIED`	Nieokreślony typ opłaty.
`DELIVERY`	Opłaty za dostawę.
`SERVICE`	opłat za obsługę,

FulfillmentOption

Opcja realizacji linku do działania „Zamów online”.

Pola
`fulfillment_type`	`FulfillmentType` Wymagane. Typ realizacji zamówień.
`available_day[]`	`AvailableDay` Wymagane. Lista dni, w których ta metoda realizacji jest dostępna (najlepiej co najmniej 2).
`fee_details`	`FeeDetails` Wymagane. Szczegóły opłat za metodę realizacji.
`minimum_order`	`Price` Wymagane. Minimalne zamówienie w przypadku metody realizacji powiązanej z linkiem do działania.

AvailableDay

Dostępność na poziomie dnia.

Pola

fulfillment_date

Date

Wymagane. Dostępna data dla metody realizacji. Zakłada się, że jest to strefa czasowa sprzedawcy.

last_ordering_time

Wymagane. Sygnatura czasowa w formacie czasu uniksowego. Ostatni dzień, w którym użytkownik mógł zamówić i otrzymać produkty, to fulfillment_date. Innymi słowy, po upływie czasu last_ordering_time data realizacji fulfillment_date nie będzie już wyświetlana jako dostępna.

Jeśli na przykład fulfillment_date to 2020-08-10, a last_ordering_time to 2020-08-10 18:00, oznacza to, że aby otrzymać zamówienie 10 sierpnia 2020 r., klient musi złożyć zamówienie do godziny 18:00 tego samego dnia. – wartość last_ordering_time 2020-08-08 20:00 oznacza, że aby otrzymać zamówienie 10 sierpnia 2020 r., klient musi złożyć zamówienie do godziny 20:00 dwa dni wcześniej.

FeeDetails

Szczegóły opłat za metodę realizacji powiązaną z linkiem do działania.

Pola
Pole zbiorcze `fee_details`. Model opłat za metodę realizacji. `fee_details` może mieć tylko jedną z tych wartości:
`no_fee`	`NoFee` Brak opłaty za metodę realizacji.
`base_fee`	`MinimumFee` Opłata podstawowa powiązana z metodą realizacji.
`fixed_fee`	`FixedFee` Opłata stała powiązana z metodą realizacji.

FixedFee

Stała opłata wymagana w przypadku metody realizacji powiązanej z linkiem do działania.

Pola

amount

Wymagane. Kwota opłaty stałej za metodę realizacji.

FulfillmentType

Typ realizacji powiązany z linkiem do działania.

Wartości w polu enum
`FULFILLMENT_TYPE_UNSPECIFIED`	Typ realizacji zamówień nie został określony.
`FULFILLMENT_TYPE_DELIVERY`	Typ realizacji zamówienia to dostawa.
`FULFILLMENT_TYPE_PICKUP`	Typ realizacji zamówień to odbiór.

MinimumFee

Minimalna opłata wymagana w przypadku metody realizacji powiązanej z linkiem do działania.

Pola

base_fee_amount

Wymagane. Podstawowa kwota opłaty za metodę realizacji.

NoFee

Ten typ nie ma pól.

W przypadku metody realizacji zamówienia powiązanej z linkiem do działania nie jest wymagana żadna opłata.

GenericDeleteRecord

Rekord do usunięcia z pliku danych typu wymienionego w żądaniu URL.

Pola
`delete_time`	`Timestamp` Wymagane. Ta sygnatura czasowa służy do określania kolejności, w jakiej usunięcie zostanie zastosowane do zasobów reklamowych.
Pole zbiorcze `record_type`. enkapsulować różne typy plików danych (ndjson, proto-based itp.); Partner może przesłać pełny rekord podobny do rekordu w pliku danych lub interfejsie BatchPush API. Partnerzy mogą też uwzględniać tylko niezbędne pola rekordu, które są wymagane do jego jednoznacznej identyfikacji. `record_type` może mieć tylko jedną z tych wartości:
`data_record`	`bytes` W przypadku plików danych nieopartych na protokole.
`proto_record`	`Any` W przypadku plików danych opartych na protokole.

GenericRecord

Zapis typu pliku danych wspomnianego w żądaniu adresu URL.

Pola
`generation_timestamp`	`Timestamp` Wymagane. Ta sygnatura czasowa służy do zapewnienia prawidłowej kolejności aktualizacji asortymentu.
Pole zbiorcze `record_type`. enkapsulować różne typy plików danych (ndjson, proto-based itp.); `record_type` może mieć tylko jedną z tych wartości:
`data_record`	`bytes` W przypadku plików danych nieopartych na protokole.
`proto_record`	`Any` W przypadku plików danych opartych na protokole.

GeoCoordinates

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

Pola
`latitude`	`double` Szerokość geograficzna w stopniach. (opcjonalnie)
`longitude`	`double` Długość geograficzna w stopniach. (opcjonalnie)
Pole zbiorcze `addresses`. Adres lokalizacji, który może być uporządkowany lub nieuporządkowany. `addresses` może mieć tylko jedną z tych wartości:
`address`	`PostalAddress` Preferowany adres pocztowy lokalizacji.
`unstructured_address`	`string` Możesz też podać nieustrukturyzowany adres jako wartość zastępczą. np. „1600 amphitheatre parkway mountain view, ca 94043”.

GetAdsAccountLinkRequest

Wiadomość z prośbą o wywołanie funkcji AdsAccountLinkingService.GetAdsAccountLink.

Pola

name

string

Wymagane. Nazwa połączenia kont Google Ads do pobrania. Format: partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

Prośba o uzyskanie MerchantStatus

Pola

name

string

Wymagane. Nazwa zasobu w formacie partners/{partner_id}/merchants/{merchant_id}/status.

GetStatusRequest

Żądanie pobrania Status dla konkretnego pliku danych przesłanego przez platformę agregatora.

Pola

name

string

Nazwa zasobu pliku danych w formacie

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

HomeServiceData

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

Pola

category_type

string

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

job_type

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.

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.

InvalidateResourceRequest

Żądanie unieważnienia zasobu.

Pola

resource_id

string

Nazwa zasobu, który ma zostać unieważniony.

Na przykład w przypadku zasobu Pickup nazwa powinna mieć format partners/{partner_id}/pickups/{pickup_id}. Implementacje MUSZĄ usuwać wersje z pamięci podręcznej zidentyfikowanego zasobu.

LineItem

Pojedynczy element zamówienia – rezerwacja pojedynczej usługi w jednym przedziale czasowym.

Pola
`service_id`	`string` Identyfikator usługi sprzedawcy.
`start_sec`	`int64` Czas rozpoczęcia przedziału czasowego spotkania w sekundach czasu UTC od początku epoki systemu Unix.
`duration_sec`	`int64` Czas trwania przedziału czasowego spotkania w sekundach.
`tickets[]`	`OrderedTickets` Liczba biletów zamówionych według typu biletu.
`price`	`Price` Łączna cena (bez podatków) tego elementu zamówienia.
`status`	`BookingStatus` Stan elementu zamówienia.

OrderedTickets

Liczba zamówionych biletów według typu biletu.

Pola

ticket_id

string

Identyfikator typu biletu.

count

int32

Liczba zamówionych biletów tego typu.

LinkoutTemplate

Szablon określający, jak Google ma generować adresy URL prowadzące do witryny partnera.

Pola

uri_template

string

Szablon URI musi być zgodny z RFC 6570. Więcej informacji znajdziesz na stronie https://datatracker.ietf.org/doc/html/rfc6570. Obsługuje szablony poziomu 1 i wszystkie szablony złożone poziomu 4, np. http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

ListMerchantStatusesRequest

Prośba o pobranie listy MerchantStatus

Pola
`parent`	`string` Wymagane. Element nadrzędny, do którego należy ta kolekcja stanów sprzedawcy. Format: `partners/{partner_id}/merchants`
`page_size`	`int32` Wymagane. Maksymalna liczba elementów do zwrócenia. Pamiętaj, że serwer może zmniejszyć rozmiar strony.
`page_token`	`string` Opcjonalnie. Wartość nextPageToken zwrócona w poprzedniej odpowiedzi ListMerchantStatusResponse (jeśli występuje).
`booking_inventory_status_restrict`	`BookingInventoryStatus` Opcjonalnie. Opcjonalne ograniczenie, które pozwala filtrować wyniki według stanu asortymentu rezerwacji.
`waitlist_inventory_status_restrict`	`WaitlistInventoryStatus` Opcjonalnie. Opcjonalne ograniczenie umożliwiające filtrowanie wyników według stanu asortymentu na liście oczekujących.
`geo_match_restrict`	`GeoMatchingStatus` Opcjonalnie. Opcjonalne ograniczenie umożliwiające filtrowanie wyników według stanu dopasowania geograficznego.

BookingInventoryStatus

Stan asortymentu rezerwacji kompleksowych.

Wartości w polu enum
`BOOKING_INVENTORY_STATUS_UNSPECIFIED`	Nie określono.
`NO_VALID_FUTURE_INVENTORY`	Sprzedawca nie ma dostępnych miejsc do rezerwacji w ciągu najbliższych 30 dni.
`HAS_VALID_FUTURE_INVENTORY`	Sprzedawca ma w ciągu najbliższych 30 dni dostępne zasoby do rezerwacji.

GeoMatchingStatus

Stan dopasowania geograficznego sprzedawcy.

Wartości w polu enum
`GEO_MATCHING_STATUS_UNSPECIFIED`	Nie określono.
`GEO_UNMATCHED`	Sprzedawca nie jest dopasowany geograficznie.
`GEO_MATCHED`	Sprzedawca jest dopasowany geograficznie.

WaitlistInventoryStatus

Stan asortymentu na liście oczekujących.

Wartości w polu enum
`WAITLIST_INVENTORY_STATUS_UNSPECIFIED`	Nie określono.
`NO_VALID_WAITLIST_SERVICE`	Sprzedawca nie ma usługi obsługującej listę oczekujących.
`HAS_VALID_WAITLIST_SERVICE`	Sprzedawca ma usługę obsługującą listę oczekujących.

ListMerchantStatusesResponse

Odpowiedź na listę MerchantStatus.

Pola

merchant_statuses[]

MerchantStatus

Lista stanów sprzedawcy, które spełniają warunki filtra.

next_page_token

string

Token do pobierania następnej strony wyników. Jeśli lista jest pusta, nie ma na niej więcej wyników.

ListStatusRequest

Żądanie pobrania Status dla wielu plików danych przesłanych przez platformę agregatora.

Pola
`name`	`string` Nazwa zasobu pliku danych w formacie `partners/{partner_id}/feeds/merchants` `partners/{partner_id}/feeds/services` `partners/{partner_id}/feeds/availability`
`page_size`	`int32` Maksymalna liczba elementów do zwrócenia.
`page_token`	`string` Wartość next_page_token zwrócona z poprzedniego żądania List (jeśli występuje).
`state_restrict`	`State` Opcjonalnie możesz ograniczyć wyniki, filtrując je według stanu pliku danych.
`time_range_restrict`	`TimeRange` Opcjonalnie możesz ograniczyć wyniki, filtrując je według górnej i dolnej granicy. Jeśli parametr start_time nie jest ustawiony, domyślnie przyjmuje wartość początku czasu uniksowego. Jeśli parametr end_time nie jest ustawiony, domyślnie przyjmuje wartość „teraz”.

ListStatusResponse

Żądanie pobrania Status dla wielu plików danych przesłanych przez platformę agregatora.

Pola

status[]

FeedStatus

Lista stanów przesłanych plików danych w odwrotnej kolejności chronologicznej. Maksymalna liczba zwróconych elementów zależy od pola page_size w żądaniu.

next_page_token

string

Token do pobierania następnej strony wyników. Jeśli lista jest pusta, nie ma na niej więcej wyników.

LocalizedString

Wystąpienie ciągu znaków w jednym języku.

Pola

locale

string

Kod języka IETF BCP 47, np. „en”, „mas”, „zh-Hant”, „de-CH-1901”. Zobacz http://www.w3.org/International/articles/language-tags/.

value

string

Wiadomość w języku podanym powyżej (UTF-8).

Lokalizacja

Informacje geograficzne o lokalizacji.

Pola
`place_id`	`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`	`GeoCoordinates` Informacje geograficzne o lokalizacji, w tym szerokość i długość geograficzna oraz adres. (opcjonalnie)
`location_type`	`LocationType` Jeśli ta lokalizacja jest podana dla usługi, musisz podać jej typ.
`location_id`	`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.

Sprzedawca

Informacje o sprzedawcy, który jest na platformie agregatora.

Pola
`name`	`string` Nazwa zasobu sprzedawcy w formacie `partners/{partner_id}/merchants/{merchant_id}`.
`merchant_name`	`string` Parametry merchant_name, telephone, url i geo są używane do dopasowywania asortymentu partnera do sprzedawców, którzy są już obecni w Mapach Google. Te informacje nie będą wyświetlane. Nazwa sprzedawcy.
`telephone`	`string` Publiczny numer telefonu sprzedawcy wraz z kodem kraju i numerem kierunkowym, np. +14567891234.
`url`	`string` Adres URL publicznej witryny sprzedawcy.
`geo`	`GeoCoordinates` Informacje geograficzne o sprzedawcy, w tym szerokość i długość geograficzna oraz adres.
`category`	`string` Kategoria firmy na platformie agregatora.
`num_bookings_30d (deprecated)`	`int64` Ten element został wycofany. To pole zostało wycofane.
`tax_rate_basis_points (deprecated)`	`uint32` Ten element został wycofany. Stawka podatku sprzedawcy w punktach bazowych (jedna setna procenta). Jeśli na przykład stawka podatku wynosi 7, 5%, to pole powinno mieć wartość 750. Jeśli to pole jest nieskonfigurowane lub ma wartość 0, łączna cena pobierana od użytkownika za dowolną usługę świadczoną przez tego sprzedawcę jest dokładnie taka, jak cena określona w polu Service.price. Zakłada się, że cena usługi jest zwolniona z obowiązujących podatków lub już je zawiera. Podatki nie będą wyświetlane użytkownikowi jako osobna pozycja. Jeśli to pole ma wartość inną niż zero, całkowita cena pobierana od użytkownika za dowolną usługę świadczoną przez tego sprzedawcę będzie obejmować cenę usługi plus podatek obliczony na podstawie podanej tu stawki podatku. Ułamki najmniejszej jednostki waluty (np. ułamki centa) będą zaokrąglane do najbliższej parzystej liczby. Podatki będą wyświetlane użytkownikowi jako osobna pozycja. To pole zostało wycofane. Zamiast niego używaj pola tax_rate.
`tax_rate (deprecated)`	`TaxRate` Ten element został wycofany. Stawka podatku sprzedawcy. Jeśli to pole jest obecne, zastępuje wycofane pole tax_rate_basis_points. Pusta wiadomość (np. tax_rate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera. Wycofane, ponieważ płatności E2E nie są już obsługiwane.
`payment_restrictions (deprecated)`	`PaymentRestrictions` Ten element został wycofany. Ograniczenia dotyczące form płatności akceptowanych przez tego sprzedawcę. Jeśli to pole nie jest ustawione, zakładamy, że nie ma ograniczeń. Wycofane, ponieważ płatności E2E nie są już obsługiwane.
`payment_option[] (deprecated)`	`PaymentOption` Ten element został wycofany. Opcje płatności dostępne u tego sprzedawcy. Usługi w ramach tego sprzedawcy będą mogły indywidualnie ograniczać opcje płatności, które akceptują. Wycofane, ponieważ płatności E2E nie są już obsługiwane.
`payment_processor_config (deprecated)`	`PaymentProcessorConfig` Ten element został wycofany. Konfiguracja tokenizowanego procesora płatności, jeśli sprzedawca go obsługuje.
`tokenization_config (deprecated)`	`TokenizationConfig` Ten element został wycofany. Konfiguracja tokenizowanego procesora płatności, jeśli sprzedawca go obsługuje. Wycofane, ponieważ płatności E2E nie są już obsługiwane.
`terms`	`Terms` Warunki konkretnego sprzedawcy wyświetlane użytkownikowi podczas rezerwowania usługi za pomocą Zarezerwuj z Google. Oprócz tego użytkownikowi zawsze wyświetlane są warunki partnera będącego agregatorem, których nie należy tu podawać.
`brand_id`	`string` Nieprzejrzysty ciąg znaków, który identyfikuje markę przeznaczoną dla użytkowników, która ma być używana podczas wyświetlania atrybucji partnera. To pole umożliwia partnerom z wieloma markami przeznaczonymi dla użytkowników dostarczanie sprzedawców dla wszystkich marek w tym samym pliku danych. Marka obejmuje elementy przeznaczone dla użytkowników, takie jak nazwa, logo, Warunki korzystania z usługi i Polityka prywatności. Jeśli istnieje tylko jedna marka partnera przeznaczona dla użytkowników, nie musisz ustawiać tego pola i możesz je zignorować. Jeśli partner… nie ma wielu marek przeznaczonych dla użytkowników; --> Ignoruj to pole ma skonfigurowanych wiele marek, `If this field is set --> Associated consumer-facing brand attribution is used If this field is unset or the empty string --> Default consumer-facing brand attribution is used` Ważna uwaga: większość partnerów nie musi ustawiać tego pola. Jeśli partner chce używać tego pola, musi najpierw skontaktować się z nami, aby skonfigurować oddzielne marki, w tym markę domyślną.
`matching_hints`	`MerchantMatchingHints` Wskazówki, które pomogą Google dopasować sprzedawcę do miejsca w Mapach Google. Uwaga: większość partnerów nie musi ustawiać tego pola, ponieważ Google dopasuje sprzedawców do miejsc w Mapach Google na podstawie podanych powyżej informacji. (opcjonalnie)
`service_attribute[]`	`ServiceAttribute` Definicje atrybutów usługi używanych do opisywania Usług dla tego Sprzedawcy. (opcjonalnie)
`action_link[]`	`ActionLink` Opcjonalnie. Adres URL działania z powiązanym językiem, listą krajów, w których jest ono ograniczone, typem i opcjonalną platformą, która wskazuje, na której platformie to działanie powinno być wykonywane.
`reservation_linkout_template[]`	`LinkoutTemplate` Opcjonalnie. Szablon linku wyjściowego, który określa, jak Google ma generować adres URL partnera, aby zarezerwować stolik na jego platformie. Pamiętaj, że jeśli podasz kilka wartości, obecnie używana będzie tylko pierwsza z nich. Szablon URI obsługuje pola, które będą wypełniane na podstawie wyborów użytkownika dotyczących rezerwacji. Aby utworzyć adres URL rezerwacji, musisz podać wszystkie wymagane pola: * (wymagane) party_size, int: liczba osób, dla których użytkownik prosi o rezerwację. * (wymagane) selected_date_time, data i godzina w formacie ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): godzina, na którą użytkownik chce dokonać rezerwacji. * (opcjonalnie) merchant_id, ciąg znaków: identyfikator sprzedawcy, u którego użytkownik chce dokonać rezerwacji. Nie jest wymagany, jeśli szablon zawiera już identyfikator sprzedawcy. * (opcjonalnie) room_id, ciąg znaków: identyfikator pokoju, w którym użytkownik chce dokonać rezerwacji.
`waitlist_advisement`	`Advisement` Opcjonalnie. Ogólne porady od konkretnego sprzedawcy dla użytkownika, który dołącza do listy oczekujących za pomocą funkcji Zarezerwuj z Google. Długość poszczególnych pól tekstowych w rekomendacji powinna być ograniczona do 100 bajtów.
`economic_operator`	`EconomicOperator` Opcjonalnie. Informacje o podmiocie gospodarczym powiązane z tym konkretnym sprzedawcą, które są wymagane do zachowania zgodności z przepisami. (opcjonalnie)

MerchantMatchingHints

Wskazówki, które pomagają Google dopasować sprzedawcę do miejsca w Mapach Google.

Pola

place_id

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.

MerchantStatus

Stan sprzedawcy na platformie Zarezerwuj z Google.

Pola
`name`	`string` Nazwa zasobu stanu sprzedawcy w formacie `partners/{partner_id}/merchants/{merchant_id}/status`.
`merchant_name`	`string` Nazwa sprzedawcy podana przez partnerów.
`input_geo_info`	`GeoCoordinates` Partnerzy przekazali informacje geograficzne o sprzedawcy.
`processing_status`	`ProcessingStatus` Stan przetwarzania sprzedawcy.
`booking_status`	`BookingStatus` Stan związany z integracją rezerwacji od początku do końca.
`waitlist_status`	`WaitlistStatus` Stan związany z integracją listy oczekujących.
`geo_match`	`PlaceInfo` Dopasowane miejsce geograficzne tego sprzedawcy. Puste, jeśli sprzedawca nie jest dopasowany geograficznie.
`local_services_match`	`LocalServicesMatchInfo` Usługi Lokalne tego sprzedawcy. Puste, jeśli sprzedawca nie świadczy usług lokalnych lub nie jest dopasowany do żadnego usługodawcy.
`direct_urls[]`	`DirectUrl` Lista adresów URL, która pokazuje zawartość bieżącego asortymentu sprzedawcy. Pamiętaj, że nie oznacza to, że zasoby reklamowe są faktycznie wyświetlane, a adres URL może się różnić od tych widocznych publicznie.

BookingStatus

Stan związany z integracją rezerwacji od początku do końca.

Pola

has_valid_future_inventory

bool

Wartość „prawda”, jeśli sprzedawca ma asortyment w ciągu najbliższych 30 dni. Nie gwarantuje, że sprzedawca będzie faktycznie obsługiwany.

DirectUrl

Adres URL, który wyświetla sprzedawcę.

Pola

type

UrlType

Typ tego adresu URL.

url

string

Adres URL, który może wyświetlać tego sprzedawcę.

UrlType

Typ adresu URL wyświetlanego.

Wartości w polu enum
`URL_TYPE_UNSPECIFIED`	Nie określono.
`BOOKING`	Adres URL rezerwacji kompleksowej.
`WAITLIST`	Pełny adres URL listy oczekujących.
`LOCAL_SERVICES`	Adres URL Usług Lokalnych Google.

LocalServicesMatchInfo

Informacje o dopasowaniu do lokalnych usług Google (ustawione tylko w przypadku sprzedawców lokalnych usług).

Pola

matched_providers[]

MatchedProvider

Dopasowani usługodawcy. Sprzedawca może być dopasowany do wielu usługodawców.

MatchedProvider

Usługodawca świadczący Usługi lokalne.

Pola

customer_id

int64

Zewnętrzny identyfikator klienta Usług lokalnych Google.

categories[]

string

Kategorie usług lokalnych (branże). np. „hydraulik” i „czyszczenie_dywanów”.

PlaceInfo

Informacje o dopasowanym miejscu.

Pola

name

string

Nazwa miejsca.

formatted_address

string

Sformatowany adres w języku lokalnym.

place_id

string

Identyfikator miejsca w Miejscach Google. Może służyć do tworzenia adresu URL Map Google lub pobierania większej liczby szczegółów o miejscu. Przykłady użycia znajdziesz na stronie https://developers.google.com/places/web-service/place-id.

ProcessingStatus

Stan przetwarzania sprzedawcy.

Wartości w polu enum
`PROCESSING_STATUS_UNSPECIFIED`	Stan nieokreślony.
`IN_PROGRESS`	Sprzedawca został zarejestrowany w Madden, ale nadal jest przetwarzany. Sprzedawcy w tym stanie nie będą mieć innych stanów.
`COMPLETED`	Obliczone zostały inne stany sprzedawcy.

WaitlistStatus

Stan związany z integracją listy oczekujących.

Pola

has_valid_waitlist_service

bool

Wartość „prawda”, jeśli sprzedawca oferuje usługę listy oczekujących. Nie gwarantuje, że sprzedawca będzie faktycznie obsługiwany.

MoneyRange

Obiekt opakowujący zakres kwot pieniężnych, który może być ograniczony lub nieograniczony. Wymagana jest co najmniej jedna z wartości min_amount i max_amount.

Pola

min_amount

Money

Minimalna kwota.

max_amount

Money

Maksymalna kwota.

NoShowFee

Opłata, którą użytkownik może ponieść, jeśli dokona rezerwacji, ale nie pojawi się w miejscu świadczenia usługi.

Pola

fee

Kwota, która może zostać pobrana od użytkownika, jeśli nie pojawi się on na rezerwacji.

fee_type

PriceType

Określa, w jaki sposób opłata jest określana na podstawie dostępności.

Zamówienie

Zamówienie wizyt serwisowych u sprzedawcy.

Pola
`name`	`string` Nazwa zasobu zamówienia: `partners/{partner ID}/orders/{order ID}`
`client_information`	`ClientInformation` dane osobowe klienta składającego zamówienie;
`payment_information`	`PaymentInformation` Informacje o transakcjach płatniczych związanych z zamówieniem.
`merchant_id`	`string` Identyfikator sprzedawcy, do którego należą wszystkie usługi w tym zamówieniu.
`item[]`	`LineItem` Elementy zamówienia w tym zamówieniu.

OrderOnlineMetadata

Metadane linku do działania „Zamów online”.

Pola

fulfillment_option[]

FulfillmentOption

Dostępne opcje realizacji zamówienia w przypadku linku do działania „Zamów online”.

PaymentInformation

dane płatności związane z rezerwacją,

Pola

prepayment_status

PrepaymentStatus

Stan przedpłaty za rezerwację. Jeśli wartość pola prepayment_status to PREPAYMENT_PROVIDED lub PREPAYMENT_REFUNDED, pole payment_transaction_id zawiera powiązany unikalny identyfikator transakcji.

payment_transaction_id

string

Unikalny identyfikator transakcji płatniczej powiązanej z rezerwacją. Puste, jeśli nie dotyczy.

PaymentOption

Opcja płatności, której można użyć do zapłaty za usługi świadczone przez sprzedawcę. Opcje płatności mogą być udostępniane wielu sprzedawcom (np. sprzedawcom należącym do tej samej sieci).

Pola
`payment_option_id`	`string` Ten identyfikator służy do identyfikowania tej opcji płatności. Ten identyfikator jest globalny dla całego agregatora, a ponowne użycie wartości u wielu sprzedawców umożliwi użytkownikowi zapłacenie za pomocą odpowiedniej opcji płatności u tych sprzedawców. Jeśli używasz tego samego identyfikatora u wielu sprzedawców, zaktualizowanie dowolnej wartości opcji płatności u jednego sprzedawcy spowoduje też zaktualizowanie każdej innej opcji płatności z tym samym identyfikatorem u innego sprzedawcy. Dlatego sprawdzoną metodą jest przypisanie wszystkim opcjom płatności tego samego identyfikatora i aktualizowanie ich do identycznych wartości, aby uniknąć nieprzewidywalnego działania.
`name`	`string` Nazwa opcji płatności. Może to być widoczne dla użytkownika.
`description`	`string` Opis opcji płatności. Może to być widoczne dla użytkownika.
`price`	`Price` Cena opcji płatności.
`tax_rate`	`TaxRate` Stawka podatku dla tej opcji płatności. Jeśli to pole jest obecne, zastępuje pole tax_rate w Merchant lub usłudze. Pusta wiadomość (np. tax_rate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera.
`payment_option_type`	`PaymentOptionType` Typ tej opcji płatności. Pojedyncze wejścia, pakiety i nieograniczone korzystanie w przypadku subskrypcji.
`session_count`	`int64` Liczba sesji, w przypadku których można użyć tej opcji płatności. Dotyczy tylko pakietów sesji, w których wartość powinna być większa niż 1.
`purchase_interval`	`TimeRange` Opcję płatności można kupić w tym przedziale.
`valid_interval`	`TimeRange` Opcja płatności może być używana w tym przedziale (np.specjalna cena w styczniu 2017 r.). Jeśli jest podany, zastępuje atrybuty valid_duration i activation_type.
`valid_duration`	`Duration` Okres ważności opcji płatności (np. 30-dniowe członkostwo).
`activation_type`	`ActivationType` Określa sposób ustalania daty rozpoczęcia ważności tej formy płatności.
`user_restriction`	`UserPurchaseRestriction` Ogranicza liczbę użytkowników, którzy mogą kupić tę opcję płatności. Może służyć do ograniczenia opcji płatności promocyjnej do podzbioru użytkowników. Jeśli nie jest skonfigurowana, wszyscy użytkownicy kwalifikują się do korzystania z tej funkcji.

ActivationType

Określa sposób ustalania daty rozpoczęcia ważności.

Wartości w polu enum
`ACTIVATION_TYPE_UNSPECIFIED`	Nieużywane.
`ACTIVATION_ON_PURCHASE`	Ważność rozpoczyna się w momencie zakupu.
`ACTIVATION_ON_FIRST_USE`	Okres ważności rozpoczyna się, gdy opcja płatności zostanie użyta po raz pierwszy.

PaymentOptionType

Rodzaj opcji płatności.

Wartości w polu enum
`PAYMENT_OPTION_TYPE_UNSPECIFIED`	Nieużywane.
`PAYMENT_OPTION_SINGLE_USE`	Opcji płatności można użyć tylko raz.
`PAYMENT_OPTION_MULTI_USE`	Opcji płatności można użyć, jeśli liczba sesji jest większa od 0.
`PAYMENT_OPTION_UNLIMITED`	Opcji płatności można używać w okresie jej ważności – liczba sesji nie ma tu zastosowania.

PaymentProcessorConfig

Konfiguracja firmy obsługującej płatności, która jest konfigurowana dla każdego sprzedawcy.

Pola

processor

Processor

Określa partnera obsługującego płatności, do którego odnosi się ta konfiguracja.

public_key

string

Klucz używany do identyfikowania tego sprzedawcy u firmy obsługującej płatności.

W przypadku Stripe zapoznaj się z tym artykułem: https://stripe.com/docs/dashboard#api-keys. W przypadku Braintree zapoznaj się z tym artykułem: https://articles.braintreepayments.com/control-panel/important-gateway-credentials.

version

string

Numer wersji interfejsu API wysyłany do firmy obsługującej płatności wraz z prośbami o płatność.

Procesor

Określa konkretnego partnera obsługującego płatności.

Wartości w polu enum
`PROCESSOR_UNSPECIFIED`	Nieużywane
`PROCESSOR_STRIPE`	Konfiguracja płatności za pomocą Stripe.
`PROCESSOR_BRAINTREE`	Konfiguracja płatności za pomocą Braintree.

PaymentRestrictions

Ograniczenia dotyczące form płatności akceptowanych przez tego sprzedawcę.

Pola

credit_card_restrictions

CreditCardRestrictions

Ograniczenia dotyczące kart kredytowych akceptowanych przez tego sprzedawcę. Jeśli to pole nie jest ustawione, zakładamy, że wszystkie karty kredytowe są akceptowane. Pamiętaj, że lista kart obsługiwanych przez CreditCardType będzie się z czasem powiększać, co oznacza, że pozostawienie tego pola pustego spowoduje, że konfiguracja będzie podlegać przyszłym zmianom.

PerOrderFee

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

Pola

delivery_fee

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

processing_fee

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

PerTicketFee

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

Pola

service_charge

Dodatkowa opłata za usługę.

facility_fee

Opłata, która trafia do obiektu.

taxes

podatki od biletu,

PostalAddress

Adres klienta lub firmy.

Pola
`address_country`	`string` Kraj podany za pomocą kodu ISO 3166-1 alfa-2, np. „US” (wymagany).
`address_locality`	`string` Miejscowość, np. „Mountain View”. (wymagane)
`address_region`	`string` Region, np. „CA”. To pole jest wymagane tylko w krajach, w których region jest zwykle częścią adresu. (opcjonalnie)
`postal_code`	`string` Kod pocztowy, np. „94043”. (wymagane)
`street_address`	`string` Ulica, np. „1600 Amphitheatre Pkwy”. (wymagane)

Przedpłata

Płatność, którą użytkownik może uiścić w ramach rezerwacji.

Pola

price_info

PriceInfo

Kontener ze szczegółami ceny.

PrepaymentStatus

Stan przedpłaty za rezerwację.

Wartości w polu enum
`PREPAYMENT_STATUS_UNSPECIFIED`	Nie określono, domyślnie PREPAYMENT_NOT_PROVIDED.
`PREPAYMENT_PROVIDED`	Opłata za rezerwację została uiszczona z góry.
`PREPAYMENT_NOT_PROVIDED`	Opłata za rezerwację nie została uiszczona z góry.
`PREPAYMENT_REFUNDED`	Opłata była wcześniej typu PREPAYMENT_PROVIDED, ale została zwrócona.

Cena

Cena usługi lub opłata.

Pola
`price_micros`	`int64` Cena w mikrojednostkach waluty. Ułamki najmniejszej jednostki waluty będą zaokrąglane do najbliższej parzystej liczby. (np. 2,5 centa USD zaokrąglone do 2 centów, 3,5 centa zaokrąglone do 4 centów, 0,5 centa zaokrąglone do 0 centów, 2,51 centa zaokrąglone do 3 centów).
`currency_code`	`string` Waluta ceny zdefiniowana w normie ISO 4217.
`pricing_option_tag`	`string` Opcjonalny i nieprzejrzysty ciąg znaków, który identyfikuje opcję cenową powiązaną z ceną rozszerzoną.

PriceInfo

Kontener ze szczegółami ceny.

Pola
`price_type`	`PriceType` Określa, jak stosowana jest cena lub przedział cenowy (za osobę lub stała cena)
Pole zbiorcze `price_options`. Opcje cenowe mogą określać dokładną cenę lub przedział cenowy. `price_options` może mieć tylko jedną z tych wartości:
`price`	`Price` Cena usługi lub opłata.
`price_range`	`PriceRange` Górna lub dolna granica usługi lub opłaty.

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

PriceRange

Obiekt opakowujący zakres kwot pieniężnych traktowany jako nieograniczony, chyba że obie wartości są ustawione. Wymagana jest co najmniej jedna z wartości min_amount i max_amount.

Pola

min_price

Minimalna kwota.

max_price

Maksymalna kwota. Wartość powinna być zawsze większa niż min_price.

PriceType

Określa, jak na podstawie dostępności określa się łączną cenę.

Wartości w polu enum

FIXED_RATE_DEFAULT

Cena jest stała. Jest to wartość domyślna, jeśli pole nie jest ustawione.

Przykłady: zaliczka w wysokości 50 zł za rezerwację stolika; opłata za niestawienie się na zajęciach jogi w wysokości 20 zł.

PER_PERSON

Podana cena jest ceną za osobę, a cena całkowita jest obliczana na podstawie liczby osób w grupie określonej w zasobach jako price_micros * party_size. Cenie PER_PERSON musi towarzyszyć rozmiar grupy w zasobach dostępności. W przeciwnym razie używany jest rozmiar grupy równy 1.

Przykłady: 10 zł za bilet do muzeum

QuantitativeValue

Obiekt opakowujący wartość liczbową, która może być zakresem lub stałą wartością. QuantitativeValue Przykłady: * Wartość pojedyncza: value: 10.5 * Ograniczony zakres: value_range {min_value: 5.5, max_value 10.5} * Dolna granica: value_range {min_value: 5.5} * Górna granica: value_range {max_value: 10.5}

Pola

Pole zbiorcze value_options. (wymagane) value_options może mieć tylko jedną z tych wartości:

value

double

pojedynczą wartość, Przykład: 5,6

value_range

RangeValue

Zakres wartości, który może być otwarty lub ograniczony. Przykłady: * Co najmniej 5,5 * Co najwyżej 5,5 * Od 5,5 do 6,5

RangeValue

Zakres wartości, tak aby min_value < max_value. Wymaga co najmniej jednej z tych wartości: min_value i max_value.

Pola

min_value

double

Wartość minimalna.

max_value

double

Wartość maksymalna.

Ocena

Określa ocenę jednostki.

Pola

value

double

Wartość średniej oceny (wymagana, gdy number_of_ratings > 0). Wartość musi mieścić się w zakresie [1, 5] i można ją pominąć tylko wtedy, gdy liczba_ocen wynosi zero.

number_of_ratings

uint64

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

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)

Pola
`url`	`string` Adres URL tego źródła multimediów. Google będzie indeksować multimedia hostowane pod tym adresem URL.
`type`	`MediaType` Typ tego źródła multimediów.
`localized_caption`	`Text` Napis do multimediów obsługujący internacjonalizację. Obsługiwany jest tylko zwykły tekst. Wszystkie komponenty HTML zostaną usunięte. (opcjonalnie)
`attribution`	`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` Ten element został wycofany. Wycofany. Zalecamy używanie pola localized_caption.

Atrybucja

Informacje o źródle tych multimediów.

Pola

localized_text

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

Wycofane. Zalecamy używanie pola localized_text.

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.

ReplaceServiceAvailabilityRequest

Prośba o zastąpienie dostępności usługi Service.

Pola

service_availability

ServiceAvailability

Dostępność usługi, która zastąpi dotychczasową.

RequireCreditCard

Określa, czy do rezerwacji terminu spotkania wymagana jest karta kredytowa.

Wartości w polu enum
`REQUIRE_CREDIT_CARD_UNSPECIFIED`	Wymóg dotyczący karty kredytowej nie jest wyraźnie określony, a działanie jest identyczne z działaniem określonym dla wartości CONDITIONAL.
`REQUIRE_CREDIT_CARD_CONDITIONAL`	Google będzie wymagać karty kredytowej do rezerwacji, jeśli spełniony jest którykolwiek z tych warunków: * dostępność ma cenę, a wartość prepayment_type to REQUIRED; * ustawiono opłatę za niepojawienie się; * ustawiono pole zaliczki.
`REQUIRE_CREDIT_CARD_ALWAYS`	Do zarezerwowania tej dostępności zawsze wymagana jest karta kredytowa, niezależnie od wartości innych pól.

Zasoby

Zasób służy do rozróżniania przedziałów czasowych, gdy usługa obejmuje różnych pracowników lub pomieszczenia. Wiele miejsc na tę samą usługę i przedział czasowy może istnieć równocześnie, jeśli mają różne zasoby.

Pola
`staff_id`	`string` Opcjonalny identyfikator pracownika świadczącego usługę. To pole identyfikuje pracownika we wszystkich rekordach sprzedawców, usług i dostępności. Musi też być stabilny w czasie, aby można było go powiązać z rezerwacjami z przeszłości. To pole musi być obecne, jeśli pole staff_name jest obecne.
`staff_name`	`string` Opcjonalna nazwa pracownika świadczącego usługę. To pole będzie wyświetlane użytkownikom dokonującym rezerwacji i powinno być zrozumiałe dla człowieka, a nie nieprzejrzyste. To pole musi być obecne, jeśli występuje pole staff_id.
`room_id`	`string` Opcjonalny identyfikator pokoju, w którym znajduje się usługa. To pole identyfikuje pokój u wszystkich sprzedawców, usług i rekordów dostępności. Musi też być stabilny w czasie, aby można było go powiązać z rezerwacjami z przeszłości. To pole musi być obecne, jeśli występuje pole room_name.
`room_name`	`string` Opcjonalna nazwa pomieszczenia, w którym znajduje się usługa. To pole będzie wyświetlane użytkownikom dokonującym rezerwacji i powinno być zrozumiałe dla człowieka, a nie nieprzejrzyste. (opcjonalny, ale wymagany, jeśli występuje parametr room_id) W przypadku restauracji nazwa pomieszczenia powinna być używana tylko w przypadku stref wypoczynkowych, takich jak bar lub patio, i nie powinna być używana w przypadku menu o stałej cenie, specjalnych aktywności ani żadnych innych wartości niezwiązanych z pomieszczeniem (takich jak rezerwacja lub kolacja). Zdecydowanie zalecamy, aby domyślna strefa wypoczynkowa nie była powiązana z żadnym pomieszczeniem.
`party_size`	`int32` Dotyczy tylko restauracji: liczba osób, które można przyjąć w tym przedziale czasowym. Restauracja może być powiązana z kilkoma przedziałami czasowymi w tym samym czasie, z których każdy określa inną liczbę osób w grupie, jeśli np. 2, 3 lub 4 osoby mogą zająć miejsca po dokonaniu rezerwacji.
`room_description`	`Text` Opcjonalnie. Zlokalizowany opis pokoju. Jeśli jest ustawiona, należy podać wartość domyślną. Warto też podać popularne języki w lokalizacji sprzedawcy. (opcjonalnie)

SchedulingRules

Reguły harmonogramu usługi.

Pola
`min_advance_online_canceling`	`int64` Minimalny okres zapowiedzi w sekundach wymagany do anulowania zarezerwowanego spotkania online. (opcjonalnie)
`late_cancellation_fee (deprecated)`	`Price` Ten element został wycofany. Opłata za anulowanie w minimalnym okresie zapowiedzi.
`noshow_fee (deprecated)`	`Price` Ten element został wycofany. Opłata za niestawienie się bez anulowania rezerwacji.
`admission_policy`	`AdmissionPolicy` Zasady dopuszczania, które mają zastosowanie do tej usługi. Jeśli nie jest ustawiony, przyjmuje się domyślnie TIME_STRICT. (opcjonalnie)
`cancellation_policy`	`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:
`min_advance_booking`	`int64` Czas (w sekundach) od momentu, w którym można dokonać ostatniej rezerwacji, do momentu rozpoczęcia przedziału dostępności.
`min_booking_buffer_before_end_time`	`int64` 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 „admission_policy” 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.

Usługa

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

Pola
`name`	`string` Nazwa zasobu usługi w formacie `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`.
`service_name`	`string` Nazwa usługi, np. „Strzyżenie męskie”. Wycofany. Zamiast niego używaj atrybutu localized_service_name.
`localized_service_name`	`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. Wycofany. Zamiast niego używaj atrybutu localized_description.
`localized_description`	`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 „related_media” 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`	`Price` Cena usługi.
`price_interpretation`	`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`	`SchedulingRules` Zasady rezerwowania i anulowania spotkań.
`prepayment_type`	`PrepaymentType` Określ, czy przedpłata jest wymagana, opcjonalna czy nieobsługiwana.
`prepayment_terms`	`PrepaymentTerms` Warunki dotyczące momentu zakończenia przedpłaty.
`form[] (deprecated)`	`ServiceIntakeForm` Ten element został wycofany. Rola wycofana. Użyj formularzy intake_form i per_ticket_intake_form.
`intake_form`	`ServiceIntakeForm` formularz z prośbą o dodatkowe informacje od użytkownika, gdy rezerwuje on tę usługę. (opcjonalnie)
`per_ticket_intake_form`	`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)
`tax_rate`	`TaxRate` Stawka podatku za usługę. Jeśli to pole występuje, zastępuje ono wszelkie wartości tax_rate ustawione na poziomie sprzedawcy. Pusta wiadomość (np. tax_rate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera.
`payment_option_id[]`	`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`	`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)
`no_show_fee`	`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)
`require_credit_card`	`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)
`action_link[]`	`ActionLink` Link do działania powiązany z tą usługą. Jeśli link do działania istnieje, w usłudze musi być ustawiony typ (patrz poniżej).
`type`	`ServiceType` Wstępnie zdefiniowany typ tej usługi. (opcjonalnie)
`ticket_type[]`	`TicketType` Rodzaje biletów, które można zarezerwować lub kupić w ramach tej usługi, jeśli bilety są obsługiwane. (opcjonalnie)
`related_media[]`	`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)
`service_attribute_value_id[]`	`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)
`waitlist_rules`	`WaitlistRules` Zasady dołączania do listy oczekujących.
`ticketing_vertical_specific_data`	`TicketingVerticalSpecificData` Dodatkowe informacje unikalne dla kategorii biletów na wydarzenia. (opcjonalnie)
`integration_type`	`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.
`per_order_fee`	`PerOrderFee` Opłaty na poziomie zamówienia za zakup tej usługi. (opcjonalnie)
`tours_and_activities_content`	`ToursAndActivitiesContent` Pola treści dotyczące wycieczek i atrakcji.
`location[]`	`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`	`Rating` Ocena użytkowników tej usługi jako zbiorcza wartość wszystkich opinii.
`home_service_data`	`HomeServiceData` Dodatkowe informacje dotyczące branży usług domowych. (opcjonalnie)
`virtual_session`	`VirtualSession` Opcjonalnie. Informacje o sesji wirtualnej. Jest to wymagane do włączenia usług wirtualnych.
`direct_merchant_payment`	`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 virtual_session, a usługa nie jest bezpłatna lub prepayment_type NIE ma wartości REQUIRED.
`uri_template`	`UriTemplate` Opcjonalnie. Opcjonalny szablon określający, jak Google ma generować adresy URL do witryny zewnętrznej.

PrepaymentTerms

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

Pola

charge_timing

ChargeTiming

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

charge_time_before_start_time_sec

int64

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.

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.

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.

ServiceAttribute

Atrybuty usługi to zdefiniowane przez partnera kategorie opisujące usługi dla sprzedawcy. Na przykład bank może zdefiniować atrybut usługi „Rodzaj konta” z możliwymi wartościami „Osobiste” i „Firmowe”, a salon fryzjerski może zdefiniować atrybut usługi „Rodzaj usługi” z możliwymi wartościami „Strzyżenie”, „Koloryzacja” i „Stylizacja”.

Pola

attribute_id

string

Identyfikator, który w unikalny sposób identyfikuje ten atrybut usługi wśród innych atrybutów tego samego sprzedawcy, np. „account-type”.

attribute_name

string

Nazwa tego atrybutu widoczna dla użytkownika, np. „Typ konta”.

value[]

Value

Wszystkie możliwe wartości tego atrybutu usługi.

Wartość

Reprezentuje możliwą wartość atrybutu usługi.

Pola

value_id

string

Identyfikator, który jednoznacznie identyfikuje tę wartość wśród innych wartości tego atrybutu usługi, np. „personal”.

value_name

string

Nazwa wartości widoczna dla użytkownika, np. „Osobiste”.

ServiceAttributeValueId

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

Pola

attribute_id

string

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

value_id

string

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

ServiceAvailability

Lista dostępności i informacje o tym, do kogo i kiedy należy je zastosować.

Pola
`name`	`string` Nazwa zasobu usługi, do której ma zostać zastosowana ta zmiana. W formacie `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`
`start_time_restrict`	`Timestamp` Jeśli zostaną podane, uznamy, że podmioty Dostępność stanowią pełny obraz stanu w przedziale [start_time_restrict, end_time_restrict). Oznacza to, że cała dotychczasowa dostępność zostanie usunięta, jeśli spełniony jest ten warunek: `start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict` Jeśli ustawiono wiadomość o czasie trwania, warunek jest dodatkowo ograniczony: `availability.duration == duration_restrict` Jeśli ustawiona jest wiadomość resources_restrict, warunek jest dodatkowo ograniczony: `availability.resources.staff_id == resources_restrict.staff_id && availability.resources.room_id == resources_restrict.room_id` Te pola służą zwykle do podawania pełnych informacji o dostępności w danym zakresie czasu. Ustawienie parametru start_time_restrict przy pozostawieniu parametru end_time_restrict bez ustawienia oznacza, że wszystkie godziny zaczynają się od parametru start_time_restrict.
`end_time_restrict`	`Timestamp` Ustawienie parametru end_time_restrict przy pozostawieniu parametru start_time_restrict bez ustawienia oznacza, że obowiązuje cały czas do momentu określonego w parametrze end_time_restrict.
`duration_restrict`	`Duration` Ustawienie czasu trwania dodatkowo ogranicza zakres aktualizacji tylko do dostępności o pasującym czasie trwania.
`resources_restrict`	`Resources` Ustawienie resources_restrict dodatkowo ogranicza zakres aktualizacji tylko do tego zestawu zasobów. Wszystkie pola identyfikatorów zasobów muszą być identyczne.
`availability[]`	`Availability` Nowa lista dostępności.

ServiceIntakeForm

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

Pola

field[]

ServiceIntakeFormField

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

first_time_customers
(deprecated)

bool

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.

returning_customers
(deprecated)

bool

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.

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`	`FieldType` Typ tego pola.
`label`	`string` Tekst wyświetlany użytkownikowi w tym polu. Ta zasada została wycofana. Zamiast niej używaj zasady `localized_label`.
`localized_label`	`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 pola „location_id” w polu „location”.
`choice_text[]`	`Text` Ustaw, jeśli typ pola to MULTIPLE_CHOICE, CHECKBOXES lub DROPDOWN. Służy do wyliczania możliwych wyborów.
`is_required`	`bool` Określa, czy odpowiedź w tym polu jest wymagana od użytkownika.
`allow_custom_answer`	`bool` 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)
`additional_option[]`	`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)
`ticket_type_restrict[]`	`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`	`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.
`LOCATION_SEARCH`	Pole wyszukiwania, które umożliwia znalezienie pasującej lokalizacji na podstawie danych wejściowych użytkownika z podanej listy lokalizacji.

TaxRate

Stawka podatku stosowana podczas obciążania użytkownika za usługę, którą można ustawić dla każdego sprzedawcy lub każdej usługi.

Pola

micro_percent

int32

Stawka podatku w milionowych częściach procenta, co daje 6 miejsc po przecinku. Jeśli na przykład stawka podatku wynosi 7, 253%, w tym polu należy ustawić wartość 7253000.

Jeśli to pole jest nieskonfigurowane lub ma wartość 0, łączna cena pobierana od użytkownika za dowolną usługę świadczoną przez tego sprzedawcę jest dokładnie taka, jak cena określona w polu Service.price. Zakłada się, że cena usługi jest zwolniona z obowiązujących podatków lub już je zawiera. Podatki nie będą wyświetlane użytkownikowi jako osobna pozycja.

Jeśli to pole ma wartość inną niż zero, całkowita cena pobierana od użytkownika za dowolną usługę świadczoną przez tego sprzedawcę będzie obejmować cenę usługi plus podatek obliczony na podstawie podanej tu stawki podatku. Ułamki najmniejszej jednostki waluty (np. ułamki centa) będą zaokrąglane do najbliższej parzystej liczby. Podatki będą wyświetlane użytkownikowi jako osobna pozycja.

Warunki

Zbiór reguł i wytycznych wyświetlanych użytkownikowi w celu umożliwienia mu dokonania rezerwacji za pomocą usługi Zarezerwuj z Google.

Pola

url

string

Opcjonalnie adres URL Warunków korzystania z usługi.

text

string

Tekst, który ma być wyświetlany użytkownikowi. W przypadku nowych integracji używaj pola localized_text.

localized_text

Text

Zlokalizowany tekst, który ma być wyświetlany użytkownikowi.

Tekst

Ładunek tekstowy, który może być zlokalizowany. Niektóre pola tekstowe mogą zawierać treści z oznaczeniami.

Pola

value

string

Wartość tekstowa w nieznanym regionie. Wymagane tylko wtedy, gdy pole localized_value jest puste. Język tej wartości może zależeć od partnera lub usługodawcy. Nie należy zakładać, że jest to konkretny język.

localized_value[]

LocalizedString

Wartości tekstowe dla poszczególnych regionów. Opcjonalnie.

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.

Pola
`ticket_type_id`	`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.
`short_description`	`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. Wycofany. Zamiast niego używaj atrybutu localized_short_description.
`localized_short_description`	`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`	`Price` Cena pojedynczego biletu tego typu bez podatków. Do biletów na usługę stosowana jest stawka podatku od usług.
`per_ticket_fee`	`PerTicketFee` Dodatkowe opłaty za zakup tego biletu. (opcjonalnie)
`price_display_type`	`PriceDisplayType` Opcjonalnie. Wstępnie określony typ wyświetlania ceny pojedynczego biletu tego typu.
`option_description`	`string` Opis dodatkowej opcji, którą reprezentuje ten typ biletu (jeśli dotyczy). Wycofano. Zamiast tego użyj atrybutu localized_option_description.
`localized_option_description`	`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: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } } Przykład 2: wielogodzinny wynajem kajaka z opcjonalnym dodatkiem w postaci suchej torby. W tym przypadku short_description może mieć wartość „3 godziny”, a option_description może mieć wartość „z suchą torbą” lub „bez suchej torby”: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { 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 opcji). 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”.
`inventory_type`	`InventoryType` Opcjonalnie. Wstępnie określony typ zasobów reklamowych pojedynczego biletu tego typu.

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.

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.

TicketingVerticalSpecificData

Dodatkowe informacje unikalne dla kategorii biletów na wydarzenia.

Pola
`event_category`	`EventCategory` Kategoria wydarzenia. Ustawiane tylko wtedy, gdy zdarzenie należy do jednej ze wstępnie zdefiniowanych kategorii. (opcjonalnie)
`event_url`	`string` Adres URL wydarzenia na stronie partnera. (opcjonalnie)
`entity[]`	`Entity` Lista podmiotów powiązanych z wydarzeniem. (opcjonalnie)
`event_attendance_mode`	`AttendanceMode` Wymagane. Rodzaj uczestnictwa w wydarzeniu.
`event_virtual_location_url[]`	`string` Opcjonalnie. Adres URL, pod którym można obejrzeć wydarzenie.
`event_organizer`	`Text` Opcjonalnie. Organizator, który organizuje wydarzenie.
`event_organizer_url`	`string` Opcjonalnie. Adres URL organizatora, który organizuje wydarzenie.
`event_organizer_type`	`OrganizerType` Opcjonalnie. Typ organizatora.
`event_source_url[]`	`string` Wymagane. Adres URL stron, na których można znaleźć informacje lub opisy wydarzenia.
`event_state`	`EventState` Opcjonalnie. Stan zdarzenia.
`brand_name`	`Text` Opcjonalnie. Zlokalizowana nazwa marki.
`event_creator`	`EventCreator` Opcjonalnie. Informacje o twórcy wydarzenia.

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.

Jednostka

Reprezentuje podmiot powiązany ze zdarzeniem.

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 parametru relevant_url w polu public_identification_data. (opcjonalnie)
`entity_type`	`EntityType` Typ podmiotu. (opcjonalnie)
`entity_role`	`EntityRole` Rola elementu w wydarzeniu. (opcjonalnie)
`public_identification_data`	`PublicIdentificationData` Publiczne odniesienia do podmiotu. (opcjonalnie)

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

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.

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.

EventCreator

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

Pola

name

string

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

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.

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

PublicIdentificationData

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

Pola

relevant_url[]

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)

musicbrainz_id

string

36-znakowy identyfikator MusicBrainz wykonawcy lub innych podmiotów muzycznych (w odpowiednich przypadkach). Zobacz https://musicbrainz.org/doc/MusicBrainz_Identifier. (opcjonalnie)

TimeRange

Przedział czasu zamknięto-otwarty, czyli [start_time, end_time).

Pola

start_time

Dolna granica zakresu czasu.

end_time