REST Resource: inventory.partners.merchants

Ресурс: Торговец

Информация о мерчанте, который есть на платформе агрегатора.

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)
  }
}
Поля
name

string

Имя ресурса продавца в формате partners/{partner_id}/merchants/{merchantId} .

merchantName

string

Имя продавца, телефон, URL-адрес и местоположение используются для сопоставления партнерского инвентаря с продавцами, уже представленными на Картах Google. Эта информация не будет отображаться.

Имя торговца.

telephone

string

Общественный номер телефона продавца, включая коды страны и города, например +14567891234.

url

string

URL общедоступного веб-сайта продавца.

geo

object ( GeoCoordinates )

Географическая информация о продавце, включая широту, долготу и адрес.

category

string

Категория бизнеса на платформе агрегатора.

numBookings30d
(deprecated)

string ( int64 format)

Это поле устарело.

taxRateBasisPoints
(deprecated)

integer ( uint32 format)

Ставка налога для торговца в базисных пунктах (одна сотая процента). Например, если ставка налога составляет 7,5%, в этом поле должно быть установлено значение 750.

Если это поле не задано или установлено равным 0, общая цена, взимаемая с пользователя за любую услугу, предоставляемую этим продавцом, равна точной цене, указанной в Service.price. Предполагается, что цена услуги освобождена от применимых налогов или уже включена в них. Налоги не будут показаны пользователю отдельной строкой.

Если в этом поле установлено любое ненулевое значение, общая цена, взимаемая с пользователя за любую услугу, предоставляемую этим продавцом, будет включать цену услуги плюс налог, начисленный с использованием указанной здесь налоговой ставки. Дроби наименьшей денежной единицы (например, доли одного цента) будут округлены с использованием ближайшего четного округления. Налоги будут показаны пользователю отдельной строкой.

Это поле устарело, вместо него используйте TaxRate.

taxRate

object ( TaxRate )

Налоговая ставка торговца. Если оно присутствует, оно переопределяет устаревшее поле TaxRateBasisPoints. Пустое сообщение (т. е. TaxRate { }) сбросит применяемую ставку налога на ноль.

paymentRestrictions

object ( PaymentRestrictions )

Ограничения на способы оплаты, которые принимает этот продавец. Мы предполагаем, что никаких ограничений не существует, если это поле не установлено.

paymentOption[]

object ( PaymentOption )

Варианты оплаты, доступные для этого продавца. Сервисы этого продавца смогут индивидуально ограничивать доступные им варианты оплаты.

paymentProcessorConfig
(deprecated)

object ( PaymentProcessorConfig )

Конфигурация для процессора токенизированных платежей, если продавец поддерживает его.

tokenizationConfig

object ( TokenizationConfig )

Конфигурация для процессора токенизированных платежей, если продавец поддерживает его.

terms

object ( Terms )

Условия использования конкретного продавца, отображаемые пользователю при бронировании услуги через «Зарезервировать через Google». Помимо этого, пользователю всегда отображаются Условия использования партнера-агрегатора, и их не следует приводить здесь.

brandId

string

Непрозрачная строка, идентифицирующая бренд, ориентированный на потребителя, который будет использоваться при отображении атрибуции партнера. Это поле позволяет партнерам с несколькими брендами, ориентированными на потребителя, предоставлять информацию о продавцах всех брендов в одном фиде.

Бренд состоит из свойств, ориентированных на потребителя, таких как имя, логотип, Условия обслуживания и Политика конфиденциальности.

Если существует только один партнерский бренд, ориентированный на потребителя, это поле не нужно задавать, и его можно игнорировать.

Если партнер...

У вас нет нескольких брендов, ориентированных на потребителя? --> Игнорировать это поле

Имеет ли настроено несколько брендов?

  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

Внимание: большинству партнеров не требуется задавать это поле. Если партнер желает использовать это поле, он должен сначала связаться с нами, чтобы настроить отдельные бренды, включая бренд по умолчанию.

matchingHints

object ( MerchantMatchingHints )

Советы, которые помогут Google сопоставить продавца с местом на Картах Google. Примечание. Большинству партнеров не требуется заполнять это поле, поскольку Google будет сопоставлять продавцов с местами на Картах Google, используя информацию, предоставленную выше. (необязательный)

serviceAttribute[]

object ( ServiceAttribute )

Определения любых атрибутов услуг, используемых для описания Услуг данного Продавца. (необязательный)

waitlistAdvisement

object ( Advisement )

Необязательный. Общие рекомендации от конкретного продавца для пользователя, присоединяющегося к списку ожидания через «Зарезервировать через Google». Длина отдельных текстовых полей в извещении должна быть ограничена 100 байтами.

Ограничения по оплате

Ограничения на способы оплаты, которые принимает этот продавец.

JSON-представление
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
Поля
creditCardRestrictions

object ( CreditCardRestrictions )

Ограничения на кредитные карты, которые принимает этот продавец. Мы предполагаем, что принимаются все кредитные карты, если это поле не установлено. Обратите внимание, что список карт, поддерживаемых CreditCardType, со временем будет расширяться, а это означает, что если оставить это поле пустым, конфигурация будет подвержена будущим изменениям.

Кредитная картаОграничения

Ограничения на типы кредитных карт, которые принимает этот продавец.

JSON-представление
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
Поля
creditCardType[]

enum ( CreditCardType )

Список поддерживаемых кредитных карт. Кредитные карты не поддерживаются, если они пусты.

Тип кредитной карты

Тип кредитной карты.

Перечисления
CREDIT_CARD_TYPE_UNSPECIFIED Неиспользованный.
VISA Кредитная карта Visa.
MASTERCARD Кредитная карта Мастеркард.
AMERICAN_EXPRESS Кредитная карта American Express.
DISCOVER Кредитная карта Discover.
JCB Кредитная карта JCB.

Вариант оплаты

Способ оплаты, который можно использовать для оплаты услуг, предоставляемых продавцом. Варианты оплаты могут быть общими для нескольких продавцов (например, продавцов, принадлежащих к одной сети).

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)
  }
}
Поля
paymentOptionId

string

Этот идентификатор используется для идентификации этого способа оплаты.

Этот идентификатор является глобальным для всего агрегатора, и повторное использование значения для нескольких продавцов позволит пользователю платить соответствующим способом оплаты между этими продавцами.

При повторном использовании идентификатора для доступа к нескольким продавцам обновление любого значения варианта оплаты у одного продавца также обновит любой другой способ оплаты с тем же идентификатором у другого продавца. Таким образом, рекомендуется, чтобы все варианты оплаты имели один и тот же идентификатор и всегда обновлялись до одинаковых значений, чтобы избежать любой возможности недооцененного поведения.

name

string

Название способа оплаты. Это может быть видно пользователю.

description

string

Описание способа оплаты. Это может быть видно пользователю.

price

object ( Price )

Цена варианта оплаты.

taxRate

object ( TaxRate )

Ставка налога для этого варианта оплаты. Если оно присутствует, оно переопределяет поле TaxRate, присутствующее в Продавце или Сервисе. Пустое сообщение (т. е. TaxRate { }) сбросит применяемую ставку налога на ноль.

paymentOptionType

enum ( PaymentOptionType )

Тип этого способа оплаты. Одноразовое использование для дополнительных модулей, многократное использование для пакетов и неограниченное использование для членства.

sessionCount

string ( int64 format)

Сколько сеансов можно использовать для этого варианта оплаты. Действительно только для мультисессий/пакетов, где значение должно быть > 1.

purchaseInterval

object ( TimeRange )

Опцию оплаты можно приобрести в течение этого интервала.

validInterval

object ( TimeRange )

В течение этого интервала можно использовать вариант оплаты (например, специальная цена на январь 2017 г.). Если они присутствуют, они переопределяют validDuration и activeType.

validDuration

string ( Duration format)

Продолжительность действия варианта оплаты (например, 30-дневное членство).

Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

activationType

enum ( ActivationType )

Определяет, как определяется дата начала действия для этого варианта оплаты.

userRestriction

object ( UserPurchaseRestriction )

Ограничивает пользователей, имеющих право приобрести этот вариант оплаты. Может использоваться для ограничения возможности рекламных платежей для определенной группы пользователей. Если не установлено, все пользователи имеют право.

Тип платежного варианта

Тип способа оплаты.

Перечисления
PAYMENT_OPTION_TYPE_UNSPECIFIED Неиспользованный.
PAYMENT_OPTION_SINGLE_USE Вариант оплаты можно использовать только один раз.
PAYMENT_OPTION_MULTI_USE Вариант оплаты можно использовать, если количество сеансов > 0.
PAYMENT_OPTION_UNLIMITED Вариант оплаты можно использовать в пределах допустимого диапазона времени — количество сеансов неприменимо.

Тип активации

Определяет, как определяется дата начала действия.

Перечисления
ACTIVATION_TYPE_UNSPECIFIED Неиспользованный.
ACTIVATION_ON_PURCHASE Срок действия начинается с момента покупки.
ACTIVATION_ON_FIRST_USE Срок действия начинается с момента первого использования способа оплаты.

Пользовательское ограничение по покупке

Ограничивает пользователей, имеющих право приобрести вариант оплаты.

JSON-представление
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
Поля
newToMerchant

boolean

Вариант оплаты, который могут приобрести только пользователи, которые никогда раньше не совершали покупок у того же продавца.

newToPaymentOption

boolean

Способ оплаты, который могут приобрести только пользователи, которые никогда раньше не приобретали этот вариант оплаты.

Конфигурация процессора оплаты

Конфигурация платежного процессора, настраиваемая индивидуально для каждого продавца.

JSON-представление
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
Поля
processor

enum ( Processor )

Определяет партнера по обработке платежей, к которому применяется эта конфигурация.

publicKey

string

Ключ, используемый для идентификации этого продавца с платежной системой.

Для Stripe см. https://stripe.com/docs/dashboard#api-keys Для Braintree см. https://articles.braintreepays.com/control-panel/important-gateway-credentials

version

string

Номер версии API, отправленный в платежную систему вместе с запросами на оплату.

Процессор

Определяет конкретного партнера по обработке платежей.

Перечисления
PROCESSOR_UNSPECIFIED Неиспользованный
PROCESSOR_STRIPE Конфигурация для платежей с помощью Stripe.
PROCESSOR_BRAINTREE Конфигурация для платежей с помощью Braintree.

Конфигурация токенизации

Конфигурация токенизации платежного процессора, настраиваемая отдельно для каждого продавца.

JSON-представление
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
Поля
tokenizationParameter

map (key: string, value: string)

Конфигурация токенизации обычно имеет один параметр tokenizationParameter, ключ которого — «шлюз», а значение — имя процессора.

Остальные параметры зависят от процессора. Дополнительную информацию см. в документации Google Pay.

Пример Braintree: tokenizationParameter {ключ: "шлюз" значение: "braintree" } tokenizationParameter { ключ: значение "braintree:apiVersion": "v1" } tokenizationParameter { ключ: значение "braintree:sdkVersion": "2.30.0" } tokenizationParameter { ключ: «braintree:merchantId» значение: «abcdef» } tokenizationParameter { ключ: «braintree:clientKey» значение: «production_xxx_yyy» }

Пример полосы: tokenizationParameter {key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Пример Adyen: tokenizationParameter {key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

billingInformationFormat

enum ( BillingInformationFormat )

Включите в платежный токен платежную информацию пользователя, введенную в Google Pay с его ФОП (см. выше). Оставление поля пустым эквивалентно указанию MIN.

Формат информации о выставлении счетов

Какую часть платежного адреса следует потребовать от пользователя и включить в токен. Значения перечисления соответствуют параметрам в API Google Pay (см. https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters) .

Перечисления
BILLING_INFORMATION_FORMAT_UNSPECIFIED Не указан. По умолчанию МИН.
MIN имя, код страны и почтовый индекс (настройка Google Pay по умолчанию).
FULL имя, почтовый адрес, населенный пункт, регион, код страны и почтовый индекс.

Условия

Набор правил и рекомендаций, которые отображаются пользователю для совершения бронирования через «Забронировать через Google».

JSON-представление
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
Поля
url

string

Необязательно, URL-адрес Положений и условий.

text

string

Текст, который будет отображаться пользователю. Используйте localizedText ниже для новых интеграций.

localizedText

object ( Text )

Локализованный текст, который будет отображаться пользователю.

Подсказки для продавца

Подсказки, которые помогают Google сопоставить продавца с местом на Картах Google.

JSON-представление
{
  "placeId": string
}
Поля
placeId

string

Идентификатор места в базе данных Google Адресов и на Картах Google. Дополнительную информацию об идентификаторах мест см. на странице https://developers.google.com/places/web-service/place-id .

Атрибут службы

Атрибуты услуг — это категории, определяемые партнерами и описывающие Услуги для Продавца. Например, банк может определить атрибут услуги «Тип счета» с возможными значениями «Личный» и «Деловой», а парикмахерская может определить атрибут услуги «Тип услуги» с возможными значениями «Стрижка», «Цвет». и «Стиль».

JSON-представление
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
Поля
attributeId

string

Идентификатор, который однозначно идентифицирует этот атрибут услуги среди других для одного и того же продавца, например «тип счета».

attributeName

string

Видимое пользователю имя этого атрибута, например «Тип учетной записи».

value[]

object ( Value )

Все возможные значения этого атрибута службы.

Ценить

Представляет возможное значение для определенного атрибута службы.

JSON-представление
{
  "valueId": string,
  "valueName": string
}
Поля
valueId

string

Идентификатор, который однозначно идентифицирует это значение среди других для этого атрибута услуги, например «личное».

valueName

string

Видимое пользователю имя значения, например «Личное».

Совет

Рекомендации, которые отображаются пользователю при бронировании через «Забронировать через Google».

JSON-представление
{
  "text": {
    object (Text)
  }
}
Поля
text

object ( Text )

Специальное сообщение, которое будет отображаться пользователю при бронировании через «Забронировать через Google».

Методы

create

 Создает нового Merchant управляемого указанным агрегатором, и возвращает его.

delete

 Удаляет существующего Merchant управляемого указанным агрегатором.

getStatus

 Получите MerchantStatus Merchant .

patch

 Обновляет существующего Merchant управляемого указанным агрегатором, и возвращает его.