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)
    }
  ],
  "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żą 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

Numer telefonu sprzedawcy, który zawiera kod kraju i kod kierunkowy, np. +14567891234.
url

string

Adres URL publicznej witryny sprzedawcy.
geo

object (GeoCoordinates)

Informacje o lokalizacji sprzedawcy, w tym szerokość i długość geograficzną 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%, w tym polu należy wpisać 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 równa cenie określonej w polu 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 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.

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

object (TaxRate)

Stawka podatku sprzedawcy. Jeśli to pole jest dostępne, zastąpi wycofane pole taxRateBasisPoints. Pusty komunikat (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki podatku do 0.
paymentRestrictions

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 żadnych ograniczeń.
paymentOption[]

object (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
(deprecated)

object (PaymentProcessorConfig)

Konfiguracja dla procesora płatności z tokenizacją, jeśli sprzedawca go obsługuje.
tokenizationConfig

object (TokenizationConfig)

Konfiguracja dla procesora płatności z tokenizacją, jeśli sprzedawca go obsługuje.
terms

object (Terms)

Warunki korzystania z usługi określone przez sprzedawcę wyświetlane użytkownikowi podczas rezerwacji usługi za pomocą Zarezerwuj z Google. Oprócz tego użytkownikowi zawsze wyświetlane są Warunki korzystania z usługi dostawcy usług agregacyjnych, których nie trzeba podawać tutaj.
brandId

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 ramach tego samego pliku danych.

Marka składa się z elementów skierowanych do konsumentó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 skierowanych do konsumentów --> Ignoruj to pole

Czy masz skonfigurowane 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

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.
matchingHints

object (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ż Google dopasowuje sprzedawców do miejsc w Mapach Google na podstawie podanych wyżej informacji. (opcjonalnie)
serviceAttribute[]

object (ServiceAttribute)

Definicje atrybutów usług służących do opisu Usług dla tego Sprzedawcy. (opcjonalnie)
waitlistAdvisement

object (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

object (EconomicOperator)

Opcjonalnie: Informacje o operatorze gospodarczym powiązane z tym konkretnym sprzedawcą, wymagane do zapewnienia 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 akceptowane są wszystkie karty kredytowe. Pamiętaj, że lista kart obsługiwanych przez typ kart kredytowych będzie się z czasem powiększać, co oznacza, że pozostawienie tego pola pustego spowoduje, że konfiguracja będzie podlegać zmianom w przyszłości.

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 jest pusta, nie obsługuje kart kredytowych.

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 karty kredytowej American Express,
DISCOVER karty kredytowej 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ć udostępniane wielu sprzedawcom (np. sprzedawcom należącym do tego samego łańcucha).

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

Jeśli identyfikator jest używany przez wielu sprzedawców, zmiana dowolnej wartości opcji płatności u jednego sprzedawcy spowoduje również zmianę wszystkich innych 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ąć jakiegokolwiek zaniżania wartości.
name

string

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

string

Opis opcji płatności. Może być on widoczny 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 dostępne, zastępuje pole taxRate w usłudze lub koncie sprzedawcy. Pusty komunikat (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki podatku do 0.
paymentOptionType

enum (PaymentOptionType)

Typ tej opcji płatności. Jednorazowe w przypadku drop-inów, wielokrotne w przypadku pakietów i nieograniczone w przypadku członkostwa.
sessionCount

string (int64 format)

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.
purchaseInterval

object (TimeRange)

W tym czasie można kupić tę opcję płatności.
validInterval

object (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 parametry validDuration i activationType.
validDuration

string (Duration format)

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

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

enum (ActivationType)

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

object (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.

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 Opcji płatności można używać, jeśli liczba sesji jest większa niż 0.
PAYMENT_OPTION_UNLIMITED Opcji płatności można używać w ramach jej okresu ważności – liczba sesji jest nieistotna.

ActivationType

Określa, jak ustalana jest data 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 Okres ważności rozpoczyna się w momencie, gdy opcja płatności zostanie użyta po raz pierwszy.

UserPurchaseRestriction

Ogranicza liczbę użytkowników kwalifikujących się do zakupu danej opcji płatności.

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

boolean

opcja płatności, z której mogą skorzystać tylko użytkownicy, którzy nigdy wcześniej nie robili zakupów u tego 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, skonfigurowana dla poszczególnych sprzedawców.

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

enum (Processor)

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

string

Klucz używany do identyfikacji tego sprzedawcy w systemie przetwarzania 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.
version

string

Numer wersji interfejsu API wysyłany do firmy obsługującej płatności wraz z żądaniami dotyczącymi płatności.

Procesor

Określa konkretnego partnera w zakresie przetwarzania 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 z Braintree.

TokenizationConfig

Konfiguracja tokenizacji procesora płatności skonfigurowana dla poszczególnych sprzedawców.

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

map (key: string, value: string)

Konfiguracja tokenizacji zwykle zawiera 1 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 dotyczący Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Przykład w przypadku 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)

Dodaj do tokena płatności informacje rozliczeniowe użytkownika wprowadzone w Google Pay za pomocą jego FOP (patrz wyżej). Pozostawienie tego pola pustego jest równoznaczne ze wskazaniem MIN.

BillingInformationFormat

Wybierz, ile danych adresu rozliczeniowego chcesz wymagać od użytkownika i włączać w tokenie. Wartości wyliczenia 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 (ustawienie domyślne Google Pay).
FULL imię i nazwisko, ulica i numer domu, miejscowość, region, kod kraju, kod pocztowy.

Warunki

zbiór zasad i wytycznych wyświetlanych użytkownikowi w celu dokonania rezerwacji za pomocą funkcji Rezerwuj z Google;

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

string

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

string

Tekst wyświetlany użytkownikowi. W przypadku nowych integracji użyj lokalizacji poniżej.
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 „Typ konta” z możliwymi wartościami „Osobiście” i „Biznesowo”, a salon fryzjerski może zdefiniować atrybut usługi „Typ 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 jednoznacznie identyfikuje ten atrybut usługi wśród innych dla 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ść danego 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

Wierna użytkownikowi nazwa wartości, np. „Osobiście”.

Zalecenie

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

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

object (Text)

Niestandardowy komunikat wyświetlany użytkownikowi podczas rezerwacji za pomocą funkcji Zarezerwuj z Google.

EconomicOperator

Informacje o operatorze ekonomicznym dla agregatora.

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

object (Text)

Wymagane. imię i nazwisko, adres, numer telefonu i adres e-mail operatora gospodarczego, czyli producenta, autoryzowanego przedstawiciela, importera, dystrybutora, dostawcy usług logistycznych lub innej osoby fizycznej lub prawnej, na którą nałożono obowiązki związane z produkcją, udostępnianiem lub wprowadzaniem produktów do obrotu. Ciąg znaków w dowolnym formacie reprezentujący operatora ekonomicznego. Te informacje mogą być sformatowane za pomocą znaków „  ” i „\n”.

Metody

create

 Tworzy nowe Merchant zarządzane przez określonego agregatora i zwraca je.

delete

 Usuwa istniejący Merchant zarządzany przez określonego agregatora.

getStatus

 Uzyskaj MerchantStatus Merchant.

patch

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