- Zasób: Sprzedawca
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig (w języku angielskim)
- Procesor
- TokenizationConfig
- BillingInformationFormat
- Warunki
- MerchantMatchingHints
- ServiceAttribute
- Wartość
- Porada
- Metody
Zasób: Sprzedawca
Informacje o sprzedawcy, który korzysta z platformy pośrednika.
Zapis JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
Pola | |
---|---|
name |
Nazwa zasobu sprzedawcy w formacie |
merchantName |
Parametr merchantName, numer telefonu, adres URL i dane geograficzne służą do dopasowania asortymentu partnera do sprzedawców, którzy już znajdują się w Mapach Google. Te informacje nie będą wyświetlane. Nazwa sprzedawcy. |
telephone |
Publiczny numer telefonu sprzedawcy wraz z jego krajem i numerem kierunkowym, np. +14567891234. |
url |
Adres URL publicznej witryny sprzedawcy. |
geo |
Dane geograficzne sprzedawcy, w tym szerokość i długość geograficzną oraz adres. |
category |
Kategoria firmy na platformie agregatora. |
numBookings30d |
To pole zostało wycofane. |
taxRateBasisPoints |
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. Zamiast niego użyj stawki taxRate. |
taxRate |
Stawka podatku sprzedawcy. Jeśli to pole jest obecne, zastępuje wycofane pole taxRateBasisPoints. Pusta wiadomość (np. stawka podatku { }) 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ć. |
brandId |
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?
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. |
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 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; |
waitlistAdvisement |
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. |
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 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. |
CreditCardRestrictions
Ograniczenia dotyczące typów kart kredytowych akceptowanych przez tego sprzedawcę.
Zapis JSON |
---|
{
"creditCardType": [
enum ( |
Pola | |
---|---|
creditCardType[] |
Listę obsługiwanych kart kredytowych. Jeśli pole jest puste, żadne karty kredytowe nie są obsługiwane. |
CreditCardType
Typ karty kredytowej.
Wartości w polu enum | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Nieużywane. |
VISA |
kartę kredytową Visa, |
MASTERCARD |
karty kredytowej Mastercard. |
AMERICAN_EXPRESS |
Kartę kredytową American Express. |
DISCOVER |
karty kredytowej Discover. |
JCB |
karty kredytowej JCB. |
PaymentOption
Opcja płatności, która umożliwia płacenie za usługi świadczone przez sprzedawców. Opcje płatności mogą być współdzielone przez wielu sprzedawców (np. sprzedawców 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 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ń. |
name |
Nazwa opcji płatności. Może to być widoczne dla użytkownika. |
description |
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ąpi ono pole taxRate w sekcji Sprzedawca lub Usługę. Pusta wiadomość (np. stawka podatku { }) 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. |
sessionCount |
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. |
purchaseInterval |
Opcję płatności można kupić w tym przedziale czasu. |
validInterval |
Tej opcji płatności można użyć w tym przedziale czasu (np.specjalna cena za styczeń 2017 r.). Jeśli ta opcja występuje, zastępuje wartości validDuration i activateType. |
validDuration |
Okres ważności opcji płatności (np. 30-dniowa subskrypcja). Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
activationType |
Określa, jak określa się datę rozpoczęcia ważności dla tej opcji płatności. |
userRestriction |
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. |
PaymentOptionType
Typ opcji płatności.
Wartości w polu enum | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Nieużywane. |
PAYMENT_OPTION_SINGLE_USE |
Opcji płatności można użyć tylko raz. |
PAYMENT_OPTION_MULTI_USE |
Można użyć opcji płatności, jeśli liczba sesji jest większa niż 0. |
PAYMENT_OPTION_UNLIMITED |
Opcji płatności można użyć w ramach jej prawidłowego zakresu czasowego – liczba sesji jest niewłaściwa. |
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 |
Okres ważności rozpoczyna się w momencie zakupu. |
ACTIVATION_ON_FIRST_USE |
Ważny jest od chwili pierwszego użycia opcji płatności. |
UserPurchaseRestriction
Ogranicza użytkowników, którzy mogą kupić daną opcję płatności.
Zapis JSON |
---|
{ "newToMerchant": boolean, "newToPaymentOption": boolean } |
Pola | |
---|---|
newToMerchant |
Jest to opcja płatności dostępna tylko dla użytkowników, którzy nigdy wcześniej nie dokonali zakupu u tego samego sprzedawcy. |
newToPaymentOption |
Opcja płatności, którą mogą kupić tylko użytkownicy, którzy nigdy wcześniej nie korzystali z tej samej opcji płatności. |
PaymentProcessorConfig
Konfiguracja firmy obsługującej płatności, konfigurowana dla poszczególnych sprzedawców.
Zapis JSON |
---|
{
"processor": enum ( |
Pola | |
---|---|
processor |
Określa partnera obsługującego płatności, którego dotyczy ta konfiguracja. |
publicKey |
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. |
version |
Numer wersji interfejsu API wysyłany do podmiotu obsługującego płatności wraz z żądaniami płatności. |
Procesor
Określa 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 dla firm obsługujących płatności wyznaczona dla poszczególnych sprzedawców.
Zapis JSON |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
Pola | |
---|---|
tokenizationParameter |
Konfiguracja tokenizacji zwykle zawiera jeden parametr tokenizationParameter, 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. Przykład Braintree: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "defraintree:abcxxId" value} Przykład w Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" } Przykład w Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "Twój_id" } Obiekt zawierający listę par |
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. |
BillingInformationFormat
Jaka część adresu rozliczeniowego jest wymagana od użytkownika i którą należy uwzględnić w tokenie. Wartości wyliczeniowe odpowiadają parametrom w Google Pay API (patrz 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 oraz kod pocztowy. |
Terminy
Zestaw zasad i wytycznych, które są wyświetlane użytkownikowi, gdy chce zrobić rezerwację przez Zarezerwuj z Google.
Zapis JSON |
---|
{
"url": string,
"text": string,
"localizedText": {
object ( |
Pola | |
---|---|
url |
Opcjonalnie adres URL Warunków korzystania z usługi. |
text |
Tekst, który będzie wyświetlany użytkownikowi. W przypadku nowych integracji używaj poniższego tekstu localizedText. |
localizedText |
Zlokalizowany tekst wyświetlany użytkownikowi. |
MerchantMatchingHints
Wskazówki, które pomagają Google dopasować sprzedawcę do miejsca w Mapach Google.
Zapis JSON |
---|
{ "placeId": string } |
Pola | |
---|---|
placeId |
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. |
ServiceAttribute
Atrybuty usług to kategorie zdefiniowane przez partnerów, które opisują Usługi w imieniu Sprzedawcy. Bank może np. zdefiniować atrybut usługi „Typ konta” z możliwymi wartościami „Osobiste” i „Firmowe”, natomiast salon fryzjerski może zdefiniować atrybut „Rodzaj 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 tego samego sprzedawcy, np. „account-type”. |
attributeName |
Nazwa tego atrybutu widoczna dla użytkownika, np. „Typ konta”. |
value[] |
Wszystkie możliwe wartości tego atrybutu usługi. |
Wartość
Reprezentuje możliwą wartość konkretnego atrybutu usługi.
Zapis JSON |
---|
{ "valueId": string, "valueName": string } |
Pola | |
---|---|
valueId |
Identyfikator, który jednoznacznie identyfikuje tę wartość wśród innych atrybutów usługi, np. „osobisty”. |
valueName |
Widoczna dla użytkownika nazwa wartości, np. „Osobiste”. |
Doradztwo
Porady wyświetlane użytkownikowi podczas dokonywania rezerwacji przez funkcję Zarezerwuj z Google.
Zapis JSON |
---|
{
"text": {
object ( |
Pola | |
---|---|
text |
Niestandardowa wiadomość, która ma się wyświetlać użytkownikowi podczas dokonywania rezerwacji przez funkcję Zarezerwuj z Google. |
Metody |
|
---|---|
|
Tworzy nowy element Merchant zarządzany przez określonego pośrednika i zwraca go. |
|
Usuwa istniejący obiekt Merchant zarządzany przez określonego pośrednika. |
|
Uzyskaj MerchantStatus w: Merchant . |
|
Aktualizuje istniejący obiekt Merchant zarządzany przez określonego pośrednika i zwraca go. |