REST Resource: inventory.partners.merchants

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

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

string

Publiczny numer telefonu sprzedawcy wraz z jego krajem i numerem 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 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

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

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

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

object (PaymentProcessorConfig)

Konfiguracja dla tokenizowanego podmiotu przetwarzającego płatności, jeśli sprzedawca obsługuje tę funkcję.
tokenizationConfig

object (TokenizationConfig)

Konfiguracja dla tokenizowanego podmiotu przetwarzającego płatności, jeśli sprzedawca obsługuje tę funkcję.
terms

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

string

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?

  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 korzystać z tego pola, musi najpierw skontaktować się z nami w celu skonfigurowania oddzielnych marek, w tym marki 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 używanych do opisania Usług danego Sprzedawcy. (opcjonalnie)
waitlistAdvisement

object (Advisement)

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 (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 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 (CreditCardType)
  ]
}
Pola
creditCardType[]

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

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ąpi ono pole taxRate w sekcji Sprzedawca lub Usługę. Pusta wiadomość (np. stawka podatku { }) spowoduje zresetowanie zastosowanej stawki podatku do zera.
paymentOptionType

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

string (int64 format)

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

object (TimeRange)

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

object (TimeRange)

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

string (Duration format)

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

enum (ActivationType)

Określa, jak określa się datę rozpoczęcia ważności dla tej opcji płatności.
userRestriction

object (UserPurchaseRestriction)

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

boolean

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

boolean

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

string

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 (BillingInformationFormat)
}
Pola
tokenizationParameter

map (key: string, value: string)

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 "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
billingInformationFormat

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

string

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

string

Tekst, który będzie wyświetlany użytkownikowi. W przypadku nowych integracji używaj poniższego tekstu localizedText.
localizedText

object (Text)

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

string

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 (Value)
    }
  ]
}
Pola
attributeId

string

Identyfikator, który jednoznacznie identyfikuje ten atrybut usługi wśród innych 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ść konkretnego atrybutu usługi.

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

string

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

string

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

object (Text)

Niestandardowa wiadomość, która ma się wyświetlać użytkownikowi podczas dokonywania rezerwacji przez funkcję Zarezerwuj z Google.

Metody

create

 Tworzy nowy element Merchant zarządzany przez określonego pośrednika i zwraca go.

delete

 Usuwa istniejący obiekt Merchant zarządzany przez określonego pośrednika.

getStatus

 Uzyskaj MerchantStatus w: Merchant.

patch

 Aktualizuje istniejący obiekt Merchant zarządzany przez określonego pośrednika i zwraca go.