REST Resource: inventory.partners.merchants.services

Ресурс: Сервис

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

JSON-представление
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
Поля
name

string

Имя ресурса сервиса имеет формат partners/{partner_id}/merchants/{merchantId}/services/{serviceId} .

serviceName

string

Название услуги, например, «Мужская стрижка». Устарело, используйте вместо него localizedServiceName.

localizedServiceName

object ( Text )

Название услуги, например, «Мужская стрижка». Возможно, используется в нескольких местах.

description

string

Описание сервиса, видимое пользователю. Устарело, используйте localizedDescription вместо него.

localizedDescription

object ( Text )

Описание услуги, видимое пользователю.

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

Поддерживаются теги форматирования, аналогичные HTML:

Теги заголовков: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Теги заголовков можно использовать для отображения заголовков и подзаголовков. Например, <h1>Маршрут</h1> отобразит встроенный текст в качестве наиболее важного заголовка раздела. Обратите внимание, что любые внутренние HTML-теги, стили или атрибуты будут игнорироваться. Например, <h1 style=".."> будет обрабатываться так же, как <h1>. Будет сохранен только чистый текст.

Тег абзаца: <p>
Тег абзаца можно использовать для выделения подробного введения или содержания. Любые внутренние теги, стили или атрибуты будут игнорироваться, за некоторыми исключениями: <br>, <strong> и <em>. Более подробную информацию см. в разделе «Теги фраз» ниже.

Список тегов: <ul>, <ol>, <li>
Тег <ul> можно использовать с тегом <li> для отображения неупорядоченных списков, а тег <ol> — с тегом <li> для отображения упорядоченных списков. Это хороший способ отображения контрольных списков, расписаний или любых других списков, подходящих для ваших задач.
Пример: Чтобы отобразить список особенностей круизного путешествия:
<ol>
<li>Прекрасный вид на океан и возможность понаблюдать за дикими животными.</li>
<li>Тщательно разработанные туристические услуги и организация поездок.</li>
<li>Гарантированно самая низкая цена.</li>
</ol>
Обратите внимание, что будут преобразованы только дочерние элементы <li> внутри тегов <ul> или <ol>. Все остальные дочерние элементы будут удалены. Кроме того, любые внутренние теги, атрибуты и стили будут проигнорированы; мы сохраним только текстовое содержимое.

Тег подразделения: <div>
Все поддерживаемые внутренние теги тега <div> будут обрабатываться в соответствии с указанными выше правилами, при этом сам тег <div> не подразумевает группировку или отступы. Кроме того, любые внутренние атрибуты и стили будут игнорироваться.

Фразовые теги: <br>, <strong>, <em>:
Поддерживаются только три упомянутых выше тега. Тег <br> можно использовать для переноса строк в абзацах, а теги <strong>/<em> — для выделения важного текста. Любые другие фразовые теги будут проигнорированы.

Неподдерживаемые теги:

  • Использование тегов <html>, <header> и <body> запрещено.
  • Любые другие теги, не упомянутые выше, не поддерживаются (например, <table>, <td> ...).
    Все URL-адреса, якоря и ссылки будут удалены и никогда не будут отображаться конечным пользователям. Если вы хотите использовать фотографии для создания расширенного пользовательского опыта, пожалуйста, используйте поле "relatedMedia" ниже, чтобы отправить URL-адреса ваших фотографий.

Важные примечания:

  • Старайтесь не использовать другие теги, кроме упомянутых выше поддерживаемых, поскольку содержимое неподдерживаемых тегов будет удалено, что может привести к нежелательному пользовательскому опыту.
  • Старайтесь избегать глубоко вложенных структур, таких как более 3 уровней заголовков или вложенные списки. Плоская, простая и понятная структура способствует улучшению пользовательского опыта.
  • Если поддерживаемых в настоящее время макетов недостаточно для ваших задач, пожалуйста, свяжитесь с командой Reserve with Google.
  • Рекомендуемый максимальный размер составляет 32 000 символов.
price

object ( Price )

Цена услуги.

priceInterpretation

enum ( PriceInterpretation )

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

rules

object ( SchedulingRules )

Правила записи/отмены записи на прием.

prepaymentType

enum ( PrepaymentType )

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

prepaymentTerms

object ( PrepaymentTerms )

Условия, касающиеся сроков завершения предоплаты.

form[]
(deprecated)

object ( ServiceIntakeForm )

Устарело. Пожалуйста, используйте intakeForm и perTicketIntakeForm.

intakeForm

object ( ServiceIntakeForm )

Форма для запроса дополнительной информации у пользователя при бронировании данной услуги. (необязательно)

perTicketIntakeForm

object ( ServiceIntakeForm )

Форма для запроса дополнительной информации у пользователя при бронировании данной услуги. Эту форму необходимо заполнить один раз для каждого бронируемого пользователем билета. (необязательно)

taxRate

object ( TaxRate )

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

paymentOptionId[]

string

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

deposit

object ( Deposit )

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

noShowFee

object ( NoShowFee )

Определяет размер платы за неявку, которая может быть взыскана с пользователя. Переопределяет плату за неявку, если она была указана. Установка пустого значения в сообщении NoShowFee отменяет любую плату за неявку, предусмотренную для данного сервиса. (необязательно)

requireCreditCard

enum ( RequireCreditCard )

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

type

enum ( ServiceType )

Предопределенный тип данной услуги. (необязательно)

ticketType[]

object ( TicketType )

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

relatedMedia[]

object ( RelatedMedia )

Фотографии, связанные с этим сервисом. Google будет индексировать и сохранять медиафайлы, чтобы обеспечить их наиболее эффективное отображение для конечных пользователей. (необязательно)

serviceAttributeValueId[]

object ( ServiceAttributeValueId )

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

waitlistRules

object ( WaitlistRules )

Правила включения в список ожидания.

ticketingVerticalSpecificData

object ( TicketingVerticalSpecificData )

Дополнительная информация, специфичная для данной сферы продажи билетов на мероприятия. (необязательно)

integrationType

enum ( IntegrationType )

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

perOrderFee

object ( PerOrderFee )

Комиссия за покупку данной услуги взимается на уровне заказа. (необязательно)

toursAndActivitiesContent

object ( ToursAndActivitiesContent )

Поля контента, относящиеся к турам и мероприятиям.

location[]

object ( Location )

Места, связанные с данной услугой. ВАЖНЫЕ ЗАМЕЧАНИЯ: Если с данной услугой связано несколько посещаемых мест или START_LOCATION отличается от VISITED_LOCATION, необходимо указать START_LOCATION. Пример: - Велосипедная экскурсия с гидом, посещающая три места, место начала необходимо указать. - Автобусная экскурсия, встреча в холле отеля, затем отправление к посещаемому месту. Место встречи необходимо указать.

rating

object ( Rating )

Пользовательский рейтинг этого сервиса как совокупный показатель по всем отзывам.

homeServiceData

object ( HomeServiceData )

Дополнительная информация, специфичная для сферы услуг на дому. (необязательно)

virtualSession

object ( VirtualSession )

Необязательно. Информация о виртуальной сессии. Она необходима для включения виртуальных сервисов.

directMerchantPayment

object ( DirectMerchantPayment )

Необязательно. Дополнительная информация, которую необходимо добавить, если услуга требует от пользователя прямой оплаты продавцу. ВАЖНОЕ ПРИМЕЧАНИЕ: RwG не будет участвовать в этой транзакции. Эта информация обязательна, если определена virtualSession, а услуга не является бесплатной или prepaymentType НЕ установлен в значение REQUIRED.

uriTemplate

object ( 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 (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
Поля
minAdvanceOnlineCanceling

string ( int64 format)

Минимальное время предварительного уведомления в секундах, необходимое для отмены забронированной онлайн-записи. (необязательно)

lateCancellationFee
(deprecated)

object ( Price )

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

noshowFee
(deprecated)

object ( Price )

Штраф за неявку без отмены бронирования.

admissionPolicy

enum ( AdmissionPolicy )

Правила доступа, применяемые к данной услуге. Если не задано, по умолчанию используется значение TIME_STRICT. (необязательно)

cancellationPolicy

object ( CancellationPolicy )

Правила бронирования и политика отмены бронирования. (Обязательно для раздела "Чем заняться")

Поле объединения min_booking_buffer . Продолжительность (в секундах) от момента, когда можно совершить последнее бронирование, до начала или окончания доступного временного интервала.

Если задан параметр "min_advance_booking", последнее доступное для бронирования время рассчитывается как (<время начала слота> - "min_advance_booking"). Если задан параметр "min_booking_buffer_before_end_time", последнее доступное для бронирования время рассчитывается как (<время окончания слота> - "min_booking_buffer_before_end_time"). Обратите внимание, что значение параметра "min_booking_buffer_before_end_time" должно быть положительным, если оно задано. Если оба параметра не заданы, слот доступен для бронирования до времени начала слота. Если оба поля заданы, будет выбрано только одно значение, а другое будет проигнорировано — мы не можем надежно предсказать, какое значение будет выбрано.

Примеры:

  • Стрижка, на которую необходимо записаться как минимум за 1 час до начала. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Музей, где последний билет можно приобрести за 30 минут до закрытия: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • Билет в кино, который необходимо приобрести до начала сеанса. 'scheduling_rules{ ...}' (оставьте это поле пустым) (необязательно) min_booking_buffer может принимать только одно из следующих значений:

minAdvanceBooking

string ( int64 format)

Продолжительность (в секундах) с момента, когда можно сделать последнее бронирование, до момента начала действия свободного временного интервала.

minBookingBufferBeforeEndTime

string ( int64 format)

Продолжительность (в секундах) с момента, когда можно сделать последнее бронирование, до окончания доступного временного интервала. Если это поле задано, поле "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)
    }
  ]
}
Поля
refundCondition[]

object ( RefundCondition )

К данному полису не применяются никакие или более условий возврата средств.

Условия возврата

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

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

string ( Duration format)

Период до начала оказания услуги, до которого клиент может получить возврат части стоимости услуги, указанной в refundPercent . Если установлено значение 0 (по умолчанию), услугу можно отменить в любое время.

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

refundPercent

integer ( uint32 format)

Процент, который может быть возвращен при условии отмены бронирования услуги как минимум minDurationBeforeStartTime до времени начала услуги, в диапазоне [0, 100]. Если установлено значение 0 (по умолчанию), услуга не подлежит возврату. Если установлено значение 100, услуга подлежит полному возврату.

Тип предоплаты

Перечисление для указания типа предоплаты.

Перечисления
PREPAYMENT_TYPE_UNSPECIFIED По умолчанию мы будем считать, что предоплата не поддерживается.
REQUIRED Пользователь должен оплатить эту услугу во время бронирования.
OPTIONAL Пользователь может внести предоплату за эту услугу во время бронирования или позже, но это не является обязательным условием для бронирования.
NOT_SUPPORTED Предоплата для данной услуги не предусмотрена.

Условия предоплаты

Конкретная информация о сроках завершения предоплаты.

JSON-представление
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Поля
chargeTiming

enum ( ChargeTiming )

Когда будет произведено списание средств относительно момента покупки.

chargeTimeBeforeStartTimeSec

string ( int64 format)

Время в секундах до начала оказания услуги, за которое с пользователя будет списана плата. Это поле следует заполнять только в том случае, если ChargeTiming имеет значение CHARGE_LATER.

Время зарядки

Перечисление, указывающее, когда будет произведено списание средств относительно момента покупки.

Перечисления
CHARGE_TIMING_UNSPECIFIED Неиспользованный.
CHARGE_NOW С клиента будет списана сумма немедленно.
CHARGE_LATER С клиента будет взиматься плата позже.

Форма приема заявок на услуги

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

JSON-представление
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
Поля
field[]

object ( ServiceIntakeFormField )

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

firstTimeCustomers
(deprecated)

boolean

Если это так, эта форма будет показана новым клиентам. Устарело. Данная функция не поддерживается для форм регистрации.

returningCustomers
(deprecated)

boolean

Если это так, эта форма будет показана постоянным клиентам. Устарело. Данная функция не поддерживается для форм регистрации.

ServiceIntakeFormField

Определяет поле, которое включается в форму приема заявок на обслуживание (ServiceIntakeForm).

JSON-представление
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
Поля
id

string

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

type

enum ( FieldType )

Тип данного поля.

label

string

Текст, отображаемый пользователю в этом поле. Устарело, используйте localizedLabel вместо него.

localizedLabel

object ( Text )

Текст, отображаемый пользователю в этом поле. Поле может быть заполнено на нескольких языках. (обязательно)

value[]

string

Устанавливайте это значение только в том случае, если тип поля — LOCATION_SEARCH. Для указания значения местоположения используйте поле "locationId" в поле "location".

choiceText[]

object ( Text )

Устанавливается только в том случае, если тип поля — MULTIPLE_CHOICE, CHECKBOXES или DROPDOWN. Используется для перечисления возможных вариантов выбора.

isRequired

boolean

Указывает, требуется ли пользователю ответить на вопросы в этом поле.

allowCustomAnswer

boolean

Указывает, допускается ли добавление пользовательского значения помимо предопределенных ответов. Это применимо только в том случае, если тип поля — LOCATION_SEARCH. (необязательно)

additionalOption[]

object ( Text )

Дополнительные параметры предоставляются в дополнение к указанным значениям. Применимо только при типе поля LOCATION_SEARCH. Например, помимо предоставленного списка местоположений, может быть доступен еще один параметр: «Я свяжусь с поставщиком позже» (необязательно).

ticketTypeRestrict[]

string

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

hint

object ( Text )

Текст подсказки для поля ввода, отображаемый в виде текстового заполнителя. Это применимо только в том случае, если тип поля — SHORT_ANSWER или PARAGRAPH. (необязательно)

FieldType

Перечисление для указания типа поля.

Перечисления
FIELD_TYPE_UNSPECIFIED Поля неуказанного или неизвестного типа будут игнорироваться.
SHORT_ANSWER Однострочное поле ввода текста.
PARAGRAPH Многострочное текстовое поле ввода.
MULTIPLE_CHOICE Набор переключателей, требующих выбора одного варианта из множества возможных.
CHECKBOXES Один или несколько пунктов, перечисленных в списке, с флажками.
DROPDOWN Выбор из выпадающего списка.
BOOLEAN Кнопка «да/нет».

Тип услуги

Предопределенные типы услуг.

Перечисления
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 (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
Поля
ticketTypeId

string

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

shortDescription

string

Краткое описание данного типа билета.

Это описание может быть видимым для пользователя, например, «взрослый», «ребенок», «ветеран», «ряд J» и т. д. Обязательно: каждый тип заявки должен иметь описание, видимое для пользователя. Устарело, используйте localizedShortDescription вместо него.

localizedShortDescription

object ( Text )

Краткое описание данного типа тикета с поддержкой интернационализации (i18n).

Это может быть видимое для пользователя поле, например, «взрослый», «ребенок», «ветеран», «ряд J» и т. д. Обязательно, чтобы каждый тип билета имел видимое для пользователя описание. Для каждой локали можно указать отдельные значения.

price

object ( Price )

Цена одного билета данного типа указана без учета налогов. К билетам применяется налоговая ставка компании Service.

perTicketFee

object ( PerTicketFee )

За покупку этого билета взимается дополнительная плата (по желанию).

priceDisplayType

enum ( PriceDisplayType )

Необязательно. Предварительно заданный тип отображения цены для разового билета данного типа.

optionDescription

string

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

localizedOptionDescription

object ( Text )

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

Дополнительные параметры полезны, когда тип билета отражает несколько аспектов.

Пример 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

enum ( InventoryType )

Необязательно. Предварительно определенный тип инвентаря для одного билета данного типа.

Плата за билет

Сборы, которые необходимо оплатить за каждый приобретенный пользователем билет.

JSON-представление
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
Поля
serviceCharge

object ( Price )

За оказание услуги взимается дополнительная плата.

facilityFee

object ( Price )

Сбор, поступающий в распоряжение организаторов мероприятия/заведения.

taxes

object ( Price )

Налоги с каждого билета.

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 (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
Поля
url

string

URL этого медиаисточника. Google проиндексирует медиафайлы, размещенные по этому URL.

type

enum ( MediaType )

Тип данного источника информации.

localizedCaption

object ( Text )

Заголовок медиафайла, поддерживающего интернационализацию (i18n), допускается только обычный текст. Любые HTML-компоненты будут удалены. (необязательно)

attribution

object ( Attribution )

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

caption
(deprecated)

string

Устарело, предпочтительнее использовать localizedCaption.

MediaType

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

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

Атрибуция

Информация об авторстве данного медиафайла.

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

object ( Text )

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

text
(deprecated)

string

Устарело, предпочтительнее использовать localizedText.

ServiceAttributeValueId

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

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

string

Идентификатор атрибута, определенного в Merchant.service_attribute, например, "service-type".

valueId

string

Идентификатор значения для этого атрибута, например, "стрижка". Должен совпадать с valueId в определении атрибута услуги.

Правила списка ожидания

Правила, касающиеся включения в список ожидания.

JSON-представление
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
Поля
minPartySize

integer

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

maxPartySize

integer

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

supportsAdditionalRequest

boolean

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

aboveMaxPartySizeOptions[]

object ( UnsupportedPartySizeOption )

Задайте параметры для групп, численность которых превышает установленный параметр maxPartySize. Оставьте поле пустым, если группам с большим количеством участников не следует предлагать альтернативные варианты присоединения к списку ожидания.

UnsupportedPartySizeOption

Варианты для сторон, находящихся вне зоны досягаемости.

JSON-представление
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
Поля
kind поля объединения. Доступные варианты для сторон, выходящих за пределы диапазона. kind может принимать только одно из следующих значений:
callMerchant

object ( CallMerchant )

Для групп, численность которых выходит за пределы допустимого диапазона, необходимо позвонить в ресторан. Пользователю будет отображено заранее заданное сообщение. Пример текста для отображения: «Для групп численностью более {waitlistRules.max_party_size}, пожалуйста, позвоните в ресторан по номеру {phone}». Параметр CallMerchant должен быть задан, но будет пустым.

CallMerchant

Этот тип не содержит полей.

Пустое сообщение для использования в UnsupportedPartySizeOption; установка этого параметра отобразит пользователям возможность позвонить в компанию для бронирования.

TicketingVerticalSpecificData

Дополнительная информация, специфичная для сферы продажи билетов на мероприятия.

JSON-представление
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
Поля
eventCategory

enum ( EventCategory )

Категория события. Устанавливается только в том случае, если событие попадает в одну из предопределенных категорий. (необязательно)

eventUrl

string

URL мероприятия на сайте партнера. (необязательно)

entity[]

object ( Entity )

Список объектов, связанных с событием. (необязательно)

eventAttendanceMode

enum ( AttendanceMode )

Обязательно. Тип посещения мероприятия.

eventVirtualLocationUrl[]

string

Необязательно. URL-адрес, по которому можно посмотреть трансляцию события.

eventOrganizer

object ( Text )

Необязательно. Организатор, проводящий мероприятие.

eventOrganizerUrl

string

Необязательно. URL-адрес организатора мероприятия.

eventOrganizerType

enum ( OrganizerType )

Необязательно. Тип организатора.

eventSourceUrl[]

string

Обязательно. URL-адреса страниц, где можно найти информацию о мероприятии или его описание.

eventState

enum ( EventState )

Необязательно. Состояние события.

brandName

object ( Text )

Необязательно. Локализованное название бренда.

eventCreator

object ( 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 (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
Поля
id

string

Уникальный идентификатор объекта в базе данных партнера. (необязательно)

name

string

Название организации. (обязательно)

url

string

URL веб-страницы, однозначно описывающей сущность. Это веб-страница на веб-сайте партнера, посвященная данной сущности, если таковая имеется; для других общедоступных URL-адресов сущности используйте relevantUrl в publicIdentificationData. (необязательно)

entityType

enum ( EntityType )

Тип сущности. (необязательно)

entityRole

enum ( EntityRole )

Роль объекта в событии. (необязательно)

publicIdentificationData

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

string

Публичный URL любой веб-страницы, посвященной исключительно данной теме. Это могут быть официальные сайты, Discogs, страницы в социальных сетях, Википедии или IMDb, например, https://www.discogs.com/artist/1124645-Taylor-Swift , https://www.wikidata.org/wiki/Q19320959 , https://twitter.com/acmilan . (необязательно)

musicbrainzId

string

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

string

Необязательно. Имя организатора мероприятия. Ограничений по количеству символов нет.

Тип интеграции

Поддерживается глубина интеграции.

Перечисления
INTEGRATION_TYPE_UNSPECIFIED По умолчанию используется значение END_TO_END.
INTEGRATION_TYPE_END_TO_END Полная интеграция, позволяющая осуществлять бронирование от начала до конца через Google.
INTEGRATION_TYPE_INVENTORY_ONLY Сервер бронирования не обязан поддерживать эту услугу. Необходимо отправлять только информацию о продавцах, услугах и (при желании) данные о наличии мест.

Комиссия за заказ

Сборы, которые необходимо оплатить один раз за заказ, независимо от количества билетов.

JSON-представление
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
Поля
deliveryFee

object ( Price )

Размер платы может варьироваться в зависимости от способа доставки.

processingFee

object ( Price )

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

Туры и мероприятия

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

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

Фразовые теги:
, , , : Поддерживаются только три указанных выше тега.
Теги фраз можно использовать для переноса строк в абзацах, а теги / / — для выделения важного текста. Любые другие теги фраз будут проигнорированы.

Все остальные теги и пользовательские стили запрещены и будут удалены. Все URL-адреса, якоря и ссылки будут удалены и никогда не будут отображаться конечным пользователям.

Важные замечания: * Не дублируйте данные, уже предоставленные в highlights , exclusion и других, более специфических, полях описания услуги. * Избегайте использования других тегов, кроме упомянутых выше поддерживаемых, поскольку содержимое неподдерживаемых тегов будет удалено, что может привести к нежелательному пользовательскому опыту.

JSON-представление
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
Поля
highlights[]

object ( Text )

Список основных моментов, отображаемый пользователю.

inclusions[]

object ( Text )

Список включений, отображаемый пользователю.

exclusions[]

object ( Text )

Список исключений, отображаемый пользователю.

mustKnow[]

object ( Text )

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

Расположение

Географическая информация о местоположении.

JSON-представление
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
Поля
placeId

string

Идентификатор места (Place ID) в базе данных Google Places и на Google Maps. Дополнительную информацию об идентификаторах мест см. на странице https://developers.google.com/places/web-service/place-id . Если этот идентификатор указан, Google сопоставит местоположение с данным местом.

name

string

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

Это поле необязательно, но в некоторых случаях может быть обязательным. Например, объект Service.location без имени не будет сопоставлен с бизнес-субъектом, даже если они расположены по одному и тому же адресу. (необязательно)

telephone

string

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

url

string

URL общедоступного веб-сайта данного места. (необязательно)

geo

object ( GeoCoordinates )

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

locationType

enum ( LocationType )

Если данное местоположение используется для оказания услуги, необходимо указать его тип.

locationId

string

Уникальный идентификатор местоположения в рамках услуги. Этот идентификатор можно использовать для ссылки на это местоположение в других полях услуги. Например, в пользовательской форме заявки набор идентификаторов местоположений можно использовать для указания вариантов места получения. Если задан, этот идентификатор должен быть уникальным в рамках одной услуги. (необязательно)

LocationType

Тип данного места.

Перечисления
LOCATION_TYPE_UNSPECIFIED Тип местоположения не указан.
VISITED_LOCATION Место, которое посещает данная служба.
START_LOCATION Место, где начинается предоставление данной услуги, также служит местом проведения встречи (MEETING_LOCATION).
END_LOCATION Место, где заканчивается действие данной услуги.

Рейтинг

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

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

number

Среднее значение рейтинга (обязательно, если numberOfRatings > 0). Значение должно находиться в диапазоне [1, 5] и может быть опущено только в том случае, если numberOfRatings равно нулю.

numberOfRatings

string

Количество оценок, использованных при расчете значения (обязательно).

HomeServiceData

Дополнительная информация, которую необходимо предоставить для направления "Услуги на дому".

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

string

Категория высокого уровня, к которой относится данная услуга на дому. Например, сантехник, электрик и т. д.

jobType

string

Тип задания, относящийся к категории, к которой относится данная услуга для дома. Например, unclog_drain, install_faucet — это типы заданий в категории «сантехник».

Виртуальная сессия

Информация о виртуальных/онлайн-занятиях. Например, онлайн-уроки йоги, виртуальные кулинарные мастер-классы и т.д.

JSON-представление
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
Поля
sessionInstructions

object ( Text )

Инструкции по настройке этого виртуального занятия. Если партнер не указывает URL-адрес видео при бронировании, то в этом тексте необходимо указать, когда URL-адрес видео будет предоставлен пользователю. Например: «URL-адрес Zoom будет отправлен по электронной почте за 30 минут до начала занятия». (Рекомендуется)

sessionRequirements

object ( Text )

Что необходимо для данного виртуального занятия. Например, коврик для йоги, кухонная утварь и т.д. (Рекомендуется)

virtualPlatformInfo

object ( VirtualPlatformInfo )

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

isSessionPrerecorded

boolean

Обязательно. Установите значение true, если виртуальная сессия не транслируется в прямом эфире и является предварительно записанной.

VirtualPlatformInfo

Информация о платформе, которая будет использоваться для этой виртуальной сессии.

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

enum ( Platform )

Platform used for virtual session.

otherPlatformName

object ( Text )

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 (Text)
    }
  ]
}
Поля
paymentMethods[]

object ( Text )

Пользователям рекомендуется оплачивать покупки только с помощью указанных ниже способов оплаты.

UriTemplate

A template specifying how Google should generate URLs to external site.

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

string

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

Методы

create

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

delete

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

patch

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