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)
  }
}
Pola
name

string

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

merchantName

string

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

string

Publiczny numer telefonu sprzedawcy wraz z numerem kraju i numeru kierunkowego, 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 działalności na platformie agregatora.

numBookings30d
(deprecated)

string (int64 format)

To pole zostało wycofane.

taxRateBasisPoints
(deprecated)

integer (uint32 format)

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

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

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

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

string

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?

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

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 wszystkich atrybutów usługi służących do opisania Usług 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.

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

string

Nazwa opcji płatności. Może być 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 obecne, zastępuje pole taxRate w usłudze sprzedawcy lub usłudze. 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. Obowiązuje tylko w przypadku wielu sesji / pakietów, gdzie wartość powinna wynosić > 1.

purchaseInterval

object (TimeRange)

W tym okresie możesz kupić tę opcję płatności.

validInterval

object (TimeRange)

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

string (Duration format)

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ą „s”. Przykład: "3.5s".

activationType

enum (ActivationType)

Określa sposób określania daty rozpoczęcia ważności przez tę opcję 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 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

boolean

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

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 dla firmy obsługującej płatności, 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, 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 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 "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, 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 (Text)
  }
}
Pola
url

string

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

text

string

Tekst, który ma zostać wyświetlony 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 „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 (Value)
    }
  ]
}
Pola
attributeId

string

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

attributeName

string

Widoczna dla użytkownika nazwa tego atrybutu, np. „Typ konta”.

value[]

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

string

Identyfikator, który jednoznacznie identyfikuje tę wartość między innymi dla danego atrybutu usługi, np. „osobiste”.

valueName

string

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 (Text)
  }
}
Pola
text

object (Text)

Niestandardowa wiadomość wyświetlana użytkownikowi podczas rezerwacji poprzez Zarezerwuj z Google.

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 zasób Merchant, którym zarządza określony pośrednik.