- Ресурс: Сервис
- Интерпретация цен
- Правила планирования
- Правила приема
- Политика отмены
- Условия возврата
- Тип предоплаты
- Условия предоплаты
- Время зарядки
- Форма приема заявок на услуги
- ServiceIntakeFormField
- FieldType
- Тип услуги
- Тип билета
- Плата за билет
- PriceDisplayType
- InventoryType
- RelatedMedia
- MediaType
- Атрибуция
- ServiceAttributeValueId
- Правила списка ожидания
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- Категория события
- Сущность
- EntityType
- EntityRole
- PublicIdentificationData
- Режим посещаемости
- OrganizerType
- СобытиеСостояние
- EventCreator
- Тип интеграции
- Комиссия за заказ
- Туры и мероприятия
- Расположение
- LocationType
- Рейтинг
- HomeServiceData
- Виртуальная сессия
- VirtualPlatformInfo
- Платформа
- DirectMerchantPayment
- UriTemplate
- Методы
Ресурс: Сервис
Информация об услуге, предоставляемой продавцом, например, о стрижке.
| JSON-представление |
|---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
| Поля | |
|---|---|
name | Имя ресурса сервиса имеет формат |
serviceName | Название услуги, например, «Мужская стрижка». Устарело, используйте вместо него localizedServiceName. |
localizedServiceName | Название услуги, например, «Мужская стрижка». Возможно, используется в нескольких местах. |
description | Описание сервиса, видимое пользователю. Устарело, используйте localizedDescription вместо него. |
localizedDescription | Описание услуги, видимое пользователю. Это поле поддерживает как обычный текст, так и форматирование, подобное HTML. В отличие от разделов с обычным текстом, здесь можно создавать настраиваемые макеты, используя заголовки, абзацы, списки и некоторые теги фраз. Пожалуйста, внимательно ознакомьтесь с приведенными ниже инструкциями и примечаниями, чтобы обеспечить наилучшее взаимодействие с пользователем. Поддерживаются теги форматирования, аналогичные HTML: Теги заголовков: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Тег абзаца: <p> Список тегов: <ul>, <ol>, <li> Тег подразделения: <div> Фразовые теги: <br>, <strong>, <em>: Неподдерживаемые теги:
Важные примечания:
|
price | Цена услуги. |
priceInterpretation | Описывает, как цена интерпретируется и отображается пользователю. Может использоваться в любой вертикали, кроме ресторанов и развлечений, для настройки отображения цены услуги. |
rules | Правила записи/отмены записи на прием. |
prepaymentType | Требуется ли предоплата, является ли она необязательной или не поддерживается. |
prepaymentTerms | Условия, касающиеся сроков завершения предоплаты. |
form[] | Устарело. Пожалуйста, используйте intakeForm и perTicketIntakeForm. |
intakeForm | Форма для запроса дополнительной информации у пользователя при бронировании данной услуги. (необязательно) |
perTicketIntakeForm | Форма для запроса дополнительной информации у пользователя при бронировании данной услуги. Эту форму необходимо заполнить один раз для каждого бронируемого пользователем билета. (необязательно) |
taxRate | Налоговая ставка услуги. Если это поле присутствует, оно переопределяет любую налоговую ставку, установленную на уровне продавца. Пустое сообщение (например, taxRate { }) обнулит применяемую налоговую ставку. |
paymentOptionId[] | Список идентификаторов, указывающих на способы оплаты данной услуги. Фактические способы оплаты определяются на уровне продавца и могут использоваться несколькими продавцами. |
deposit | Определяет способ списания депозита с пользователя. Переопределяет депозит за услуги, если он был указан. Установка пустого значения в сообщении "Депозит" отменяет любой депозит за услуги. (необязательно) |
noShowFee | Определяет размер платы за неявку, которая может быть взыскана с пользователя. Переопределяет плату за неявку, если она была указана. Установка пустого значения в сообщении NoShowFee отменяет любую плату за неявку, предусмотренную для данного сервиса. (необязательно) |
requireCreditCard | Указывает, необходимо ли пользователю предоставлять данные кредитной карты для бронирования данной услуги. Это поле можно изменить на уровне доступности. (необязательно) |
actionLink[] | Ссылка на действие, связанная с данной услугой. Если ссылка на действие существует, в настройках услуги необходимо указать ее тип (см. ниже). |
type | Предопределенный тип данной услуги. (необязательно) |
ticketType[] | Типы билетов, которые можно забронировать/приобрести для этой услуги, если поддержка билетов доступна. (необязательно) |
relatedMedia[] | Фотографии, связанные с этим сервисом. Google будет индексировать и сохранять медиафайлы, чтобы обеспечить их наиболее эффективное отображение для конечных пользователей. (необязательно) |
serviceAttributeValueId[] | Значения атрибутов услуги, применяемые к данной услуге (необязательно). Каждая услуга может иметь ноль или более значений для каждого атрибута услуги, определенного в соответствующем продавце. (необязательно) |
waitlistRules | Правила включения в список ожидания. |
ticketingVerticalSpecificData | Дополнительная информация, специфичная для данной сферы продажи билетов на мероприятия. (необязательно) |
integrationType | Глубина интеграции, поддерживаемая для данного сервиса. (необязательно) Неактуально для партнеров со стартовой интеграцией. Для таких партнеров сквозная интеграция всегда будет отключена. |
perOrderFee | Комиссия за покупку данной услуги взимается на уровне заказа. (необязательно) |
toursAndActivitiesContent | Поля контента, относящиеся к турам и мероприятиям. |
location[] | Места, связанные с данной услугой. ВАЖНЫЕ ЗАМЕЧАНИЯ: Если с данной услугой связано несколько посещаемых мест или START_LOCATION отличается от VISITED_LOCATION, необходимо указать START_LOCATION. Пример: - Велосипедная экскурсия с гидом, посещающая три места, место начала необходимо указать. - Автобусная экскурсия, встреча в холле отеля, затем отправление к посещаемому месту. Место встречи необходимо указать. |
rating | Пользовательский рейтинг этого сервиса как совокупный показатель по всем отзывам. |
homeServiceData | Дополнительная информация, специфичная для сферы услуг на дому. (необязательно) |
virtualSession | Необязательно. Информация о виртуальной сессии. Она необходима для включения виртуальных сервисов. |
directMerchantPayment | Необязательно. Дополнительная информация, которую необходимо добавить, если услуга требует от пользователя прямой оплаты продавцу. ВАЖНОЕ ПРИМЕЧАНИЕ: RwG не будет участвовать в этой транзакции. Эта информация обязательна, если определена virtualSession, а услуга не является бесплатной или prepaymentType НЕ установлен в значение REQUIRED. |
uriTemplate | Необязательно. Необязательный шаблон, определяющий, как Google должен генерировать URL-адреса для внешних сайтов. |
Интерпретация цен
Описывает, как следует интерпретировать и отображать цену пользователю.
| Перечисления | |
|---|---|
PRICE_INTERPRETATION_UNSPECIFIED | Интерпретация цены не указана, по умолчанию используется значение EXACT_AMOUNT. |
EXACT_AMOUNT | Когда цену следует интерпретировать как конкретное значение. Примеры: 20 долларов за занятие йогой; 15 долларов за детскую стрижку. |
STARTS_AT | Когда цена услуги является переменной, но известна и отображается для потребителей минимальная цена, потребители могут делать выбор, который приводит к увеличению цены. Обратите внимание, что любой сервис, использующий этот PriceInterpretation, должен использовать PrepaymentType NOT_SUPPORTED. Пример: стрижка собаки стоит 30 долларов, но дополнительные варианты выбора для потребителей могут повысить цену. |
NOT_DISPLAYED | Когда цена услуги является переменной, и информация о цене не отображается потребителям заранее. Обратите внимание, что любой сервис, использующий этот параметр PriceInterpretation, должен использовать PrepaymentType NOT_SUPPORTED, а поле Price должно быть пустым. Примеры: Консультация по оказанию услуг на дому. |
Правила планирования
Правила планирования обслуживания.
| JSON-представление |
|---|
{ "minAdvanceOnlineCanceling": string, "lateCancellationFee": { object ( |
| Поля | |
|---|---|
minAdvanceOnlineCanceling | Минимальное время предварительного уведомления в секундах, необходимое для отмены забронированной онлайн-записи. (необязательно) |
lateCancellationFee | Плата за отмену бронирования в течение минимального срока предварительного уведомления. |
noshowFee | Штраф за неявку без отмены бронирования. |
admissionPolicy | Правила доступа, применяемые к данной услуге. Если не задано, по умолчанию используется значение TIME_STRICT. (необязательно) |
cancellationPolicy | Правила бронирования и политика отмены бронирования. (Обязательно для раздела "Чем заняться") |
Поле объединения Если задан параметр "min_advance_booking", последнее доступное для бронирования время рассчитывается как (<время начала слота> - "min_advance_booking"). Если задан параметр "min_booking_buffer_before_end_time", последнее доступное для бронирования время рассчитывается как (<время окончания слота> - "min_booking_buffer_before_end_time"). Обратите внимание, что значение параметра "min_booking_buffer_before_end_time" должно быть положительным, если оно задано. Если оба параметра не заданы, слот доступен для бронирования до времени начала слота. Если оба поля заданы, будет выбрано только одно значение, а другое будет проигнорировано — мы не можем надежно предсказать, какое значение будет выбрано. Примеры:
| |
minAdvanceBooking | Продолжительность (в секундах) с момента, когда можно сделать последнее бронирование, до момента начала действия свободного временного интервала. |
minBookingBufferBeforeEndTime | Продолжительность (в секундах) с момента, когда можно сделать последнее бронирование, до окончания доступного временного интервала. Если это поле задано, поле "admissionPolicy" должно быть установлено в значение TIME_FLEXIBLE, чтобы указать, что пользователи могут использовать приобретенные билеты после начала временных интервалов. |
Правила приема
Правила приема в данную службу.
| Перечисления | |
|---|---|
ADMISSION_POLICY_UNSPECIFIED | Неиспользованный. |
TIME_STRICT | Клиенты должны присутствовать к началу указанного временного интервала, и услуга должна завершиться к концу этого интервала. Примеры использования TIME_STRICT: * Экскурсия, начинающаяся в 9:00, на которую все участники должны прибыть к началу, и возвращение примерно в 12:00. * Запись на стрижку в 15:00 в субботу, которая займет приблизительно 30 минут. * Фитнес-занятие с 18:00 до 20:00. |
TIME_FLEXIBLE | Для использования этого бронирования клиенты могут прибыть в любое время в промежутке между началом и окончанием указанного временного интервала. Примеры использования TIME_FLEXIBLE: * Билет в музей, который можно использовать в любое время в день покупки. * Входной билет в парк развлечений на вторую половину дня, который можно использовать с 12:00 до 21:00. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION | Покупатели должны прибыть к продавцу к началу указанного временного интервала, но могут уйти в любое удобное для них время. Например, в сценарии посещения музея билет с указанием времени входа (10:00) требует от пользователя присутствия в музее к 10:00. Время начала доступных временных интервалов для этой услуги обозначает назначенное время входа. Время окончания, однако, используется исключительно в качестве ключа для определения доступного временного интервала для бронирования. |
Политика отмены
Правила отмены заказа.
| JSON-представление |
|---|
{
"refundCondition": [
{
object ( |
| Поля | |
|---|---|
refundCondition[] | К данному полису не применяются никакие или более условий возврата средств. |
Условия возврата
Определяет одно условие возврата средств. Несколько условий возврата средств могут использоваться вместе для описания «этапов возврата», представляющих собой различные промежутки времени до начала оказания услуги.
| JSON-представление |
|---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
| Поля | |
|---|---|
minDurationBeforeStartTime | Период до начала оказания услуги, до которого клиент может получить возврат части стоимости услуги, указанной в Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « |
refundPercent | Процент, который может быть возвращен при условии отмены бронирования услуги как минимум |
Тип предоплаты
Перечисление для указания типа предоплаты.
| Перечисления | |
|---|---|
PREPAYMENT_TYPE_UNSPECIFIED | По умолчанию мы будем считать, что предоплата не поддерживается. |
REQUIRED | Пользователь должен оплатить эту услугу во время бронирования. |
OPTIONAL | Пользователь может внести предоплату за эту услугу во время бронирования или позже, но это не является обязательным условием для бронирования. |
NOT_SUPPORTED | Предоплата для данной услуги не предусмотрена. |
Условия предоплаты
Конкретная информация о сроках завершения предоплаты.
| JSON-представление |
|---|
{
"chargeTiming": enum ( |
| Поля | |
|---|---|
chargeTiming | Когда будет произведено списание средств относительно момента покупки. |
chargeTimeBeforeStartTimeSec | Время в секундах до начала оказания услуги, за которое с пользователя будет списана плата. Это поле следует заполнять только в том случае, если ChargeTiming имеет значение CHARGE_LATER. |
Время зарядки
Перечисление, указывающее, когда будет произведено списание средств относительно момента покупки.
| Перечисления | |
|---|---|
CHARGE_TIMING_UNSPECIFIED | Неиспользованный. |
CHARGE_NOW | С клиента будет списана сумма немедленно. |
CHARGE_LATER | С клиента будет взиматься плата позже. |
Форма приема заявок на услуги
Определяет форму заявки, которая позволяет персонализировать услуги, предоставляемые продавцом.
| JSON-представление |
|---|
{
"field": [
{
object ( |
| Поля | |
|---|---|
field[] | Поля, которые будут отображаться пользователю. |
firstTimeCustomers | Если это так, эта форма будет показана новым клиентам. Устарело. Данная функция не поддерживается для форм регистрации. |
returningCustomers | Если это так, эта форма будет показана постоянным клиентам. Устарело. Данная функция не поддерживается для форм регистрации. |
ServiceIntakeFormField
Определяет поле, которое включается в форму приема заявок на обслуживание (ServiceIntakeForm).
| JSON-представление |
|---|
{ "id": string, "type": enum ( |
| Поля | |
|---|---|
id | Строка от партнера-агрегатора, однозначно идентифицирующая поле формы. Этот идентификатор должен совпадать с идентификатором в соответствующем поле ответа формы и должен быть уникальным как для форм обработки запросов на уровне сервиса, так и для форм обработки запросов по отдельным заявкам. (обязательно) |
type | Тип данного поля. |
label | Текст, отображаемый пользователю в этом поле. Устарело, используйте |
localizedLabel | Текст, отображаемый пользователю в этом поле. Поле может быть заполнено на нескольких языках. (обязательно) |
value[] | Устанавливайте это значение только в том случае, если тип поля — LOCATION_SEARCH. Для указания значения местоположения используйте поле "locationId" в поле "location". |
choiceText[] | Устанавливается только в том случае, если тип поля — MULTIPLE_CHOICE, CHECKBOXES или DROPDOWN. Используется для перечисления возможных вариантов выбора. |
isRequired | Указывает, требуется ли пользователю ответить на вопросы в этом поле. |
allowCustomAnswer | Указывает, допускается ли добавление пользовательского значения помимо предопределенных ответов. Это применимо только в том случае, если тип поля — LOCATION_SEARCH. (необязательно) |
additionalOption[] | Дополнительные параметры предоставляются в дополнение к указанным значениям. Применимо только при типе поля LOCATION_SEARCH. Например, помимо предоставленного списка местоположений, может быть доступен еще один параметр: «Я свяжусь с поставщиком позже» (необязательно). |
ticketTypeRestrict[] | Если этот вопрос должен отображаться только при бронировании пользователем определенных типов билетов, в это поле следует установить набор идентификаторов соответствующих типов билетов. Оставьте поле пустым, если вопрос актуален всегда. |
hint | Текст подсказки для поля ввода, отображаемый в виде текстового заполнителя. Это применимо только в том случае, если тип поля — SHORT_ANSWER или PARAGRAPH. (необязательно) |
FieldType
Перечисление для указания типа поля.
| Перечисления | |
|---|---|
FIELD_TYPE_UNSPECIFIED | Поля неуказанного или неизвестного типа будут игнорироваться. |
SHORT_ANSWER | Однострочное поле ввода текста. |
PARAGRAPH | Многострочное текстовое поле ввода. |
MULTIPLE_CHOICE | Набор переключателей, требующих выбора одного варианта из множества возможных. |
CHECKBOXES | Один или несколько пунктов, перечисленных в списке, с флажками. |
DROPDOWN | Выбор из выпадающего списка. |
BOOLEAN | Кнопка «да/нет». |
LOCATION_SEARCH | Поле поиска, позволяющее находить подходящее местоположение на основе ввода пользователя из предоставленного списка местоположений. |
Тип услуги
Предопределенные типы услуг.
| Перечисления | |
|---|---|
SERVICE_TYPE_UNSPECIFIED | Неиспользованный. |
SERVICE_TYPE_DINING_RESERVATION | Бронирование столика в ресторане. |
SERVICE_TYPE_FOOD_ORDERING | Заказ еды может осуществляться как с доставкой, так и на вынос, или и тем, и другим одновременно. |
SERVICE_TYPE_FOOD_DELIVERY | Доставка еды. |
SERVICE_TYPE_FOOD_TAKEOUT | Еда на вынос. |
SERVICE_TYPE_EVENT_TICKET | Билет на мероприятие. |
SERVICE_TYPE_TRIP_TOUR | Экскурсионная поездка. |
SERVICE_TYPE_APPOINTMENT | Сервис, предоставляющий услуги записи на прием или проведения занятий. Рекомендуется для (1) здоровья и фитнеса, (2) спа-салонов и салонов красоты, и (3) финансовых консультаций и оценок. Список поддерживаемых типов услуг см. здесь: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT | Сервис, предоставляющий возможность онлайн-записи на занятия или сессии, которые будут проводиться полностью в виртуальном формате. Этот параметр необходимо включить, если требуется бронирование виртуальных услуг. |
SERVICE_TYPE_SHOPPING | Сервис, позволяющий пользователям совершать покупки у указанного продавца. Это может быть доставка или самовывоз. |
Тип билета
Параметр TicketType используется для различения билетов с разными ценами и/или доступностью в зависимости от типа пользователя, характеристик услуги или дополнительных опций/дополнений.
Билет — это минимальная единица бронирования услуги, например, места в сплаве по реке, входного билета в музей или аренды двухместного каяка на целый день.
| JSON-представление |
|---|
{ "ticketTypeId": string, "shortDescription": string, "localizedShortDescription": { object ( |
| Поля | |
|---|---|
ticketTypeId | Идентификатор билета используется для различения различных типов билетов на одну и ту же услугу и должен быть уникальным только в рамках одной услуги. |
shortDescription | Краткое описание данного типа билета. Это описание может быть видимым для пользователя, например, «взрослый», «ребенок», «ветеран», «ряд J» и т. д. Обязательно: каждый тип заявки должен иметь описание, видимое для пользователя. Устарело, используйте localizedShortDescription вместо него. |
localizedShortDescription | Краткое описание данного типа тикета с поддержкой интернационализации (i18n). Это может быть видимое для пользователя поле, например, «взрослый», «ребенок», «ветеран», «ряд J» и т. д. Обязательно, чтобы каждый тип билета имел видимое для пользователя описание. Для каждой локали можно указать отдельные значения. |
price | Цена одного билета данного типа указана без учета налогов. К билетам применяется налоговая ставка компании Service. |
perTicketFee | За покупку этого билета взимается дополнительная плата (по желанию). |
priceDisplayType | Необязательно. Предварительно заданный тип отображения цены для разового билета данного типа. |
optionDescription | Описание любых дополнительных опций, которые представляет данный тип заявки, если таковые имеются. Устарело, используйте вместо этого localizedOptionDescription. |
localizedOptionDescription | Описание любых дополнительных опций, которые представляет данный тип билета, если таковые имеются. Для каждого региона могут быть указаны отдельные значения. Дополнительные параметры полезны, когда тип билета отражает несколько аспектов. Пример 1: входной билет с различными типами: «взрослый», «ребенок» и языком в качестве дополнительной опции. Ожидаемый список TicketType будет следующим: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } } Пример 2: многочасовая аренда каяка с дополнительной опцией «герметичный мешок». В кратком описании может быть указано «3 часа», а в описании опции — «с герметичным мешком» или «без герметичного мешка»: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 часа" } localizedOptionDescription { value: "английский" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 часа" } localizedOptionDescription { value: "испанский" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 часа" } localizedOptionDescription { value: "английский" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 часа" } localizedOptionDescription { value: "испанский" } } Это поле необязательно, но если в рамках сервиса для какого-либо типа заявки оно задано, мы ожидаем, что для всех остальных типов заявок оно также будет задано (можно использовать значение по умолчанию optionDescription). Например, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] — недопустимый список. Поддерживаются только два тега форматирования HTML: и |
inventoryType | Необязательно. Предварительно определенный тип инвентаря для одного билета данного типа. |
Плата за билет
Сборы, которые необходимо оплатить за каждый приобретенный пользователем билет.
| JSON-представление |
|---|
{ "serviceCharge": { object ( |
| Поля | |
|---|---|
serviceCharge | За оказание услуги взимается дополнительная плата. |
facilityFee | Сбор, поступающий в распоряжение организаторов мероприятия/заведения. |
taxes | Налоги с каждого билета. |
PriceDisplayType
Указывает формат ценообразования, отображаемый на целевой странице.
Это поле игнорируется для товаров, не являющихся исходящими из системы ссылками.
Это поле позволяет Google отображать тот же формат цен, что и на целевой странице. Единые форматы цен повышают коэффициент конверсии и уменьшают путаницу.
| Перечисления | |
|---|---|
PRICE_DISPLAY_TYPE_UNSPECIFIED | Тип отображения цены не указан. Google определит, какой формат показывать. |
PRICE_DISPLAY_TYPE_BASE | Цена, указанная на целевой странице, является базовой ценой. |
PRICE_DISPLAY_TYPE_ALL_IN | Цена, указанная на целевой странице, включает все сборы и налоги. |
InventoryType
Заранее определенный тип инвентаризации отдельного билета данного типа.
| Перечисления | |
|---|---|
INVENTORY_TYPE_UNSPECIFIED | Тип товара не указан. |
INVENTORY_TYPE_PRIMARY | Первичный инвентарь. |
INVENTORY_TYPE_VERIFIED_RESALE | Проверенные запасы для перепродажи. |
INVENTORY_TYPE_RESALE | Товары, предназначенные для перепродажи. |
INVENTORY_TYPE_AGGREGATOR | Агрегаторный инвентарь. Агрегатор (например, www.bandsintown.com) означает, что партнер предоставляет информацию о мероприятиях и билетах. Но билеты не продаются партнером напрямую. Фактический продавец билетов может быть основным продавцом, проверенным перепродавцом или перепродавцом. Теперь мы различаем только тип инвентаря партнера верхнего уровня и игнорируем тип инвентаря фактического продавца билетов в рамках агрегатора. |
RelatedMedia
Фотографии, относящиеся к данной услуге. Google проиндексирует эти медиафайлы, чтобы убедиться в их корректном отображении для конечных пользователей. (необязательно)
| JSON-представление |
|---|
{ "url": string, "type": enum ( |
| Поля | |
|---|---|
url | URL этого медиаисточника. Google проиндексирует медиафайлы, размещенные по этому URL. |
type | Тип данного источника информации. |
localizedCaption | Заголовок медиафайла, поддерживающего интернационализацию (i18n), допускается только обычный текст. Любые HTML-компоненты будут удалены. (необязательно) |
attribution | Информация об источнике медиафайла. Обратите внимание, что если указание источника необходимо для отображения информации о фотографе или агентстве, это поле должно быть заполнено. (необязательно) |
caption | Устарело, предпочтительнее использовать localizedCaption. |
MediaType
Перечисление для указания типа данного медиафайла. Поддерживаются только фотографии. Если вам необходима поддержка других медиафайлов, помимо фотографий, пожалуйста, свяжитесь с командой Reserve with Google.
| Перечисления | |
|---|---|
TYPE_UNSPECIFIED | Неиспользованный. |
PHOTO | Указывает, что предоставленный по URL-адресу медиафайл представляет собой фотографию. |
Атрибуция
Информация об авторстве данного медиафайла.
| JSON-представление |
|---|
{
"localizedText": {
object ( |
| Поля | |
|---|---|
localizedText | Текст для указания авторства фотографа или агентства, поддерживающего интернационализацию. Этот текст будет отображаться вместе с исходным медиафайлом. Обратите внимание, что для этого поля поддерживается только обычный текст, любые HTML-компоненты будут удалены (указание авторства на основе гиперссылок не поддерживается). |
text | Устарело, предпочтительнее использовать localizedText. |
ServiceAttributeValueId
Определяет конкретное значение атрибута сервиса, которое должно быть применено к сервису.
| JSON-представление |
|---|
{ "attributeId": string, "valueId": string } |
| Поля | |
|---|---|
attributeId | Идентификатор атрибута, определенного в Merchant.service_attribute, например, "service-type". |
valueId | Идентификатор значения для этого атрибута, например, "стрижка". Должен совпадать с valueId в определении атрибута услуги. |
Правила списка ожидания
Правила, касающиеся включения в список ожидания.
| JSON-представление |
|---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
| Поля | |
|---|---|
minPartySize | Обязательно. Для сервисов, предоставляющих функцию списка ожидания, это должно быть положительное целое число. Если сервис или продавец не предоставляют функцию списка ожидания, это поле заполнять не следует. |
maxPartySize | Обязательно. Для сервисов, предоставляющих функцию списка ожидания, это должно быть положительное целое число. Если сервис или продавец не предоставляют функцию списка ожидания, это поле заполнять не следует. |
supportsAdditionalRequest | Если это так, пользователь сможет отправить дополнительный текстовый запрос в свободной форме при добавлении в список ожидания для этой услуги. |
aboveMaxPartySizeOptions[] | Задайте параметры для групп, численность которых превышает установленный параметр maxPartySize. Оставьте поле пустым, если группам с большим количеством участников не следует предлагать альтернативные варианты присоединения к списку ожидания. |
UnsupportedPartySizeOption
Варианты для сторон, находящихся вне зоны досягаемости.
| JSON-представление |
|---|
{ // Union field |
| Поля | |
|---|---|
kind поля объединения. Доступные варианты для сторон, выходящих за пределы диапазона. kind может принимать только одно из следующих значений: | |
callMerchant | Для групп, численность которых выходит за пределы допустимого диапазона, необходимо позвонить в ресторан. Пользователю будет отображено заранее заданное сообщение. Пример текста для отображения: «Для групп численностью более {waitlistRules.max_party_size}, пожалуйста, позвоните в ресторан по номеру {phone}». Параметр CallMerchant должен быть задан, но будет пустым. |
CallMerchant
Этот тип не содержит полей.
Пустое сообщение для использования в UnsupportedPartySizeOption; установка этого параметра отобразит пользователям возможность позвонить в компанию для бронирования.
TicketingVerticalSpecificData
Дополнительная информация, специфичная для сферы продажи билетов на мероприятия.
| JSON-представление |
|---|
{ "eventCategory": enum ( |
| Поля | |
|---|---|
eventCategory | Категория события. Устанавливается только в том случае, если событие попадает в одну из предопределенных категорий. (необязательно) |
eventUrl | URL мероприятия на сайте партнера. (необязательно) |
entity[] | Список объектов, связанных с событием. (необязательно) |
eventAttendanceMode | Обязательно. Тип посещения мероприятия. |
eventVirtualLocationUrl[] | Необязательно. URL-адрес, по которому можно посмотреть трансляцию события. |
eventOrganizer | Необязательно. Организатор, проводящий мероприятие. |
eventOrganizerUrl | Необязательно. URL-адрес организатора мероприятия. |
eventOrganizerType | Необязательно. Тип организатора. |
eventSourceUrl[] | Обязательно. URL-адреса страниц, где можно найти информацию о мероприятии или его описание. |
eventState | Необязательно. Состояние события. |
brandName | Необязательно. Локализованное название бренда. |
eventCreator | Необязательно. Информация об организаторе мероприятия. |
Категория события
Подмножество категорий событий, для которых мы настраиваем пользовательский опыт. Примечание: это не универсальная онтология событий.
| Перечисления | |
|---|---|
EVENT_CATEGORY_UNSPECIFIED | Не указано. Не использовать. |
EVENT_CATEGORY_CONCERT | Концерты. |
EVENT_CATEGORY_SPORTS | Спортивные мероприятия. |
EVENT_CATEGORY_THEATRE | Театральные мероприятия. |
EVENT_CATEGORY_EXHIBITS | Экспонаты. |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES | Мастер-классы и курсы. |
Сущность
Представляет собой сущность, связанную с событием.
| JSON-представление |
|---|
{ "id": string, "name": string, "url": string, "entityType": enum ( |
| Поля | |
|---|---|
id | Уникальный идентификатор объекта в базе данных партнера. (необязательно) |
name | Название организации. (обязательно) |
url | URL веб-страницы, однозначно описывающей сущность. Это веб-страница на веб-сайте партнера, посвященная данной сущности, если таковая имеется; для других общедоступных URL-адресов сущности используйте relevantUrl в publicIdentificationData. (необязательно) |
entityType | Тип сущности. (необязательно) |
entityRole | Роль объекта в событии. (необязательно) |
publicIdentificationData | Публичные ссылки на организацию. (необязательно) |
EntityType
Тип сущности. Примечание: данная онтология не является универсальной.
| Перечисления | |
|---|---|
ENTITY_TYPE_UNSPECIFIED | Не указано. Не использовать. |
ENTITY_TYPE_PERFORMER | Данная организация представляет собой артиста или группу, выступающую на концерте или представлении. Применимо только в том случае, если категория мероприятия — КОНЦЕРТ или ТЕАТР. |
ENTITY_TYPE_PLAYER | Данная организация представляет спортивную команду или игрока, участвующего в мероприятии. Применимо только в том случае, если категория мероприятия — СПОРТ. |
ENTITY_TYPE_CONCERT_TOUR | Данный объект представляет собой тур, к которому относится это мероприятие. Применимо только в том случае, если категория мероприятия — КОНЦЕРТ. |
ENTITY_TYPE_SPORTS_SERIES | Данный объект представляет собой спортивный турнир, к которому относится данное мероприятие. Применимо только в том случае, если категория мероприятия — СПОРТ. |
ENTITY_TYPE_PLAY | Данный объект обозначает тип представления (например, мюзикл, комедия, балет и т. д.), которое будет показано на мероприятии. Применимо только в том случае, если категория мероприятия — ТЕАТР. |
EntityRole
Роль субъекта в данном событии.
| Перечисления | |
|---|---|
ENTITY_ROLE_UNSPECIFIED | Не указан. |
ENTITY_ROLE_HEADLINER | Данная организация представляет собой хедлайнера или ведущего исполнителя на мероприятии. |
ENTITY_ROLE_SUPPORTER | Данная организация представляет собой артиста, выступающего на мероприятии в качестве приглашенного исполнителя. |
ENTITY_ROLE_HOME_TEAM | Данная организация представляет домашнюю команду на спортивном мероприятии. |
ENTITY_ROLE_AWAY_TEAM | Данная организация представляет гостевую команду на спортивном мероприятии. |
PublicIdentificationData
Идентификаторы, веб-страницы или любые другие общедоступные источники, содержащие ссылки на определённую организацию.
| JSON-представление |
|---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
| Поля | |
|---|---|
relevantUrl[] | Публичный URL любой веб-страницы, посвященной исключительно данной теме. Это могут быть официальные сайты, Discogs, страницы в социальных сетях, Википедии или IMDb, например, https://www.discogs.com/artist/1124645-Taylor-Swift , https://www.wikidata.org/wiki/Q19320959 , https://twitter.com/acmilan . (необязательно) |
musicbrainzId | 36-символьный идентификатор исполнителя или других музыкальных объектов в MusicBrainz (если применимо). См. https://musicbrainz.org/doc/MusicBrainz_Identifier (необязательно). |
Режим посещаемости
Тип посещаемости мероприятия.
| Перечисления | |
|---|---|
ATTENDANCE_MODE_UNSPECIFIED | Не указан. |
ONLINE | Для виртуальных мероприятий. |
PHYSICAL | Для мероприятий с физическим присутствием. |
PHYSICAL_ONLINE_MIXED | Для мероприятий, проводимых как в очном, так и в виртуальном формате. |
OrganizerType
Тип организатора.
| Перечисления | |
|---|---|
ORGANIZER_TYPE_UNSPECIFIED | Не указан. |
PERSON | Для организатора, который является человеком. |
ORGANIZATION | Для организатора, которым является организация. |
СобытиеСостояние
Текущее положение дел.
| Перечисления | |
|---|---|
EVENT_STATE_UNSPECIFIED | Не указан. |
SCHEDULED | Мероприятие запланировано. |
RESCHEDULED | Мероприятие перенесено. |
CANCELLED | Мероприятие отменено. |
POSTPONED | Мероприятие отложено. |
EventCreator
Информация об организаторе мероприятия. Актуально только для платформ, на которых размещается контент, созданный пользователями.
| JSON-представление |
|---|
{ "name": string } |
| Поля | |
|---|---|
name | Необязательно. Имя организатора мероприятия. Ограничений по количеству символов нет. |
Тип интеграции
Поддерживается глубина интеграции.
| Перечисления | |
|---|---|
INTEGRATION_TYPE_UNSPECIFIED | По умолчанию используется значение END_TO_END. |
INTEGRATION_TYPE_END_TO_END | Полная интеграция, позволяющая осуществлять бронирование от начала до конца через Google. |
INTEGRATION_TYPE_INVENTORY_ONLY | Сервер бронирования не обязан поддерживать эту услугу. Необходимо отправлять только информацию о продавцах, услугах и (при желании) данные о наличии мест. |
Комиссия за заказ
Сборы, которые необходимо оплатить один раз за заказ, независимо от количества билетов.
| JSON-представление |
|---|
{ "deliveryFee": { object ( |
| Поля | |
|---|---|
deliveryFee | Размер платы может варьироваться в зависимости от способа доставки. |
processingFee | Комиссия за обработку платежа, произведенного пользователем. |
Туры и мероприятия
Поля содержимого, специфичные для туров и мероприятий. Каждый элемент в повторяющемся поле должен быть независимым, чтобы обеспечить возможность его отдельного отображения (например, в виде маркированного списка).
Заполнение поля ToursAndActivitiesContent настоятельно рекомендуется для туров и мероприятий, но не является обязательным. Все поля поддерживают как обычный текст, так и текст, похожий на HTML, для базового форматирования. Поддерживаемые теги форматирования, похожие на HTML:
Фразовые теги:
, , , : Поддерживаются только три указанных выше тега.
Теги фраз можно использовать для переноса строк в абзацах, а теги / / — для выделения важного текста. Любые другие теги фраз будут проигнорированы.
Все остальные теги и пользовательские стили запрещены и будут удалены. Все URL-адреса, якоря и ссылки будут удалены и никогда не будут отображаться конечным пользователям.
Важные замечания: * Не дублируйте данные, уже предоставленные в highlights , exclusion и других, более специфических, полях описания услуги. * Избегайте использования других тегов, кроме упомянутых выше поддерживаемых, поскольку содержимое неподдерживаемых тегов будет удалено, что может привести к нежелательному пользовательскому опыту.
| JSON-представление |
|---|
{ "highlights": [ { object ( |
| Поля | |
|---|---|
highlights[] | Список основных моментов, отображаемый пользователю. |
inclusions[] | Список включений, отображаемый пользователю. |
exclusions[] | Список исключений, отображаемый пользователю. |
mustKnow[] | Список важных примечаний, отображаемый пользователю; используйте его для указания таких деталей, как возрастные ограничения или другие условия, при которых данная услуга не подходит. |
Расположение
Географическая информация о местоположении.
| JSON-представление |
|---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
| Поля | |
|---|---|
placeId | Идентификатор места (Place ID) в базе данных Google Places и на Google Maps. Дополнительную информацию об идентификаторах мест см. на странице https://developers.google.com/places/web-service/place-id . Если этот идентификатор указан, Google сопоставит местоположение с данным местом. |
name | Название местоположения, номер телефона, URL-адрес и географические данные используются для сопоставления местоположения с местами, уже присутствующими на Google Maps. Это поле необязательно, но в некоторых случаях может быть обязательным. Например, объект Service.location без имени не будет сопоставлен с бизнес-субъектом, даже если они расположены по одному и тому же адресу. (необязательно) |
telephone | Общедоступный телефонный номер населенного пункта, включая коды страны и региона, например, +14567891234. (необязательно) |
url | URL общедоступного веб-сайта данного места. (необязательно) |
geo | Географическая информация о местоположении, включая широту, долготу и адрес. (необязательно) |
locationType | Если данное местоположение используется для оказания услуги, необходимо указать его тип. |
locationId | Уникальный идентификатор местоположения в рамках услуги. Этот идентификатор можно использовать для ссылки на это местоположение в других полях услуги. Например, в пользовательской форме заявки набор идентификаторов местоположений можно использовать для указания вариантов места получения. Если задан, этот идентификатор должен быть уникальным в рамках одной услуги. (необязательно) |
LocationType
Тип данного места.
| Перечисления | |
|---|---|
LOCATION_TYPE_UNSPECIFIED | Тип местоположения не указан. |
VISITED_LOCATION | Место, которое посещает данная служба. |
START_LOCATION | Место, где начинается предоставление данной услуги, также служит местом проведения встречи (MEETING_LOCATION). |
END_LOCATION | Место, где заканчивается действие данной услуги. |
Рейтинг
Определяет рейтинг для объекта.
| JSON-представление |
|---|
{ "value": number, "numberOfRatings": string } |
| Поля | |
|---|---|
value | Среднее значение рейтинга (обязательно, если numberOfRatings > 0). Значение должно находиться в диапазоне [1, 5] и может быть опущено только в том случае, если numberOfRatings равно нулю. |
numberOfRatings | Количество оценок, использованных при расчете значения (обязательно). |
HomeServiceData
Дополнительная информация, которую необходимо предоставить для направления "Услуги на дому".
| JSON-представление |
|---|
{ "categoryType": string, "jobType": string } |
| Поля | |
|---|---|
categoryType | Категория высокого уровня, к которой относится данная услуга на дому. Например, сантехник, электрик и т. д. |
jobType | Тип задания, относящийся к категории, к которой относится данная услуга для дома. Например, unclog_drain, install_faucet — это типы заданий в категории «сантехник». |
Виртуальная сессия
Информация о виртуальных/онлайн-занятиях. Например, онлайн-уроки йоги, виртуальные кулинарные мастер-классы и т.д.
| JSON-представление |
|---|
{ "sessionInstructions": { object ( |
| Поля | |
|---|---|
sessionInstructions | Инструкции по настройке этого виртуального занятия. Если партнер не указывает URL-адрес видео при бронировании, то в этом тексте необходимо указать, когда URL-адрес видео будет предоставлен пользователю. Например: «URL-адрес Zoom будет отправлен по электронной почте за 30 минут до начала занятия». (Рекомендуется) |
sessionRequirements | Что необходимо для данного виртуального занятия. Например, коврик для йоги, кухонная утварь и т.д. (Рекомендуется) |
virtualPlatformInfo | Информация о виртуальной платформе, используемой в этой сессии. (Необходима для включения виртуальных сервисов) |
isSessionPrerecorded | Обязательно. Установите значение true, если виртуальная сессия не транслируется в прямом эфире и является предварительно записанной. |
VirtualPlatformInfo
Информация о платформе, которая будет использоваться для этой виртуальной сессии.
| JSON-представление |
|---|
{ "platform": enum ( |
| Поля | |
|---|---|
platform | Platform used for virtual session. |
otherPlatformName | The name of the platform if the platform is set to OTHER. (Required if platform is set to OTHER) |
Платформа
Enum to indicate which virtual platform would be used by the merchant.
| Перечисления | |
|---|---|
PLATFORM_UNSPECIFIED | Неиспользованный. |
FLEXIBLE | The merchant is flexible in which video platform they use. |
GOOGLE_HANGOUTS | Google Hangouts product. |
GOOGLE_MEET | Google Meet product. |
ZOOM | Zoom Video Communications. |
SKYPE | Скайп. |
YOUTUBE | Livestreaming in YouTube. |
OTHER | Should be set if the video platform used is different from the ones mentioned here. |
DirectMerchantPayment
Информация о том, как пользователь может оплатить услугу напрямую продавцу, вместо предварительной оплаты через RwG.
| JSON-представление |
|---|
{
"paymentMethods": [
{
object ( |
| Поля | |
|---|---|
paymentMethods[] | Пользователям рекомендуется оплачивать покупки только с помощью указанных ниже способов оплаты. |
UriTemplate
A template specifying how Google should generate URLs to external site.
| JSON-представление |
|---|
{ "uriTemplate": string } |
| Поля | |
|---|---|
uriTemplate | Optional. The uri template must follow the RFC6570, see https://datatracker.ietf.org/doc/html/rfc6570 . Supports Level 2 templates. These parameters will be resolved to their values specified in their respective entities. Available parameters for Dining Reservation Linkout: 1) (required) {availability_slot_start_seconds} :: populated from startSec field in availability feed 2) (required) {resources_party_size} :: populated from partySize field in availability feed 3) (optional) {availability_slot_duration_seconds} :: populated from durationSec field in availability feed 4) (optional) {availability_slot_availability_tag} :: populated from availabilityTag field in availability feed Example usage: http://example.com/book/restaurant?start={availability_slot_start_seconds } &num_guests={resources_party_size} With: * startSec = 123456 * partySize = 2 https://example.com/book/restaurant?start=123456&num_guests=2 |
Методы | |
|---|---|
| Создает новый Service для продавца, управляемого указанным агрегатором, и возвращает его. |
| Удаляет существующую Service продавца, управляемую указанным агрегатором. |
| Обновляет существующий Service продавца, управляемого указанным агрегатором, и возвращает его. |