Package google.maps.booking.v1alpha

string

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

string

Tag języka BCP-47 określający język, w którym dostępna jest treść z tego identyfikatora URI.

string

Kod kraju zgodny ze standardem ISO 3166-1 alfa-2. Aby zachować widoczność bez ograniczeń, pozostaw to pole puste.

ActionPlatform

Platforma, na której należy wykonać to działanie. Jeśli to pole nie jest skonfigurowane, jako wartość zastępczą będzie używana ACTION_PLATFORM_WEB_APPLICATION.

ActionLinkType

Wstępnie określony typ działania.

OrderOnlineMetadata

Metadane linku online do zamówienia. Obsługuje akcje z parametrem ActionLinkType o wartości 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.

Text

Niestandardowa wiadomość wyświetlana użytkownikowi podczas rezerwacji poprzez Zarezerwuj z Google.

Timestamp

Godzina rozpoczęcia terminu spotkania.

Duration

Czas trwania terminu spotkania

int64

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

• Zajęcia jogi obejmujące 10 miejsc z 3 zarezerwowanymi: 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 przy użyciu zdefiniowanego poniżej formatu kompresji dostępności, te 2 pola zostaną wywnioskowane.

• Powtarzanie obejmuje reguły spots_total=1 i spots_open=1.
• Wyjątek ScheduleException zakłada, że chodzi o 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 jest ustawiona, będzie uwzględniana w prośbach dotyczących rezerwowania, aktualizowania lub anulowania spotkań.

Resources

Opcjonalne zasoby używane do odróżnienia tego przedziału dostępności od innych, gdy usługa obejmuje różnych pracowników lub sale.

Na przykład: 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 opłacenia tego przedziału. Rzeczywiste opcje płatności są zdefiniowane na poziomie sprzedawcy i mogą być udostępniane wielu sprzedawcom.

To pole zastępuje wszystkie identyfikatory payment_option_id określone w komunikacie dotyczącym usługi. Podobnie określone tutaj identyfikatory payment_option_ids NIE muszą występować w komunikacie dotyczącym usługi, ale muszą być zdefiniowane na poziomie sprzedawcy.

Recurrence

Informacje o powtórzeniu dostępności, które reprezentują więcej niż 1 czas rozpoczęcia. Cykliczność powinna zawierać spotkania zaplanowane na jeden dzień roboczy.

ScheduleException

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

Deposit

Opcjonalna wpłata za tę dostępność. Zastępuje wpłatę za usługę, jeśli została określona.

NoShowFee

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

RequireCreditCard

Wskazuje, czy użytkownik musi podać kartę kredytową, aby zarezerwować ten przedział dostępności. Jeśli wartość nie jest ustawiona, jest dziedziczona z poziomu usługi, o ile jest na nim ustawiona. (opcjonalnie)

string

Wskazuje listę obsługiwanych typów biletów w tym przedziale czasu. Jeśli zasada jest nieskonfigurowana, dla tego przedziału są dostępne wszystkie typy zgłoszeń w usłudze nadrzędnej. Pamiętaj, że wartości tego pola muszą być zdefiniowane w usłudze nadrzędnej. Przykłady:

• Usługa z czterema typami biletów: TicketType {ticket_type_id: "adult_1" Short_description: "Adult weekdays"} – typ biletu {ticket_type_id: "adult_2" Short_description: "Adult weekends"}. TicketType {ticket_type_id: "youth_1" Short_description: "Youth weekdays"} Typ biletu {ticket_type_id: "youth_2" Short_description: "Weekendy dla młodzieży"}

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

• Usługa z 3 typami biletów: TicketType {ticket_type_id: "dla dorosłych" Short_description: "Adult"} TicketType {ticket_type_id: "youth" Short_description: "Youth"} TicketType {ticket_type_id: "senior" Short_description: "Senior"}

Aby wskazać, że dla tego przedziału czasu dostępne są wszystkie 3 typy biletów, użyj atrybutu availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} lub „dostępność {...}” (nie ustawiaj pola Ticket_type_id w tym przedziale).

(opcjonalnie)

DurationRequirement

Wymóg wyświetlania czasu trwania przedziałów lub czasu zakończenia. Jeśli przedział jest niedostępny, to pole jest ignorowane. Nieużywane w branży Atrakcje. (opcjonalnie)

SchedulingRuleOverrides

Reguły harmonogramu dostępności. Jeśli pola będą wypełnione, zastąpią wszystkie odpowiadające im reguły harmonogramu w regułach harmonogramu na poziomie usługi.

ConfirmationMode

Tryb potwierdzenia, który zostanie użyty podczas rezerwacji tej dostępności. Próby utworzenia rezerwacji na potrzeby dostępności z trybem potwierdzenia CONFIRMATION_MODE_SYNCHRONOUS muszą zostać natychmiast potwierdzone lub odrzucone. Próby utworzenia rezerwacji na potrzeby dostępności z trybem potwierdzenia CONFIRMATION_MODE_ASYNCHRONOUS muszą być natychmiast odrzucone lub utworzone ze stanem OCZEKUJĄCA.

Timestamp

Maksymalna sygnatura czasowa UTC obejmująca okres powtarzania dostępności.

Duration

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

Przykład: dostępność z czasem trwania 20 min, powtórz_wszystko 30 min, godzina rozpoczęcia 9:00 oraz powtórzenie_do 11:00 powodują wyświetlenia przedziałów o godzinach 9:20, 9:30–9:50, 10–10:20, 10:30–2:11:10. (wymagane)

TimeRange

Zakres czasowy wyjątku. Wszystkie przedziały opisane przez powtarzanie, które nakładają się na ten zakres czasu zamkniętego i otwartego, są uważane za niedostępne.

Przykład: jeśli powtarzanie ma ustawiony czas trwania 20 min, powtórz_wszystko 30 min, czas startowy 9:00 i powtarzanie_do 11:00am, to zdarzenie ScheduleException z zakresem czasowym 9:45am-11:00am będzie niedostępne w godzinach 9:30-9:51am, 9:30-9:51am, 9:00am-1:51am,

Pamiętaj, że ponieważ przedział czasu jest zamknięty i otwarty, nie będzie to miało wpływu na przedział zaczynający się o 11:00.

int64

Ostatni czas (w sekundach), kiedy można zarezerwować ten przedział czasu. Ta sygnatura czasowa musi być przed datą start_sec przedziału, która ma być respektowana (jeśli użytkownicy powinni mieć możliwość rezerwacji po czasie rozpoczęcia, użyj SchedulingRules.min_booking_before_end_time) na poziomie usługi. Jeśli ta opcja jest dostępna, zastąpi wszystkie ustawienia określone w polu min_booking_buffer w regułach harmonogramu odpowiedniej usługi.

int64

Pierwszy raz (w sekundach), kiedy można zarezerwować ten przedział. Ta sygnatura czasowa musi być przed wartością start_sec przedziału lub last_bookable_sec, jeśli jest określona.

int64

Jeśli jest ustawiony, ostatni czas (w sekundach od początku epoki uniksowej), o którym można anulować dany termin spotkania przez 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. Jedno wywołanie interfejsu API może zawierać maksymalnie 1000 rekordów.

string

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

GenericRecord

Rekordy do wstawienia lub aktualizacji. Jedno wywołanie interfejsu API może zawierać maksymalnie 1000 rekordów.

string

Format: partners/{partner_id}.

ExtendedServiceAvailability

Rozszerzona dostępność usługi, która służy do zastępowania istniejących przedziałów dostępności.

ExtendedServiceAvailability

Zaktualizowano komunikaty o rozszerzonej dostępności usługi, które zostały użyte do zastąpienia istniejących przedziałów dostępności.

string

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

string

Identyfikator sprzedawcy dla boksu

string

Identyfikator usługi sprzedawcy

Timestamp

Godzina rozpoczęcia terminu spotkania

Duration

Czas trwania terminu spotkania

ClientInformation

Dane osobowe klienta umawiającego się na spotkanie

BookingStatus

Stan rezerwacji

PaymentInformation

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

int64

Liczba osób w rezerwacji

Cause

Powód niepowodzenia rezerwacji. (wymagane)

CreditCardType

(wymagane tylko wtedy, gdy przyczyna to PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

To opcjonalne pole pozwala partnerowi podać dodatkowe informacje tylko do celów debugowania. (opcjonalnie)

PaymentFailureInformation

informacje o niepowodzeniu płatności;

ThreeDS1Parameters

Parametry używane przez agregator RwG do zainicjowania protokołu uwierzytelniania 3DS1 z użytkownikiem. Będzie ignorowana, chyba że ustawienie BookingFailure.cause ma wartość PAYMENT_REQUIRES_3DS1.

string

Adres URL, z którego ma zostać wczytany formularz, który ma zostać wyświetlony użytkownikowi w celu uwierzytelnienia.

string

a PaymentAuthentication Request. Do opublikowania w formularzu ACSUrl, jeśli został podany.

string

Identyfikator używany przez dostawcę ACS. Do opublikowania w formularzu ACSUrl, jeśli został podany.

string

Dane sprzedawcy. Do opublikowania w formularzu ACSUrl, jeśli został podany.

RefundCondition

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

Duration

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

uint32

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

string

Imię klienta

string

Nazwisko klienta

PostalAddress

Adres klienta

string

Numer telefonu klienta

string

Adres e-mail klienta

string

Nazwa zasobu nadrzędnego partnera, do którego należy ten sprzedawca, w formacie partners/{partner_id}.

string

Identyfikator sprzedawcy, którego należy 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óry ma być dla niej używany.

Service

Usługa do utworzenia.

CreditCardType

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

string

Nazwa zasobu sprzedawcy, który ma zostać usunięty. 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

Minimalne anulowanie wpłaty z wyprzedzeniem.

PriceType

Określa, jak wpłata jest określana na podstawie dostępności.

Text

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

Duration

Minimalny czas trwania.

Duration

Maksymalny czas trwania.

string

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

string

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

Timestamp

Jeśli podasz encje dostępności, uznamy je za pełne zrzuty z okresu [start_time_restrict, end_time_restrict). Oznacza to, że cała istniejąca dostępność zostanie usunięta, jeśli zostanie spełniony ten warunek:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Jeśli ustawiony jest komunikat o czasie trwania, warunek jest jeszcze bardziej ograniczony:

  availability.duration == duration_restrict

Jeśli ustawiono komunikat resource_restrict, warunek jest jeszcze bardziej ograniczony:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Te pola są zwykle używane do zapewnienia pełnej aktualizacji dostępności w danym przedziale czasu.

Ustawienie start_time_restrict z pozostawieniem nieskonfigurowania end_time_restrict jest interpretowane tak, że cały czas zaczyna się od start_time_restrict.

Timestamp

Ustawienie end_time_restrict z pozostawieniem nieskonfigurowanej wartości start_time_restrict jest interpretowane tak, że oznacza to, że cały okres nie może przekraczać end_time_restrict.

Duration

Ustawienie czasu trwania jeszcze bardziej ogranicza zakres aktualizacji tylko do dostępności z pasującym czasem trwania.

Resources

Ustawienie resource_restrict jeszcze bardziej ogranicza zakres aktualizacji tylko do tego zbioru zasobów. Wszystkie pola identyfikatorów zasobów muszą być dokładnie takie same.

Availability

Nowa lista dostępności.

int64

Nowo dodane elementy przez ten plik danych. W zależności od typu pliku danych produktami mogą być sprzedawcy, usługi lub przedziały dostępności.

int64

Istniejące produkty, zaktualizowane w razie potrzeby na podstawie nowszych informacji z pliku danych.

int64

Produkty, których nie ma już w tym pliku danych, zostały usunięte.

string

Nazwa zasobu kanału, która ma format

• 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

Zrozumiały dla człowieka ciąg tekstowy zawierający więcej szczegółów, jeśli nie udało się nam przetworzyć tego pliku danych.

FeedStatistics

Statystyki dotyczące tego kanału.

FeeDetails

Szczegóły opłat pobieranych od użytkownika wraz z łączną liczbą produktów. Powtórzono w przypadku różnych rodzajów opłat, takich jak opłata za obsługę, opłata za dostawę itp.

AdvanceOrderDetails

Szczegóły obsługi zaawansowanego zamawiania, tzw. zamówienia z wyprzedzeniem, dzięki której użytkownik może złożyć zamówienie w celu realizacji zamówienia później niż teraz.

Duration

Stały czas trwania. Na przykład: 30 minut.

DurationRange

Zakres czasu trwania. Przykłady: * 30 min do 45 min * więcej niż 30 min * mniej niż 50 min

bool

Prawda, jeśli obsługiwane są zamówienia z wyprzedzeniem (znane też jako „Zamówienie z wyprzedzeniem”). (wymagane)

FeeType

Typ opłaty. (wymagane)

FeeAmount

Kwota opłaty może być wyrażona w walucie jednostkowej, jako procent wartości koszyka lub jako kombinacja obu tych wartości. (wymagane)

QuantitativeValue

Opłata jako procent wartości koszyka. Obsługuje zakres (ograniczony i nieograniczony) lub stałą wartość procentową. Wartość powinna mieścić się w zakresie od 0 do 100. Przykłady: * Stała * Co najmniej 5,5% * Maksymalnie 5,5% * 4,5% do 5,5%.

Money

Ustalona kwota. Przykład: 3,5 PLN.

MoneyRange

Zakres kwoty. Przykłady: * 3,5–5,5 PLN * Co najmniej 3,5 PLN * maksymalnie 5,5 PLN

bool

Nieznana kwota.

FulfillmentType

Wymagane. Typ realizacji.

AvailableDay

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

FeeDetails

Wymagane. Szczegóły opłaty za metodę realizacji zamówienia.

Price

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

Date

Wymagane. Data dostępności metody realizacji zamówienia. Przynajmniej w strefie czasowej sprzedawcy.

Timestamp

Wymagane. Sygnatura czasowa systemu Unix. Ostatni raz, kiedy użytkownik mógł zamówić i otrzymać produkty do fulfillment_date. Oznacza to, że po upłynięciu last_ordering_time parametr fulfillment_date nie będzie już wyświetlany jako dostępny.

Jeśli na przykład fulfillment_date [data_realizacji] to 2020-08-10: – wartość last_ordering_time 2020-08-10 18:00 oznacza, że aby otrzymać zamówienie 10 sierpnia 2020 r., klient musi je złożyć do 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 je złożyć do 20:00 dwa dni wcześniej.

NoFee

Brak opłat za metodę realizacji zamówienia.

MinimumFee

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

FixedFee

Stała opłata związana z metodą realizacji.

Price

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

Price

Wymagane. Kwota opłaty podstawowej za metodę realizacji zamówienia.

Timestamp

Wymagane. Ta sygnatura czasowa służy do określenia kolejności, w jakiej zostaną usunięte zasoby reklamowe.

bytes

Dotyczy to plików danych, które nie są oparte na proto.

Any

W przypadku plików danych opartych na proto.

Timestamp

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

bytes

Dotyczy to plików danych, które nie są oparte na proto.

Any

W przypadku plików danych opartych na proto.

double

Szerokość geograficzna w stopniach. (opcjonalnie)

double

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

PostalAddress

Preferowany adres pocztowy lokalizacji.

string

Jako adres zastępczy można też podać nieuporządkowany adres. Na przykład: „Woronicza 17 Warszawa, Polska”

string

Wymagane. Nazwa zasobu w formacie partnerzy/{identyfikator_partnera}/merchants/{merchant_id}/status.

string

Nazwa zasobu kanału, która ma format

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

string

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

string

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

string

Nazwa zasobu do unieważnienia.

Na przykład dla zasobu z odbiorem należy podać nazwę w formacie partners/{partner_id}/pickups/{pickup_id}. Implementacje MUSZĄ usuwać wersje zidentyfikowanego zasobu z pamięci podręcznej.

string

Identyfikator usługi sprzedawcy.

int64

Godzina rozpoczęcia przedziału czasu dla spotkań w sekundach czasu UTC od początku epoki uniksowej.

int64

Czas trwania przedziału czasu dla spotkania w sekundach.

OrderedTickets

Liczba biletów uporządkowanych według typu.

Price

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

BookingStatus

Stan elementu zamówienia.

string

Identyfikator typu zgłoszenia.

int32

Liczba zamówionych biletów tego typu.

string

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

int32

Wymagane. Maksymalna liczba produktów do zwrotu. Pamiętaj, że serwer może zmniejszyć rozmiar strony.

string

Opcjonalnie: Wartość nextPageToken zwrócona z poprzedniej odpowiedzi ListMerchantStatusResponse (jeśli istnieje).

BookingInventoryStatus

Opcjonalnie: Opcjonalne ograniczenie filtrowania wyników według stanu rezerwacji zasobów reklamowych.

WaitlistInventoryStatus

Opcjonalnie: Opcjonalne ograniczenie filtrowania wyników według stanu asortymentu na liście oczekujących.

GeoMatchingStatus

Opcjonalnie: Opcjonalne ograniczenie filtrowania wyników według stanu dopasowania geograficznego.

MerchantStatus

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

string

Token pobierający następną stronę wyników. Jeśli lista jest pusta, nie ma więcej wyników.

string

Nazwa zasobu kanału, która ma format

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

int32

Maksymalna liczba produktów do zwrotu.

string

Wartość next_page_token zwrócona z poprzedniego żądania listy (jeśli miało to miejsce).

State

Opcjonalne ograniczenie filtrowania wyników według stanu pliku danych.

TimeRange

Opcjonalne ograniczenie filtrowania wyników według górnej i dolnej granicy. Jeśli czas start_time nie jest ustawiony, domyślnie przyjmuje się wartość początek czasu uniksowego. Jeśli pole end_time nie jest ustawione, przyjmuje wartość domyślną teraz.

FeedStatus

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

string

Token pobierający następną stronę wyników. Jeśli lista jest pusta, nie ma więcej wyników.

string

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

string

Wyślij wiadomość w powyższym języku (UTF-8).

string

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

string

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

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

string

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

string

Adres URL publicznej witryny lokalizacji. (opcjonalnie)

GeoCoordinates

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

LocationType

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

string

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

string

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

string

Atrybuty merchant_name, numer telefonu, adres URL i dane geograficzne służą do dopasowywania zasobów reklamowych partnera do sprzedawców znajdujących się już w Mapach Google. Te informacje nie będą wyświetlane.

Nazwa sprzedawcy.

string

Publiczny numer telefonu sprzedawcy wraz z numerem kraju i numeru kierunkowego, np. +14567891234.

string

Adres URL publicznej witryny sprzedawcy.

GeoCoordinates

Dane geograficzne sprzedawcy, w tym szerokość i długość geograficzną oraz adres.

string

Kategoria działalności na platformie agregatora.

int64

To pole zostało wycofane.

uint32

Stawka podatku ustalona przez sprzedawcę w punktach podstawowych (setna część jednego procenta). Jeśli np.stawka podatku wynosi 7, 5%, w tym polu należy ustawić wartość 750.

Jeśli to pole jest nieskonfigurowane lub ma wartość 0, łączna cena, jaką użytkownik ponosi za usługi świadczone przez tego sprzedawcę, jest dokładną ceną określoną za pomocą atrybutu Service.price. Zakładamy, że cena usługi jest zwolniona z obowiązujących podatków lub będzie już obejmować obowiązujące podatki. Podatki nie będą wyświetlane użytkownikowi jako osobna pozycja.

Jeśli to pole ma wartość inną niż zero, łączna cena, jaką użytkownik ponosi za dowolną usługę świadczoną przez tego sprzedawcę, będzie zawierać cenę usługi powiększoną o podatek obliczony na podstawie podanej tu stawki podatku. Ułamki z najmniejszej jednostki waluty (np. ułamek jednego centa) są zaokrąglane przy użyciu zaokrągleń równomiernych. Podatki będą widoczne dla użytkownika jako osobna pozycja.

To pole zostało wycofane. Zamiast niego użyj atrybutu tax_rate.

TaxRate

Stawka podatku ustalona przez sprzedawcę. Jeśli to pole jest dostępne, zastępuje wycofane pole tax_rate_basis_points. Pusty komunikat (np. tax_rate { }) zresetuje zastosowaną stawkę podatku do zera.

PaymentRestrictions

Ograniczenia dotyczące form płatności akceptowanych przez tego sprzedawcę. Jeśli to pole nie jest skonfigurowane, zakładamy, że nie ma żadnych ograniczeń.

PaymentOption

Opcje płatności dostępne w przypadku tego sprzedawcy. Usługi tego sprzedawcy będą mogły pojedynczo ograniczać opcje płatności dostępne dla niego.

PaymentProcessorConfig

Konfiguracja dla tokenizowanej firmy obsługującej płatności, jeśli sprzedawca ją obsługuje.

TokenizationConfig

Konfiguracja dla tokenizowanej firmy obsługującej płatności, jeśli sprzedawca ją obsługuje.

Terms

Warunki korzystania z usługi konkretnego sprzedawcy wyświetlane użytkownikowi, gdy usługa Zarezerwuj z Google została zarezerwowana przez Zarezerwuj z Google. Dodatkowo Warunki korzystania z usługi partnera pośredniczącego są zawsze wyświetlane użytkownikowi i nie można ich tu podawać.

string

Nieprzezroczysty ciąg znaków określający markę widoczną dla klientów, która ma być używana do wyświetlania atrybucji partnera. Dzięki tym polu partnerzy z wieloma markami przeznaczonymi dla konsumentów mogą udostępniać informacje o sprzedawcach dla wszystkich marek w tym samym pliku danych.

Marka składa się z właściwości przeznaczonych dla użytkowników, takich jak nazwa, logo, Warunki korzystania z usługi i Polityka prywatności.

Jeśli istnieje tylko 1 marka partnera widoczna dla konsumentów, nie trzeba ustawiać tego pola i można je zignorować.

Jeśli partner...

Nie ma wielu marek przeznaczonych dla konsumentów? --> Zignoruj to pole

Masz skonfigurowanych kilka 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

Uwaga: większość partnerów nie musi ustawiać tego pola. Jeśli partner chce użyć tego pola, musi najpierw się z nami skontaktować, 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ż na podstawie podanych wyżej informacji Google dopasuje sprzedawców do miejsc w Mapach Google. (opcjonalnie)

ServiceAttribute

Definicje wszystkich atrybutów usługi służących do opisania Usług danego Sprzedawcy. (opcjonalnie)

ActionLink

Opcjonalnie: adres URL działania wraz z powiązanym językiem, listą krajów ograniczonych do, typem i opcjonalną platformą wskazującą, na której platformie należy wykonać działanie;

Advisement

Opcjonalnie: Ogólne porady od konkretnego sprzedawcy dla użytkownika dołączającego do listy oczekujących w Zarezerwuj z Google. Długość poszczególnych pól tekstowych w poleceniu nie może przekraczać 100 bajtów.

string

Identyfikator miejsca w bazie danych Miejsc Google i na Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz na stronie https://developers.google.com/places/web-service/place-id.

string

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

string

Nazwa sprzedawcy podana przez partnerów.

GeoCoordinates

Partnerzy udostępnili dane geograficzne sprzedawcy.

ProcessingStatus

Stan przetwarzania przez sprzedawcę.

BookingStatus

Stan związany z kompleksową integracją rezerwacji.

WaitlistStatus

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

PlaceInfo

Dopasowane dane geograficzne dotyczące miejsca tego sprzedawcy. Pole puste, jeśli sprzedawca nie ma dopasowania geograficznego.

LocalServicesMatchInfo

Dopasowanie reklam w Usługach Lokalnych tego sprzedawcy. Pole puste, jeśli nie jest to lokalny sprzedawca usług lub nie pasuje do żadnego dostawcy.

DirectUrl

Lista adresów URL prezentujących zawartość obecnego asortymentu sprzedawcy. Pamiętaj, że nie oznacza to, że zasoby reklamowe są rzeczywiście wyświetlane, a adres URL może różnić się od tych widocznych publicznie.

bool

Prawda, jeśli sprzedawca ma asortyment w ciągu najbliższych 30 dni. Nie gwarantuje, że sprzedawca zostanie rzeczywiście obsłużony.

UrlType

Typ tego adresu URL.

string

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

MatchedProvider

Dopasowani dostawcy usług. Sprzedawcę można dopasować do kilku dostawców usług.

int64

Zewnętrzny identyfikator klienta w Usługach Lokalnych Google.

string

Kategorie usług lokalnych (branże). Na przykład: „hydraulik” i „Czyszczenie_dywanów”.

string

Nazwa miejsca.

string

Sformatowany adres w języku lokalnym.

string

Identyfikator tego miejsca w Miejscach Google. Umożliwia utworzenie adresu URL w Mapach Google lub pobranie dodatkowych informacji o danym miejscu. Przykład użycia znajdziesz na https://developers.google.com/places/web-service/place-id.

bool

Prawda, jeśli sprzedawca oferuje obsługę listy oczekujących. Nie gwarantuje, że sprzedawca zostanie rzeczywiście obsłużony.

Money

Minimalna kwota.

Money

Maksymalna kwota.

Price

Kwota, jaką użytkownik może zostać obciążony, jeśli nie pojawi się on w rezerwacji.

PriceType

Określa, jak 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 tego zamówienia.

FulfillmentOption

Dostępne opcje realizacji zamówienia dla linku do działania online.

PrepaymentStatus

Stan przedpłaty rezerwacji. Jeśli atrybut prepayment_status ma wartość PREPAYMENT_PROVIDED lub PREPAYMENT_REFUNDED, to payment_transaction_id zawiera powiązany unikalny identyfikator transakcji.

string

Unikalny identyfikator transakcji płatności powiązanej z rezerwacją. Pole puste, jeśli nie dotyczy.

string

Ten identyfikator służy do identyfikacji 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 płatność za pomocą odpowiedniej opcji płatności u tych sprzedawców.

Zaktualizowanie wartości opcji płatności u jednego sprzedawcy powoduje też zaktualizowanie każdej opcji płatności z tym samym identyfikatorem u innego sprzedawcy. Dlatego najlepiej jest, aby wszystkie opcje płatności miały ten sam identyfikator i miały zawsze identyczne wartości. Pozwala to uniknąć ryzyka zaniżania ryzyka.

string

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

string

Opis opcji płatności. Może być widoczny 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 widniejące na stronie sprzedawcy lub w usłudze. Pusty komunikat (np. tax_rate { }) zresetuje zastosowaną stawkę podatku do zera.

PaymentOptionType

Typ danej opcji płatności. Jednorazowy sposób na zakupy w ramach subskrypcji, wielokrotny w przypadku pakietów i nieograniczony w przypadku wspierania kanału.

int64

Liczba sesji, w których można wykorzystać tę opcję płatności. Obowiązuje tylko w przypadku wielu sesji / pakietów, gdzie wartość powinna wynosić > 1.

TimeRange

W tym okresie możesz kupić tę opcję płatności.

TimeRange

W tym przedziale czasu możesz używać opcji płatności (np.specjalna cena za styczeń 2017 r.). Jeśli ta opcja jest dostępna, zastępuje wartość pola valid_duration i activate_type.

Duration

Okres ważności opcji płatności (np. 30-dniowa subskrypcja).

ActivationType

Określa sposób określania daty rozpoczęcia ważności przez tę opcję płatności.

UserPurchaseRestriction

Ogranicza dostęp do użytkowników, którzy mogą kupić tę opcję płatności. Pozwala ograniczyć możliwość korzystania z opcji płatności w promocji tylko do wybranej grupy użytkowników. Jeśli jej nie skonfigurujesz, wszyscy użytkownicy będą mogli korzystać z tej funkcji.

Processor

Określa partnera obsługującego płatności, którego dotyczy ta konfiguracja.

string

Klucz, który posłużył do identyfikacji tego sprzedawcy w firmie obsługującej płatności.

Informacje o Stripe: https://stripe.com/docs/dashboard#api-keys (w przypadku Braintree): 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 żądaniami płatności.

CreditCardRestrictions

Ograniczenia dotyczące kart kredytowych akceptowanych przez tego sprzedawcę. Jeśli to pole nie jest podane, uznajemy, że akceptowane są wszystkie karty kredytowe. Pamiętaj, że lista kart obsługiwanych przez CreditCardType będzie się z czasem powiększać, co oznacza, że pozostawienie tych pustych pól będzie wymagało wprowadzenia w przyszłości zmian w konfiguracji.

Price

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

Price

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

Price

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

Price

Opłata za wstęp na teren wydarzenia.

Price

Podatki za bilet.

string

Kraj określony za pomocą kodu kraju ISO 3166-1 alfa-2, np. US (wymagane)

string

Rejon, 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 i numer, np. „1600 Amphitheatre Pkwy”. (wymagane)

int64

Cena w mikrojednostkach waluty. Ułamki najmniejszej jednostki waluty będą zaokrąglane przy użyciu najbliższej równomiernej wartości. (np. 2,5 centa – 2,5 centa – 3,5 centa – 4 centów, 0,5 centa – 0 centów, 2,51 centa – 3 centy).

string

Waluta ceny zdefiniowana w normie ISO 4217.

string

Opcjonalny, nieprzejrzysty ciąg znaków określający opcję ceny powiązaną z ceną rozszerzoną.

double

Wartość pojedyncza. Przykład: 5.6

RangeValue

Zakres wartości, które mogą być jednocześnie otwarte lub ograniczone. Przykłady: * Co najmniej 5,5 * Maksymalnie 5,5 * 5,5 do 6,5

double

Wartość minimalna.

double

Wartość maksymalna.

double

Średnia wartość oceny (wymagana, gdy liczba_ocen> > 0). Wartość musi mieścić się w zakresie [1–5] i można ją pominąć tylko wtedy, gdy parametr number_of_ratings ma wartość 0.

uint64

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

string

Adres URL tego źródła multimediów. Google zindeksuje multimedia przechowywane pod tym adresem URL.

MediaType

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

Text

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

Attribution

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

string

Wycofany. Wolę używać localized_caption.

Text

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

string

Wycofany. Wolę używać elementu localized_text.

ServiceAvailability

Dostępność usług, która zastępuje istniejące.

string

Opcjonalny identyfikator pracownika świadczącego usługę. To pole określa pracownika we wszystkich rekordach sprzedaży, usługach i dostępności. Musi też być stabilny z upływem czasu, aby umożliwić korelację z wcześniejszymi rezerwacjami. To pole musi być obecne, jeśli istnieje people_name.

string

Opcjonalna nazwa pracownika świadczącego usługę. To pole będzie wyświetlane użytkownikom dokonującym rezerwacji i powinno być czytelne dla człowieka, a nie nieprzezroczyste. To pole musi być obecne, jeśli podany jest identyfikator people_id.

string

Opcjonalny identyfikator pokoju, w którym działa usługa. To pole identyfikuje salę we wszystkich sprzedawcach, usługach i rekordach dostępności. Musi też być stabilny z upływem czasu, aby umożliwić korelację z wcześniejszymi rezerwacjami. To pole musi być obecne, jeśli istnieje sala_name.

string

Opcjonalna nazwa pokoju, w którym działa obsługa. To pole będzie wyświetlane użytkownikom dokonującym rezerwacji i powinno być czytelne dla człowieka, a nie nieprzezroczyste. (opcjonalnie, ale wymagane, jeśli podano identyfikator_pokoju). Nazwa sali powinna służyć tylko do określania miejsca wypoczynkowego, takiego jak bar lub patio. Nie powinna być używana w przypadku menu ze stałą ceną, ofert specjalnych ani innych wartości niezwiązanych z pokojem (np. rezerwacji czy kolacji). Zdecydowanie zalecamy, aby domyślny kącik wypoczynkowy nie był powiązany z pomieszczeniem.

int32

Dotyczy tylko restauracji: liczba miejsc, w których można wziąć udział w tym czasie. Restauracja może być powiązana z wieloma salami jednocześnie i określać inny rozmiar grupy (jeśli na przykład w rezerwacji mogą być miejsca dla 2, 3 lub 4 osób).

int64

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

CancellationPolicy

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

int64

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

int64

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

string

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

string

Nazwa usługi, np. „Fryzjer męski”. Wycofano. Zamiast niego użyj atrybutu localized_service_name.

Text

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

string

Opis usługi widoczny dla użytkowników. Wycofany. Użyj atrybutu localized_description.

Text

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

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

Obsługiwane tagi formatowania podobne do HTML:

Tagi nagłówka: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Do wyświetlania tytułów i podtytułów można używać tagów nagłówka. Na przykład <h1>Plan podróży</h1> spowoduje wyświetlenie wbudowanego tekstu jako najważniejszego nagłówka sekcji. Pamiętaj, że wszystkie wewnętrzne tagi HTML, style i atrybuty zostaną zignorowane. Na przykład <h1 style=".."> będzie traktowany tak samo jak <h1>. Zostanie zachowany tylko czysty tekst.

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

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

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

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

Nieobsługiwane tagi:

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

Ważne informacje:

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

Price

Cena usługi.

PriceInterpretation

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

SchedulingRules

Zasady rezerwacji lub anulowania spotkań.

PrepaymentType

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

PrepaymentTerms

Warunki dotyczące terminu realizacji przedpłaty.

ServiceIntakeForm

Rola wycofana. Użyj atrybutów intake_form i per_ticket_intake_form.

ServiceIntakeForm

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

ServiceIntakeForm

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

TaxRate

Stawka podatku usługi. Jeśli to pole jest obecne, zastępuje wszystkie stawki tax_rate ustawione na poziomie sprzedawcy. Pusty komunikat (np. tax_rate { }) zresetuje zastosowaną stawkę podatku do zera.

string

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

Deposit

Określa sposób pobierania kaucji od użytkownika. Zastępuje wpłatę za usługę, jeśli została określona. Ustawienie w tym miejscu komunikatu o depozycie spowoduje usunięcie wszelkich wpłat na poziomie usługi. (opcjonalnie)

NoShowFee

Określa opłatę za niestawienie się, która może zostać pobrana od użytkownika. Zastępuje opłatę za niestawienie się, jeśli została określona. Ustawienie tej opcji na pustą wiadomość NoShowFee spowoduje usunięcie wszelkich opłat za niestawienie się na poziomie usługi. (opcjonalnie)

RequireCreditCard

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 związanego z tą usługą. Jeśli istnieje link do działania, w usłudze należy ustawić typ (patrz poniżej).

ServiceType

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

TicketType

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

RelatedMedia

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

ServiceAttributeValueId

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

WaitlistRules

Zasady dołączania do listy oczekujących.

TicketingVerticalSpecificData

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

IntegrationType

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

PerOrderFee

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

ToursAndActivitiesContent

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

Location

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

Rating

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

HomeServiceData

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

VirtualSession

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

ChargeTiming

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

int64

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

string

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

string

Widoczna dla użytkownika nazwa tego atrybutu, np. „Typ konta”.

Value

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

string

Identyfikator, który jednoznacznie identyfikuje tę wartość między innymi dla danego atrybutu usługi, np. „osobiste”.

string

Widoczna dla użytkownika nazwa wartości, np. „Osobisty”.

string

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

string

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

string

Nazwa zasobu usługi, do której ma zostać zastosowany ten wskaźnik. W formacie partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

Jeśli podasz encje dostępności, uznamy je za pełne zrzuty z okresu [start_time_restrict, end_time_restrict). Oznacza to, że cała istniejąca dostępność zostanie usunięta, jeśli zostanie spełniony ten warunek:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Jeśli ustawiony jest komunikat o czasie trwania, warunek jest jeszcze bardziej ograniczony:

  availability.duration == duration_restrict

Jeśli ustawiono komunikat resource_restrict, warunek jest jeszcze bardziej ograniczony:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Te pola są zwykle używane do zapewnienia pełnej aktualizacji dostępności w danym przedziale czasu.

Ustawienie start_time_restrict z pozostawieniem nieskonfigurowania end_time_restrict jest interpretowane tak, że cały czas zaczyna się od start_time_restrict.

Timestamp

Ustawienie end_time_restrict z pozostawieniem nieskonfigurowanej wartości start_time_restrict jest interpretowane tak, że oznacza to, że cały okres nie może przekraczać end_time_restrict.

Duration

Ustawienie czasu trwania jeszcze bardziej ogranicza zakres aktualizacji tylko do dostępności z pasującym czasem trwania.

Resources

Ustawienie resource_restrict jeszcze bardziej ogranicza zakres aktualizacji tylko do tego zbioru zasobów. Wszystkie pola identyfikatorów zasobów muszą być dokładnie takie same.

Availability

Nowa lista dostępności.

ServiceIntakeFormField

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

bool

Jeśli ma wartość prawda, ten formularz wyświetli się nowym klientom. Rola wycofana. Ta funkcja nie jest obsługiwana w przypadku formularzy przyjmowania zgłoszeń.

bool

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

string

Ciąg znaków od partnera agregatora, który jednoznacznie identyfikuje pole formularza. Powinien być taki sam jak identyfikator w odpowiedniej odpowiedzi w polu formularza i musi być niepowtarzalny zarówno na poziomie usługi, jak i w formularzach przyjmowania zgłoszeń. (wymagane)

FieldType

Typ tego pola.

string

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

Text

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

string

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

Text

Ustaw tylko wtedy, gdy typ pola to MULTIPLE_CHOICE, CHECKBOXES lub DROPDOWN. Służy do wyliczania możliwych opcji.

bool

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

bool

Wskazuje, czy w uzupełnieniu wstępnie zdefiniowanych odpowiedzi dozwolona jest wartość niestandardowa. Ma to zastosowanie tylko wtedy, gdy typ pola to LOCATION_SEARCH. (opcjonalnie)

Text

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

string

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

Text

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

int32

Stawka podatku w milionowych częściach jednego procenta, co daje dokładność z 6 miejscami po przecinku. Jeśli np.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, jaką użytkownik ponosi za usługi świadczone przez tego sprzedawcę, jest dokładną ceną określoną za pomocą atrybutu Service.price. Zakładamy, że cena usługi jest zwolniona z obowiązujących podatków lub będzie już obejmować obowiązujące podatki. Podatki nie będą wyświetlane użytkownikowi jako osobna pozycja.

Jeśli to pole ma wartość inną niż zero, łączna cena, jaką użytkownik ponosi za dowolną usługę świadczoną przez tego sprzedawcę, będzie zawierać cenę usługi powiększoną o podatek obliczony na podstawie podanej tu stawki podatku. Ułamki z najmniejszej jednostki waluty (np. ułamek jednego centa) są zaokrąglane przy użyciu zaokrągleń równomiernych. Podatki będą widoczne dla użytkownika jako osobna pozycja.

string

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

string

Tekst, który ma zostać wyświetlony użytkownikowi. W przypadku nowych integracji użyj elementu localized_text poniżej.

Text

Zlokalizowany tekst, który będzie wyświetlany użytkownikowi.

string

Wartość tekstowa w nieznanym regionie. Wymagany tylko wtedy, gdy pole localized_value jest puste. Lokalizacja tej wartości może zależeć od partnera lub dostawcy usług – nie należy zakładać, że jest to konkretny język.

LocalizedString

Wartości tekstowe dla różnych języków. Opcjonalnie:

string

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

string

Krótki opis tego obiektu TicketType.

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

Text

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

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

Price

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

PerTicketFee

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

string

Opis dodatkowej opcji reprezentowanej przez ten typ biletu (jeśli dotyczy). Wycofano. Użyj atrybutu localized_option_description.

Text

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

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

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

Przykład 2: wielogodzinne wypożyczenie kajaka z opcjonalnym dodatkiem suchej torby; w polu Shorts_description można podać wartość "3 hours". a opcja „option_description” może mieć wartość „z suchą torbą” lub "bez suchego worka": - {ticket_type_id: "ticket_type_1" localized_short_description { value: "2 godziny" } localized_option_description { value: "english" } } – {ticket_type_id: "ticket_type_2" localized_short_description { value: "2 godziny" } localized_option_description { value: "spanish" } } – {ticket_type_id: "ticket_type_3" localized_short_description { value: "3 godziny" } localized_option_description { value: "english" } } – {ticket_type_id: "ticket_type_4" localized_short_description { value: "3 godziny" } localized_option_description { value: "spanish" }

Opcjonalne, ale jeśli dowolny typ biletu w usłudze ma ustawione to pole, oczekujemy, że w przypadku wszystkich innych typów biletów również to pole będzie ustawione (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 dwa tagi formatowania HTML: i
. Służą do określenia opcji z tytułem i szczegółowym opisem, np. „Miejsca premium
W tej opcji dostępne są miejsca do siedzenia przy prywatnych skrzyniach, w tym w pełni wyłożone fotelami, prywatne telewizory oraz obsługa posiłków i napojów. Z tych miejsc rozciąga się malowniczy widok na pole golfowe”.

EventCategory

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

string

Adres URL zdarzenia na stronie partnera. (opcjonalnie)

Entity

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

AttendanceMode

Wymagane. Typ obecności na wydarzeniu.

string

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

Text

Opcjonalnie: Organizatorem wydarzenia.

string

Opcjonalnie: Adres URL organizatora wydarzenia.

OrganizerType

Opcjonalnie: Typ organizatora.

string

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

EventState

Opcjonalnie: Stan wydarzenia.

string

Unikalny identyfikator elementu w bazie danych partnera. (opcjonalnie)

string

Nazwa elementu. (wymagane)

string

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

EntityType

Typ elementu. (opcjonalnie)

EntityRole

Rola elementu w zdarzeniu. (opcjonalnie)

PublicIdentificationData

Publiczne odniesienia do podmiotu. (opcjonalnie)

string

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

string

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

Timestamp

Dolna granica zakresu czasu.

Timestamp

Górna granica zakresu czasu.

map<string, string>

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

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

Przykład Braintree: parametrization_parameter { key: "gateway" value: „braintree” } tokenization_parameter { key: &quot;braintree:apiVersion&quot; value: „v1” } tokenization_parameter { key: &quot;braintree:sdkVersion&quot; value: „2.30.0” } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: &quot;braintree:clientKey&quot; value: „production_xxx_yyy”

Przykład Stripe: parametr tokenization_parameter { key: "gateway" value: "paski" } tokenization_parameter { key: &quot;stripe:version&quot; value: „28-02-2018” } tokenization_parameter { key: &quot;stripe:publishableKey&quot; value: „pk_1234”

Przykład w Adyen: tokenization_parameter { key: "gateway" wartość: „adyen” } tokenization_parameter { key: "gatewayMerchantId" value: "TwójId"

BillingInformationFormat

Podaj w tokenie płatności informacje rozliczeniowe użytkownika podane w Google Pay przy użyciu formy płatności (patrz wyżej). Pozostawienie pustego pola jest równoważne z określeniem MIN.