Package google.maps.booking.v1alpha

string

Adres URL punktu wejścia dla tego linku do działania.

string

Tag języka BCP-47 określający język, w którym dostępne są treści z tego URI.

string

Kod kraju zgodny ze standardem ISO 3166-1 alpha-2. Aby zezwolić na nieograniczoną widoczność, zostaw to pole puste.

ActionPlatform

Platforma, na której ma zostać wykonane to działanie. Jeśli to pole nie jest ustawione, jako wartość zastępcza zostanie użyta wartość ACTION_PLATFORM_WEB_APPLICATION.

ActionLinkType

Wstępnie określony typ działania.

OrderOnlineMetadata

Metadane linku do składania zamówień online. Obsługuje działanie z wartością ActionLinkType równą ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

Metadane linków do zamawiania jedzenia. Obsługuje typ działania: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT NIE obsługuje ACTION_LINK_TYPE_ORDER_FOOD.

EventMetadata

Dodatkowe informacje o linku do działania, które są unikalne dla kategorii wydarzeń.

Surface

Wstępnie określona powierzchnia zdarzenia powiązana z linkiem do działania. Jest to używane tylko w kategorii wydarzeń.

string

Identyfikator. Nazwa zasobu AdsAccountLink. Format: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Wymagane. Lista identyfikatorów produktów z asortymentu, które mają zostać połączone z kontem Google Ads.

State

Tylko dane wyjściowe. Stan połączenia z kontem Google Ads.

Text

Niestandardowy komunikat, który będzie wyświetlany użytkownikowi podczas rezerwacji za pomocą funkcji Zarezerwuj z Google.

Timestamp

Czas rozpoczęcia terminu spotkania.

Duration

Czas trwania terminu spotkania

int64

Łączna liczba miejsc i wolnych miejsc w ramach tej dostępności. Przykłady:

• Zajęcia z jogi z 10 miejscami, z których 3 są zarezerwowane: availability {spots_total: 10, spots_open: 7 ...}
• Sesja masażu na krześle, która jest już w pełni zarezerwowana: availability {spots_total: 1, spots_open: 0 ...}

Uwaga: jeśli wysyłasz żądania w formacie kompresji dostępności zdefiniowanym poniżej, te 2 pola zostaną wywnioskowane.

• Powtarzanie oznacza spots_total=1 i spots_open=1.
• ScheduleException oznacza spots_total=1 i spots_open=0.

int64

Liczba wolnych miejsc.

string

Opcjonalny nieprzezroczysty ciąg znaków identyfikujący ten przedział dostępności. Jeśli to ustawienie jest włączone, będzie ono uwzględniane w żądaniach dotyczących rezerwowania, aktualizowania i anulowania wizyt.

Resources

Opcjonalne zasoby używane do odróżnienia tego przedziału czasowego od innych, gdy usługa obejmuje różnych pracowników lub pokoje.

np. te same zajęcia jogi z 2 instruktorami:

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

string

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

To pole zastępuje wszystkie identyfikatory payment_option_ids określone w wiadomości usługi. Podobnie identyfikatory payment_option_ids określone tutaj NIE muszą być obecne w wiadomości o usłudze, ale muszą być zdefiniowane na poziomie sprzedawcy.

Recurrence

Informacje o powtarzaniu dostępności, które reprezentują więcej niż 1 godzinę rozpoczęcia. Cykliczne spotkanie powinno zawierać spotkania na 1 dzień roboczy.

ScheduleException

Okresy, w których nie można zaplanować tej usługi. Aby ograniczyć liczbę wiadomości schedule_exception, rozważ połączenie sąsiednich wyjątków.

Deposit

Opcjonalna zaliczka w przypadku tej dostępności. Zastępuje kaucję za usługę, jeśli została określona.

NoShowFee

Opcjonalna opłata za niepojawienie się w przypadku tej dostępności. Zastępuje opłatę za niestawienie się w przypadku usługi, jeśli została określona.

Prepayment

Opcjonalnie. Opcjonalne informacje o przedpłacie w przypadku tej dostępności.

RequireCreditCard

Wskazuje, czy użytkownik musi podać dane karty kredytowej, aby zarezerwować ten przedział czasu. Jeśli wartość nie jest ustawiona, jest dziedziczona z poziomu usługi, jeśli jest tam ustawiona. (opcjonalnie)

string

Wskazuje listę obsługiwanych typów biletów w przypadku tego przedziału czasowego dostępności. Jeśli nie zostanie ustawiony, wszystkie typy biletów w usłudze nadrzędnej będą dostępne w tym przedziale. Wartości tego pola muszą być zdefiniowane w usłudze nadrzędnej. Przykłady:

• Usługa z 4 rodzajami biletów: TicketType {ticket_type_id: "adult_1" short_description: "Bilet dla dorosłych ważny w dni powszednie"} TicketType {ticket_type_id: "adult_2" short_description: "Bilet dla dorosłych ważny w weekendy"} TicketType {ticket_type_id: "youth_1" short_description: "Bilet dla młodzieży ważny w dni powszednie"} TicketType {ticket_type_id: "youth_2" short_description: "Bilet dla młodzieży ważny w weekendy"}

Aby reprezentować zasoby reklamowe w dni powszednie: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Aby reprezentować zasoby reklamowe w okresie świątecznym: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

• Usługa z 3 rodzajami biletów: TicketType {ticket_type_id: „adult” short_description: „Adult”} TicketType {ticket_type_id: „youth” short_description: „Youth”} TicketType {ticket_type_id: „senior” short_description: „Senior”}

Aby wskazać, że w tym przedziale czasowym dostępne są wszystkie 3 rodzaje biletów, użyj wartości availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} lub `availability {...}' (nie ustawiaj w tym przedziale atrybutu ticket_type_id).

(opcjonalnie)

DurationRequirement

Wymóg wyświetlania czasu trwania lub godziny zakończenia przedziałów. To pole będzie ignorowane, jeśli przedział jest niedostępny. Nie jest używany w przypadku kategorii „Atrakcje”. (opcjonalnie)

SchedulingRuleOverrides

Reguły planowania dostępności. Jeśli pola są wypełnione, zastąpią one odpowiednie reguły harmonogramu w polu SchedulingRules na poziomie usługi.

ConfirmationMode

Tryb potwierdzenia, który będzie używany podczas rezerwowania tej dostępności. Próby utworzenia rezerwacji dla dostępności z trybem potwierdzenia CONFIRMATION_MODE_SYNCHRONOUS muszą być natychmiast potwierdzone lub odrzucone. Próby utworzenia rezerwacji dla dostępności z trybem potwierdzenia CONFIRMATION_MODE_ASYNCHRONOUS muszą być natychmiast odrzucane lub tworzone ze stanem PENDING.

LinkoutRequiredReason

Opcjonalnie. Przyczyna, dla której w tym miejscu wymagany jest link do zewnętrznej strony. Jeśli ten atrybut jest ustawiony, zasób sprzedawcy dla tego miejsca musi mieć prawidłowy atrybut LinkoutTemplate. (opcjonalnie)

Timestamp

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

Duration

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)

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.

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.

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.

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)

string

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

GenericDeleteRecord

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

string

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

GenericRecord

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

string

Format partners/{partner_id}.

ExtendedServiceAvailability

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

ExtendedServiceAvailability

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

string

Nazwa zasobu rezerwacji: partners/{partner ID}/bookings/{booking ID}

string

Identyfikator sprzedawcy dla przedziału

string

Identyfikator usługi sprzedawcy

Timestamp

Godzina rozpoczęcia terminu spotkania

Duration

Czas trwania terminu spotkania

ClientInformation

Dane osobowe klienta, który umawia spotkanie

BookingStatus

Stan rezerwacji

PaymentInformation

Informacje o transakcjach płatniczych związanych z rezerwacją.

int64

Liczba osób w rezerwacji

Cause

Przyczyna niepowodzenia rezerwacji. (wymagane)

CreditCardType

(wymagany tylko wtedy, gdy przyczyną jest PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

To pole opcjonalne służy partnerowi do podawania dodatkowych informacji wyłącznie na potrzeby debugowania. (opcjonalnie)

PaymentFailureInformation

Informacje o nieudanych płatnościach.

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.

string

Adres URL, z którego ma być wczytywany formularz do uwierzytelniania użytkownika.

string

Żądanie PaymentAuthentication. Jeśli zostanie podany, zostanie opublikowany w formularzu ACSUrl.

string

Identyfikator używany przez dostawcę ACS. Jeśli zostanie podany, zostanie opublikowany w formularzu ACSUrl.

string

dane sprzedawcy; Jeśli zostanie podany, zostanie opublikowany w formularzu ACSUrl.

RefundCondition

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

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.

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.

string

Imię klienta

string

Nazwisko klienta

PostalAddress

Adres klienta

string

Numer telefonu klienta

string

Adres e-mail klienta

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}

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.

AdsAccountLink

Wymagane. Obiekt AdsAccountLink do utworzenia.

string

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

string

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

Merchant

Sprzedawca, który ma zostać utworzony.

string

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

string

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

Service

Usługa do utworzenia.

CreditCardType

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

string

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

string

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

string

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

Price

kwota wpłaty;

int64

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

PriceType

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

Text

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

Duration

Minimalny czas trwania.

Duration

Maksymalny czas trwania.

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

string

To pole jest wymagane, aby określić, do którego sprzedawcy należą poniższe wiadomości o dostępności.

string

To pole jest wymagane, aby określić, do której usługi należą poniższe wiadomości o dostępności.

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.

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

Ustawienie czasu trwania dodatkowo ogranicza zakres aktualizacji tylko do dostępności o pasującym czasie trwania.

Resources

Ustawienie resources_restrict dodatkowo ogranicza zakres aktualizacji tylko do tego zestawu zasobów. Wszystkie pola identyfikatorów zasobów muszą być identyczne.

Availability

Nowa lista dostępności.

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.

int64

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

int64

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

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

Stan przetwarzania tego pliku danych.

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.

FeedStatistics

Statystyki dotyczące tego pliku danych.

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.

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.

Duration

Stały czas trwania. Przykład: 30 minut.

DurationRange

Zakres czasu trwania. Przykłady: * 30–45 minut * ponad 30 minut * mniej niż 50 minut

bool

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

FeeType

Typ opłaty. (wymagane)

FeeAmount

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

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%

Money

Ustalona kwota. Na przykład 3,50 PLN.

MoneyRange

Zakres kwoty. Przykłady: * 3,5–5,5 PLN * co najmniej 3,5 PLN * co najwyżej 5,5 PLN

bool

Nieznana kwota.

FulfillmentType

Wymagane. Typ realizacji zamówień.

AvailableDay

Wymagane. Lista dni, w których ta metoda realizacji jest dostępna (najlepiej co najmniej 2).

FeeDetails

Wymagane. Szczegóły opłat za metodę realizacji.

Price

Wymagane. Minimalne zamówienie w przypadku metody realizacji powiązanej z linkiem do działania.

Date

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

Timestamp

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.

NoFee

Brak opłaty za metodę realizacji.

MinimumFee

Opłata podstawowa powiązana z metodą realizacji.

FixedFee

Opłata stała powiązana z metodą realizacji.

Price

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

Price

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

Timestamp

Wymagane. Ta sygnatura czasowa służy do określania kolejności, w jakiej usunięcie zostanie zastosowane do zasobów reklamowych.

bytes

W przypadku plików danych nieopartych na protokole.

Any

W przypadku plików danych opartych na protokole.

Timestamp

Wymagane. Ta sygnatura czasowa służy do zapewnienia prawidłowej kolejności aktualizacji asortymentu.

bytes

W przypadku plików danych nieopartych na protokole.

Any

W przypadku plików danych opartych na protokole.

double

Szerokość geograficzna w stopniach. (opcjonalnie)

double

Długość geograficzna w stopniach. (opcjonalnie)

PostalAddress

Preferowany adres pocztowy lokalizacji.

string

Możesz też podać nieustrukturyzowany adres jako wartość zastępczą. np. „1600 amphitheatre parkway mountain view, ca 94043”.

string

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

string

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

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}

string

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

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.

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.

string

Identyfikator usługi sprzedawcy.

int64

Czas rozpoczęcia przedziału czasowego spotkania w sekundach czasu UTC od początku epoki systemu Unix.

int64

Czas trwania przedziału czasowego spotkania w sekundach.

OrderedTickets

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

Price

Łączna cena (bez podatków) tego elementu zamówienia.

BookingStatus

Stan elementu zamówienia.

string

Identyfikator typu biletu.

int32

Liczba zamówionych biletów tego typu.

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

string

Wymagane. Element nadrzędny, do którego należy ta kolekcja stanów sprzedawcy. Format: partners/{partner_id}/merchants

int32

Wymagane. Maksymalna liczba elementów do zwrócenia. Pamiętaj, że serwer może zmniejszyć rozmiar strony.

string

Opcjonalnie. Wartość nextPageToken zwrócona w poprzedniej odpowiedzi ListMerchantStatusResponse (jeśli występuje).

BookingInventoryStatus

Opcjonalnie. Opcjonalne ograniczenie, które pozwala filtrować wyniki według stanu asortymentu rezerwacji.

WaitlistInventoryStatus

Opcjonalnie. Opcjonalne ograniczenie umożliwiające filtrowanie wyników według stanu asortymentu na liście oczekujących.

GeoMatchingStatus

Opcjonalnie. Opcjonalne ograniczenie umożliwiające filtrowanie wyników według stanu dopasowania geograficznego.

MerchantStatus

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

string

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

string

Nazwa zasobu pliku danych w formacie

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

int32

Maksymalna liczba elementów do zwrócenia.

string

Wartość next_page_token zwrócona z poprzedniego żądania List (jeśli występuje).

State

Opcjonalnie możesz ograniczyć wyniki, filtrując je według stanu pliku danych.

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

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.

string

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

string

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

string

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

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.

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)

string

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

string

Adres URL publicznej witryny lokalizacji. (opcjonalnie)

GeoCoordinates

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

LocationType

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

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)

string

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

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.

string

Publiczny numer telefonu sprzedawcy wraz z kodem kraju i numerem kierunkowym, np. +14567891234.

string

Adres URL publicznej witryny sprzedawcy.

GeoCoordinates

Informacje geograficzne o sprzedawcy, w tym szerokość i długość geograficzna oraz adres.

string

Kategoria firmy na platformie agregatora.

int64

To pole zostało wycofane.

uint32

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.

TaxRate

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.

PaymentRestrictions

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.

PaymentOption

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.

PaymentProcessorConfig

Konfiguracja tokenizowanego procesora płatności, jeśli sprzedawca go obsługuje.

TokenizationConfig

Konfiguracja tokenizowanego procesora płatności, jeśli sprzedawca go obsługuje. Wycofane, ponieważ płatności E2E nie są już obsługiwane.

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

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

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)

ServiceAttribute

Definicje atrybutów usługi używanych do opisywania Usług dla tego Sprzedawcy. (opcjonalnie)

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.

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.

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.

EconomicOperator

Opcjonalnie. Informacje o podmiocie gospodarczym powiązane z tym konkretnym sprzedawcą, które są wymagane do zachowania zgodności z przepisami. (opcjonalnie)

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.

string

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

string

Nazwa sprzedawcy podana przez partnerów.

GeoCoordinates

Partnerzy przekazali informacje geograficzne o sprzedawcy.

ProcessingStatus

Stan przetwarzania sprzedawcy.

BookingStatus

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

WaitlistStatus

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

PlaceInfo

Dopasowane miejsce geograficzne tego sprzedawcy. Puste, jeśli sprzedawca nie jest dopasowany geograficznie.

LocalServicesMatchInfo

Usługi Lokalne tego sprzedawcy. Puste, jeśli sprzedawca nie świadczy usług lokalnych lub nie jest dopasowany do żadnego usługodawcy.

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.

bool

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

UrlType

Typ tego adresu URL.

string

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

MatchedProvider

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

int64

Zewnętrzny identyfikator klienta Usług lokalnych Google.

string

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

string

Nazwa miejsca.

string

Sformatowany adres w języku lokalnym.

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.

bool

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

Money

Minimalna kwota.

Money

Maksymalna kwota.

Price

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

PriceType

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

string

Nazwa zasobu zamówienia: partners/{partner ID}/orders/{order ID}

ClientInformation

dane osobowe klienta składającego zamówienie;

PaymentInformation

Informacje o transakcjach płatniczych związanych z zamówieniem.

string

Identyfikator sprzedawcy, do którego należą wszystkie usługi w tym zamówieniu.

LineItem

Elementy zamówienia w tym zamówieniu.

FulfillmentOption

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

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.

string

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

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.

string

Nazwa opcji płatności. Może to być widoczne dla użytkownika.

string

Opis opcji płatności. Może to być widoczne dla użytkownika.

Price

Cena opcji płatności.

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.

PaymentOptionType

Typ tej opcji płatności. Pojedyncze wejścia, pakiety i nieograniczone korzystanie w przypadku subskrypcji.

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.

TimeRange

Opcję płatności można kupić w tym przedziale.

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.

Duration

Okres ważności opcji płatności (np. 30-dniowe członkostwo).

ActivationType

Określa sposób ustalania daty rozpoczęcia ważności tej formy płatności.

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.

Processor

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

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.

string

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

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.

Price

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

Price

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

Price

Dodatkowa opłata za usługę.

Price

Opłata, która trafia do obiektu.

Price

podatki od biletu,

string

Kraj podany za pomocą kodu ISO 3166-1 alfa-2, np. „US” (wymagany).

string

Miejscowość, np. „Mountain View”. (wymagane)

string

Region, np. „CA”. To pole jest wymagane tylko w krajach, w których region jest zwykle częścią adresu. (opcjonalnie)

string

Kod pocztowy, np. „94043”. (wymagane)

string

Ulica, np. „1600 Amphitheatre Pkwy”. (wymagane)

PriceInfo

Kontener ze szczegółami ceny.

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

string

Waluta ceny zdefiniowana w normie ISO 4217.

string

Opcjonalny i nieprzejrzysty ciąg znaków, który identyfikuje opcję cenową powiązaną z ceną rozszerzoną.

PriceType

Określa, jak stosowana jest cena lub przedział cenowy (za osobę lub stała cena)

Price

Cena usługi lub opłata.

PriceRange

Górna lub dolna granica usługi lub opłaty.

Price

Minimalna kwota.

Price

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

double

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

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

double

Wartość minimalna.

double

Wartość maksymalna.

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.

uint64

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

string

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

MediaType

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

Text

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

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)

string

Wycofany. Zalecamy używanie pola localized_caption.

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

string

Wycofane. Zalecamy używanie pola localized_text.

ServiceAvailability

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

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.

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.

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.

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.

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.

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)

int64

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

Price

Opłata za anulowanie w minimalnym okresie zapowiedzi.

Price

Opłata za niestawienie się bez anulowania rezerwacji.

AdmissionPolicy

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

CancellationPolicy

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

int64

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

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.

string

Nazwa zasobu usługi w formacie partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

string

Nazwa usługi, np. „Strzyżenie męskie”. Wycofany. Zamiast niego używaj atrybutu localized_service_name.

Text

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

string

Opis usługi widoczny dla użytkownika. Wycofany. Zamiast niego używaj atrybutu 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

Cena usługi.

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.

SchedulingRules

Zasady rezerwowania i anulowania spotkań.

PrepaymentType

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

PrepaymentTerms

Warunki dotyczące momentu zakończenia przedpłaty.

ServiceIntakeForm

Rola wycofana. Użyj formularzy intake_form i per_ticket_intake_form.

ServiceIntakeForm

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

ServiceIntakeForm

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

TaxRate

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.

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

Określa, w jaki sposób można obciążyć użytkownika kaucją. Zastępuje kaucję za usługę, jeśli została określona. Ustawienie pustej wartości w przypadku wiadomości o wpłacie powoduje usunięcie wszelkich wpłat na poziomie usługi. (opcjonalnie)

NoShowFee

Określa opłatę za niestawienie się, która może zostać naliczona użytkownikowi. Zastępuje opłatę za niestawienie się w przypadku usługi, jeśli została określona. Ustawienie pustego komunikatu NoShowFee usuwa wszelkie opłaty za niestawienie się na poziomie usługi. (opcjonalnie)

RequireCreditCard

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)

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

ServiceType

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

TicketType

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

RelatedMedia

Zdjęcia związane z tą usługą. Google będzie indeksować i przechowywać multimedia, aby wyświetlać je użytkownikom w najbardziej efektywny sposób. (opcjonalnie)

ServiceAttributeValueId

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

WaitlistRules

Zasady dołączania do listy oczekujących.

TicketingVerticalSpecificData

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

IntegrationType

Poziom integracji, który obsługujemy w przypadku tej usługi. (opcjonalnie) Nie ma znaczenia w przypadku partnerów korzystających z integracji podstawowej. W przypadku tych partnerów szyfrowanie end-to-end będzie zawsze wyłączone.

PerOrderFee

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

ToursAndActivitiesContent

Pola treści dotyczące wycieczek i atrakcji.

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

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

HomeServiceData

Dodatkowe informacje dotyczące branży usług domowych. (opcjonalnie)

VirtualSession

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

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.

UriTemplate

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

ChargeTiming

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

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.

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

string

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

Value

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

string

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

string

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

string

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

string

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

string

Nazwa zasobu usługi, do której ma zostać zastosowana ta zmiana. W formacie partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

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.

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

Ustawienie czasu trwania dodatkowo ogranicza zakres aktualizacji tylko do dostępności o pasującym czasie trwania.

Resources

Ustawienie resources_restrict dodatkowo ogranicza zakres aktualizacji tylko do tego zestawu zasobów. Wszystkie pola identyfikatorów zasobów muszą być identyczne.

Availability

Nowa lista dostępności.

ServiceIntakeFormField

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

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.

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.

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)

FieldType

Typ tego pola.

string

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

Text

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

string

Ustaw, jeśli typ pola to LOCATION_SEARCH. Aby określić wartość lokalizacji, użyj pola „location_id” w polu „location”.

Text

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

bool

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

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)

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)

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.

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)

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.

string

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

string

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

Text

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

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.

LocalizedString

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

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.

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.

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

Cena pojedynczego biletu tego typu bez podatków. Do biletów na usługę stosowana jest stawka podatku od usług.

PerTicketFee

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

PriceDisplayType

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

string

Opis dodatkowej opcji, którą reprezentuje ten typ biletu (jeśli dotyczy). Wycofano. Zamiast tego użyj atrybutu 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”.

InventoryType

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

EventCategory

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

string

Adres URL wydarzenia na stronie partnera. (opcjonalnie)

Entity

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

AttendanceMode

Wymagane. Rodzaj uczestnictwa w wydarzeniu.

string

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

Text

Opcjonalnie. Organizator, który organizuje wydarzenie.

string

Opcjonalnie. Adres URL organizatora, który organizuje wydarzenie.

OrganizerType

Opcjonalnie. Typ organizatora.

string

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

EventState

Opcjonalnie. Stan zdarzenia.

Text

Opcjonalnie. Zlokalizowana nazwa marki.

EventCreator

Opcjonalnie. Informacje o twórcy wydarzenia.

string

Unikalny identyfikator podmiotu w bazie danych partnera. (opcjonalnie)

string

Nazwa jednostki. (wymagane)

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)

EntityType

Typ podmiotu. (opcjonalnie)

EntityRole

Rola elementu w wydarzeniu. (opcjonalnie)

PublicIdentificationData

Publiczne odniesienia do podmiotu. (opcjonalnie)

string

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

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)

string

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

Timestamp

Dolna granica zakresu czasu.

Timestamp

Górna granica zakresu czasu.

map<string, string>

Konfiguracja tokenizacji zwykle zawiera 1 parametr tokenizacji, którego kluczem jest „gateway”, a wartością nazwa procesora.

Pozostałe parametry zależą od procesora. Więcej informacji znajdziesz w dokumentacji Google Pay.

Przykład Braintree: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Przykład Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Przykład Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

W tokenie płatności uwzględnij informacje rozliczeniowe użytkownika wprowadzone w Google Pay wraz z formą płatności (patrz wyżej). Pozostawienie tego pola pustego jest równoznaczne z określeniem wartości MIN.