REST Resource: inventory.partners.merchants

Zasób: Merchant

Informacje o sprzedawcy, który jest na platformie agregatora.

Zapis JSON 
{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "reservationLinkoutTemplate": [
    {
      object (LinkoutTemplate)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}
Pola
name

string

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

string

Atrybuty merchantName, telephone, url i geo są używane do dopasowywania asortymentu partnera do sprzedawców, którzy są już obecni w Mapach Google. Te informacje nie będą wyświetlane.

Nazwa sprzedawcy.
telephone

string

Publiczny numer telefonu sprzedawcy wraz z kodem kraju i numerem kierunkowym, np. +14567891234.
url

string

Adres URL publicznej witryny sprzedawcy.
geo

object (GeoCoordinates)

Informacje geograficzne o sprzedawcy, w tym szerokość i długość geograficzna oraz adres.
category

string

Kategoria firmy na platformie agregatora.
numBookings30d
(deprecated)

string (int64 format)

To pole zostało wycofane.
taxRateBasisPoints
(deprecated)

integer (uint32 format)

Stawka podatku sprzedawcy w punktach bazowych (jedna setna procenta). Jeśli na przykład stawka podatku wynosi 7, 5%, to pole powinno mieć wartość 750.

Jeśli to pole jest nieskonfigurowane lub ma wartość 0, łączna cena pobierana od użytkownika za dowolną usługę świadczoną przez tego sprzedawcę jest dokładnie taka, jak cena określona w polu Service.price. Zakłada się, że cena usługi jest zwolniona z obowiązujących podatków lub już je zawiera. Podatki nie będą wyświetlane użytkownikowi jako osobna pozycja.

Jeśli to pole ma wartość inną niż zero, całkowita cena pobierana od użytkownika za dowolną usługę świadczoną przez tego sprzedawcę będzie obejmować cenę usługi plus podatek obliczony na podstawie podanej tu stawki podatku. Ułamki najmniejszej jednostki waluty (np. ułamki centa) będą zaokrąglane do najbliższej parzystej liczby. Podatki będą wyświetlane użytkownikowi jako osobna pozycja.

To pole zostało wycofane. Zamiast niego używaj pola taxRate.
taxRate
(deprecated)

object (TaxRate)

Stawka podatku sprzedawcy. Jeśli to pole jest obecne, zastępuje wycofane pole taxRateBasisPoints. Pusta wiadomość (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera. Wycofane, ponieważ płatności E2E nie są już obsługiwane.
paymentRestrictions
(deprecated)

object (PaymentRestrictions)

Ograniczenia dotyczące form płatności akceptowanych przez tego sprzedawcę. Jeśli to pole nie jest ustawione, zakładamy, że nie ma ograniczeń. Wycofane, ponieważ płatności E2E nie są już obsługiwane.
paymentOption[]
(deprecated)

object (PaymentOption)

Opcje płatności dostępne u tego sprzedawcy. Usługi w ramach tego sprzedawcy będą mogły indywidualnie ograniczać opcje płatności, które akceptują. Wycofane, ponieważ płatności E2E nie są już obsługiwane.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

Konfiguracja tokenizowanego procesora płatności, jeśli sprzedawca go obsługuje. Wycofane, ponieważ płatności E2E nie są już obsługiwane.
terms

object (Terms)

Warunki konkretnego sprzedawcy wyświetlane użytkownikowi podczas rezerwowania usługi za pomocą Zarezerwuj z Google. Oprócz tego użytkownikowi zawsze wyświetlane są warunki partnera będącego agregatorem, których nie należy tu podawać.
brandId

string

Nieprzejrzysty ciąg znaków, który identyfikuje markę przeznaczoną dla użytkowników, która ma być używana podczas wyświetlania atrybucji partnera. To pole umożliwia partnerom z wieloma markami przeznaczonymi dla użytkowników dostarczanie sprzedawców dla wszystkich marek w tym samym pliku danych.

Marka obejmuje elementy przeznaczone dla użytkowników, takie jak nazwa, logo, Warunki korzystania z usługi i Polityka prywatności.

Jeśli istnieje tylko jedna marka partnera przeznaczona dla użytkowników, nie musisz ustawiać tego pola i możesz je zignorować.

Jeśli partner…

nie ma wielu marek przeznaczonych dla użytkowników; --> Ignoruj to pole

ma skonfigurowanych wiele 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

Ważna uwaga: większość partnerów nie musi ustawiać tego pola. Jeśli partner chce używać tego pola, musi najpierw skontaktować się z nami, aby skonfigurować oddzielne marki, w tym markę domyślną.
matchingHints

object (MerchantMatchingHints)

Wskazówki, które pomogą Google dopasować sprzedawcę do miejsca w Mapach Google. Uwaga: większość partnerów nie musi ustawiać tego pola, ponieważ Google dopasuje sprzedawców do miejsc w Mapach Google na podstawie podanych powyżej informacji. (opcjonalnie)
serviceAttribute[]

object (ServiceAttribute)

Definicje atrybutów usługi używanych do opisywania Usług dla tego Sprzedawcy. (opcjonalnie)
reservationLinkoutTemplate[]

object (LinkoutTemplate)

Opcjonalnie. Szablon linku wyjściowego, który określa, jak Google ma generować adres URL partnera, aby zarezerwować stolik na jego platformie.

Pamiętaj, że jeśli podasz kilka wartości, obecnie używana będzie tylko pierwsza z nich.

Szablon URI obsługuje pola, które będą wypełniane na podstawie wyborów użytkownika dotyczących rezerwacji. Wszystkie wymagane pola są potrzebne do prawidłowego utworzenia adresu URL rezerwacji: * (wymagane) partySize, int: liczba osób, dla których użytkownik prosi o rezerwację. * (wymagane) selected_date_time, data i godzina w formacie ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): godzina, na którą użytkownik chce dokonać rezerwacji. * (opcjonalnie) merchantId, string: identyfikator sprzedawcy, u którego użytkownik chce dokonać rezerwacji. Nie jest wymagany, jeśli szablon zawiera już identyfikator sprzedawcy. * (opcjonalnie) roomId, string: identyfikator pokoju, w którym użytkownik chce dokonać rezerwacji.
waitlistAdvisement

object (Advisement)

Opcjonalnie. Ogólne porady od konkretnego sprzedawcy dla użytkownika, który dołącza do listy oczekujących za pomocą funkcji Zarezerwuj z Google. Długość poszczególnych pól tekstowych w rekomendacji powinna być ograniczona do 100 bajtów.
economicOperator

object (EconomicOperator)

Opcjonalnie. Informacje o podmiocie gospodarczym powiązane z tym konkretnym sprzedawcą, które są wymagane do zachowania zgodności z przepisami. (opcjonalnie)

PaymentRestrictions

Ograniczenia dotyczące form płatności akceptowanych przez tego sprzedawcę.

Zapis JSON 
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
Pola
creditCardRestrictions

object (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 powiększać, co oznacza, że pozostawienie tego pola pustego spowoduje, że konfiguracja będzie podlegać przyszłym zmianom.

CreditCardRestrictions

Ograniczenia dotyczące typów kart kredytowych akceptowanych przez tego sprzedawcę.

Zapis JSON 
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
Pola
creditCardType[]

enum (CreditCardType)

Lista obsługiwanych kart kredytowych. Jeśli to 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 karty kredytowej Visa;
MASTERCARD karta kredytowa Mastercard;
AMERICAN_EXPRESS karta kredytowa American Express;
DISCOVER karta kredytowa Discover,
JCB karta kredytowa JCB;

PaymentOption

Opcja płatności, której można użyć do zapłaty za usługi świadczone przez sprzedawcę. Opcje płatności mogą być udostępniane wielu sprzedawcom (np. sprzedawcom należącym do tej samej sieci).

Zapis JSON 
{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}
Pola
paymentOptionId

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 u wielu sprzedawców umożliwi użytkownikowi zapłacenie za pomocą odpowiedniej opcji płatności u tych sprzedawców.

Jeśli używasz tego samego identyfikatora u wielu sprzedawców, zaktualizowanie dowolnej wartości opcji płatności u jednego sprzedawcy spowoduje też zaktualizowanie każdej innej opcji płatności z tym samym identyfikatorem u innego sprzedawcy. Dlatego sprawdzoną metodą jest przypisanie wszystkim opcjom płatności tego samego identyfikatora i aktualizowanie ich do identycznych wartości, aby uniknąć nieprzewidywalnego działania.
name

string

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

string

Opis opcji płatności. Może to być widoczne dla użytkownika.
price

object (Price)

Cena opcji płatności.
taxRate

object (TaxRate)

Stawka podatku dla tej opcji płatności. Jeśli to pole jest obecne, zastępuje pole taxRate w Merchant lub usłudze. Pusta wiadomość (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera.
paymentOptionType

enum (PaymentOptionType)

Typ tej opcji płatności. Pojedyncze wejścia, pakiety i nieograniczone korzystanie w przypadku subskrypcji.
sessionCount

string (int64 format)

Liczba sesji, w przypadku których można użyć tej opcji płatności. Dotyczy tylko pakietów sesji, w których wartość powinna być większa niż 1.
purchaseInterval

object (TimeRange)

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

object (TimeRange)

Opcja płatności może być używana w tym przedziale (np.specjalna cena w styczniu 2017 r.). Jeśli ta opcja jest dostępna, zastępuje wartości validDuration i activationType.
validDuration

string (Duration format)

Okres ważności opcji płatności (np. 30-dniowe członkostwo).

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
activationType

enum (ActivationType)

Określa sposób ustalania daty rozpoczęcia ważności tej formy płatności.
userRestriction

object (UserPurchaseRestriction)

Ogranicza liczbę użytkowników, którzy mogą kupić tę opcję płatności. Może służyć do ograniczenia opcji płatności promocyjnej do podzbioru użytkowników. Jeśli nie jest skonfigurowana, wszyscy użytkownicy kwalifikują się do korzystania z tej funkcji.

PaymentOptionType

Rodzaj 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 Opcji płatności można użyć, jeśli liczba sesji jest większa od 0.
PAYMENT_OPTION_UNLIMITED Opcji płatności można używać w okresie jej ważności – liczba sesji nie ma tu zastosowania.

ActivationType

Określa sposób ustalania daty rozpoczęcia ważności.

Wartości w polu enum
ACTIVATION_TYPE_UNSPECIFIED Nieużywane.
ACTIVATION_ON_PURCHASE Ważność rozpoczyna się w momencie zakupu.
ACTIVATION_ON_FIRST_USE Okres ważności rozpoczyna się, gdy opcja płatności zostanie użyta po raz pierwszy.

UserPurchaseRestriction

Ogranicza liczbę użytkowników, którzy mogą kupić opcję płatności.

Zapis JSON 
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
Pola
newToMerchant

boolean

Opcja płatności, którą mogą kupić tylko użytkownicy, którzy nigdy wcześniej nie robili zakupów u danego sprzedawcy.
newToPaymentOption

boolean

Opcja 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 firmy obsługującej płatności, która jest konfigurowana dla każdego sprzedawcy.

Zapis JSON 
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
Pola
processor

enum (Processor)

Określa partnera obsługującego płatności, do którego odnosi się ta konfiguracja.
publicKey

string

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

W przypadku Stripe zapoznaj się z tym artykułem: https://stripe.com/docs/dashboard#api-keys. W przypadku Braintree zapoznaj się z tym artykułem: https://articles.braintreepayments.com/control-panel/important-gateway-credentials.
version

string

Numer wersji interfejsu API wysyłany do firmy obsługującej płatności wraz z prośbami o płatność.

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 za pomocą Braintree.

TokenizationConfig

Konfiguracja tokenizacji przez firmę obsługującą płatności, skonfigurowana dla każdego sprzedawcy.

Zapis JSON 
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
Pola
tokenizationParameter

map (key: string, value: string)

Konfiguracja tokenizacji zwykle zawiera jeden parametr tokenizacji, 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: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

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

Przykład Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
billingInformationFormat

enum (BillingInformationFormat)

W tokenie płatności uwzględnij informacje rozliczeniowe użytkownika wprowadzone w Google Pay wraz z formą płatności (patrz wyżej). Pozostawienie tego pola pustego jest równoznaczne z określeniem wartości MIN.

BillingInformationFormat

Określa, ile informacji o adresie rozliczeniowym użytkownik musi podać i ile z nich ma być uwzględnione 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, kod pocztowy (domyślne ustawienie Google Pay);
FULL imię i nazwisko, ulica i numer, miejscowość, region, kod kraju, kod pocztowy.

Warunki

Zbiór reguł i wytycznych wyświetlanych użytkownikowi w celu umożliwienia mu dokonania rezerwacji za pomocą usługi Zarezerwuj z Google.

Zapis JSON 
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
Pola
url

string

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

string

Tekst, który ma być wyświetlany użytkownikowi. W przypadku nowych integracji używaj parametru localizedText.
localizedText

object (Text)

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

MerchantMatchingHints

Wskazówki, które pomagają Google dopasować sprzedawcę do miejsca w Mapach Google.

Zapis JSON 
{
  "placeId": string
}
Pola
placeId

string

Identyfikator 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ługi to zdefiniowane przez partnera kategorie opisujące usługi dla sprzedawcy. Na przykład bank może zdefiniować atrybut usługi „Rodzaj konta” z możliwymi wartościami „Osobiste” i „Firmowe”, a salon fryzjerski może zdefiniować atrybut usługi „Rodzaj usługi” z możliwymi wartościami „Strzyżenie”, „Koloryzacja” i „Stylizacja”.

Zapis JSON 
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
Pola
attributeId

string

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

string

Nazwa tego atrybutu widoczna dla użytkownika, np. „Typ konta”.
value[]

object (Value)

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

Wartość

Reprezentuje możliwą wartość atrybutu usługi.

Zapis JSON 
{
  "valueId": string,
  "valueName": string
}
Pola
valueId

string

Identyfikator, który jednoznacznie identyfikuje tę wartość wśród innych wartości tego atrybutu usługi, np. „personal”.
valueName

string

Nazwa wartości widoczna dla użytkownika, np. „Osobiste”.

LinkoutTemplate

Szablon określający, jak Google ma generować adresy URL prowadzące do witryny partnera.

Zapis JSON 
{
  "uriTemplate": string
}
Pola
uriTemplate

string

Szablon URI musi być zgodny z RFC 6570. Więcej informacji znajdziesz na stronie https://datatracker.ietf.org/doc/html/rfc6570. Obsługuje szablony poziomu 1 i wszystkie szablony złożone poziomu 4, np. http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

Doradztwo

Informacje wyświetlane użytkownikowi podczas rezerwacji za pomocą Zarezerwuj z Google.

Zapis JSON 
{
  "text": {
    object (Text)
  }
}
Pola
text

object (Text)

Niestandardowy komunikat, który będzie wyświetlany użytkownikowi podczas rezerwacji za pomocą funkcji Zarezerwuj z Google.

EconomicOperator

Informacje o podmiocie gospodarczym w przypadku agregatora.

Zapis JSON 
{
  "text": {
    object (Text)
  }
}
Pola
text

object (Text)

Wymagane. Imię i nazwisko, adres, numer telefonu i adres e-mail podmiotu gospodarczego, czyli producenta, upoważnionego przedstawiciela, importera, dystrybutora, dostawcy usług realizacji zamówień lub innej osoby fizycznej lub prawnej podlegającej obowiązkom związanym z produkcją produktów, udostępnianiem ich lub wprowadzaniem do użytku. Ciąg znaków w dowolnym formacie reprezentujący economicOperator. Informacje te mogą być formatowane za pomocą znaków „ ” i „\n”.

Metody

create

 Tworzy nowy obiekt Merchant zarządzany przez określonego agregatora i go zwraca.

delete

 Usuwa istniejącą usługę Merchant zarządzaną przez określonego agregatora.

getStatus

 Uzyskaj MerchantStatus Merchant.

patch

 Aktualizuje istniejący Merchant zarządzany przez określonego agregatora i zwraca go.