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ępne są treści 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 ustawione, jako wartość zastępczą zostanie użyte ACTION_PLATFORM_WEB_APPLICATION.

ActionLinkType

Wstępnie określony typ działania.

OrderOnlineMetadata

Metadane linku online do zamówienia. Obsługuje działanie o typie ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

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

EventMetadata

Dodatkowe informacje o linku do działania, które jest unikalne dla kategorii zdarzeń.

Surface

Wstępnie określona powierzchnia zdarzenia powiązana z linkiem do działania. Jest on używany tylko w kategorii Imprezy.

string

Identyfikator. Nazwa zasobu połączenia z kontem Ads. Format: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Wymagane. Lista identyfikatorów produktów asortymentu, które chcesz połączyć z kontem Google Ads.

State

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

Text

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

Timestamp

Czas rozpoczęcia terminu spotkania.

Duration

Czas trwania terminu spotkania

int64

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

• Zajęcia 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 zakłada spots_total=1 i spots_open=1.
• Rekord ScheduleException przy użyciu argumentów spots_total=1 i spots_open=0.

int64

Liczba otwartych miejsc.

string

Opcjonalny nieprzejrzysty ciąg znaków identyfikujący ten slot 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_ids określone w wiadomości 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 powtarzalności dostępności, które wskazują 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

Opcjonalny depozyt dla tej dostępności. zastępuje depozyt na poczet usługi, jeśli został on podany;

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.

Prepayment

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

RequireCreditCard

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

string

Wskazuje listę obsługiwanych typów biletów dla tego przedziału dostępności. Jeśli nie zostanie ustawiony, w tym miejscu dostępne są wszystkie typy biletów 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 4 typami biletów: TicketType {ticket_type_id: "adult_1" short_description: "Dorośli w tygodniu"} TicketType {ticket_type_id: "adult_2" short_description: "Dorośli w weekend"} TicketType {ticket_type_id: "youth_1" short_description: "Dzieci w tygodniu"} TicketType {ticket_type_id: "youth_2" short_description: "Dzieci w weekend"}

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

• Usługa z 3 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

Wymaganie wyświetlania czasu trwania lub czasu zakończenia slotu. Jeśli przedział jest niedostępny, to pole jest ignorowane. Nie jest używany w kategorii „Lista zadań”. (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.

LinkoutRequiredReason

Opcjonalnie: Wyjaśnienie, dlaczego w tym slocie wymagany jest link zewnętrzny. Jeśli jest ustawiony, zasób Merchant w tym miejscu musi zawierać prawidłowy LinkoutTemplate. (opcjonalnie)

Timestamp

Sygnatura czasowa UTC, do której obowiązuje dostępność.

Duration

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

Przykład: dostępność z czasem trwania 20 min, parametrem repeat_every o wartości 30 min, parametrem start_time o wartości 9:00 rano i parametrem repeat_until o wartości 11:00 rano da sloty o godzinach 9–9:20, 9:30–9:50, 10–10:20, 10:30–10:50 i 11–11:20. (wymagane)

TimeRange

Zakres czasowy wyjątku. Wszystkie przedziały opisane przez powtarzalność, które pokrywają się z tym zakresem czasu, będą uważane za niedostępne.

Przykład: jeśli powtarzanie określa czas trwania 20 min, powtarzanie co 30 min, czas rozpoczęcia 9:00 i powtarzanie do 11:00, to ScheduleException z zakresem czasowym 9:45–11:00 spowoduje, że niemożliwe do użycia będą przedziały 9:30–9:50, 10:00–10:20 i 10:30–10:50.

Pamiętaj, że ze względu na to, że 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. Ten sygnaturze czasu musi być krótszy niż start_sec danego przedziału (jeśli użytkownicy mają mieć możliwość rezerwacji po godzinie rozpoczęcia, użyj parametru SchedulingRules.min_booking_before_end_time na poziomie usługi). Jeśli jest obecna, zastąpi wszystko określone w min_booking_buffer w regułach harmonogramowania odpowiedniej usługi.

int64

Pierwszy raz (w sekundach), kiedy można zarezerwować ten przedział. Ta sygnatura czasowa musi być wcześniejsza niż start_sec boksu lub last_bookable_sec, jeśli jest podana.

int64

Jeśli ustawiono wartość, jest to ostatni czas (w sekundach od epoki Unixa), do którego można anulować ten konkretny przedział czasowy rezerwacji za pomocą platformy 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 podać maksymalnie 1000 rekordów.

string

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

GenericRecord

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

string

Format partners/{partner_id}.

ExtendedServiceAvailability

Rozszerzona dostępność usługi, która zastępuje dotychczasowe przedziały 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 spotkanie;

BookingStatus

Stan rezerwacji

PaymentInformation

informacje o transakcjach płatniczych związanych z rezerwacją;

int64

Liczba osób w rezerwacji

Cause

przyczyna niepowodzenia rezerwacji; (wymagane)

CreditCardType

(wymagany tylko wtedy, gdy przyczyna to PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

To opcjonalne pole służy do przekazywania przez partnera dodatkowych informacji tylko na potrzeby debugowania. (opcjonalnie)

PaymentFailureInformation

informacje o niepowodzeniu płatności;

ThreeDS1Parameters

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

string

Adres URL, z którego wczytywane jest formularz, który użytkownik musi wypełnić w celu uwierzytelnienia.

string

Prośba o płatność. Przesłanie do formularza ACSUrl, jeśli został podany.

string

Identyfikator używany przez dostawcę ACS. Przesłanie do formularza 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

Czas, który upłynął od rozpoczęcia okresu, do którego klient może otrzymać zwrot części kosztów usługi określonych w refund_percent. Gdy wartość wynosi 0 (domyślnie), usługę można anulować w każdej chwili.

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]. Gdy wartość wynosi 0 (domyślnie), usługa nie podlega zwrotowi. 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

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

string

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

AdsAccountLink

Wymagane. Link do konta Google Ads, który chcesz utworzyć.

string

Nazwa zasobu nadrzędnego partnera, który jest właścicielem tego sprzedawcy, 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 dla 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 jest pusta, nie obsługuje kart kredytowych.

string

Wymagane. Nazwa linku do konta Google Ads, który chcesz usunąć. Format: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Nazwa zasobu sprzedawcy, który ma zostać usunięty. W formacie partners/{partner_id}/merchants/{merchant_id}

string

Nazwa zasobu usługi, którą chcesz usunąć. w formacie partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

Price

Kwota wpłaty.

int64

Minimalny okres wypowiedzenia z zastrzeżeniem wpłaty depozytu.

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.

Text

Wymagane. imię i nazwisko, adres, numer telefonu i adres e-mail operatora gospodarczego, zdefiniowanego jako producent, autoryzowany przedstawiciel, importer, dystrybutor, dostawca usług płatniczych lub inna osoba fizyczna lub prawna podlegająca obowiązkom związanym z produkcją, udostępnianiem lub wprowadzaniem produktów do obrotu. Ciąg znaków reprezentujący operatora economic_operator. Te informacje można sformatować za pomocą atrybutu „ ” i „\n”.

string

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

string

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

Timestamp

Jeśli zostaną podane, uznamy, że przesłane elementy Availability stanowią pełny zrzut ekranu z [start_time_restrict, end_time_restrict). Oznacza to, że wszystkie istniejące informacje o dostępności zostaną usunięte, jeśli spełniony jest 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 pełnego zaktualizowania dostępności w danym zakresie czasowym.

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 identyfikatora zasobów muszą być identyczne.

Availability

Nowa lista dostępności.

int64

Nowo dodane elementy z tego pliku danych. W zależności od typu pliku danych elementy mogą być sprzedawcami, usługami lub slotami dostępności.

int64

istniejące elementy, które w razie potrzeby są aktualizowane na podstawie nowszych informacji z pliku danych;

int64

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

string

Nazwa zasobu pliku danych, 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 dodatkowo do łącznej kwoty produktu. Powtarzane w przypadku różnych typów opłat, takich jak opłata za usługę, opłata za dostawę itp.

AdvanceOrderDetails

Szczegóły dotyczące zaawansowanego wsparcia dotyczącego składania zamówień, które jest również znane jako składanie zamówień z wyprzedzeniem, gdzie użytkownik może złożyć zamówienie na realizację w późniejszym terminie.

Duration

Czas trwania jest stały. 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

Wartość Prawda, jeśli zamówienia z wyprzedzeniem, znane też jako zamówienia z wyprzedzeniem, są obsługiwane. (wymagane)

FeeType

Typ opłaty. (wymagane)

FeeAmount

Kwota opłaty w walucie jednostkowej, jako odsetek wartości koszyka lub w połączeniu obu tych opcji. (wymagane)

QuantitativeValue

Opłata jako odsetek 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 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. Załóżmy, że jest to strefa czasowa sprzedawcy.

Timestamp

Wymagane. Sygnatura czasowa systemu Unix. Ostatni raz, kiedy użytkownik mógł zamówić i otrzymać produkty do fulfillment_date. Innymi słowy, po dacie last_ordering_time data fulfillment_date nie będzie już wyświetlana jako dostępna.

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 złożyć zamówienie do 20:00 8 sierpnia 2020 r.

NoFee

Brak opłaty za metodę realizacji.

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.

Price

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

Timestamp

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

bytes

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

Any

W przypadku plików danych w formacie proto.

Timestamp

Wymagane. Ten znacznik czasu służy do zapewnienia prawidłowej kolejności aktualizacji danych o asortymencie.

bytes

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

Any

W przypadku plików danych w formacie 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ć adres nieustrukturyzowany. np. „1600 Amphitheatre Parkway, Mountain View, CA 94043”

string

Wymagane. Nazwa konta Google Ads, do którego prowadzi link. Format: partners/{partner}/adsAccountLinks/{ads_account_link}

string

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

string

Nazwa zasobu pliku danych, 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 zadania w ramach kategorii, do której należy dana usługa domowa. Na przykład: unclog_drain i install_faucet to typy zleceń w kategorii hydraulik.

string

Nazwa zasobu do unieważnienia.

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

string

Identyfikator usługi sprzedawcy.

int64

Czas rozpoczęcia przedziału czasowego w sekundach czasu UTC od epoki Unix.

int64

Czas trwania terminu w sekundach.

OrderedTickets

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

Price

Łączny koszt (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 elementó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 do filtrowania wyników według stanu rezerwacji asortymentu.

WaitlistInventoryStatus

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

GeoMatchingStatus

Opcjonalnie: Opcjonalne ograniczenie do 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 na niej żadnych 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 elementów do zwrócenia.

string

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

State

Opcjonalnie ogranicz wyniki do stanu pliku danych.

TimeRange

Opcjonalne ograniczenie filtrowania wyników według górnej i dolnej granicy. Jeśli parametr start_time nie jest ustawiony, zostanie domyślnie użyty początek czasu Unixa. 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 produktów zależy od wartości 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”, „de-CH-1901”. Zobacz http://www.w3.org/International/articles/language-tags/.

string

Komunikat w danym 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 podasz ten adres, 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

Numer telefonu publicznego lokalizacji, w tym kod kraju i kod kierunkowy, np. +14567891234. (opcjonalnie)

string

Adres URL witryny publicznej lokalizacji. (opcjonalnie)

GeoCoordinates

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

LocationType

Typ lokalizacji, który musi zostać podany, jeśli lokalizacja jest udostępniana w ramach usługi.

string

Unikalny identyfikator 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, 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

Numer telefonu sprzedawcy, który jest dostępny dla klientów, wraz z kodem kraju i kodem 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 w punktach bazowych (jedna setna 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, którą płaci użytkownik za dowolną usługę świadczoną przez tego sprzedawcę, to dokładna cena określona przez parametr Service.price. Uznaje się, że cena usługi jest zwolniona z podatku lub że zawiera już stosowne 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 1 centa) są zaokrąglane przy użyciu najbardziej zbliżonego równomiernego zaokrąglenia. 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 sprzedawcy. 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 indywidualnie ograniczać dozwolone opcje płatności.

PaymentProcessorConfig

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

TokenizationConfig

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

Terms

Warunki korzystania z usługi konkretnego sprzedawcy wyświetlane użytkownikowi, gdy usługa zarezerwuje usługę 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

Nieprzejrzysty ciąg znaków, który identyfikuje markę skierowaną do konsumentów, aby wyświetlić atrybucję partnera. To pole umożliwia partnerom, którzy mają wiele marek przeznaczonych dla konsumentów, udostępnianie danych 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 jest tylko jedna marka partnera skierowana do konsumentów, nie musisz ustawiać tego pola i możesz je zignorować.

Jeśli partner...

Nie ma wielu marek przeznaczonych dla konsumentów? --> Ignoruj 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 wypełniać tego pola. Jeśli partner chce używać tego pola, musi najpierw skontaktować się z nami w celu skonfigurowania osobnych marek, w tym domyślnej.

MerchantMatchingHints

Wskazówki, które pomagają 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 służących do opisu Usług dla 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, który dołączył do listy oczekujących za pomocą funkcji Zarezerwuj z Google. Poszczególne pola tekstowe w powiadomieniu powinny mieć długość ograniczoną do 100 bajtów.

EconomicOperator

Opcjonalnie: Informacje o Operatorach ekonomicznych powiązane z tym konkretnym sprzedawcą niezbędne do zapewnienia zgodności z przepisami. (opcjonalnie)

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ą listy oczekujących.

PlaceInfo

Dopasowane dane geograficzne dotyczące miejsca tego sprzedawcy. Pusty, jeśli sprzedawca nie został dopasowany pod względem lokalizacji.

LocalServicesMatchInfo

Usługi Lokalne – dopasowanie dotyczące 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 reklama zostanie wyświetlona sprzedawcy.

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). Przykład: „hydraulik” i „czyszczenie_dywanów”.

string

Nazwa miejsca.

string

Sformatowany adres w języku lokalnym.

string

Identyfikator miejsca w Google. Może służyć do tworzenia adresów URL Map Google lub pobierania dodatkowych informacji o miejscu. Przykłady 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 faktycznie obsłużony.

Money

Minimalna kwota.

Money

Maksymalna kwota.

Price

Kwota, która może zostać naliczona użytkownikowi, jeśli nie stawi się w miejscu 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, których dotyczy to zamówienie.

LineItem

Elementy tego zamówienia.

FulfillmentOption

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

PrepaymentStatus

Stan przedpłaty za rezerwację. Jeśli wartość prepayment_status to 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 identyfikowania tej opcji płatności.

Ten identyfikator jest globalny dla całego agregatora, a ponowne użycie wartości w przypadku 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 sprawdzoną metodą jest używanie identycznych wartości identyfikatorów we wszystkich opcjach płatności, które są zawsze aktualizowane, aby uniknąć jakichkolwiek działań podważających bezpieczeństwo.

string

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

string

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

Price

Cena opcji płatności.

TaxRate

Stawka podatku dla tej opcji płatności. Jeśli to pole jest dostępne, zastępuje pole tax_rate w Merchant lub Service. 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 użyć tej opcji płatności. Dotyczy tylko sesji wielokrotnych lub pakietów, w których wartość powinna być większa niż 1.

TimeRange

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

TimeRange

W tym przedziale czasowym można korzystać z opcji płatności (np. cena specjalna w styczniu 2017 r.). Jeśli jest podany, zastępuje atrybuty valid_duration i activation_type.

Duration

Czas 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 liczbę użytkowników kwalifikujących się do zakupu za pomocą tej opcji płatności. Można go użyć do ograniczenia opcji płatności promocyjnych do podzbioru użytkowników. Jeśli nie jest ustawiony, wszyscy użytkownicy kwalifikują się do korzystania 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.

W przypadku 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 wypełnione, przyjmujemy, ż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, która trafia do obiektu.

Price

Podatki za bilet.

string

Kraj podany w postaci dwuliterowego kodu kraju zgodnego ze standardem ISO 3166-1 alfa-2, np. „US” (wymagany).

string

Rejon, np. „Mountain View”. (wymagane)

string

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

string

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

string

Adres ulicy, np. „1600 Amphitheatre Parkway”. (wymagane)

PriceInfo

Pojemnik na szczegóły dotyczące cen.

int64

Cena w mikrojednostkach waluty. Ułamki najmniejszej jednostki waluty będą zaokrąglane do najbliższej liczby całkowitej. (np. 2,5 centa zaokrąglane do 2 centów, 3,5 centa zaokrąglane do 4 centów, 0,5 centa zaokrąglane do 0 centów, 2,51 centa zaokrąglane do 3 centów).

string

Waluta, w której podano cenę, zdefiniowana w ISO 4217.

string

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

PriceType

Określa sposób stosowania ceny lub przedziału cenowego (za osobę lub stała cena).

Price

Cena usługi lub opłata.

PriceRange

Górna lub dolna granica opłaty za usługę.

Price

Minimalna kwota.

Price

Maksymalna kwota. Właściwa wartość to zawsze > min_price.

double

Wartość pojedyncza. Na 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

Wartość średniej 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 będzie indeksować multimedia hostowane pod tym adresem URL.

MediaType

Typ ź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 multimedió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, zalecamy użycie localized_caption.

Text

Tekst z podziękowaniami dla fotografa lub agencji obsługującej i18n. Ten tekst będzie wyświetlany razem z multimediami źródłowymi. Pamiętaj, że w tym polu jest obsługiwany tylko tekst zwykły. Wszystkie elementy HTML zostaną usunięte (przypisywanie na podstawie hiperlinków nie jest obsługiwane).

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 być też stabilny w czasie, aby można było go porównać z poprzednimi rezerwacjami. To pole musi być obecne, jeśli jest obecne pole staff_name.

string

Opcjonalnie 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 występuje pole staff_id.

string

Opcjonalny identyfikator pokoju, w którym znajduje się usługa. To pole identyfikuje salę we wszystkich sprzedawcach, usługach i rekordach dostępności. Musi też być stabilny w czasie, aby umożliwić korelację z wcześniejszymi rezerwacjami. To pole musi być obecne, jeśli występuje pole room_name.

string

Opcjonalna nazwa pokoju, w którym znajduje się usługa. To pole będzie wyświetlane użytkownikom dokonującym rezerwacji i powinno być zrozumiałe dla człowieka, a nie zaciemnionym identyfikatorem. (opcjonalnie, ale wymagane, jeśli występuje parametr room_id) W przypadku restauracji nazwa pokoju powinna być używana tylko w przypadku miejsc siedzących, takich jak bar lub patio, i nie powinna być używana w przypadku menu z ustaloną ceną, specjalnych zajęć ani innych wartości niezwiązanych z pokojem (takich jak rezerwacja czy kolacja). Zdecydowanie zalecamy, aby domyślny kącik wypoczynkowy nie był powiązany z pomieszczeniem.

int32

Dotyczy tylko restauracji: liczba osób, które mogą zjeść w danym czasie. Restauracja może być powiązana z wieloma slotami w tym samym czasie, z których każdy określa inną wartość party_size, jeśli na przykład w rezerwacji mogą siedzieć 2, 3 lub 4 osoby.

Text

Opcjonalnie: zlokalizowany opis pokoju, Jeśli jest ustawione, należy podać wartość domyślną. Zaleca się również podanie języków używanych w regionie sprzedawcy. (opcjonalnie)

int64

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

Price

Opłata za anulowanie w minimalnym okresie zapowiedzi.

Price

Opłata za niestawienie się bez anulowania.

AdmissionPolicy

Zasady opłaty za korzystanie z danej usługi. Jeśli nie jest ustawione, przyjmuje wartość domyślną TIME_STRICT. (opcjonalnie)

CancellationPolicy

Zasady anulowania reguł harmonogramu. (wymagany w przypadku listy zadań)

int64

Czas (w sekundach) od momentu, gdy można dokonać ostatniej rezerwacji, do momentu rozpoczęcia okresu dostępności.

int64

Czas (w sekundach) od momentu, gdy można dokonać ostatniej rezerwacji, do momentu zakończenia okresu 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”. Wycofany, użyj zamiast niego parametru localized_service_name.

Text

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

string

Opis usługi widoczny dla użytkownika. Wycofany, użyj atrybutu localized_description.

Text

Opis usługi widoczny dla użytkownika.

To pole obsługuje formatowanie w postaci zwykłego tekstu i w formacie HTML. W odróżnieniu od sekcji z zwykłym tekstem możesz tu tworzyć niestandardowe układy za pomocą nagłówków, akapitów, list i niektórych tagów fraz. 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 kod <h1>Itinerary</h1> spowoduje wyświetlenie tekstu wstawianego jako najważniejszy nagłówek sekcji. Pamiętaj, że wszystkie wewnętrzne tagi HTML, style i atrybuty zostaną zignorowane. Na przykład element <h1 style=".."> będzie traktowany tak samo jak element <h1>. Zachowany zostanie tylko sam tekst.

Tag akapitu: <p>
Służy do wyróżniania szczegółowego wprowadzenia lub treści. Wszystkie tagi wewnętrzne, style i atrybuty zostaną zignorowane, z kilkoma wyjątkami: <br>, <strong> i <em>. Więcej informacji znajdziesz w sekcji dotyczącej tagów fraz.

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 potrzeb.
Przykład: aby wyświetlić listę funkcji wycieczki statkiem:
<ol>
<li>Wspaniały widok na ocean i możliwość obcowania z dziką przyrodą.</li>
<li>Starannie opracowane usługi i usługi podróżnicze.</li>
<li>Gwarantowana najniższa cena.</li>
</ol>
Pamiętaj, że tylko elementy <li> pod tagami <ul> lub <ol> zostaną przekonwertowane. Wszystkie pozostałe potomki zostaną odrzucone. 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> zostaną przeanalizowane zgodnie z powyższymi regułami, co oznacza, że sam tag <div> nie oznacza żadnego grupowania ani wcięcia. 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 frazy zostaną zignorowane.

Nieobsługiwane tagi:

• <html>, <header> i <body> tagi są niedozwolone.
• Pozostałe 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.
  
• Zalecana maksymalna długość to 32 tys. znaków.

Price

Cena usługi.

PriceInterpretation

Opisuje, jak cena jest interpretowana i wyświetlana użytkownikowi. Moż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 momentu, w którym płatność w wysokości zaliczki zostanie zrealizowana.

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 z prośbą o dodatkowe informacje od użytkownika podczas rezerwacji tej usługi; Ten formularz musi zostać wypełniony 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ę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ą definiowane 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ć naliczona użytkownikowi. Zastępuje opłatę za niestawienie się, jeśli została określona. Ustawienie pustego komunikatu NoShowFee powoduje usunięcie wszelkich opłat za brak udziału na poziomie usługi. (opcjonalnie)

RequireCreditCard

Wskazuje, czy użytkownik musi podać dane karty kredytowej, aby zarezerwować tę usługę. To pole można zastąpić na poziomie dostępności. (opcjonalnie)

ActionLink

Link do działania powiązany z tą usługą. Jeśli 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ć/kupić w ramach tej usługi (jeśli 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, które mają zastosowanie do tej usługi (opcjonalnie). Każda usługa może mieć 0 lub więcej wartości dla każdego atrybutu usługi zdefiniowanego w odpowiednim sprzedawcy. (opcjonalnie)

WaitlistRules

Zasady dołączania do listy oczekujących

TicketingVerticalSpecificData

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

IntegrationType

Głębokość integracji obsługiwanej przez tę usługę. (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 dotyczące wycieczek i atrakcji.

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, która obejmuje 3 miejsca, musisz podać miejsce rozpoczęcia wycieczki. – wycieczka autobusowa, która rozpoczyna się w holu hotelu, a potem uczestnicy udają się do zwiedzanego obiektu. Należy określić lokalizację spotkania.

Rating

Ocena użytkowników tego serwisu jako dane zbiorcze obejmujące wszystkie opinie.

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.

UriTemplate

Opcjonalnie: Opcjonalny szablon określający sposób generowania adresów URL do zewnętrznej witryny przez Google.

ChargeTiming

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

int64

Czas w sekundach przed czasem rozpoczęcia usługi, za który użytkownik jest obciążany opłatą. To pole powinno być ustawione tylko wtedy, gdy pole 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. „Account Type” (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 zdefiniowany w 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ć zastosowana reguła. 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 pełnego zaktualizowania dostępności w danym zakresie czasowym.

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 identyfikatora zasobów muszą być identyczne.

Availability

Nowa lista dostępności.

ServiceIntakeFormField

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

bool

Jeśli to pole ma wartość Prawda, formularz będzie wyświetlany 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. Wycofane. Zamiast tego używaj elementu localized_label.

Text

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

string

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

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

Text

dodatkowe opcje oprócz podanych wartości; 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 się wyświetlać tylko wtedy, gdy użytkownik rezerwuje określone typy biletów, to pole powinno być ustawione jako zbiór odpowiednich identyfikatorów typów biletów. Pozostaw to pole puste, jeśli pytanie jest zawsze stosowane.

Text

Tekst podpowiedzi dla danych wejściowych, który wyświetla się jako obiekt zastępczy tekstu. Dotyczy to tylko pól typu SHORT_ANSWER lub PARAGRAPH. (opcjonalnie)

int32

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

Jeśli to pole jest nieskonfigurowane lub ma wartość 0, łączna cena, którą płaci użytkownik za dowolną usługę świadczoną przez tego sprzedawcę, to dokładna cena określona przez parametr 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 jest ustawione na dowolną wartość niezerową, łączna cena obciążająca użytkownika za dowolną usługę świadczoną przez tego sprzedawcę będzie obejmować cenę usługi oraz podatek obliczany według podanego tu stawki podatku. Ułamki najmniejszej jednostki waluty (np. ułamki jednego centa) będą zaokrąglane do najbliższej parzystej liczby. Podatki będą wyświetlane użytkownikowi jako osobny element zamówienia.

string

Opcjonalnie adres URL strony z Warunkami korzystania z usługi.

string

Tekst wyświetlany użytkownikowi. W przypadku nowych integracji użyj elementu localized_text poniżej.

Text

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

string

Wartość tekstowa w nieznanym regionie. Wymagane tylko wtedy, gdy pole localized_value jest puste. 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 poszczególnych lokalizacji. Opcjonalnie:

string

Identyfikator zgłoszenia służy do rozróżniania różnych typów zgłoszeń w ramach tej samej usługi i powinien być unikalny tylko w ramach tej usługi.

string

Krótki opis tego typu biletu.

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

Text

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

Może być ona widoczna dla użytkownika, na przykład: „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 regionu można podać osobne wartości.

Price

Cena pojedynczego biletu tego typu bez podatków. Stawka podatku od usługi jest stosowana do biletów.

PerTicketFee

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

PriceDisplayType

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

string

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

Text

Opis dodatkowych opcji, które reprezentuje ten typ biletu (jeśli występują). Dla każdego języka można podać oddzielne wartości.

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

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: &quot;adult&quot; } localized_option_description { value: &quot;english&quot; } } - { ticket_type_id: &quot;ticket_type_2&quot; localized_short_description { value: &quot;adult&quot; } localized_option_description { value: "spanish" } } – {ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: &quot;english&quot; } } - { ticket_type_id: &quot;ticket_type_4&quot; localized_short_description { value: "child" } localized_option_description { value: "spanish" }

Przykład 2.: wynajem kajaka na kilka godzin z opcjonalnym dodatkowym wyposażeniem w postaci worka suchego. W tym przypadku short_description może być „3 godziny”, a option_description może być „z workiem suchym” lub „bez worka suchego”: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

Opcjonalne, ale jeśli 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”.

InventoryType

Opcjonalnie: Z góry określony typ zasobów reklamowych pojedynczego biletu tego typu.

EventCategory

Kategoria wydarzenia. Ustaw tylko wtedy, gdy zdarzenie mieści się w jednej z wstępnie zdefiniowanych kategorii. (opcjonalnie)

string

Adres URL wydarzenia 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: Organizator, który organizuje wydarzenie.

string

Opcjonalnie: Adres URL organizatora, który prowadzi wydarzenie.

OrganizerType

Opcjonalnie: Typ organizatora.

string

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

EventState

Opcjonalnie: Stan zdarzenia.

Text

Opcjonalnie: Zlokalizowana nazwa marki.

EventCreator

Opcjonalnie: Informacje o twórcy zdarzenia.

string

Unikalny identyfikator podmiotu w bazie danych partnera. (opcjonalnie)

string

Nazwa elementu. (wymagane)

string

Adres URL strony internetowej, która jednoznacznie opisuje dany podmiot. Strona w witrynie partnera, która dotyczy danego podmiotu (jeśli istnieje). W przypadku innych publicznych adresów URL podmiotu użyj atrybutu relevant_url w polu public_identification_data. (opcjonalnie)

EntityType

Typ elementu. (opcjonalnie)

EntityRole

Rola elementu w zdarzeniu. (opcjonalnie)

PublicIdentificationData

publiczne odniesienia do podmiotu; (opcjonalnie)

string

Opcjonalnie: Nazwa konta twórcy zdarzenia. Brak ograniczeń dotyczących znaków.

string

Publiczny adres URL dowolnej strony internetowej poświęconej tylko tematowi. Mogą to być oficjalne strony internetowe, discogs, 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

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

Timestamp

Dolna granica zakresu czasowego.

Timestamp

Górna granica zakresu czasowego.

map<string, string>

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

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

Przykład Braintree: 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: &quot;braintree:merchantId&quot; 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: &quot;gatewayMerchantId&quot; 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.