- Zasób: sprzedawca
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- Procesor
- TokenizationConfig
- BillingInformationFormat
- Warunki
- MerchantMatchingHints
- ServiceAttribute
- Wartość
- Rekomendacja
- Metody
Zasób: sprzedawca
informacje o sprzedawcy, który korzysta z platformy agregatora;
Zapis JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
Pola | |
---|---|
name |
Nazwa zasobu sprzedawcy w formacie |
merchantName |
Nazwa merchantName, numer telefonu, adres URL i dane geograficzne są używane 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. |
telephone |
Publiczny numer telefonu sprzedawcy wraz z numerem kraju i numeru kierunkowego, np. +14567891234. |
url |
Adres URL publicznej witryny sprzedawcy. |
geo |
Dane geograficzne sprzedawcy, w tym szerokość i długość geograficzną oraz adres. |
category |
Kategoria działalności na platformie agregatora. |
numBookings30d |
To pole zostało wycofane. |
taxRateBasisPoints |
Stawka podatku ustalona przez sprzedawcę w punktach podstawowych (setna część jednego procenta). Jeśli np.stawka podatku wynosi 7, 5%, w tym polu należy ustawić wartość 750. Jeśli to pole jest nieskonfigurowane lub ma wartość 0, łączna cena, jaką użytkownik ponosi za usługi świadczone przez tego sprzedawcę, jest dokładną ceną określoną za pomocą atrybutu Service.price. Zakładamy, że cena usługi jest zwolniona z obowiązujących podatków lub będzie już obejmować obowiązujące podatki. Podatki nie będą wyświetlane użytkownikowi jako osobna pozycja. Jeśli to pole ma wartość inną niż zero, łączna cena, jaką użytkownik ponosi za dowolną usługę świadczoną przez tego sprzedawcę, będzie zawierać cenę usługi powiększoną o podatek obliczony na podstawie podanej tu stawki podatku. Ułamki z najmniejszej jednostki waluty (np. ułamek jednego centa) są zaokrąglane przy użyciu zaokrągleń równomiernych. Podatki będą widoczne dla użytkownika jako osobna pozycja. To pole zostało wycofane. Zamiast niego użyj stawki taxRate. |
taxRate |
Stawka podatku ustalona przez sprzedawcę. Jeśli to pole jest obecne, zastępuje wycofane pole taxRateBasisPoints. Pusty komunikat (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera. |
paymentRestrictions |
Ograniczenia dotyczące form płatności akceptowanych przez tego sprzedawcę. Jeśli to pole nie jest skonfigurowane, zakładamy, że nie ma żadnych ograniczeń. |
paymentOption[] |
Opcje płatności dostępne w przypadku tego sprzedawcy. Usługi tego sprzedawcy będą mogły pojedynczo ograniczać opcje płatności dostępne dla niego. |
paymentProcessorConfig |
Konfiguracja dla tokenizowanej firmy obsługującej płatności, jeśli sprzedawca ją obsługuje. |
tokenizationConfig |
Konfiguracja dla tokenizowanej firmy obsługującej płatności, jeśli sprzedawca ją obsługuje. |
terms |
Warunki korzystania z usługi konkretnego sprzedawcy wyświetlane użytkownikowi, gdy usługa Zarezerwuj z Google została zarezerwowana przez Zarezerwuj z Google. Dodatkowo Warunki korzystania z usługi partnera pośredniczącego są zawsze wyświetlane użytkownikowi i nie można ich tu podawać. |
brandId |
Nieprzezroczysty ciąg znaków określający markę widoczną dla klientów, która ma być używana do wyświetlania atrybucji partnera. Dzięki tym polu partnerzy z wieloma markami przeznaczonymi dla konsumentów mogą udostępniać informacje o sprzedawcach dla wszystkich marek w tym samym pliku danych. Marka składa się z właściwości przeznaczonych dla użytkowników, takich jak nazwa, logo, Warunki korzystania z usługi i Polityka prywatności. Jeśli istnieje tylko 1 marka partnera widoczna dla konsumentów, nie trzeba ustawiać tego pola i można je zignorować. Jeśli partner... Nie ma wielu marek przeznaczonych dla konsumentów? --> Zignoruj to pole Masz skonfigurowanych kilka marek?
Uwaga: większość partnerów nie musi ustawiać tego pola. Jeśli partner chce użyć tego pola, musi najpierw się z nami skontaktować, aby skonfigurować oddzielne marki, w tym markę domyślną. |
matchingHints |
Wskazówki, które pomogą Google dopasować sprzedawcę do miejsca w Mapach Google. Uwaga: większość partnerów nie musi ustawiać tego pola, ponieważ na podstawie podanych wyżej informacji Google dopasuje sprzedawców do miejsc w Mapach Google. (opcjonalnie) |
serviceAttribute[] |
Definicje wszystkich atrybutów usługi służących do opisania Usług danego Sprzedawcy. (opcjonalnie) |
actionLink[] |
Opcjonalnie: adres URL działania wraz z powiązanym językiem, listą krajów ograniczonych do, typem i opcjonalną platformą wskazującą, na której platformie należy wykonać działanie; |
waitlistAdvisement |
Opcjonalnie: Ogólne porady od konkretnego sprzedawcy dla użytkownika dołączającego do listy oczekujących w Zarezerwuj z Google. Długość poszczególnych pól tekstowych w poleceniu nie może przekraczać 100 bajtów. |
PaymentRestrictions
Ograniczenia dotyczące form płatności akceptowanych przez tego sprzedawcę.
Zapis JSON |
---|
{
"creditCardRestrictions": {
object ( |
Pola | |
---|---|
creditCardRestrictions |
Ograniczenia dotyczące kart kredytowych akceptowanych przez tego sprzedawcę. Jeśli to pole nie jest podane, uznajemy, że akceptowane są wszystkie karty kredytowe. Pamiętaj, że lista kart obsługiwanych przez CreditCardType będzie się z czasem powiększać, co oznacza, że pozostawienie tych pustych pól będzie wymagało wprowadzenia w przyszłości zmian w konfiguracji. |
CreditCardRestrictions
Ograniczenia dotyczące typów kart kredytowych, które akceptuje ten sprzedawca.
Zapis JSON |
---|
{
"creditCardType": [
enum ( |
Pola | |
---|---|
creditCardType[] |
Lista obsługiwanych kart kredytowych. Jeśli to pole jest puste, nie są obsługiwane żadne karty kredytowe. |
CreditCardType
Typ karty kredytowej.
Wartości w polu enum | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Nieużywane. |
VISA |
Karta kredytowa Visa. |
MASTERCARD |
Karta kredytowa Mastercard |
AMERICAN_EXPRESS |
kartę kredytową American Express; |
DISCOVER |
kartę kredytową Discover, |
JCB |
Karta kredytowa JCB. |
PaymentOption
Opcja płatności, która może być używana do opłacania usług świadczonych przez sprzedawcę. Opcje płatności mogą być dostępne dla wielu sprzedawców (np. należących do tej samej sieci).
Zapis JSON |
---|
{ "paymentOptionId": string, "name": string, "description": string, "price": { object ( |
Pola | |
---|---|
paymentOptionId |
Ten identyfikator służy do identyfikacji tej opcji płatności. Ten identyfikator jest globalny dla całego agregatora, a ponowne użycie wartości u wielu sprzedawców umożliwi użytkownikowi płatność za pomocą odpowiedniej opcji płatności u tych sprzedawców. Zaktualizowanie wartości opcji płatności u jednego sprzedawcy powoduje też zaktualizowanie każdej opcji płatności z tym samym identyfikatorem u innego sprzedawcy. Dlatego najlepiej jest, aby wszystkie opcje płatności miały ten sam identyfikator i miały zawsze identyczne wartości. Pozwala to uniknąć ryzyka zaniżania ryzyka. |
name |
Nazwa opcji płatności. Może być widoczny dla użytkownika. |
description |
Opis opcji płatności. Może być widoczny dla użytkownika. |
price |
Cena opcji płatności. |
taxRate |
Stawka podatku dla tej opcji płatności. Jeśli to pole jest obecne, zastępuje pole taxRate w usłudze sprzedawcy lub usłudze. Pusty komunikat (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki 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. |
sessionCount |
Liczba sesji, w których można wykorzystać tę opcję płatności. Obowiązuje tylko w przypadku wielu sesji / pakietów, gdzie wartość powinna wynosić > 1. |
purchaseInterval |
W tym okresie możesz kupić tę opcję płatności. |
validInterval |
W tym przedziale czasu możesz używać opcji płatności (np.specjalna cena za styczeń 2017 r.). Jeśli ta opcja jest dostępna, zastępują one wartości validDuration i ActivationType. |
validDuration |
Okres ważności opcji płatności (np. 30-dniowa subskrypcja). Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „ |
activationType |
Określa sposób określania daty rozpoczęcia ważności przez tę opcję płatności. |
userRestriction |
Ogranicza dostęp do użytkowników, którzy mogą kupić tę opcję płatności. Pozwala ograniczyć możliwość korzystania z opcji płatności w promocji tylko do wybranej grupy użytkowników. Jeśli jej nie skonfigurujesz, wszyscy użytkownicy będą mogli korzystać z tej funkcji. |
PaymentOptionType
typ opcji płatności.
Wartości w polu enum | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Nieużywane. |
PAYMENT_OPTION_SINGLE_USE |
Z tej opcji płatności można skorzystać tylko raz. |
PAYMENT_OPTION_MULTI_USE |
Możesz użyć opcji płatności, jeśli liczba sesji > 0. |
PAYMENT_OPTION_UNLIMITED |
Z opcji płatności można korzystać w prawidłowym przedziale czasu – liczba sesji jest nieodpowiednia. |
ActivationType
Określa sposób określania daty rozpoczęcia ważności.
Wartości w polu enum | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Nieużywane. |
ACTIVATION_ON_PURCHASE |
Ważność rozpoczyna się w chwili zakupu. |
ACTIVATION_ON_FIRST_USE |
Okres ważności rozpoczyna się, gdy dana opcja płatności jest używana po raz pierwszy. |
UserPurchaseRestriction
Ogranicza dostęp do użytkowników, którzy mogą kupić daną opcję płatności.
Zapis JSON |
---|
{ "newToMerchant": boolean, "newToPaymentOption": boolean } |
Pola | |
---|---|
newToMerchant |
Opcja płatności, którą mogą kupić tylko użytkownicy, którzy nigdy wcześniej nie robili zakupów u tego samego sprzedawcy. |
newToPaymentOption |
Opcję płatności, którą mogą kupić tylko użytkownicy, którzy nigdy wcześniej nie kupili tej samej opcji płatności. |
PaymentProcessorConfig
Konfiguracja dla firmy obsługującej płatności, konfigurowana dla każdego sprzedawcy.
Zapis JSON |
---|
{
"processor": enum ( |
Pola | |
---|---|
processor |
Określa partnera obsługującego płatności, którego dotyczy ta konfiguracja. |
publicKey |
Klucz, który posłużył do identyfikacji tego sprzedawcy w firmie obsługującej płatności. Informacje o Stripe: https://stripe.com/docs/dashboard#api-keys (w przypadku Braintree): https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
Numer wersji interfejsu API wysyłany do firmy obsługującej płatności wraz z żądaniami płatności. |
Procesor
Definiuje konkretnego partnera obsługującego płatności.
Wartości w polu enum | |
---|---|
PROCESSOR_UNSPECIFIED |
Nieużywane |
PROCESSOR_STRIPE |
Konfiguracja płatności za pomocą Stripe. |
PROCESSOR_BRAINTREE |
Konfiguracja płatności w Braintree. |
TokenizationConfig
Konfiguracja tokenizacji podmiotu przetwarzającego płatności dla każdego sprzedawcy.
Zapis JSON |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
Pola | |
---|---|
tokenizationParameter |
Konfiguracja tokenizacji zwykle ma jeden parametr tokenizationParameter, którego kluczem jest „gateway” a wartością jest nazwa procesora. Pozostałe parametry zależą od procesora. Więcej informacji znajdziesz w dokumentacji Google Pay. Przykład Braintree: tokenizationParameter { key: "gateway" value: „braintree” } tokenizationParameter { klucz: "braintree:apiVersion" value: „v1” } tokenizationParameter { key: "braintree:sdkVersion" value: „2.30.0” } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { klucz: "braintree:clientKey" value: „production_xxx_yyy” Przykład Stripe: tokenizationparameter { key: "gateway" value: "paski" } tokenizationParameter { key: "stripe:wersja" value: „28-02-2018” } tokenizationParameter { key: "stripe:publishableKey" value: „pk_1234” Przykład w Adyen: tokenizationparameter { key: "gateway" wartość: „adyen” } tokenizationParameter { key: "gatewayMerchantId" value: "TwójId" Obiekt zawierający listę par |
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. |
BillingInformationFormat
Długość adresu rozliczeniowego, która ma być wymagana od użytkownika i która powinna znajdować się w tokenie. Wartości wyliczeniowe odpowiadają parametrom w Google Pay API (zobacz https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
Wartości w polu enum | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
Nie określono. Domyślna wartość to MIN. |
MIN |
imię i nazwisko, kod kraju i kod pocztowy (domyślne ustawienie Google Pay). |
FULL |
imię i nazwisko, ulicę i numer domu, miejscowość, region, kod kraju i kod pocztowy. |
Warunki
Zestaw reguł i wytycznych wyświetlanych użytkownikowi, który umożliwia dokonanie rezerwacji w Zarezerwuj z Google.
Zapis JSON |
---|
{
"url": string,
"text": string,
"localizedText": {
object ( |
Pola | |
---|---|
url |
Opcjonalnie adres URL do Warunków korzystania z usługi. |
text |
Tekst, który ma zostać wyświetlony użytkownikowi. W przypadku nowych integracji użyj narzędzia localizedText poniżej. |
localizedText |
Zlokalizowany tekst, który będzie wyświetlany użytkownikowi. |
MerchantMatchingHints
Wskazówki pomagające Google dopasować sprzedawcę do miejsca w Mapach Google.
Zapis JSON |
---|
{ "placeId": string } |
Pola | |
---|---|
placeId |
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. |
ServiceAttribute
Atrybuty usług to zdefiniowane przez partnerów kategorie, które opisują Usługi danego Sprzedawcy. Na przykład bank może zdefiniować „Typ konta” atrybut usługi z możliwymi wartościami „osobisty” i „Firma”, natomiast salon fryzjerski może określić „Typ usługi” atrybutu usługi z możliwymi wartościami „Strzyżenie”, „Kolor” i „Styl”.
Zapis JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
Pola | |
---|---|
attributeId |
Identyfikator, który jednoznacznie identyfikuje ten atrybut usługi wśród innych atrybutów tego samego sprzedawcy, np. „account-type”. |
attributeName |
Widoczna dla użytkownika nazwa tego atrybutu, np. „Typ konta”. |
value[] |
Wszystkie możliwe wartości tego atrybutu usługi. |
Wartość
Reprezentuje możliwą wartość określonego atrybutu usługi.
Zapis JSON |
---|
{ "valueId": string, "valueName": string } |
Pola | |
---|---|
valueId |
Identyfikator, który jednoznacznie identyfikuje tę wartość między innymi dla danego atrybutu usługi, np. „osobiste”. |
valueName |
Widoczna dla użytkownika nazwa wartości, np. „Osobisty”. |
Doradztwo
Porady wyświetlane użytkownikowi w przypadku rezerwacji poprzez Zarezerwuj z Google.
Zapis JSON |
---|
{
"text": {
object ( |
Pola | |
---|---|
text |
Niestandardowa wiadomość wyświetlana użytkownikowi podczas rezerwacji poprzez Zarezerwuj z Google. |
Metody |
|
---|---|
|
Tworzy i zwraca nowy zasób Merchant zarządzany przez określonego pośrednika. |
|
Usuwa istniejącą zasadę Merchant zarządzaną przez określonego pośrednika. |
|
Weź do ręki MerchantStatus : Merchant . |
|
Aktualizuje i zwraca istniejący zasób Merchant , którym zarządza określony pośrednik. |