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

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

string

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

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

string

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

string

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

object ( GeoCoordinates )

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

string

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

string ( int64 format)

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

integer ( uint32 format)

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

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

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

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

object ( TaxRate )

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

object ( PaymentRestrictions )

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

object ( PaymentOption )

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

object ( PaymentProcessorConfig )

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

object ( TokenizationConfig )

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

object ( Terms )

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

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

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

object ( MerchantMatchingHints )

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

object ( ServiceAttribute )

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

object ( ActionLink )

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

object ( Advisement )

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

object ( EconomicOperator )

Необязательный. Информация экономического оператора, связанная с этим конкретным торговцем, необходимая для соблюдения нормативных требований. (необязательный)

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object ( CreditCardRestrictions )

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

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

enum ( CreditCardType )

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

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

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

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

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

string

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

string

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

object ( Price )

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

object ( TaxRate )

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

enum ( PaymentOptionType )

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

string ( int64 format)

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

object ( TimeRange )

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

object ( TimeRange )

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

string ( Duration format)

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

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

enum ( ActivationType )

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

object ( UserPurchaseRestriction )

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

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

boolean

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

boolean

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

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

enum ( Processor )

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

string

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

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

string

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

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

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

enum ( BillingInformationFormat )

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

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

string

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

string

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

object ( Text )

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

{
  "placeId": string
}

string

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

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

string

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

string

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

object ( Value )

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

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

string

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

string

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

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

object ( Text )

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

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

object ( Text )

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