REST Resource: inventory.partners.merchants

{
  "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)
  }
}

string

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

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.

string

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

string

Adres URL publicznej witryny sprzedawcy.

object (GeoCoordinates)

Informacje o lokalizacji sprzedawcy, w tym szerokość i długość geograficzną oraz adres.

string

Kategoria firmy na platformie agregatora.

string (int64 format)

To pole zostało wycofane.

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.

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.

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

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.

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

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

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.

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.

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)

object (ServiceAttribute)

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

object (ActionLink)

Opcjonalnie: Adres URL działania z powiązanym językiem, listą krajów, na które jest ono ograniczone, typem i opcjonalną platformą, która wskazuje, na której platformie ma być wykonywane to działanie.

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.

object (EconomicOperator)

Opcjonalnie: Informacje o operatorze gospodarczym powiązane z tym konkretnym sprzedawcą, wymagane do zapewnienia zgodności z przepisami. (opcjonalnie)

{
  "creditCardRestrictions": {
    object (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.

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

Lista obsługiwanych kart kredytowych. Jeśli jest pusta, nie obsługuje kart kredytowych.

{
  "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)
  }
}

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.

string

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

string

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

object (Price)

Cena opcji płatności.

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.

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.

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.

object (TimeRange)

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

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.

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

enum (ActivationType)

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

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.

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

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;

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;

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

enum (Processor)

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

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.

string

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

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

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" }.

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.

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

string

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

string

Tekst wyświetlany użytkownikowi. W przypadku nowych integracji użyj lokalizacji poniżej.

object (Text)

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

{
  "placeId": string
}

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.

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

string

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

string

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

object (Value)

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

{
  "valueId": string,
  "valueName": string
}

string

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

string

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

{
  "text": {
    object (Text)
  }
}

object (Text)

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

{
  "text": {
    object (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”.