Package google.maps.booking.v1alpha

string

Adres URL punktu wejścia dla tego linku 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 widzieć je 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ępcza będzie używana ACTION_PLATFORM_WEB_APPLICATION.

ActionLinkType

Określony z góry typ działania.

OrderOnlineMetadata

Metadane linku do zamówienia online. Obsługuje działania z 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ść, która ma się wyświetlać użytkownikowi podczas dokonywania rezerwacji przez funkcję Zarezerwuj z Google.

Timestamp

Godzina rozpoczęcia przedziału czasu dla spotkań.

Duration

Czas trwania przedziału czasu dla spotkań

int64

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

• Zajęcia z jogi w 10 miejscach, w tym 3 zarezerwowane: availability {spots_total: 10, spots_open: 7 ...}
• Sesja masażu na krześle, która jest już 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 zakłada spots_total=1 i spots_open=1.
• Wyjątek harmonogramu oznacza klasyfikację spots_total=1 i spots_open=0.

int64

Liczba wolnych miejsc.

string

Opcjonalny nieprzejrzysty ciąg znaków identyfikujący ten przedział dostępności. Jeśli zasada jest skonfigurowana, jest uwzględniana w prośbach o rezerwowanie, aktualizowanie i anulowanie spotkań.

Resources

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

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 odnoszących się do opcji płatności, za pomocą których można zapłacić za ten przedział. Rzeczywiste opcje płatności są określone na poziomie sprzedawcy i mogą być też współdzielone przez wielu sprzedawców.

To pole zastępuje wszystkie wartości payment_option_id określone w komunikacie dotyczącym usługi. Podobnie określone tutaj wartości parametru payment_option_id NIE muszą być zawarte w komunikacie dotyczącym usługi, chociaż muszą być zdefiniowane na poziomie sprzedawcy.

Recurrence

Informacje o powtarzaniu dotyczące dostępności reprezentujące więcej niż jeden czas rozpoczęcia. Cyklicznie powinny obejmować spotkania na jeden dzień roboczy.

ScheduleException

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

Deposit

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

NoShowFee

Opcjonalnie – brak opłaty za wstęp 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 tam ustawiona. (opcjonalnie)

string

Wskazuje listę obsługiwanych typów zgłoszeń dla tego przedziału dostępności. Jeśli nie są ustawione, dla tego przedziału dostępne są 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 rodzajami biletów: TicketType {ticketType_id: "adult_1" short_description: "adult_type"} TicketType {ticket_type_id: "adult_2" short_description: "adult_2" short_description: "adult weekends"}, TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "Youth_2" weekends"}

Aby reprezentować zasoby reklamowe w dni robocze: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Aby zaprezentować 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 przypadku 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 `availability {...}' (nie ustawiaj w tym przedziale czasu identyfikatora Ticket_type_id).

(opcjonalnie)

DurationRequirement

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

SchedulingRuleOverrides

Reguły harmonogramu dostępności. Wypełnione pola zastąpią wszystkie odpowiadające im reguły planowania 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 dla dostępności z trybem potwierdzenia CONFIRMATION_MODE_SYNCHRONOUS muszą zostać natychmiast potwierdzone lub odrzucone. Próby utworzenia rezerwacji dla dostępności w trybie potwierdzenia CONFIRMATION_MODE_ASYNCHRONOUS muszą zostać natychmiast odrzucone lub utworzone ze stanem PENDING.

Timestamp

Obejmuje maksymalną sygnaturę czasową UTC, do której dostępność powtarza się.

Duration

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

Przykład: dostępność o czasie trwania 20 minut, powtarzanie_co 30 minut, godzina rozpoczęcia 9:00 i powtarzanie_do 11:00 spowoduje utworzenie przedziału czasu 9:30–9:20, 9:30–9:50, 10:30–10:20, 10:30–10:50 (pole wymagane)

TimeRange

Zakres czasowy wyjątku. Wszystkie przedziały opisane w powtarzającym się przedziale czasu, które nakładają się na ten zakres czasu zamknięcia, będą uznane za niedostępne.

Przykład: jeśli powtarzanie określa czas trwania wynoszący 20 minut, powtarzanie_co 30 minut, powtarzanie_razy o 9:00 oraz powtarzanie_do 11:00, wyjątek harmonogramu o zakresie czasu 9:45am–11:00 w godzinach 9:30–9:50 w godzinach 9:30–9:50

Pamiętaj, że ponieważ przedział czasu jest zamknięty, nie wpłynie to na przedział rozpoczynający się o 11:00 rano.

int64

Ostatni czas (w sekundach), w którym można zarezerwować ten przedział. Ta sygnatura czasowa musi przypadać przed datą rozpoczęcia_sekundy przedziału, która ma być respektowana (jeśli użytkownicy powinni mieć możliwość rezerwowania usług po tym czasie, użyj reguły planowania na poziomie usługi.min_booking_before_end_time). Jeśli ten adres występuje, zastąpi wszystko, co jest określone w polu min_booking_buffer w regułach planowania odpowiedniej usługi.

int64

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

int64

Jeśli ustawiono, ostatni czas (w sekundach od początku ery uniksowej), przez jaki ten konkretny przedział czasu dla spotkania można anulować za pomocą 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 użyć maksymalnie 1000 rekordów.

string

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

GenericRecord

Rekordy do wstawienia i/lub zaktualizowania. W jednym wywołaniu interfejsu API można użyć maksymalnie 1000 rekordów.

string

Format: partners/{partner_id}.

ExtendedServiceAvailability

Rozszerzona dostępność usługi, która zastępuje istniejące przedziały dostępności.

ExtendedServiceAvailability

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

string

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

string

Identyfikator sprzedawcy przedziału

string

Identyfikator usługi sprzedawcy

Timestamp

Godzina rozpoczęcia przedziału czasu dla spotkań

Duration

Czas trwania przedziału czasu dla spotkań

ClientInformation

Dane osobowe klienta organizującego spotkanie

BookingStatus

Stan rezerwacji

PaymentInformation

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

int64

Liczba osób dokonujących rezerwacji

Cause

Przyczyna niepowodzenia rezerwacji. (pole wymagane)

CreditCardType

(wymagane tylko wtedy, gdy przyczyna to PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

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

PaymentFailureInformation

Informacje o nieudanych płatności.

ThreeDS1Parameters

Parametry używane przez agregator RwG do inicjowania protokołu uwierzytelniania 3DS1 u użytkownika. Jest ignorowana, chyba że BookingFailure.cause ma wartość PAYMENT_REQUIRES_3DS1.

string

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

string

Żądanie uwierzytelniania PaymentAuth. Do opublikowania w formularzu ACSUrl, jeśli jest podany.

string

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

string

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

RefundCondition

Nie więcej niż 0 warunków zwrotu środków w związku z zasadami.

Duration

Czas przed czasem rozpoczęcia, do którego klient może otrzymać zwrot środków za część kosztów usługi określoną w polu refund_percent. Jeśli ustawisz wartość 0 (domyślnie), usługę można anulować w każdej chwili.

uint32

Wartość procentowa, którą możemy zwrócić, pod warunkiem, że 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]. Gdy zasada ma wartość 0 (domyślnie), usługa nie podlega zwrotowi. Jeśli ustawisz wartość 100, za tę usługę przysługuje pełny zwrot środków.

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 chcesz użyć w przypadku tego sprzedawcy.

Merchant

Sprzedawca, który ma utworzyć.

string

Nadrzędna nazwa zasobu sprzedawcy, do którego należy ta usługa, w formacie partners/{partner_id}/merchants/{merchant_id}.

string

Identyfikator usługi, której chcesz używać w przypadku tej usługi.

Service

Usługa do utworzenia.

CreditCardType

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

string

Nazwa zasobu sprzedawcy do usunięcia. W formacie partner/{identyfikator_partnera}/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

Minimalna zaliczka na poczet kaucji.

PriceType

Określa sposób określania kaucji na podstawie dostępności.

Text

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

Duration

Minimalny czas trwania.

Duration

Maksymalny czas trwania.

string

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

string

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

Timestamp

Jeśli je podasz, uznamy je za kompletny zrzut z [start_time_restrict, end_time_restrict). Oznacza to, że jeśli zostanie spełniony ten warunek, wszystkie dotychczasowe informacje o dostępności zostaną usunięte:

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

Jeśli zostanie ustawiony komunikat o czasie trwania, warunek będzie dodatkowo ograniczony:

  availability.duration == duration_restrict

Jeśli zostanie ustawiony komunikat resource_restrict, warunek będzie dodatkowo ograniczony:

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

Te pola zwykle służą do przedstawienia pełnej aktualizacji dostępności w danym okresie.

Ustawienie start_time_restrict, a jednocześnie pozostawienie nieskonfigurowanej wartości end_time_restrict jest interpretowane jako oznaczało cały czas rozpoczynający się od start_time_restrict.

Timestamp

Ustawienie parametru end_time_restrict i nieskonfigurowanie ustawienia start_time_restrict jest interpretowane jako oznaczało cały czas, aż do parametru end_time_restrict.

Duration

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

Resources

Ustawienie pola resource_restrict dodatkowo 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 produkty z tego pliku danych. Produktami mogą być sprzedawcy, usługi lub przedziały dostępności, w zależności od typu pliku danych.

int64

Dotychczasowe produkty, w razie potrzeby aktualizowane na podstawie nowszych informacji z pliku danych.

int64

Elementy, których już nie ma w tym pliku danych, i które zostały w wyniku tego usunięte.

string

Nazwa zasobu kanału, 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

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

FeedStatistics

Statystyki dotyczące tego kanału.

FeeDetails

Szczegóły opłat, którymi obciąża się użytkownik jako część sumy produktu. Powtarzane w przypadku różnych rodzajów opłat, takich jak opłata za obsługę, opłata za dostawę itp.

AdvanceOrderDetails

Szczegóły dotyczące zaawansowanej obsługi zamówień, nazywane też składaniem zamówień z wyprzedzeniem, w ramach których użytkownik może złożyć zamówienie w późniejszym terminie.

Duration

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

DurationRange

Zakres czasu trwania. Przykłady: * 30 minut do 45 minut * Powyżej 30 minut * Mniej niż 50 minut

bool

Wartość to „prawda”, jeśli obsługiwane są zamówienia z wyprzedzeniem (nazywane też zamówieniem z wyprzedzeniem). (pole wymagane)

FeeType

Typ opłaty. (pole wymagane)

FeeAmount

Kwota opłaty w walucie jednostki, jako procent wartości koszyka lub kombinacja obu tych wartości. (pole wymagane)

QuantitativeValue

Opłata wyrażony 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ły 5,5% * Co najmniej 5,5% * Maksymalnie 5,5% * 4,5% do 5,5%

Money

Ustalona kwota. np.3,5 PLN.

MoneyRange

Zakres kwoty. Przykłady: * od 3,5 do 5,5 PLN * Co najmniej 3,5 PLN * Maksymalnie 5,5 PLN

bool

Nieznana kwota.

FulfillmentType

To pole jest wymagane. Typ realizacji.

AvailableDay

To pole jest wymagane. Lista dni, w które dostępna jest ta metoda realizacji zamówień (najlepiej co najmniej 2).

FeeDetails

To pole jest wymagane. Szczegóły opłaty za metodę realizacji zamówienia.

Price

To pole jest wymagane. Minimalna wartość zamówienia na metodę realizacji powiązaną z linkiem do działania.

Date

To pole jest wymagane. Data dostępności metody realizacji zamówienia. Prawdopodobnie znajduje się w strefie czasowej sprzedawcy.

Timestamp

To pole jest wymagane. Sygnatura czasowa uniksowej. Ostatni raz, kiedy użytkownik mógł zamówić i otrzymać produkty do fulfillment_date. Oznacza to, że po last_ordering_time parametr fulfillment_date nie będzie już wyświetlany jako dostępny.

Jeśli na przykład data fulfillment_date to 2020-08-10: a wartość last_ordering_time 2020-08-10 18:00 oznacza, że aby otrzymać zamówienie 10.08.2020, klient musi złożyć zamówienie 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 złożyć zamówienie do 20:00 2 dni wcześniej.

NoFee

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

MinimumFee

Opłata podstawowa powiązana z metodą realizacji zamówienia.

FixedFee

Opłata stała związana z metodą realizacji zamówień.

Price

To pole jest wymagane. Kwota stałej opłaty za metodę realizacji zamówienia.

Price

To pole jest wymagane. Podstawowa kwota opłaty za metodę realizacji zamówienia.

Timestamp

To pole jest wymagane. Wskazuje ona kolejność, w jakiej usunięcie zostanie zastosowane do zasobów reklamowych.

bytes

Pliki danych nieoparte na proto.

Any

Dotyczy plików danych opartych na proto.

Timestamp

To pole jest wymagane. Ta sygnatura czasowa ma zapewnić prawidłową kolejność aktualizacji asortymentu.

bytes

Pliki danych nieoparte na proto.

Any

Dotyczy 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: „Rynek Główny 12, 31-042 Kraków”

string

To pole jest wymagane. Nazwa zasobu w formacie partners/{identyfikator_partnera}/merchants/{merchant_id}/status.

string

Nazwa zasobu kanału, w formacie

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

string

Ogólna kategoria, do której należy ta usługa dla domu. np. hydraulik, elektryk

string

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

string

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

Na przykład nazwa zasobu odbioru powinna mieć format 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 spotkań w sekundach.

OrderedTickets

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

Price

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

BookingStatus

Stan elementu zamówienia.

string

Identyfikator rodzaju biletu.

int32

Liczba biletów tego typu zamówionych.

string

To pole jest wymagane. Podmiot nadrzędny, do którego należy kolekcja statusów sprzedawcy. Format: partners/{partner_id}/merchants

int32

To pole jest wymagane. Maksymalna liczba produktów do zwrócenia. 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 zasobów reklamowych rezerwacji.

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 sprzedawcy, które spełniają warunki filtra.

string

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

string

Nazwa zasobu kanału, w formacie

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

int32

Maksymalna liczba produktów do zwrócenia.

string

Wartość next_page_token zwrócona w odpowiedzi na poprzednie żądanie listy (jeśli występuje).

State

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

TimeRange

Opcjonalnie możesz ograniczyć filtrowanie wyników według górnej i dolnej granicy. Jeśli zasada start_time nie jest skonfigurowana, przyjmuje domyślnie wartość od początku systemu unix. Jeśli zasada end_time nie jest skonfigurowana, przyjmuje wartość domyślną teraz.

FeedStatus

Odwrócona chronologiczna lista stanów przesyłanych plików danych. Maksymalna liczba zwracanych 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 więcej wyników.

string

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

string

Komunikat w wymienionym powyżej języku (UTF-8).

string

Identyfikator miejsca dla 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 te informacje, Google dopasuje lokalizację do tego miejsca.

string

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

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

string

Publiczny numer telefonu lokalizacji wraz z numerem kraju i numeru kierunkowego, 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

Typ lokalizacji, należy podać, jeśli lokalizacja jest udostępniana w ramach Usługi.

string

Unikalne odwołanie do lokalizacji w usłudze. Można go używać, aby odwoływać się do tej lokalizacji w innych polach usługi. Na przykład w niestandardowym formularzu odbioru można użyć zestawu identyfikatorów lokalizacji, aby określić opcje miejsca odbioru. Jeśli jest ustawiony, ten identyfikator powinien być unikalny w obrębie tej samej usługi. (opcjonalnie)

string

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

string

Parametr merchant_name, numer telefonu, adres URL i lokalizacja geograficzna pomagają dopasować asortyment partnera do sprzedawców, którzy już znajdują się w Mapach Google. Te informacje nie będą wyświetlane.

Nazwa sprzedawcy.

string

Publiczny numer telefonu sprzedawcy wraz z jego krajem i numerem kierunkowym, np. +14567891234.

string

Adres URL publicznej witryny sprzedawcy.

GeoCoordinates

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

string

Kategoria firmy na platformie agregatora.

int64

To pole zostało wycofane.

uint32

Stawka podatku sprzedawcy wyrażona w punktach bazowych (jedna 100%). Jeśli na przykład 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 płaci za dowolną usługę świadczoną przez tego sprzedawcę, jest dokładną ceną określoną w atrybucie Service.price. Przyjmujemy, że cena usługi jest zwolniona z obowiązujących podatków lub już zawiera odpowiednie podatki. Podatki nie będą wyświetlane użytkownikowi jako osobna pozycja.

Jeśli to pole ma wartość inną niż zero, łączna cena naliczana od użytkownika za usługi świadczone przez tego sprzedawcę będzie obejmowała cenę usługi plus podatek naliczony z wykorzystaniem podanej tutaj stawki podatku. Ułamki od najmniejszej jednostki waluty (np. ułamki 1 centa) będą zaokrąglane według zaokrąglenia parzystego. Podatki będą wyświetlane użytkownikowi jako osobna pozycja.

To pole zostało wycofane. Użyj stawki 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.

PaymentRestrictions

Ograniczenia dotyczące form płatności akceptowanych przez tego sprzedawcę. Zakładamy, że nie istnieją żadne ograniczenia, jeśli to pole nie jest ustawione.

PaymentOption

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

PaymentProcessorConfig

Konfiguracja dla tokenizowanego podmiotu przetwarzającego płatności, jeśli sprzedawca obsługuje tę funkcję.

TokenizationConfig

Konfiguracja dla tokenizowanego podmiotu przetwarzającego płatności, jeśli sprzedawca obsługuje tę funkcję.

Terms

Warunki korzystania z usługi konkretnego sprzedawcy wyświetlane użytkownikowi, gdy usługa jest rezerwowana przez Zarezerwuj z Google. Oprócz tych Warunków korzystania z usługi partnera pośrednika są zawsze wyświetlane użytkownikowi i nie należy ich tu podawać.

string

Nieprzejrzysty ciąg znaków identyfikujący markę przeznaczoną dla konsumentów, która ma być używana podczas prezentowania atrybucji partnera. Dzięki temu polu partnerzy z wieloma markami przeznaczonymi dla konsumentów mogą udostępniać sprzedawcom wszystkie marki w tym samym pliku danych.

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

Jeśli istnieje tylko 1 marka partnera mającego kontakt z konsumentami, nie trzeba ustawiać tego pola i można je zignorować.

Jeśli partner...

Czy nie masz wielu marek dla konsumentów? --> Zignoruj to pole

Czy 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 korzystać z tego pola, musi najpierw skontaktować się z nami w celu skonfigurowania oddzielnych marek, w tym marki domyślnej.

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 atrybutów usług używanych do opisania Usług danego Sprzedawcy. (opcjonalnie)

ActionLink

Opcjonalnie. adres URL działania wraz z powiązanym językiem, listą krajów, do których dostęp jest ograniczony, typem i opcjonalną platformą wskazującą, na jakiej platformie należy wykonać działanie;

Advisement

Opcjonalnie. Ogólne porady od konkretnego sprzedawcy dla użytkownika, który chce dołączyć do listy oczekujących przez Zarezerwuj z Google. Poszczególne pola tekstowe w radzie nie powinny mieć więcej niż 100 bajtów.

string

Identyfikator miejsca dla 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 podali 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 geograficzne miejsce tego sprzedawcy. Pole jest puste, jeśli sprzedawca nie ma dopasowania geograficznego.

LocalServicesMatchInfo

Pasujące reklamy 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ąca zawartość bieżącego asortymentu sprzedawców. 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

Prawda, jeśli sprzedawca ma swój asortyment w ciągu najbliższych 30 dni. Nie gwarantuje to, że dane sprzedawcy będą wyświetlane.

UrlType

Typ tego adresu URL.

string

Adres URL, pod którym można znaleźć tego sprzedawcę.

MatchedProvider

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

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 tego miejsca Miejsc Google. Mogą posłużyć do utworzenia adresu URL w Mapach Google lub pobrania dodatkowych informacji o danym miejscu. Przykład użycia znajdziesz na stronie https://developers.google.com/places/web-service/place-id.

bool

Prawda, jeśli sprzedawca obsługuje listę oczekujących. Nie gwarantuje to, że dane sprzedawcy będą wyświetlane.

Money

Minimalna kwota.

Money

Maksymalna kwota.

Price

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

PriceType

Określa sposób określania opłaty 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łatności 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 w przypadku linku do działań związanych z zamówieniem online.

PrepaymentStatus

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

string

Unikalny identyfikator transakcji płatności powiązanej z rezerwacją. Jeśli nie ma zastosowania, pole puste.

string

Ten identyfikator służy do identyfikacji tej opcji płatności.

Ten identyfikator jest globalny dla całego pośrednika, a ponowne użycie tej samej wartości u wielu sprzedawców umożliwi użytkownikowi płacenie za pomocą odpowiedniej opcji płatności u tych sprzedawców.

Jeśli w przypadku ponownego korzystania z dokumentu tożsamości wielu sprzedawców zaktualizujesz wartość opcji płatności u jednego sprzedawcy, spowoduje to również zaktualizowanie każdej opcji płatności z tym samym identyfikatorem w przypadku innego sprzedawcy. Sprawdzoną metodą jest stosowanie przez wszystkie opcje płatności tego samego identyfikatora i ich ustawianie do identycznych wartości, aby uniknąć osłabiania zachowań.

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 ono pole tax_rate w sekcji Merchant lub Service. Pusta wiadomość (np. tax_rate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera.

PaymentOptionType

Typ tej opcji płatności. Jednorazowe rozwiązanie do udostępniania, wielokrotnego użytku w pakietach, bez ograniczeń w przypadku wspierania kanału.

int64

Liczba sesji, podczas których można użyć tej formy płatności. Dotyczy tylko wielu sesji lub pakietów, gdzie wartość powinna być większa niż 1.

TimeRange

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

TimeRange

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

Duration

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

ActivationType

Określa, jak określa się datę rozpoczęcia ważności dla tej opcji płatności.

UserPurchaseRestriction

Ogranicza użytkowników, którzy mogą kupić tę opcję płatności. Pozwala ograniczyć opcję płatności promocyjnych do podzbioru użytkowników. Jeśli zasada nie jest skonfigurowana, wszyscy użytkownicy mogą korzystać z raportu.

Processor

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

string

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

Informacje na temat Stripe znajdziesz tutaj: https://stripe.com/docs/dashboard#api-keys. W przypadku Braintree zajrzyj na stronę https://articles.braintreepayments.com/control-panel/important-gateway-credentials.

string

Numer wersji interfejsu API wysyłany do podmiotu obsługującego 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 ustawione, zakładamy, że wszystkie karty kredytowe są akceptowane. Pamiętaj, że lista kart obsługiwanych przez CreditCardType będzie się z czasem wydłużać, co oznacza, że pozostawienie tego pustego pola konfiguracji pozostanie bez zmian.

Price

Opłata 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 pobierana na poczet obiektu lub obiektu.

Price

Podatki za bilet

string

Kraj określony za pomocą kodu kraju zgodnego ze standardem ISO 3166-1 alfa-2, np. „PL” (wymagany)

string

Okolica, np. „Mountain View”. (pole 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”. (pole wymagane)

string

Ulica i numer domu, np. „Emilii Plater 23”. (pole wymagane)

int64

Cena w mikrojednostkach waluty. Ułamki od najmniejszej jednostki waluty będą zaokrąglane wg zaokrąglenia równomiernego. (np. w przypadku zaokrąglonych do 2 groszy 2,5 centa zaokrąglonego do 4 groszy, 0,5 centa zaokrąglonego do 0 gr lub 2,51 centa zaokrąglonego do 3 groszy).

string

Waluta ceny określona w normie ISO 4217.

string

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

double

Wartość pojedyncza. Na przykład: 5.6

RangeValue

Zakres wartości, które mogą być też otwarte lub ograniczone. Przykłady: * co najmniej 5,5 * maks. 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 wynosi zero.

uint64

Liczba ocen używanych do obliczania wartości (wymagana).

string

URL tego źródła multimediów. Google zindeksuje multimedia znajdujące się pod tym adresem URL.

MediaType

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

Text

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

Attribution

Informacje o źródle multimediów. Pamiętaj, że jeśli informacje o autorze muszą być wyświetlane w mediach, aby informacje o fotografu lub agencji mogły zostać uwzględnione w informacjach o autorze, musisz ustawić to pole. (opcjonalnie)

string

Wycofano, lepiej użyć parametru localized_caption.

Text

Tekst z informacjami o fotografu lub agencji obsługującej i18n. Ten tekst będzie wyświetlany razem ze źródłowym plikiem multimedialnym. Pamiętaj, że w tym polu obsługiwany jest tylko zwykły tekst – wszystkie komponenty HTML są usuwane (atrybucja oparta na hiperlinkach nie jest obsługiwana).

string

Wycofano, wolę używać localized_text.

ServiceAvailability

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

string

Opcjonalny identyfikator pracownika świadczącego usługę. To pole określa pracownika we wszystkich sprzedawcach, usługach i rejestrach dostępności. Musi też być stabilna w czasie, aby umożliwić korelację z wcześniejszymi rezerwacjami. To pole musi być obecne, jeśli istnieje element „person_name”.

string

Opcjonalne imię i nazwisko 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 nieprzejrzyste identyfikator. To pole musi być obecne, jeśli istnieje identyfikator sales_id.

string

Opcjonalny identyfikator pokoju, w którym dostępna jest usługa. To pole określa salę we wszystkich sprzedawcach, usługach i rejestrach dostępności. Musi też być stabilna w czasie, aby umożliwić korelację z wcześniejszymi rezerwacjami. To pole musi być obecne, jeśli występuje parametr „room_name”.

string

Opcjonalna nazwa pokoju, w którym dostępna jest usługa. To pole będzie wyświetlane użytkownikom dokonującym rezerwacji i powinno być czytelne dla człowieka, a nie nieprzejrzyste identyfikator. (opcjonalne, ale wymagane, jeśli podano identyfikator_pokoju) W jadalni nazwa sali powinna być używana tylko w odniesieniu do miejsc wypoczynkowych, takich jak bar lub patio. Nie należy jej używać w przypadku dań w stałej cenie, atrakcji specjalnych ani innych wartości niezwiązanych z pokojem (np. rezerwacji lub kolacji). Zdecydowanie zalecamy, aby domyślne miejsce wypoczynkowe nie było przypisane do żadnego pomieszczenia.

int32

Dotyczy tylko restauracji: liczba miejsc, na które można przyjść w tym czasie. Restauracja może być powiązana z wieloma przedziałami naraz, a każdy z nich może określać inną wartość parametru party_size, na przykład dla 2, 3 lub 4 osób siedzących w ramach rezerwacji.

int64

Minimalne wyprzedzenie (w sekundach), które jest wymagane do anulowania zarezerwowanego spotkania online. (opcjonalnie)

Price

Opłata za anulowanie subskrypcji po upłynięciu minimalnego okresu zapowiedzi.

Price

Opłata za niestawienie się bez anulowania.

AdmissionPolicy

Zasady uczestnictwa obowiązujące w przypadku tej usługi. Jeśli nie jest skonfigurowana, domyślna wartość to TIME_STRICT. (opcjonalnie)

CancellationPolicy

Zasady anulowania reguł planowania. (wymagane w przypadku funkcji Atrakcje)

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 zakończenia przedziału dostępności. Jeśli to pole jest ustawione, pole „admission_policy” musi mieć 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. Użyj parametru localized_service_name.

Text

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

string

Opis usługi widoczny dla użytkowników. Wycofano. Użyj parametru localized_description.

Text

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

To pole obsługuje zarówno zwykły tekst, jak i formatowanie podobne do HTML. W przeciwieństwie do sekcji ze zwykłym tekstem możesz tu tworzyć układy niestandardowe, korzystając z nagłówków, akapitów, list i tagów wyrażenia. Aby zapewnić użytkownikom maksymalną wygodę, należy dokładnie zapoznać się z poniższymi instrukcjami i uwagami.

Obsługiwane tagi formatowania podobne do HTML:

Tagi nagłówka: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
umożliwiają wyświetlanie tytułów i podtytułów. Na przykład w tekście <h1>Plan podróży</h1> wyświetlany jest tekst wbudowany jako najważniejszy nagłówek sekcji. Wszystkie wewnętrzne tagi HTML, style i atrybuty będą ignorowane. Na przykład parametr <h1 style=".."> będzie traktowany tak samo jak tag <h1>. Zostanie zachowany tylko czysty tekst.

Tag akapitu: <p>
możesz użyć tagu akapitu, by wyróżnić szczegółowe wprowadzenie lub treść. Wszystkie wewnętrzne tagi, style i atrybuty będą ignorowane (z kilkoma wyjątkami: <br>, <strong> i <em>). Więcej informacji znajdziesz w sekcji tagów wyrażenia poniżej.

Tagi listy: <ul>, <ol> i <li>
Tagu <ul> można używać razem z tagiem <li> do wyświetlania list nieuporządkowanych, a tagu <ol> można używać razem z tagiem <li> do wyświetlania list uporządkowanych. Jest to dobry sposób na wyświetlenie list kontrolnych, harmonogramów lub innych list pasujących do Twoich potrzeb.
Przykład: aby wyświetlić listę atrakcji podczas rejsu:
<ol>
<li>Wspaniały widok na ocean i możliwość zabawy z dziką przyrodą.</li>
<li>Starannie opracowane plany podróży i usługi.</li>
<li>Gwarantowana najniższa cena.</li>
</ol>
Pamiętaj, że skonwertowane zostaną tylko dzieci poniżej <li> tagów <ul> i <ol>. Pozostałe dzieci zostaną usunięte. Wszystkie wewnętrzne tagi, atrybuty i style będą ignorowane – zachowujemy tylko samą zawartość tekstu.

Tag podziału: <div>
Wszystkie obsługiwane tagi wewnętrzne tagu <div> zostaną przeanalizowane zgodnie z opisanymi powyżej zasadami. Samodzielna interpretacja tagu <div> nie oznacza tu jego grupowania ani wcięcia. Wszystkie wewnętrzne atrybuty i style będą ignorowane.

Tagi wyrażeń: <br>, <strong>, <em>:
obsługiwane są tylko trzy wymienione powyżej tagi. <br> może służyć do podziału wierszy w akapicie, a symbolu <strong>/<em> do wyróżnienia ważnego tekstu. Wszelkie inne tagi do wyrażenia będą ignorowane.

Nieobsługiwane tagi:

• Tagi <html>, <header> i <body> są niedozwolone.
• Wszelkie inne tagi niewymienione 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 użyć zdjęć, aby zwiększyć wygodę użytkowników, użyj pola „related_media” poniżej, aby wysłać adresy URL zdjęć.
  

Ważne informacje:

• Staraj się nie używać innych tagów oprócz tych wymienionych powyżej, ponieważ zawartość nieobsługiwanych tagów zostanie usunięta i może być nieprzydatna dla użytkowników.
  
• Unikaj stosowania głębokich zagnieżdżonych struktur, takich jak więcej niż 3 różne poziomy nagłówków czy zagnieżdżone listy. Płaska, prosta i funkcjonalna struktura pomaga zadbać o wygodę użytkowników.
  
• Jeśli obecnie obsługiwane układy nie są wystarczające do Twoich zastosowań, skontaktuj się z zespołem Zarezerwuj z Google.
  
• Zalecany maksymalny rozmiar to 32 tys. znaków.

Price

Cena usługi.

PriceInterpretation

Opisuje, jak cena jest interpretowana i wyświetlana użytkownikowi. Tej opcji można używać w przypadku każdej branży z wyjątkiem restauracji i Atrakcji do konfigurowania wyświetlania cen usług.

SchedulingRules

Zasady rezerwowania lub anulowania spotkania.

PrepaymentType

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

PrepaymentTerms

Warunki obowiązujące w momencie dokonania przedpłaty.

ServiceIntakeForm

Rola wycofana. Używaj intake_form oraz per_ticket_intake_form.

ServiceIntakeForm

Formularz z prośbą o dodatkowe informacje podczas rezerwowania tej usługi przez użytkownika. (opcjonalnie)

ServiceIntakeForm

Formularz z prośbą o dodatkowe informacje podczas rezerwowania tej usługi przez użytkownika. Ten formularz należy wypełnić tylko raz w przypadku każdego biletu, który użytkownik rezerwuje. (opcjonalnie)

TaxRate

Stawka podatku od usługi. Jeśli to pole jest obecne, zastąpi ono wszystkie stawki tax_rate ustawione na poziomie sprzedawcy. Pusta wiadomość (np. tax_rate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera.

string

Lista identyfikatorów odnoszących się do opcji płatności, za pomocą których można opłacić tę usługę. Rzeczywiste opcje płatności są określone na poziomie sprzedawcy i mogą być też współdzielone przez wielu sprzedawców.

Deposit

Określa sposób obciążenia użytkownika płatnością. Zastępuje kwotę wpłaty za usługę, jeśli została określona. Ustawienie dla tej opcji pustej wiadomości o depozycie powoduje usunięcie wszelkich wpłat na poziomie usługi. (opcjonalnie)

NoShowFee

Określa opłatę za niestawienie się użytkownika, którą może pobrać użytkownik. Zastępuje opłatę za niestawienie się, jeśli została określona. Ustawienie pustej wiadomości NoShowFee powoduje usunięcie wszystkich 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, typ (patrz poniżej) musi być ustawiony w Usłudze.

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 jak najefektywniejszy 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 u odpowiedniego Sprzedawcy. (opcjonalnie)

WaitlistRules

Reguły dołączania do listy oczekujących.

TicketingVerticalSpecificData

Dodatkowe informacje związane z branżą sprzedaży biletów na wydarzenia. (opcjonalnie)

IntegrationType

Głębokość integracji obsługiwanej w tej usłudze. (Opcjonalnie) Nieistotne dla partnerów korzystających z integracji ze stroną inicjującą. Usługa zawsze będzie wyłączona dla 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: jeśli istnieje wiele odwiedzonych lokalizacji powiązanych z tą usługą lub lokalizacja START_LOCATION jest inna niż VISITED_LOCATION, należy określić START_LOCATION. Przykład: – wycieczka rowerowa z przewodnikiem po 3 miejscach – należy określić miejsce początkowe. – Wycieczka autobusem w lobby hotelu, a następnie udaj się do odwiedzonego miejsca. Musisz określić lokalizację spotkania.

Rating

Ocena użytkowników tej usługi określana na podstawie wszystkich opinii.

HomeServiceData

Dodatkowe informacje związane z branżą usług dla domu. (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 dokonania płatności bezpośrednio na rzecz sprzedawcy. WAŻNA UWAGA: RwG nie uczestniczy w tej transakcji. Jest wymagany, jeśli zdefiniowano atrybut virtual_session, a usługa nie jest bezpłatna lub typ przedpłaty nie jest ustawiony na REQUIRED (WYMAGANE).

ChargeTiming

Moment naliczenia opłaty w zależności od czasu zakupu.

int64

Czas (w sekundach) przed godziną rozpoczęcia usługi, przez jaki użytkownik zostaje obciążony płatnością. To pole należy ustawiać tylko wtedy, gdy ChargeTiming ma wartość CHARGE_LATER.

string

Identyfikator, który jednoznacznie identyfikuje ten atrybut usługi wśród innych 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 atrybutów usługi, np. „osobisty”.

string

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

string

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

string

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

string

Nazwa zasobu usługi, do której ma być zastosowane polecenie. W formacie partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

Jeśli je podasz, uznamy je za kompletny zrzut z [start_time_restrict, end_time_restrict). Oznacza to, że jeśli zostanie spełniony ten warunek, wszystkie dotychczasowe informacje o dostępności zostaną usunięte:

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

Jeśli zostanie ustawiony komunikat o czasie trwania, warunek będzie dodatkowo ograniczony:

  availability.duration == duration_restrict

Jeśli zostanie ustawiony komunikat resource_restrict, warunek będzie dodatkowo ograniczony:

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

Te pola zwykle służą do przedstawienia pełnej aktualizacji dostępności w danym okresie.

Ustawienie start_time_restrict, a jednocześnie pozostawienie nieskonfigurowanej wartości end_time_restrict jest interpretowane jako oznaczało cały czas rozpoczynający się od start_time_restrict.

Timestamp

Ustawienie parametru end_time_restrict i nieskonfigurowanie ustawienia start_time_restrict jest interpretowane jako oznaczało cały czas, aż do parametru end_time_restrict.

Duration

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

Resources

Ustawienie pola resource_restrict dodatkowo 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ść true (prawda), ten formularz będzie wyświetlany klientom po raz pierwszy. Rola wycofana. Ta funkcja nie jest obsługiwana w przypadku formularzy przyjmowania zgłoszeń.

bool

Jeśli ma wartość true (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 tekstowy od partnera agregatora, który jednoznacznie identyfikuje pole formularza. Ten identyfikator powinien być taki sam jak identyfikator w odpowiedniej odpowiedzi w polu formularza i musi być unikalny na poziomie usługi i w formularzach przyjmowania zgłoszeń. (pole wymagane)

FieldType

Typ tego pola.

string

Tekst wyświetlany użytkownikowi w tym polu. Wycofano. Użyj interfejsu localized_label.

Text

Tekst wyświetlany użytkownikowi w tym polu. To pole można podać w wielu językach. (pole wymagane)

string

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

Text

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

bool

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

bool

Wskazuje, czy oprócz wstępnie zdefiniowanych odpowiedzi można używać wartości niestandardowej. Ma to zastosowanie tylko wtedy, gdy typ pola to LOCATION_SEARCH. (opcjonalnie)

Text

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

string

Jeśli to pytanie powinno być wyświetlane tylko wtedy, gdy użytkownik rezerwuje określony typ biletu, to pole należy ustawić jako zbiór odpowiednich identyfikatorów typów biletów. Jeśli pytanie dotyczy zawsze, pozostaw to pole puste.

Text

Tekst podpowiedzi do wprowadzenia, który wyświetla się jako zmienna tekstowa. Ma to zastosowanie tylko wtedy, gdy typ pola to SHORT_ANSWER lub PARAGRAPH. (opcjonalnie)

int32

Stawka podatku wyrażona w milionach procenta, co daje 6 miejsc po przecinku z dokładnością. 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, jaką użytkownik płaci za dowolną usługę świadczoną przez tego sprzedawcę, jest dokładną ceną określoną w atrybucie Service.price. Przyjmujemy, że cena usługi jest zwolniona z obowiązujących podatków lub już zawiera odpowiednie podatki. Podatki nie będą wyświetlane użytkownikowi jako osobna pozycja.

Jeśli to pole ma wartość inną niż zero, łączna cena naliczana od użytkownika za usługi świadczone przez tego sprzedawcę będzie obejmowała cenę usługi plus podatek naliczony z wykorzystaniem podanej tutaj stawki podatku. Ułamki od najmniejszej jednostki waluty (np. ułamki 1 centa) będą zaokrąglane według zaokrąglenia parzystego. Podatki będą wyświetlane użytkownikowi jako osobna pozycja.

string

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

string

Tekst, który będzie wyświetlany użytkownikowi. W przypadku nowych integracji używaj poniższego tekstu localized_text.

Text

Zlokalizowany tekst wyświetlany użytkownikowi.

string

Wartość tekstowa w nieznanym języku. Wymagane tylko wtedy, gdy pole localized_value jest puste. Ustawienie regionalne dla tej wartości może zależeć od partnera lub dostawcy usług i nie należy zakładać, że określa się tutaj konkretny język.

LocalizedString

Wartości tekstowe dla poszczególnych języków. Opcjonalnie.

string

Identyfikator zgłoszenia służy do rozróżniania typów biletów w tej samej usłudze. Powinien być unikalny tylko w obrębie danej usługi.

string

Krótki opis tego biletu.

Może to być widoczne dla użytkownika, np. „adult”, „child”, „weteran”, „Row J” itp. Wymagany. Każdy rodzaj biletu powinien mieć opis, aby był widoczny dla użytkownika. Wycofano. Użyj parametru localized_short_description.

Text

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

Może to być widoczne dla użytkownika, np. „adult”, „child”, „weteran”, „Row J” itp. Wymagany. Każdy rodzaj biletu powinien mieć opis, aby był widoczny dla użytkownika. Dla każdego języka możesz podać osobne wartości.

Price

Cena za bilet tego typu bez żadnych podatków. Stawka podatku związana z Usługami jest doliczana do biletów.

PerTicketFee

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

string

Opis dodatkowych opcji reprezentowanych przez ten typ biletu (jeśli dotyczy). Wycofano. Użyj parametru localized_option_description.

Text

Opis dodatkowych opcji reprezentowanych przez ten typ biletu (jeśli dotyczy). Dla każdego języka możesz podać osobne wartości.

Dodatkowe opcje są przydatne, gdy typ biletu obejmuje wiele wymiarów.

Przykład 1: bilet wstępu z różnymi typami 'adult', 'child' i językiem jako dodatkową opcją, oczekiwanym biletem typu TicketType: - {ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } -adult: {child_type_2} -adult: {child_type_id: "localized_description value}

Example 2: an multi-hour wypożycz withoptional dry bag add-on, the short_description hours can "with dry bag" or "without dry bag": - {ticket_type_id: "ticket_type_1" localized_short_description hours { value: "2 hours" } localized_option_description godziny

Opcjonalne, ale jeśli dowolny typ zgłoszenia w usłudze ma ustawione to pole, oczekujemy, że to pole będzie też mieć ustawione w przypadku wszystkich innych rodzajów zgłoszeń (możesz 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ży do określania opcji z tytułem i szczegółowym opisem, na przykład: „Fotele premium
Ta opcja obejmuje miejsca w prywatnych skrzyniach, w tym w pełni wyściełane fotele, prywatny telewizor, podkłady jedzenia i napoje. Z tych siedzisk rozciąga się malowniczy widok na pole”.

EventCategory

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

string

Adres URL wydarzenia w witrynie partnera. (opcjonalnie)

Entity

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

AttendanceMode

To pole jest wymagane. Typ obecności na wydarzeniu.

string

Opcjonalnie. Adres URL strony, na której można obejrzeć wydarzenie.

Text

Opcjonalnie. Organizator wydarzenia.

string

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

OrganizerType

Opcjonalnie. Typ organizatora.

string

To pole jest wymagane. Adresy URL stron, na których można znaleźć informacje o zdarzeniu lub ich opisy.

EventState

Opcjonalnie. Stan wydarzenia.

string

Unikalny identyfikator encji w bazie danych partnera. (opcjonalnie)

string

Nazwa elementu. (pole wymagane)

string

Adres URL strony internetowej, która jednoznacznie opisuje element. Jest to strona internetowa danego podmiotu, jeśli taki istnieje. W przypadku innych publicznych adresów URL tego podmiotu użyj atrybutu odpowiedni_url w polu public_identification_data. (opcjonalnie)

EntityType

Typ elementu. (opcjonalnie)

EntityRole

Rola podmiotu w zdarzeniu. (opcjonalnie)

PublicIdentificationData

Publiczne odniesienia do jednostki. (opcjonalnie)

string

Publiczny adres URL dowolnej strony internetowej poświęconej tylko zagadnieniom. Mogą to być oficjalne strony internetowe, dyskoteki, platformy mediów społecznościowych, strony 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 stosownych przypadkach). Więcej informacji znajdziesz na stronie 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 klucz to „gateway” i którego wartość to nazwa procesora.

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

Braintree example: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } parametr tokenization_parameter { key: "braintree:sdk" value: "2.30.0" }:parametr tokenizacji { key: "identyfikator_wersji"

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

Przykład w Adyen: parametr tokenization_parameter { key: "gateway" value: "adyen" } parametr tokenization_parameter { key: "gatewayMerchantId" value: "Twój_identyfikator" }

BillingInformationFormat

W tokenie płatności podaj informacje rozliczeniowe użytkownika podane w Google Pay wraz z formą płatności (patrz wyżej). Pozostawienie pustego pola jest równoważne z podaniem wartości MIN.