REST Resource: inventory.partners.merchants

Zasób: sprzedawca

informacje o sprzedawcy, który korzysta z platformy 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 jest dostępny dla klientów, wraz z kodem kraju i kodem kierunkowym, np. +14567891234.
url

string

Adres URL publicznej witryny sprzedawcy.
geo

object (GeoCoordinates)

Dane geograficzne 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 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 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 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żywaj pola taxRate.
taxRate

object (TaxRate)

Stawka podatku sprzedawcy. Jeśli to pole jest obecne, zastępuje wycofane pole taxRateBasisPoints. Pusty komunikat (np. taxRate { }) spowoduje zresetowanie zastosowanej stawki podatku do zera.
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 pojedynczo ograniczać opcje płatności dostępne dla niego.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

Konfiguracja dla tokenizowanej firmy obsługującej płatności, jeśli sprzedawca ją 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. Dodatkowo Warunki korzystania z usługi partnera pośredniczącego są zawsze wyświetlane użytkownikowi i nie można ich tu podawać.
brandId

string

Nieprzejrzysty ciąg znaków, który identyfikuje markę skierowaną do konsumentów, aby wyświetlić atrybucję 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 elementów skierowanych do konsumentó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 skierowanych do konsumentów --> Zignoruj 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 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[]

object (ServiceAttribute)

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

object (Advisement)

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.
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 wypełnione, przyjmujemy, ż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, które akceptuje ten sprzedawca.

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

enum (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 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ć dostępne dla wielu sprzedawców (np. należących 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 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.
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ć 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 zera.
paymentOptionType

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

string (int64 format)

Liczba sesji, w których można wykorzystać tę opcję 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 ta opcja jest dostępna, zastępuje to wartości validDuration i ActivationType.
validDuration

string (Duration format)

Czas 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 i kończący się „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 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 Opcji płatności można używać, jeśli liczba sesji jest większa niż 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 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 dostęp do użytkowników, którzy mogą kupić daną opcję 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

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

string

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 (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 Stripe: tokenizationparameter { key: "gateway" value: "paski" } tokenizationParameter { key: "stripe:version" 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 "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
billingInformationFormat

enum (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, 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 do Warunków korzystania z usługi.
text

string

Tekst wyświetlany użytkownikowi. W przypadku nowych integracji użyj narzędzia localizedText poniżej.
localizedText

object (Text)

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

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.

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 „Biznesowy”, 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 (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ść atrybutu danej 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

Widoczna dla użytkownika nazwa wartości, np. „Osobisty”.

Doradztwo

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ą 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, 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 w dowolnym formacie reprezentujący operatora ekonomicznego. Te informacje można sformatować za pomocą atrybutu „ ” i „\n”.

Metody

create

 Tworzy i zwraca nowy zasób Merchant zarządzany przez określonego pośrednika.

delete

 Usuwa istniejącą zasadę Merchant zarządzaną przez określonego pośrednika.

getStatus

 Weź do ręki MerchantStatus: Merchant.

patch

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