Package google.maps.booking.v1alpha

Индекс

AdsAccountLinkingService

Сервис для управления связью аккаунтов между Google Ads и Партнерским центром.

Уведомление о бронировании

Получает уведомления о записях на прием от внешних партнеров по планированию. Партнер должен вызвать либо UpdateBooking, либо UpdateOrder в зависимости от того, использует ли он RPC-вызовы на основе бронирования, такие как CreateBooking и CheckAvailability, или RPC-вызовы на основе заказов, такие как CreateOrder и CheckOrderFulfillability.

Обновление бронирования

rpc UpdateBooking( UpdateBookingRequest ) returns ( Booking )

Обновляет существующее Booking .

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
ОбновитьПорядок

rpc UpdateOrder( UpdateOrderRequest ) returns ( Order )

Обновляет существующий Order .

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking

Кормить

Получение информации о статусе обработки загруженных фидов от внешних партнеров-агрегаторов.

GetStatus

rpc GetStatus( GetStatusRequest ) returns ( FeedStatus )

Получает Status ранее загруженного фида указанным агрегатором и возвращает его.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
ListStatus

rpc ListStatus( ListStatusRequest ) returns ( ListStatusResponse )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking

InvalidationService

Получает запросы на аннулирование ресурсов от внешних партнеров.

InvalidateResource

rpc InvalidateResource( InvalidateResourceRequest ) returns ( Empty )

Аннулирует существующий ресурс.

Запрос игнорируется, если запрашиваемый ресурс не подписан на сервис Google.

Поддерживаемые типы ресурсов: - Самовывоз

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking

Статус запасов

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

GetMerchantStatus

rpc GetMerchantStatus( GetMerchantStatusRequest ) returns ( MerchantStatus )

Получите статус Merchant MerchantStatus ).

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
ListMerchantStatuses

rpc ListMerchantStatuses( ListMerchantStatusesRequest ) returns ( ListMerchantStatusesResponse )

Перечислите все MerchantStatus партнера, удовлетворяющие условиям фильтра.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking

Обновление инвентаря

Получает обновления информации о наличии товаров от внешних агрегаторов.

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords( BatchDeleteGenericRecordsRequest ) returns ( Empty )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
BatchPushGenericRecord

rpc BatchPushGenericRecord( BatchPushGenericRecordRequest ) returns ( Empty )

Вставляет и/или обновляет записи указанного типа фида. Выполняет только базовую проверку (например, на наличие некорректного запроса), после чего партнеру немедленно возвращается соответствующий ответ. Google выполняет проверку бизнес-логики запроса асинхронно. Этот пакетный вызов не гарантирует атомарность.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability( BatchReplaceServiceAvailabilityRequest ) returns ( BatchReplaceServiceAvailabilityResponse )

Заменяет Availability существующих Services . Этот пакетный вызов не гарантирует атомарность. Будут возвращены только успешно обновленные слоты доступности.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
CreateMerchant

rpc CreateMerchant( CreateMerchantRequest ) returns ( Merchant )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
Создать сервис

rpc CreateService( CreateServiceRequest ) returns ( Service )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
Удалить продавца

rpc DeleteMerchant( DeleteMerchantRequest ) returns ( Empty )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
DeleteService

rpc DeleteService( DeleteServiceRequest ) returns ( Empty )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
ReplaceServiceAvailability

rpc ReplaceServiceAvailability( ReplaceServiceAvailabilityRequest ) returns ( ServiceAvailability )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
Обновить продавца

rpc UpdateMerchant( UpdateMerchantRequest ) returns ( Merchant )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking
Служба обновления

rpc UpdateService( UpdateServiceRequest ) returns ( Service )

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

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/mapsbooking

ActionLinkType

Заранее определенный тип действия, связанный с определенной связью действий.

Перечисления

Метаданные события

Дополнительная информация о ссылке на действие, уникальной для тематического направления «Мероприятия».

Поля
surface

Surface

Заранее определенная поверхность событий, связанная со ссылкой на действие. Это используется только для вертикальной структуры «События».

Поверхность

Заранее определенная поверхность событий, связанная со ссылкой на действие. Это используется только для вертикальной структуры «События».

Перечисления
SURFACE_UNSPECIFIED Тип поверхности не указан.
SURFACE_YOUTUBE Ссылка для активации ведет к бронированию билета на мероприятие на YouTube.
SURFACE_ADS Ссылка для совершения действия ведет к клику на рекламное объявление мероприятия.

ActionPlatform

Платформа, на которой выполняется действие. Веб-приложение обычно используется в качестве резервного варианта. Рекомендуется иметь как минимум одну ActionLink с ACTION_PLATFORM_WEB_APPLICATION. Ссылки с платформами Android и iOS используются только в соответствующих системах.

Перечисления
ACTION_PLATFORM_UNSPECIFIED Платформа не указана.
ACTION_PLATFORM_WEB_APPLICATION Платформа для действий в целом представляет собой веб-ресурс.
ACTION_PLATFORM_MOBILE_WEB Платформа для проведения мероприятий доступна в веб-формате на мобильных устройствах.
ACTION_PLATFORM_ANDROID Платформа для выполнения действий — операционная система Android.
ACTION_PLATFORM_IOS Платформа для действия — iOS.

Состояние

Ссылка на страницу состояния аккаунта Ads.

Перечисления
STATE_UNSPECIFIED Неизвестное состояние.
LINKED Аккаунт связан между Партнерским центром и Рекламным порталом.
PENDING Аккаунт ожидает одобрения либо в Партнерском центре, либо на Рекламном портале.
DELETED Ссылка на аккаунт удалена.
REJECTED Запрос на привязку аккаунта отклоняется либо Партнерским центром, либо Рекламным порталом.

Консультации

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

Поля
text

Text

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

Доступность

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

Поля
start_time

Timestamp

Время начала назначенного приема.

duration

Duration

Продолжительность сеанса приема

spots_total

int64

Общее количество мест и количество свободных мест в рамках данной вакансии. Примеры:

  • Занятие по йоге на 10 мест, 3 места забронированы: availability {spots_total: 10, spots_open: 7 ...}
  • Сеанс массажа на стуле, который уже полностью забронирован: availability {spots_total: 1, spots_open: 0 ...}

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

  • Повторение подразумевает spots_total=1 и spots_open=1 .
  • Ошибка ScheduleException означает, что spots_total=1 и spots_open=0 .
spots_open

int64

Количество свободных мест.

availability_tag

string

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

resources

Resources

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

Например, один и тот же урок йоги с двумя инструкторами:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }
payment_option_id[]

string

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

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

recurrence

Recurrence

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

schedule_exception[]

ScheduleException

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

deposit

Deposit

Внесение необязательного депозита за данную услугу. Заменяет собой депозит за услугу, если он был указан.

no_show_fee

NoShowFee

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

prepayment

Prepayment

Необязательно. Информация о предоплате за этот вариант размещения необязательна.

require_credit_card

RequireCreditCard

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

ticket_type_id[]

string

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

  • Услуга предоставляется с четырьмя типами билетов: TicketType {ticket_type_id: "adult_1" short_description: "Взрослые в будние дни"} TicketType {ticket_type_id: "adult_2" short_description: "Взрослые в выходные дни"} TicketType {ticket_type_id: "youth_1" short_description: "Молодежные в будние дни"} TicketType {ticket_type_id: "youth_2" short_description: "Молодежные в выходные дни"}

Для отображения наличия билетов в будние дни: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...} . Для отображения наличия билетов в праздничные дни: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...} .

  • Услуга с тремя типами билетов: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

Чтобы указать, что все три типа билетов доступны в этот временной интервал, используйте либо availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} , либо `availability {...}' (не указывайте ticket_type_id в этом интервале).

(необязательный)

duration_requirement

DurationRequirement

Необходимо указать продолжительность и/или время окончания слота. Это поле будет проигнорировано, если слот недоступен. Не используется в разделе «Чем заняться». (необязательно)

scheduling_rule_overrides

SchedulingRuleOverrides

Правила планирования доступности. Если поля заполнены, они переопределят любые соответствующие правила планирования на уровне сервиса в разделе SchedulingRules.

confirmation_mode

ConfirmationMode

Режим подтверждения, который будет использоваться при бронировании данного варианта размещения. Попытки создания бронирований для вариантов размещения с режимом подтверждения CONFIRMATION_MODE_SYNCHRONOUS должны быть немедленно подтверждены или отклонены. Попытки создания бронирований для вариантов размещения с режимом подтверждения CONFIRMATION_MODE_ASYNCHRONOUS должны быть либо немедленно отклонены, либо созданы со статусом PENDING (ожидание).

linkout_required_reason

LinkoutRequiredReason

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

Режим подтверждения

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

Перечисления
CONFIRMATION_MODE_UNSPECIFIED Режим подтверждения не указан. Будет предполагаться синхронное подтверждение.
CONFIRMATION_MODE_SYNCHRONOUS Бронирование на этот период будет подтверждено синхронно.
CONFIRMATION_MODE_ASYNCHRONOUS Бронирование на этот период будет подтверждаться в асинхронном режиме.

Требования к продолжительности

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

Перечисления
DURATION_REQUIREMENT_UNSPECIFIED Обработка времени окончания не указана. Это значение по умолчанию.
DO_NOT_SHOW_DURATION Время окончания не отображается пользователю.
MUST_SHOW_DURATION Перед тем как записаться на прием, пользователю необходимо показать время окончания.

LinkoutRequiredReason

Причина, по которой в слоте присутствует эффект "связного взаимодействия".

Перечисления
LINKOUT_REQUIRED_REASON_UNSPECIFIED Значение по умолчанию: Не использовать, соответствует неизвестному значению.
PAYMENT_REQUIRED Для бронирования слота необходима оплата на партнерской платформе.

Рецидив

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

Требования:

  1. Расширение слотов доступности или периодичности НЕ должно приводить к созданию идентичных слотов. Если идентификаторы, время начала, длительность и ресурсы совпадают, слоты считаются идентичными.
  2. Не следует смешивать стандартный формат доступности и формат с регулярным посещением в рамках одной услуги. Формат с регулярным посещением выгоден продавцам/сервисам, предлагающим запись на прием. Стандартный формат ориентирован на продавцов/сервисы, предлагающие регулярные занятия.
  3. Продолжительность рецидивов не должна превышать 24 часов.
Поля
repeat_until

Timestamp

Максимальное время доступности, включая временную метку UTC, будет повторяться до тех пор, пока...

repeat_every

Duration

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

Пример: Доступность с продолжительностью 20 мин, периодом повтора 30 мин, временем начала 9:00 и временем повтора до 11:00 даст слоты в 9:00-9:20, 9:30-9:50, 10:00-10:20, 10:30-10:50, 11:00-11:20. (обязательно)

ScheduleException

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

Поля
time_range

TimeRange

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

Пример: Если в заданном интервале повторения указано время 20 мин, период повторения 30 мин, время начала 9:00 и время повторения до 11:00, то исключение ScheduleException с временным диапазоном 9:45–11:00 сделает недоступными временные интервалы 9:30–9:50, 10:00–10:20 и 10:30–10:50.

Обратите внимание, что поскольку временной диапазон является закрытым/открытым, это не повлияет на временной интервал, начинающийся в 11:00.

SchedulingRuleOverrides

Правила планирования на основе уровня доступности.

Поля
last_bookable_sec

int64

Последнее время (в секундах), когда этот слот можно было забронировать. Эта метка времени должна быть до start_sec слота, чтобы ее учитывать (если пользователи должны иметь возможность бронировать после времени начала, используйте SchedulingRules.min_booking_before_end_time уровня сервиса). Если присутствует, переопределит все, что указано в min_booking_buffer правил SchedulingRules соответствующего сервиса.

first_bookable_sec

int64

Первое время (в секундах), когда этот слот можно забронировать. Эта метка времени должна быть раньше, чем start_sec слота, или last_bookable_sec, если указано.

last_online_cancellable_sec

int64

Если задано, указывается последнее время (в секундах с начала эпохи Unix), когда этот конкретный слот для записи можно отменить через функцию «Зарезервировать с помощью Google». Это поле переопределяет любые правила отмены на уровне сервиса. (необязательно)

BatchDeleteGenericRecordsRequest

Пакетный запрос на удаление записей указанного типа потока данных.

Поля
parent

string

Название ресурса, имеющее формат - partners/{partner_id}/feeds/{feed_name} .

records[]

GenericDeleteRecord

Записи, подлежащие удалению. Максимальное количество записей в одном вызове API — 1000.

BatchPushGenericRecordRequest

Пакетный запрос на вставку и/или обновление записей типа ленты, указанного в URL-адресе запроса.

Поля
parent

string

Название ресурса, имеющее формат - partners/{partner_id}/feeds/{feed_name} .

records[]

GenericRecord

Записи, которые необходимо вставить и/или обновить. Максимальное количество записей в одном вызове API — 1000.

BatchReplaceServiceAvailabilityRequest

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

Поля
parent

string

Формат partners/{partner_id} .

extended_service_availability[]

ExtendedServiceAvailability

Расширенная доступность услуг, которая используется для замены существующих слотов доступности.

BatchReplaceServiceAvailabilityResponse

Пакетный ответ для замены нескольких слотов доступности Service . В это сообщение будут включены только успешно обновленные слоты.

Поля
extended_service_availability[]

ExtendedServiceAvailability

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

Бронирование

Бронирование места в товарном запасе

Поля
name

string

Название ресурса бронирования: partners/{partner ID}/bookings/{booking ID}

merchant_id

string

Идентификатор продавца для игрового автомата

service_id

string

Идентификатор сервиса продавца

start_time

Timestamp

Время начала назначенного приема

duration

Duration

Продолжительность сеанса приема

client_information

ClientInformation

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

status

BookingStatus

Статус бронирования

payment_information

PaymentInformation

Информация о платежных операциях, связанных с бронированием.

party_size

int64

количество человек в группе, забронировавших номер.

BookingFailure

Данные о статусе, указывающие на причину асинхронной обработки бронирования. BookingFailure предназначен в первую очередь для выявления ошибок бизнес-логики.

Поля
cause

Cause

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

rejected_card_type

CreditCardType

(требуется только в том случае, если причиной является PAYMENT_ERROR_CARD_TYPE_REJECTED)

description

string

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

payment_failure

PaymentFailureInformation

Информация о сбоях платежей.

Причина

Перечисление причин отказов.

Перечисления
CAUSE_UNSPECIFIED Значение по умолчанию: Не использовать; это означает "неизвестную ошибку".
SLOT_UNAVAILABLE Указанный временной интервал недоступен.
SLOT_ALREADY_BOOKED_BY_USER Пользователь уже забронировал встречу на указанный временной интервал.
LEASE_EXPIRED Срок действия договора аренды (если таковой был предоставлен) истек, и его больше нельзя использовать для завершения запрошенного бронирования.
OUTSIDE_CANCELLATION_WINDOW В настоящее время отмена заказа невозможна из-за временных ограничений, установленных в политике отмены заказов продавца.
PAYMENT_ERROR_CARD_TYPE_REJECTED Произошла ошибка при обработке платежа, поскольку указанный тип кредитной карты не был принят продавцом. Тип кредитной карты необходимо указывать в поле rejected_card_type.
PAYMENT_ERROR_CARD_DECLINED Произошла ошибка при обработке платежа, поскольку предоставленная кредитная карта была отклонена.
PAYMENT_OPTION_NOT_VALID Произошла ошибка при использовании пакета/членства, примененного для оплаты бронирования. Возможно, не осталось действительных использований, срок действия истек и т.д.
PAYMENT_ERROR При обработке платежа по этому бронированию произошла ошибка. Используйте это значение для обозначения общей ошибки, связанной с платежом, только если ошибка не соответствует конкретной ошибке платежа, указанной выше.
USER_CANNOT_USE_PAYMENT_OPTION Пользователь не может использовать указанный способ оплаты (например, пользователь пытается использовать цену, указанную в первый раз, во второй раз).
BOOKING_ALREADY_CANCELLED Бронирование, которое пользователь пытался отменить, уже было отменено.
BOOKING_NOT_CANCELLABLE Бронирование, которое пользователь пытался отменить, отменить невозможно.
OVERLAPPING_RESERVATION У пользователя уже есть бронирование на слишком близкое к этому времени время.
USER_OVER_BOOKING_LIMIT Бронирование не удалось, поскольку пользователь превысил лимит бронирований, установленный агрегатором для одного пользователя.
PAYMENT_REQUIRES_3DS1

Установите значение, при котором платеж отклоняется, поскольку вы запрашиваете повторную попытку транзакции, но на этот раз после проверки подлинности (3DS1) с помощью запроса/ответа. Обратите внимание, что текущее состояние неудачной транзакции останется «неудачным». Повторная попытка будет выполнена отдельно.

Если причиной сбоя является именно это, параметр payment_failure.3DS1_parameters ДОЛЖЕН быть установлен. В противном случае текущая причина будет рассматриваться как ошибка платежа (PAYMENT_ERROR).

Информация о сбое платежа

Информация о сбоях платежей.

Поля
threeds1_parameters

ThreeDS1Parameters

Параметры, используемые агрегатором RwG для инициирования протокола аутентификации 3DS1 с пользователем. Будут игнорироваться, если параметр BookingFailure.cause не установлен в значение PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Параметры, запрашивающие у RwG выполнение проверки 3DS1.

Параметры задаются в соответствии с описанием протокола 3DS1, предоставленным компанией EMVCo.

Поля
acs_url

string

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

pa_req

string

Запрос на аутентификацию платежа. Будет отправлен в форму ACSUrl, если она предоставлена.

transaction_id

string

Идентификатор, используемый поставщиком ACS. При необходимости будет отправлен в форму ACSUrl.

md_merchant_data

string

Данные продавца. Будут отправлены в форму ACSUrl, если предоставлены.

Статус бронирования

Статус бронирования

Перечисления
BOOKING_STATUS_UNSPECIFIED Не указан.
CONFIRMED Бронирование подтверждено.
PENDING_MERCHANT_CONFIRMATION Бронирование ожидает подтверждения от продавца, прежде чем оно сможет перейти в статус ПОДТВЕРЖДЕНО (в настоящее время эта функция НЕ поддерживается).
PENDING_CLIENT_CONFIRMATION Бронирование ожидает подтверждения от клиента, прежде чем оно сможет перейти в статус ПОДТВЕРЖДЕНО (в настоящее время эта функция НЕ поддерживается).
CANCELED Бронирование было отменено по вине пользователя.
NO_SHOW Клиент не явился на прием.
NO_SHOW_PENALIZED Клиент не явился на назначенную встречу, нарушив правила отмены записи.
FAILED Бронирование не удалось завершить из-за ошибки обработки.
DECLINED_BY_MERCHANT Бронирование было отклонено продавцом в асинхронном режиме.

CallMerchant

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

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

Политика отмены

Правила отмены заказа.

Поля
refund_condition[]

RefundCondition

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

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

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

Поля
min_duration_before_start_time

Duration

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

refund_percent

uint32

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

Информация о клиенте

Персональные данные лица, осуществляющего бронирование.

Поля
given_name

string

Имя клиента

family_name

string

Фамилия клиента

address

PostalAddress

Адрес клиента

telephone

string

Номер телефона клиента

email

string

Адрес электронной почты клиента

CreateAdsAccountLinkRequest

Сообщение запроса для AdsAccountLinkingService.CreateAdsAccountLink.

Поля
parent

string

Обязательно. Родительский ресурс, где будет создана ссылка на этот рекламный аккаунт. Это тот же идентификатор, что и в Партнерском центре. Формат: partners/{partner}

CreateMerchantRequest

Запрос на создание Merchant .

Поля
parent

string

Имя родительского ресурса для партнера, которому принадлежит данный продавец, в формате partners/{partner_id} .

merchant_id

string

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

merchant

Merchant

Торговец должен создать.

CreateServiceRequest

Запрос на создание новой Service .

Поля
parent

string

Имя родительского ресурса для продавца, которому принадлежит данная услуга, в формате partners/{partner_id}/merchants/{merchant_id} .

service_id

string

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

service

Service

Сервис для создания.

Ограничения по кредитным картам

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

Поля
credit_card_type[]

CreditCardType

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

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

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

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

DeleteAdsAccountLinkRequest

Сообщение запроса для AdsAccountLinkingService.DeleteAdsAccountLink.

Поля
name

string

Обязательно. Название ссылки на рекламный аккаунт, которую нужно удалить. Формат: partners/{partner}/adsAccountLinks/{ads_account_link}

DeleteMerchantRequest

Запрос на удаление Merchant .

Поля
name

string

Имя ресурса продавца, которого нужно удалить. В формате partners/{partner_id}/merchants/{merchant_id}

DeleteServiceRequest

Запрос на удаление Service .

Поля
name

string

Имя ресурса сервиса, который нужно удалить. В формате partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Вклад

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

Поля
deposit

Price

Сумма депозита.

min_advance_cancellation_sec

int64

Минимальный размер предоплаты при отмене заказа для внесения депозита.

deposit_type

PriceType

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

DirectMerchantPayment

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

Поля
payment_methods[]

Text

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

Диапазон продолжительности

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

Поля
min_duration

Duration

Минимальная продолжительность.

max_duration

Duration

Максимальная продолжительность.

Экономический оператор

Информация об экономическом операторе для агрегатора.

Поля
text

Text

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

Расширенная доступность услуг

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

Поля
merchant_id

string

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

service_id

string

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

start_time_restrict

Timestamp

Если предоставленные данные о доступности указаны, мы будем рассматривать их как полный снимок состояния на момент времени [start_time_restrict, end_time_restrict]. То есть, вся существующая доступность будет удалена, если выполняется следующее условие:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Если задано условие по длительности, то условие дополнительно ограничивается:

  availability.duration == duration_restrict

Если задано сообщение resources_restrict, условие дополнительно ограничивается:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

Установка параметра start_time_restrict при отсутствии параметра end_time_restrict интерпретируется как "все время, начинающееся с start_time_restrict".

end_time_restrict

Timestamp

Установка параметра end_time_restrict при отсутствии параметра start_time_restrict интерпретируется как "все время до значения end_time_restrict".

duration_restrict

Duration

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

resources_restrict

Resources

Установка параметра resources_restrict дополнительно ограничивает область обновления только этим набором ресурсов. Все поля id ресурсов должны точно совпадать.

availability[]

Availability

Новый список доступных товаров.

FeedStatistics

Статистические данные, полученные в процессе обработки загруженного видеопотока.

Поля
new_items

int64

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

existing_items

int64

Существующие элементы обновляются по мере необходимости на основе новой информации из ленты.

deleted_items

int64

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

FeedStatus

Статус ленты, загруженной платформой агрегатора.

Поля
name

string

Название ресурса ленты, имеющее следующий формат:

  • partners/{partner_id}/feeds/merchants/{file_name}
  • partners/{partner_id}/feeds/services/{file_name}
  • partners/{partner_id}/feeds/availability/{file_name}
state

State

Состояние обработки данного потока данных.

error_details

string

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

statistics

FeedStatistics

Статистика, относящаяся непосредственно к этой ленте.

Состояние

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

Перечисления
STATE_UNSPECIFIED Значение по умолчанию. Не используется.
IN_PROGRESS Обработка корма еще продолжается.
SUCCESS Обработка корма прошла успешно.
FAILURE В процессе обработки ленты возникла ошибка.

Метаданные заказа еды

Метаданные для ссылок, используемых при оформлении заказа еды.

Поля
fee_details[]

FeeDetails

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

advance_order_details

AdvanceOrderDetails

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

Поле Union field fulfillment_duration_options . Время выполнения заказа с момента подтверждения заказа. Для заказов с доставкой — время до доставки еды. Для заказов с самовывозом — время до готовности еды к выдаче. fulfillment_duration_options может принимать только одно из следующих значений:
fulfillment_lead_time_duration

Duration

Фиксированная продолжительность. Например: 30 минут.

fulfillment_lead_time_duration_range

DurationRange

Диапазон продолжительности. Примеры: * от 30 до 45 минут * Более 30 минут * Менее 50 минут

Предварительные сведения о заказе

Для оформления предварительного заказа.

Поля
is_supported

bool

Значение True, если поддерживаются предварительные заказы (также известные как заказы заранее). (обязательно)

Подробности о комиссионных сборах

Подробная информация о платежах.

Поля
type

FeeType

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

fee_amount

FeeAmount

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

Сумма комиссии

Примеры FeeAmount : * Фиксированная комиссия: 0 долларов США (без комиссии), 1,5 доллара США * Диапазон фиксированной комиссии: 1,0 доллар США (минимум), 3,0 доллара США (максимум), 5,0-6,0 долларов США * Процент от размера корзины: 15,5%, 10%-20%, 10% (минимум), 15% (максимум) * Составная сумма диапазона и процента: 25,5% и 2,5 доллара США (минимум), 25,5% и 4,5 доллара США (максимум), 10% и 1,5-2,5 доллара США, 10,5%-20% и 2,5-3,5 доллара США

Поля
cart_percentage

QuantitativeValue

Комиссия в процентах от стоимости корзины. Поддерживается диапазон (ограниченный и неограниченный) или фиксированный процент. Значение должно быть от 0 до 100. Примеры: * Фиксированная 5,5% * Не менее 5,5% * Не более 5,5% * От 4,5% до 5,5%

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

Money

Фиксированная сумма. Например, 3,5 доллара США.

amount_range

MoneyRange

Диапазон сумм. Примеры: * от 3,5 до 5,5 долларов США * Минимум 3,5 доллара США * Максимум 5,5 доллара США

amount_unknown

bool

Неизвестная сумма.

FeeType

Тип оплаты.

Перечисления
FEE_TYPE_UNSPECIFIED Тип платы не указан.
DELIVERY Стоимость доставки.
SERVICE Стоимость услуг.

Вариант выполнения

Ссылка для выполнения онлайн-заказа.

Поля
fulfillment_type

FulfillmentType

Обязательно. Тип выполнения.

available_day[]

AvailableDay

Обязательно. Список дней, когда доступен данный способ выполнения заказа (желательно не менее 2).

fee_details

FeeDetails

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

minimum_order

Price

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

Доступный день

Доступно в течение дня.

Поля
fulfillment_date

Date

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

last_ordering_time

Timestamp

Обязательно. Временная метка Unix. Последнее время, когда пользователь мог сделать заказ и получить товары до даты fulfillment_date . Другими словами, после last_ordering_time дата выполнения заказа больше не будет отображаться как доступная.

Например, если fulfillment_date — 2020-08-10: — значение last_ordering_time, равное 2020-08-10 18:00, означает, что для получения заказа 10.08.2020 клиент должен оформить заказ до 18:00 того же дня. — значение last_ordering_time, равное 20:00.2020, означает, что для получения заказа 10.08.2020 клиент должен оформить заказ до 20:00 за два дня до этого.

Подробности о комиссионных сборах

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

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

NoFee

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

base_fee

MinimumFee

Базовая плата, связанная с методом выполнения заказа.

fixed_fee

FixedFee

Фиксированная плата, связанная с методом выполнения заказа.

Фиксированная плата

Фиксированная плата, взимаемая за способ выполнения заказа, связанный с ссылкой для совершения действия.

Поля
amount

Price

Обязательно. Размер фиксированной платы за выбранный способ выполнения заказа.

Тип выполнения

Тип выполнения, связанный со ссылкой для совершения действия.

Перечисления
FULFILLMENT_TYPE_UNSPECIFIED Тип выполнения заказа не указан.
FULFILLMENT_TYPE_DELIVERY Тип выполнения заказа — доставка.
FULFILLMENT_TYPE_PICKUP Тип выполнения заказа — самовывоз.

Минимальная плата

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

Поля
base_fee_amount

Price

Обязательно. Базовая сумма комиссии за выбранный способ выполнения заказа.

Без комиссии

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

За использование метода выполнения заказа, связанного с ссылкой для совершения действия, плата не взимается.

GenericDeleteRecord

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

Поля
delete_time

Timestamp

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

Поле объединения record_type . Инкапсулирует различные типы фидов (ndjson, на основе протоколов и т. д.). Партнер может предоставить полную запись, аналогично тому, как запись предоставляется в фиде или API BatchPush. Партнеры также могут включать только необходимые поля записи, требуемые для ее уникальной идентификации. record_type может принимать только одно из следующих значений:
data_record

bytes

Для кормов, не основанных на прототипах.

proto_record

Any

Для кормов на основе прототипов.

GenericRecord

Запись о типе фида, указанном в URL-запросе.

Поля
generation_timestamp

Timestamp

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

Поле объединения record_type . Инкапсулирует различные типы фидов (ndjson, на основе прототипов и т. д.). record_type может принимать только одно из следующих значений:
data_record

bytes

Для кормов, не основанных на прототипах.

proto_record

Any

Для кормов на основе прототипов.

Геокоординаты

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

Поля
latitude

double

Широта в градусах. (необязательно)

longitude

double

Долгота в градусах. (необязательно)

addresses в объединенных полях. Адрес местоположения может быть как структурированным, так и неструктурированным. addresses может быть только одним из следующих:
address

PostalAddress

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

unstructured_address

string

В качестве запасного варианта можно указать неструктурированный адрес. Например: "1600 amphitheatre parkway mountain view, ca 94043"

GetAdsAccountLinkRequest

Сообщение запроса для AdsAccountLinkingService.GetAdsAccountLink.

Поля
name

string

Обязательно. Название ссылки на рекламный аккаунт, которую необходимо получить. Формат: partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

Запрос на получение статуса MerchantStatus

Поля
name

string

Обязательно. Название ресурса в формате partners/{partner_id}/merchants/{merchant_id}/status.

GetStatusRequest

Запрос на получение Status для конкретного фида, загруженного платформой агрегатора.

Поля
name

string

Название ресурса ленты, имеющее следующий формат:

  • partners/{partner_id}/feeds/merchants/{file_name}
  • partners/{partner_id}/feeds/services/{file_name}
  • partners/{partner_id}/feeds/availability/{file_name}

HomeServiceData

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

Поля
category_type

string

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

job_type

string

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

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

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

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

InvalidateResourceRequest

Запрос на аннулирование ресурса.

Поля
resource_id

string

Название ресурса, подлежащего аннулированию.

Например, для ресурса Pickup имя должно иметь формат partners/{partner_id}/pickups/{pickup_id} . Реализация ОБЯЗАТЕЛЬНО должна удалять кэшированные версии указанного ресурса.

Позиция

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

Поля
service_id

string

Идентификатор сервиса продавца.

start_sec

int64

Время начала назначенного сеанса записи в секундах по UTC с момента начала эпохи Unix.

duration_sec

int64

Продолжительность сеанса приема в секундах.

tickets[]

OrderedTickets

Количество билетов, заказанных по типу билета.

price

Price

Общая стоимость (без учета налогов) данной позиции.

status

BookingStatus

Статус позиции.

Заказанные билеты

Количество заказанных билетов по типу билета.

Поля
ticket_id

string

Идентификатор типа билета.

count

int32

Количество билетов, заказанных на этот тип.

LinkoutTemplate

Шаблон, определяющий, как Google должен генерировать URL-адреса для сайта партнера.

Поля
uri_template

string

Шаблон URI должен соответствовать RFC 6570, см. https://datatracker.ietf.org/doc/html/rfc6570 . Поддерживает шаблоны уровня 1 и все составные шаблоны уровня 4. Например: http://example.com/book/{foo}?b={bar } * foo = 2 * bar = abc https://example.com/book/2?b=abc

ListMerchantStatusesRequest

Запрос на получение списка MerchantStatus

Поля
parent

string

Обязательно. Родительская компания, которой принадлежит эта коллекция статусов продавцов. Формат: partners/{partner_id}/merchants

page_size

int32

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

page_token

string

Необязательно. Значение nextPageToken, возвращаемое из предыдущего ListMerchantStatusResponse, если таковое имелось.

booking_inventory_status_restrict

BookingInventoryStatus

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

waitlist_inventory_status_restrict

WaitlistInventoryStatus

Необязательно. Дополнительное ограничение для фильтрации результатов по статусу наличия мест в списке ожидания.

geo_match_restrict

GeoMatchingStatus

Необязательно. Дополнительное ограничение для фильтрации результатов по статусу географического соответствия.

Статус бронирования

Полный список доступных для бронирования мест.

Перечисления
BOOKING_INVENTORY_STATUS_UNSPECIFIED Не указан.
NO_VALID_FUTURE_INVENTORY У продавца нет свободных мест для бронирования в течение следующих 30 дней.
HAS_VALID_FUTURE_INVENTORY У продавца есть свободные места для бронирования в течение следующих 30 дней.

GeoMatchingStatus

Статус географического соответствия продавца.

Перечисления
GEO_MATCHING_STATUS_UNSPECIFIED Не указан.
GEO_UNMATCHED Местоположение продавца не определено.
GEO_MATCHED Торговец соответствует географическому местоположению.

WaitlistInventoryStatus

Полный список доступных мест в списке ожидания.

Перечисления
WAITLIST_INVENTORY_STATUS_UNSPECIFIED Не указан.
NO_VALID_WAITLIST_SERVICE У продавца нет сервиса, поддерживающего списки ожидания.
HAS_VALID_WAITLIST_SERVICE У продавца есть сервис, поддерживающий создание списков ожидания.

ListMerchantStatusesResponse

Ответ на запрос списка MerchantStatus .

Поля
merchant_statuses[]

MerchantStatus

Список статусов продавцов, удовлетворяющих условиям фильтра.

next_page_token

string

Токен для перехода на следующую страницу результатов. Если список пуст, в нем больше нет результатов.

ListStatusRequest

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

Поля
name

string

Название ресурса ленты, имеющее следующий формат:

  • partners/{partner_id}/feeds/merchants
  • partners/{partner_id}/feeds/services
  • partners/{partner_id}/feeds/availability
page_size

int32

Максимальное количество товаров, подлежащих возврату.

page_token

string

Значение next_page_token, возвращенное из предыдущего запроса List, если таковой имелся.

state_restrict

State

Дополнительное ограничение для фильтрации результатов по состоянию потока.

time_range_restrict

TimeRange

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

ListStatusResponse

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

Поля
status[]

FeedStatus

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

next_page_token

string

Токен для перехода на следующую страницу результатов. Если список пуст, в нем больше нет результатов.

LocalizedString

Экземпляр строки в одной локали.

Поля
locale

string

Языковой код IETF BCP 47, например, "en", "mas", "zh-Hant", "de-CH-1901". См. http://www.w3.org/International/articles/language-tags/ .

value

string

Сообщение в указанной выше кодировке (UTF-8).

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

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

Поля
place_id

string

The Place ID for a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id for more about Place IDs. If this is provided, Google will match the location to this place.

name

string

The location's name, telephone, url and geo are used to support matching the location with places already present on Google Maps.

This field is optional, but may be required in some contexts. For example, a Service.location without a name will not be matched to a business entity, even if they are located at the same address. (optional)

telephone

string

The public telephone number of the location including its country and area codes, eg +14567891234. (optional)

url

string

The url of the location's public website. (optional)

geo

GeoCoordinates

The Geo info of the location, including latitude, longitude, and address. (optional)

location_type

LocationType

The type of the location, must be supplied if this location is provided for a Service.

location_id

string

Unique reference of the location within the service. This id can be used to refer to this location in other service fields. Eg in the custom intake form, a set of location ids can be used to specify pick up location options. If set, this id should be unique within the same service. (optional)

LocationType

The type of this location.

Перечисления
LOCATION_TYPE_UNSPECIFIED Location type unspecified.
VISITED_LOCATION The location where this service visits.
START_LOCATION The location where this service starts, also serves as MEETING_LOCATION.
END_LOCATION The location where this service ends.

Торговец

Info about a merchant that is on the aggregator's platform.

Поля
name

string

The merchant resource name, which has the format of partners/{partner_id}/merchants/{merchant_id} .

merchant_name

string

The merchant_name, telephone, url and geo are used to support matching partner inventory with merchants already present on Google Maps. This information will not be displayed.

The name of the merchant.

telephone

string

The public telephone number of the merchant including its country and area codes, eg +14567891234.

url

string

The url of the merchant's public website.

geo

GeoCoordinates

The Geo info of the merchant, including latitude, longitude, and address.

category

string

The category of the business in aggregator's platform.

num_bookings_30d
(deprecated)

int64

This field is deprecated.

tax_rate_basis_points
(deprecated)

uint32

The merchant's tax rate in basis points (one hundredth of one percent). For example, if the tax rate is 7.5%, this field should be set to 750.

If this field is left unset or set to 0, the total price charged to a user for any service provided by this merchant is the exact price specified by Service.price. The service price is assumed to be exempt from or already inclusive of applicable taxes. Taxes will not be shown to the user as a separate line item.

If this field is set to any nonzero value, the total price charged to a user for any service provided by this merchant will include the service price plus the tax assessed using the tax rate provided here. Fractions of the smallest currency unit (for example, fractions of one cent) will be rounded using nearest even rounding. Taxes will be shown to the user as a separate line item.

This field is deprecated, please use tax_rate instead.

tax_rate
(deprecated)

TaxRate

The merchant's tax rate. If present this field overrides the deprecated tax_rate_basis_points field. An empty message (ie tax_rate { }) will reset the applied tax rate to zero. Deprecated since E2E payments is no longer supported.

payment_restrictions
(deprecated)

PaymentRestrictions

Restrictions to the payment methods this merchant accepts. We assume no restrictions exist if this field is not set. Deprecated since E2E payments is no longer supported.

payment_option[]
(deprecated)

PaymentOption

Payment options available for this merchant. Services under this merchant will be able to individually limit the payment options they allow. Deprecated since E2E payments is no longer supported.

payment_processor_config
(deprecated)

PaymentProcessorConfig

Configuration for a tokenized payment processor, if the merchant has support for it.

tokenization_config
(deprecated)

TokenizationConfig

Configuration for a tokenized payment processor, if the merchant has support for it. Deprecated since E2E payments is no longer supported.

terms

Terms

The specific merchant's Terms and Conditions displayed to the user when a service is being booked through Reserve with Google. In addition to these the aggregator partner's Terms and Conditions are always displayed to the user and must not be provided here.

brand_id

string

An opaque string that identifies the consumer-facing brand to use when displaying partner attribution. This field allows partners with multiple consumer-facing brands to provide merchants for all brands within the same feed.

A brand consists of consumer-facing properties like the name, logo, Terms of Service, and Privacy Policy.

If there is only one consumer-facing partner brand, this field does not need to be set and can be ignored.

If the partner...

Does not have multiple consumer-facing brands? --> Ignore this field

Has Multiple Brands that are configured?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Careful Note: most partners do not need to set this field. If a partner wishes to use this field, they must contact us first to configure separate brands, including the default brand.

matching_hints

MerchantMatchingHints

Hints to help Google match a merchant to a place on Google Maps. Note: most partners do not need to set this field, as Google will match merchants to places on Google Maps using the information provided above. (optional)

service_attribute[]

ServiceAttribute

Definitions for any service attributes used to describe the Services for this Merchant. (optional)

reservation_linkout_template[]

LinkoutTemplate

Optional. The linkout template that specifies how Google should generate the partner's URL to reserve a table on their platform.

Note that currently only the first one will be used if multiple are provided.

The URI template has support for fields which will be populated based on the user's reservation selections, all required fields are needed to build a reservation URL successfully: * (required) party_size, int: The size of the party for which the user is requesting a reservation. * (required) selected_date_time, ISO 8601 datetime ( https://en.wikipedia.org/wiki/ISO_8601) : The time the user is requesting a reservation for. * (optional) merchant_id, string: The ID of the Merchant the user is requesting a reservation with, not needed if template already includes a merchant identifier. * (optional) room_id, string: The id of the room the user is requesting a reservation for.

waitlist_advisement

Advisement

Optional. General advisements from a specific merchant for a user joining a waitlist through Reserve with Google. Individual text fields in the advisement should be limited to 100 bytes in length.

economic_operator

EconomicOperator

Optional. Economic Operator information associated to this specific merchant needed for regulatory compliance. (optional)

MerchantMatchingHints

Hints used to help Google match a merchant to a place on Google Maps.

Поля
place_id

string

The Place ID for a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id for more about Place IDs.

MerchantStatus

Status of a merchant in the Reserve with Google platform.

Поля
name

string

The merchant status resource name, which has the format of partners/{partner_id}/merchants/{merchant_id}/status

merchant_name

string

Name of the merchant provided by partners.

input_geo_info

GeoCoordinates

Partners provided Geo info of the merchant.

processing_status

ProcessingStatus

Merchant processing status.

booking_status

BookingStatus

Status related to end-to-end booking integration.

waitlist_status

WaitlistStatus

Status related to waitlist integration.

geo_match

PlaceInfo

Matched Geo place of this merchant. Empty if the merchant is not Geo matched.

local_services_match

LocalServicesMatchInfo

Local services match of this merchant. Empty if it is not a local service merchant or is not matched to any providers.

direct_urls[]

DirectUrl

A list of URLs to demonstrate the content of the current merchant inventory. Note that it doesn't mean the inventory is actually being served and the URL may be different from the public visible ones.

BookingStatus

Status related to end-to-end booking integration.

Поля
has_valid_future_inventory

bool

True if the merchant has inventory in the next 30 day. Doesn't guarantee the merchant is actually served.

DirectUrl

URL that surfaces the merchant.

Поля
type

UrlType

Type of this URL.

url

string

URL that may surface this merchant.

UrlType

Type of the surfacing URL.

Перечисления
URL_TYPE_UNSPECIFIED Не указан.
BOOKING End-to-end booking URL.
WAITLIST End-to-end waitlist URL.
LOCAL_SERVICES Google Local Services URL.

LocalServicesMatchInfo

Information of the Google local services match (only set for local services merchant).

Поля
matched_providers[]

MatchedProvider

Matched service providers. A merchant can be matched to multiple service providers.

MatchedProvider

Local services provider.

Поля
customer_id

int64

Google local services external customer ID.

categories[]

string

Local service categories (verticals). Eg "plumber" and "carpet_cleaning".

PlaceInfo

Information of a matched place.

Поля
name

string

Name of the place.

formatted_address

string

Formatted address in local language.

place_id

string

Google Place ID of this place. Can be used to construct Google Maps URL or fetch more details of the place. See https://developers.google.com/places/web-service/place-id for example usage.

ProcessingStatus

Merchant processing status.

Перечисления
PROCESSING_STATUS_UNSPECIFIED Status unspecified.
IN_PROGRESS The merchant has been received by Madden, but is still being processed. Merchants in this status will not have other status populated.
COMPLETED Other statuses of the merchant have been computed.

WaitlistStatus

Status related to waitlist integration.

Поля
has_valid_waitlist_service

bool

True if the merchant has waitlist service. Doesn't guarantee the merchant is actually served.

MoneyRange

Wrapper for a range of monetary amount that could be bounded or unbounded. At least one of min_amount and max_amount is required.

Поля
min_amount

Money

Минимальная сумма.

max_amount

Money

Максимальная сумма.

NoShowFee

A fee that a user may be charged if they have made a booking but do not show up.

Поля
fee

Price

The amount the user may be charged if they do not show up for their reservation.

fee_type

PriceType

Defines how the fee is determined from the availability.

Заказ

An order for service appointments with a merchant.

Поля
name

string

Resource name of the order: partners/{partner ID}/orders/{order ID}

client_information

ClientInformation

Personal information of the client making the order.

payment_information

PaymentInformation

Information about payment transactions that relate to the order.

merchant_id

string

ID of the merchant that all services in this order belong to.

item[]

LineItem

Line items in this order.

Метаданные онлайн-заказа

Метаданные для ссылки, ведущей к онлайн-заказу.

Поля
fulfillment_option[]

FulfillmentOption

Доступные варианты выполнения заказа по ссылке для онлайн-заказа.

Платежная информация

Payment details that relate to a booking

Поля
prepayment_status

PrepaymentStatus

Prepayment status of the booking. If the prepayment_status is PREPAYMENT_PROVIDED or PREPAYMENT_REFUNDED, then payment_transaction_id contains the associated unique transaction id.

payment_transaction_id

string

Unique identifier for a payment transaction associated with the booking. Empty if not applicable.

PaymentOption

A payment option, which can be used to pay for services provided by a merchant. Payment options can be shared among multiple merchants (eg merchants belonging to the same chain).

Поля
payment_option_id

string

This ID is used to identify this payment option.

This ID is global to the whole aggregator, and re-using a value across multiple merchants will allow a user to pay with the corresponding payment option across those merchants.

When re-using an ID accoss multiple merchants, updating any value for a payment option under one merchant will also update any other payment option with the same ID, under a different merchant. As such, it's a best practice to have all payment options sharing the same ID, always be updated to identical values, to avoid any possibility of underministic behavior.

name

string

The name of the payment option. This can be user visible.

description

string

A description of the payment option. This can be user visible.

price

Price

The price of the payment option.

tax_rate

TaxRate

The tax rate for this payment option. If present this field overrides the tax_rate field present in the Merchant or Service. An empty message (ie tax_rate { }) will reset the applied tax rate to zero.

payment_option_type

PaymentOptionType

The type of this payment option. Single-use for drop-ins, multi-use for packs, and unlimited for memberships.

session_count

int64

How many sessions this payment option can be used for. Valid only for multi-session / packs, where the value should be > 1.

purchase_interval

TimeRange

The payment option can be purchased within this interval.

valid_interval

TimeRange

The payment option can be used within this interval (eg special price for January 2017). If present, this overrides valid_duration and activation_type.

valid_duration

Duration

Duration of the payment option validity (eg 30 day membership).

activation_type

ActivationType

Defines how the validity start date is determined for this payment option.

user_restriction

UserPurchaseRestriction

Restricts the users eligible to purchase this payment option. Can be used to restrict a promotional payment option to a subset of users. If not set, all users are eligible.

ActivationType

Defines how the validity start date is determined.

Перечисления
ACTIVATION_TYPE_UNSPECIFIED Неиспользованный.
ACTIVATION_ON_PURCHASE Validity starts at the time of purchase.
ACTIVATION_ON_FIRST_USE Validity starts when the payment option is used for the first time.

PaymentOptionType

A payment option type.

Перечисления
PAYMENT_OPTION_TYPE_UNSPECIFIED Неиспользованный.
PAYMENT_OPTION_SINGLE_USE Payment option can only be used once.
PAYMENT_OPTION_MULTI_USE Payment option can be used if its session count > 0.
PAYMENT_OPTION_UNLIMITED Payment option can be used within its valid time range - session count is inapplicable.

PaymentProcessorConfig

A configuration for a payment processor, setup on a per Merchant basis.

Поля
processor

Processor

Defines the payment processor partner this configuration applies to.

public_key

string

The key used to identify this merchant with the payment processor.

For Stripe, refer to: https://stripe.com/docs/dashboard#api-keys For Braintree, refer to: https://articles.braintreepayments.com/control-panel/important-gateway-credentials

version

string

The API version number sent to the payment processor along with payment requests.

Процессор

Defines a specific payment processor partner.

Перечисления
PROCESSOR_UNSPECIFIED Неиспользованный
PROCESSOR_STRIPE A configuration for payments with Stripe.
PROCESSOR_BRAINTREE A configuration for payments with Braintree.

PaymentRestrictions

Restrictions to the payment methods this merchant accepts.

Поля
credit_card_restrictions

CreditCardRestrictions

Restrictions to the credit cards this merchant accepts. We assume all credit cards are accepted if this field is not set. Note that the list of cards supported by CreditCardType will grow over time, meaning that leaving this empty subjects a configuration to future changes.

PerOrderFee

Fees that must be paid once per order, regardless of number of tickets.

Поля
delivery_fee

Price

A fee that can vary by delivery method.

processing_fee

Price

A fee to process the user's payment method.

PerTicketFee

Fees that must be paid for each ticket the user purchases.

Поля
service_charge

Price

An extra charge assessed for a service.

facility_fee

Price

A fee that goes to the venue/facility.

taxes

Price

Per ticket taxes.

PostalAddress

Address of a customer or a business.

Поля
address_country

string

The country, specified using its ISO 3166-1 alpha-2 country code, eg "US" (required)

address_locality

string

The locality, eg "Mountain View". (required)

address_region

string

The region, eg "CA". This field is only required in countries where region is commonly a part of the address. (optional)

postal_code

string

The postal code, eg "94043". (required)

street_address

string

The street address, eg "1600 Amphitheatre Pkwy". (required)

Предоплата

A payment the user may be charged as part of their reservation.

Поля
price_info

PriceInfo

Container for price details.

PrepaymentStatus

Prepayment status of a booking.

Перечисления
PREPAYMENT_STATUS_UNSPECIFIED Not specified, defaults to PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED The fee for the booking has been paid in advance.
PREPAYMENT_NOT_PROVIDED The fee for the booking has not been paid in advance.
PREPAYMENT_REFUNDED The fee was previously PREPAYMENT_PROVIDED but has now been refunded.

Цена

The price of a service or a fee.

Поля
price_micros

int64

The price in micro-units of the currency. Fractions of smallest currency unit will be rounded using nearest even rounding. (eg For USD 2.5 cents rounded to 2 cents, 3.5 cents rounded to 4 cents, 0.5 cents rounded to 0 cents, 2.51 cents rounded to 3 cents).

currency_code

string

The currency of the price that is defined in ISO 4217.

pricing_option_tag

string

An optional and opaque string that identifies the pricing option that is associated with the extended price.

PriceInfo

Container for price details.

Поля
price_type

PriceType

Defines how price or price range is applied (per person or fixed)

Union field price_options . Price options are to either specify an exact price or a range. price_options can be only one of the following:
price

Price

The price of a service or a fee.

price_range

PriceRange

The upper and/or lower bound of a service or a fee.

PriceInterpretation

Describes how a Price should be interpreted and displayed to the user.

Перечисления
PRICE_INTERPRETATION_UNSPECIFIED Price interpretation unspecified, defaults to EXACT_AMOUNT.
EXACT_AMOUNT

When the price should be interpreted as a specific value.

Examples: $20 for a yoga class; $15 for a child haircut

STARTS_AT

When the price of a service is variable but a minimum price is known and displayed to consumers. Consumers may make choices which increase the price.

Note that any service that uses this PriceInterpretation must use PrepaymentType NOT_SUPPORTED.

Examples: $30 for dog grooming, but additional consumer choices may increase the price

NOT_DISPLAYED

When the price of a service is variable and no price information is displayed to consumers ahead of time.

Note that any service that uses this PriceInterpretation must use PrepaymentType NOT_SUPPORTED and Price must be empty.

Examples: A consultation for a home service

PriceRange

Wrapper for a range of monetary amount treated as unbounded unless both values are set. At least one of min_amount and max_amount is required.

Поля
min_price

Price

Минимальная сумма.

max_price

Price

Maximum amount. Should always be > min_price.

PriceType

Defines how a total price is determined from an availability.

Перечисления
FIXED_RATE_DEFAULT

The price is for a fixed amount. This is the default value if the field is not set.

Examples: $50 deposit to reserve a table; $20 no show fee for a yoga class

PER_PERSON

The price specified is per person, and the total price is calculated according to the party size specified in Resources as price_micros * party_size. A PER_PERSON price must be accompanied by a party size in the availability resources. If it is not, a party size of one is used.

Examples: $10 each for tickets to a museum

Количественная ценность

Wrapper for a numerical value that could be a range or a fixed value. QuantitativeValue examples: * Singular value: value: 10.5 * Bounded range: value_range {min_value: 5.5, max_value 10.5} * Lower bound: value_range {min_value: 5.5} * Upper bound: value_range {max_value: 10.5}

Поля
Поле объединения value_options (обязательное поле). value_options может принимать только одно из следующих значений:
value

double

Единственное значение. Например: 5,6

value_range

RangeValue

Диапазон значений, который может быть как неограниченным, так и ограниченным. Примеры: * Не менее 5,5 * Не более 5,5 * От 5,5 до 6,5

RangeValue

Range of values such that min_value < max_value . Requires at least one of min_value and max_value .

Поля
min_value

double

Минимальное значение.

max_value

double

Максимальное значение.

Рейтинг

Defines Rating for an entity.

Поля
value

double

Average rating value (required when number_of_ratings > 0). The value must be in the range of [1, 5] and can be omitted if and only if the number_of_ratings is zero.

number_of_ratings

uint64

Number of ratings used in calculating the value (required).

RelatedMedia

Photos related to this service. Google will crawl these media to ensure that they are displayed correctly to end-users. (optional)

Поля
url

string

URL of this media source. Google will crawl the media hosted at this URL.

type

MediaType

Type of this media source.

localized_caption

Text

Caption of the media that supports i18n, only plain text is supported. Any HTML components will be stripped. (optional)

attribution

Attribution

Attribution information about the source of the media. Note that if the attribution is required to display with the media to give credit to photographer or agency, this field must be set. (optional)

caption
(deprecated)

string

Deprecated, prefer to use localized_caption.

Атрибуция

Attribution information for this media.

Поля
localized_text

Text

The text to give credit to the photographer or agency supporting i18n. This text will be displayed together with the source media. Note that only plain text is supported for this field, any HTML components will be stripped (hyperlink based attribution is not supported).

text
(deprecated)

string

Deprecated, prefer to use localized_text.

MediaType

Enum to indicate the type of this media source. Only photos are supported. Please reach out to the Reserve with Google team if other media beyond photos need to be supported.

Перечисления
TYPE_UNSPECIFIED Неиспользованный.
PHOTO Indicates the media provided by the url is a photo.

ReplaceServiceAvailabilityRequest

The request to replace a Service 's availability.

Поля
service_availability

ServiceAvailability

The service availability that is used to replace the existing ones.

RequireCreditCard

Defines whether a credit card is required in order to book an appointment.

Перечисления
REQUIRE_CREDIT_CARD_UNSPECIFIED The credit card requirement is not explicitly specified and the behaviour is identical to the one specified for CONDITIONAL.
REQUIRE_CREDIT_CARD_CONDITIONAL Google will require a credit card for the booking if any of the following conditions are met: * the availability has a price and the prepayment_type is REQUIRED * the no_show_fee is set * the deposit field is set.
REQUIRE_CREDIT_CARD_ALWAYS A credit card is always required in order to book this availability regardless of other field values.

Ресурсы

A resource is used to disambiguate availability slots from one another when different staff members, or rooms are part of the service. Multiple slots for the same service and time interval can co-exist when they have different resources.

Поля
staff_id

string

Optional ID for a staff member providing the service. This field identifies the staff member across all merchants, services, and availability records. It also needs to be stable over time to allow correlation with past bookings. This field must be present if staff_name is present.

staff_name

string

Optional name of a staff member providing the service. This field will be displayed to users making a booking, and should be human readable, as opposed to an opaque identifier. This field must be present if staff_id is present.

room_id

string

An optional ID for the room the service is located in. This field identifies the room across all merchants, services, and availability records. It also needs to be stable over time to allow correlation with past bookings. This field must be present if room_name is present.

room_name

string

An optional name for the room the service is located in. This field will be displayed to users making a booking, and should be human readable, as opposed to an opaque identifier. (optional but required if room_id is present) In dining a room name should only be used for seating areas such as the bar or patio and should not be used for fixed price menus, special activities, or any other non-room value (such as reservation or dinner). It is strongly recommended that the default seating area not have a room associated with it.

party_size

int32

Applicable only for Dining: The party size which can be accommodated during this time slot. A restaurant can be associated with multiple Slots for the same time, each specifying a different party_size, if for instance 2, 3, or 4 people can be seated with a reservation.

room_description

Text

Optional. Localized room description. If set, a default value must be provided. It is preferred to also provide common languages for the merchant's locale. (optional)

SchedulingRules

The scheduling rules for a service.

Поля
min_advance_online_canceling

int64

The minimum advance notice in seconds required to cancel a booked appointment online. (optional)

late_cancellation_fee
(deprecated)

Price

The fee for canceling within the minimum advance notice period.

noshow_fee
(deprecated)

Price

The fee for no-show without canceling.

admission_policy

AdmissionPolicy

The admission policy that applies to this service. If unset, defaults to TIME_STRICT. (optional)

cancellation_policy

CancellationPolicy

Scheduling rules cancellation policy. (required for Things-to-do)

Union field min_booking_buffer . The duration (in seconds) from when the last booking can be made to when the availability slot starts or ends.

If "min_advance_booking" is set, the last bookable time is calculated as (<slot start time> - "min_advance_booking"). If "min_booking_buffer_before_end_time" is set, the last bookable time is calculated as (<slot end time> - "min_booking_buffer_before_end_time"). Note that the value of "min_booking_buffer_before_end_time" must be positive if set. If both are unset, the slot is bookable until the slot begin time. If both fields are set, only one value will be picked while the other value ignored--we cannot reliably predict which value is chosen.

Примеры:

  • A haircut that needs to be booked at least 1 hour before the start time. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • A museum where the last ticket can be purchased 30 mins before closing: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • A movie ticket that needs to be purchased before the start time. 'scheduling_rules{ ...}' (leave this field empty) (optional) min_booking_buffer can be only one of the following:

min_advance_booking

int64

The duration (in seconds) from when the last booking can be made to when the availability slot starts.

min_booking_buffer_before_end_time

int64

The duration (in seconds) from when the last booking can be made to when the availability slot ends. If this field is set, the "admission_policy" field must be set to TIME_FLEXIBLE to indicate that users can use the purchased tickets after slots start.

AdmissionPolicy

The admission policy of this service.

Перечисления
ADMISSION_POLICY_UNSPECIFIED Неиспользованный.
TIME_STRICT Customers are required to be present at the start time of the availability slot, and the service is expected to finish at the end time of the slot. Examples of TIME_STRICT use cases: * A tour that starts at 9am that requires all attendees to arrive at the start time, and returns at around 12pm. * A haircut reservation at 3pm on Saturday that will take approximately 30 minutes. * A fitness class from 6pm to 8pm.
TIME_FLEXIBLE

Customers can arrive at any time between the start and end time of the availability slot to use this booking.

Examples of TIME_FLEXIBLE use cases: * A museum ticket that can be used during any time on the purchase date. * An afternoon admission to an amusement park that can be used from 12pm to 9pm.

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Customers need to arrive at the merchant at the start time of the availability slot but can leave any time they want.

For example, in the museum admission scenario, a timed entry ticket for 10am requires the user to be at the museum at 10am. The start time of availability slots for this service represents the designated entry time. The end time, however, is used solely as a key to identify the availability slot for booking.

Услуга

Info about a service that is provided by the merchant, eg haircut.

Поля
name

string

The service resource name, which has the format of partners/{partner_id}/merchants/{merchant_id}/services/{service_id} .

service_name

string

The name of the service, eg "Men's haircut". Deprecated, use localized_service_name instead.

localized_service_name

Text

The name of the service, eg "Men's haircut". Possibly in several locales.

description

string

The user-visible description of the service. Deprecated, use localized_description instead.

localized_description

Text

The user-visible description of the service.

This field supports both plain-text and HTML-like formatting. Unlike plain text sections, customized layouts can be created here using headings, paragraphs, lists and some phrase tags. Please read the following instructions and notes carefully to ensure you create the best user-experience.

Supported HTML-like formatting tags:

Heading tags: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Heading tags can be used to display titles and sub-titles. For example, <h1>Itinerary</h1> will display the inline text as the most important heading of the section. Note that any inner HTML tags, styles or attributes will be ignored. For example, <h1 style=".."> will be treated the same as <h1>. Only pure text wil be preserved.

Paragraph tag: <p>
The paragraph tag can be used to highlight a detailed introduction or contents. Any inner tags, styles or attributes will be ignored, with a few exceptions: <br>, <strong> and <em>. Please see the phrase tag section below for more details.

List tags: <ul>, <ol>, <li>
The <ul> tag can be used with the <li> tag to display unordered lists, and the <ol> tag can be used with <li> to display ordered lists. This is a good way to display checklists, schedules, or any other lists that fit your use-cases.
Example: To show a list of features of a cruise trip:
<ol>
<li>Wonderful ocean view and chances to play with wildlife.</li>
<li>Carefully designed travel arrangements and services.</li>
<li>Guaranteed lowest price.</li>
</ol>
Note that only <li> children under <ul> or <ol> tags will be converted. All other children will be dropped. Also, any inner tags, attributes and styles will be ignored; we only preserve pure text contents.

Division tag: <div>
All supported inner tags of the <div> tag will be parsed with the rules stated above, imply <div> tag itself does not mean any grouping or indenting here. Also, any inner attributes and styles will be ignored.

Phrase tags: <br>, <strong>, <em>:
Only the three tags mentioned above are supported. <br> can be used to break lines in paragraphs, and <strong>/<em> can be used to highlight important text. Any other phrase tags will be ignored.

Unsupported tags:

  • <html>, <header>, and <body> tags are not allowed.
  • Any other tags not mentioned above are not supported (for example <table>, <td> ...).
    Any URLs, anchors, and links will be stripped, and will never be displayed to end-users. If you want to use photos to create a rich user experience, please use the "related_media" field below to send your photo URLs.

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

  • Try not to use other tags except for the supported ones mentioned above, because the contents within unsupported tags will be stripped, and may lead to an undesirable user experience.
  • Try avoid deep nested structures like more than 3 different heading levels or nested lists. Keeping the structure flat, simple, and straightforward, helps to create a better user experience.
  • If the currently supported layouts are not sufficient for your use cases, please reach out to the Reserve with Google team.
  • The recommended maximum size is 32,000 characters.
price

Price

The price of the service.

price_interpretation

PriceInterpretation

Describes how the price is interpreted and displayed to the user. Can be used by any vertical except Dining and Things To Do to configure display of the service price.

rules

SchedulingRules

Rules to book/cancel an appointment.

prepayment_type

PrepaymentType

Whether a prepayment is required, optional or not supported.

prepayment_terms

PrepaymentTerms

Terms around when the prepayment is completed.

form[]
(deprecated)

ServiceIntakeForm

Deprecated. Please use intake_form and per_ticket_intake_form.

intake_form

ServiceIntakeForm

A form requesting additional information from the user when they book this service. (optional)

per_ticket_intake_form

ServiceIntakeForm

A form requesting additional information from the user when they book this service. This form must be filled out once for each ticket the user is booking. (optional)

tax_rate

TaxRate

The service's tax rate. If present this field overrides any tax_rate set at the merchant level. An empty message (ie tax_rate { }) will reset the applied tax rate to zero.

payment_option_id[]

string

A list of ids referencing the payment options which can be used to pay for this service. The actual payment options are defined at the Merchant level, and can also be shared among multiple Merchants.

deposit

Deposit

Defines how a deposit may be charged to the user. Overrides the service deposit if one was specified. Setting this to an empty Deposit message removes any service-level deposit. (optional)

no_show_fee

NoShowFee

Defines a no show fee that may be charged to the user. Overrides the service no show fee if one was specified. Setting this to an empty NoShowFee message removes any service-level no show fee. (optional)

require_credit_card

RequireCreditCard

Indicates whether the user must provide a credit card in order to book this service. This field can be overridden at the availability level. (optional)

type

ServiceType

The predefined type of this service. (optional)

ticket_type[]

TicketType

Types of tickets that can be booked/purchased for this service, if tickets are supported. (optional)

related_media[]

RelatedMedia

Photos related to this service. Google will crawl and store the media to ensure that they are displayed to end-users in the most efficient way. (optional)

service_attribute_value_id[]

ServiceAttributeValueId

Service attribute values that apply to this service (optional). Each Service may have zero or more values for each service attribute defined in the corresponding Merchant. (optional)

waitlist_rules

WaitlistRules

Rules to joining the waitlist.

ticketing_vertical_specific_data

TicketingVerticalSpecificData

Additional information unique to the event ticketing vertical. (optional)

integration_type

IntegrationType

Depth of integration we support for this service. (optional) Irrelevant for partners with the starter integration. End to end will always be disabled for these partners.

per_order_fee

PerOrderFee

Order level fees for purchasing this service. (optional)

tours_and_activities_content

ToursAndActivitiesContent

Content fields specific to Tours and Activities.

location[]

Location

Locations related to this service. IMPORTANT NOTES: If there are multiple visited locations related to this service, or the START_LOCATION is different from the VISITED_LOCATION, the START_LOCATION must be specified. Example: - A guided biking tour visiting three venues, the start venue needs to be specified. - A bus tour meeting at a hotel lobby and then head to the visited venue. The meeting location needs to be specified.

rating

Rating

User rating for this service as an aggregate metric over all reviews.

home_service_data

HomeServiceData

Additional information unique to home service vertical. (optional)

virtual_session

VirtualSession

Optional. Information about virtual session. It is required for enabling virtual services.

direct_merchant_payment

DirectMerchantPayment

Optional. Additional information which needs to be added if the service requires the user to pay directly to the merchant. IMPORTANT NOTE: RwG would not be involved in this transaction. It is required if virtual_session is defined and the service is not free or prepayment_type is NOT set to REQUIRED.

uri_template

UriTemplate

Optional. An optional template specifying how Google should generate URLs to external site.

PrepaymentTerms

Specific information around when prepayment is completed.

Поля
charge_timing

ChargeTiming

When the charge will occur relative to the purchase time.

charge_time_before_start_time_sec

int64

Time in seconds before the service start time that the user is charged for payment. This field should only be set when ChargeTiming is CHARGE_LATER.

ChargeTiming

Enum to specify when the charge will occur relative to the purchase time.

Перечисления
CHARGE_TIMING_UNSPECIFIED Неиспользованный.
CHARGE_NOW Customer will be charged immediately.
CHARGE_LATER Customer will be charged later.

PrepaymentType

Enum to indicate the prepayment type.

Перечисления
PREPAYMENT_TYPE_UNSPECIFIED By default we will assume that the prepayment is NOT_SUPPORTED.
REQUIRED The user has to pay this service at the booking time.
OPTIONAL The user can choose to pre-pay this service at the booking time or later, but it is not required in order to book.
NOT_SUPPORTED The prepayment is not supported for this service.

ServiceType

Predefined service types.

Перечисления
SERVICE_TYPE_UNSPECIFIED Неиспользованный.
SERVICE_TYPE_DINING_RESERVATION Dining reservation.
SERVICE_TYPE_FOOD_ORDERING Food ordering, could be either food delivery or takeout or both.
SERVICE_TYPE_FOOD_DELIVERY Food delivery.
SERVICE_TYPE_FOOD_TAKEOUT Food takeout.
SERVICE_TYPE_EVENT_TICKET Event ticket.
SERVICE_TYPE_TRIP_TOUR Trip tour.
SERVICE_TYPE_APPOINTMENT Service that provides appointments or classes. Recommended for (1) health and fitness, (2) spa and beauty, and (3) financial consults and evaluations services. Please see the supported service types: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT Service that provides online appointment for a class or session which will be fully virtual. Must be set if enabling virtual service bookings.
SERVICE_TYPE_SHOPPING Service that allows users to shop from the given merchant. It could either be delivery or pickup.

ServiceAttribute

Service attributes are partner-defined categories that describe the Services for a Merchant. For example, a bank may define an "Account Type" service attribute with possible values of "Personal" and "Business", while a hair salon may define a "Service Type" service attribute with possible values of "Haircut", "Color", and "Style".

Поля
attribute_id

string

An identifier that uniquely identifies this service attribute among others for the same merchant, eg "account-type".

attribute_name

string

A user-visible name for this attribute, eg "Account Type".

value[]

Value

All possible values for this service attribute.

Ценить

Represents a possible value for a particular service attribute.

Поля
value_id

string

An identifier that uniquely identifies this value among others for this service attribute, eg "personal".

value_name

string

A user-visible name for the value, eg "Personal".

ServiceAttributeValueId

Identifies a particular value of a service attribute to be applied to a Service.

Поля
attribute_id

string

ID of an attribute as defined in Merchant.service_attribute, eg "service-type".

value_id

string

ID of the value for this attribute, eg "haircut". Must match a value_id in the service attribute definition.

ServiceAvailability

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

Поля
name

string

The resource name of the service to apply this to. In the format of partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

start_time_restrict

Timestamp

If provided, we will consider the Availability entities provided to be a complete snapshot from [start_time_restrict, end_time_restrict). That is, all existing availability will be deleted if the following condition holds true:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Если задано условие по длительности, то условие дополнительно ограничивается:

  availability.duration == duration_restrict

If a resources_restrict message is set, the condition is further restricted:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

Setting start_time_restrict while leaving end_time_restrict unset is interpreted to mean all time beginning at start_time_restrict.

end_time_restrict

Timestamp

Setting end_time_restrict while leaving start_time_restrict unset is interpreted to mean all time up to the end_time_restrict.

duration_restrict

Duration

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

resources_restrict

Resources

Setting resources_restrict further restricts the scope of the update to just this set of resources. All id fields of the resources must match exactly.

availability[]

Availability

Новый список доступных товаров.

ServiceIntakeForm

Defines an intake form that customizes the service provided by a merchant.

Поля
field[]

ServiceIntakeFormField

Fields that will be displayed to the user.

first_time_customers
(deprecated)

bool

If true, this form will be shown to first time customers. Deprecated. This functionality is not supported for intake forms.

returning_customers
(deprecated)

bool

If true, this form will be shown to repeat customers. Deprecated. This functionality is not supported for intake forms.

ServiceIntakeFormField

Defines a field that is included in a ServiceIntakeForm.

Поля
id

string

A string from an aggregator partner which uniquely identifies a form field. This id should be the same as the id in the corresponding form field answer and must be unique across both the service level and per ticket intake forms. (required)

type

FieldType

The type of this field.

label

string

The text shown to the user for this field. Deprecated, please use localized_label instead.

localized_label

Text

The text shown to the user for this field. The field can be supplied in multiple locales. (required)

value[]

string

Set if and only if the field type is LOCATION_SEARCH. Please use the "location_id" in the "location" field to specify the location value.

choice_text[]

Text

Set if and only if the field type is MULTIPLE_CHOICE, CHECKBOXES, or DROPDOWN. Used to enumerate possible choices.

is_required

bool

Indicates whether an answer to this field is required by a user.

allow_custom_answer

bool

Indicates whether a custom value is allowed in additional to predefined answers. This is only applicable when the field type is LOCATION_SEARCH. (optional)

additional_option[]

Text

Additional options provided in addition to the provided values. Only applicable when the field type is LOCATION_SEARCH. Eg in addition to the provided location list, another available option can be "I will contact supplier later". (optional)

ticket_type_restrict[]

string

If this question should only be shown when the user books certain ticket types, this field should be set as the set of applicable ticket type ids. Leave the field empty if the question is always applicable.

hint

Text

The hint text for input, which shows up as a text placeholder. This is only applicable when the field type is SHORT_ANSWER or PARAGRAPH. (optional)

FieldType

Enum to indicate the type of field.

Перечисления
FIELD_TYPE_UNSPECIFIED Fields of unspecified or unknown type will be ignored.
SHORT_ANSWER A one-line input field for text.
PARAGRAPH A multi-line input field for text.
MULTIPLE_CHOICE A set of radio buttons that requires one choice from many options.
CHECKBOXES One or more enumerated items with checkboxes.
DROPDOWN A selection from a dropdown.
BOOLEAN A yes/no button.

TaxRate

A tax rate applied when charging the user for a service, and which can be set on either a per merchant, or per service basis.

Поля
micro_percent

int32

A tax rate in millionths of one percent, effectively giving 6 decimals of precision. For example, if the tax rate is 7.253%, this field should be set to 7253000.

If this field is left unset or set to 0, the total price charged to a user for any service provided by this merchant is the exact price specified by Service.price. The service price is assumed to be exempt from or already inclusive of applicable taxes. Taxes will not be shown to the user as a separate line item.

If this field is set to any nonzero value, the total price charged to a user for any service provided by this merchant will include the service price plus the tax assessed using the tax rate provided here. Fractions of the smallest currency unit (for example, fractions of one cent) will be rounded using nearest even rounding. Taxes will be shown to the user as a separate line item.

Условия

A set of rules and guidelines that are displayed to the user in order to make a booking through Reserve with Google.

Поля
url

string

Optionally, the URL to the Terms and Conditions.

text

string

The text to be displayed to the user. Use localized_text below for new integrations.

localized_text

Text

The localized text to be displayed to the user.

Текст

A possibly-localized text payload. Some Text fields may contain marked-up content.

Поля
value

string

Text value in an unknown locale. Required if and only if localized_value is empty. The locale for this value may depend on the partner or service provider -- it should not be assumed to be any specific language.

localized_value[]

LocalizedString

Per-locale text values. Optional.

TicketType

TicketType is used to differentiate among tickets with different prices and/or availabilities due to different user types, different service attributes, or different options/add-ons.

A ticket is the minimal bookable unit to a service, eg a spot on a rafting trip, an admission to a museum, a full day double kayak rental.

Поля
ticket_type_id

string

The ticket id is used to differentiate among different ticket types of the same service, and is only expected to be unique within a service.

short_description

string

A short description to this TicketType.

This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Deprecated, use localized_short_description instead.

localized_short_description

Text

A short description to this TicketType with i18n support.

This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Separate values could be supplied for each locale.

price

Price

The price of a single ticket of this type, exclusive of any taxes. The tax rate of Service is applied to its tickets.

per_ticket_fee

PerTicketFee

Additional fees for purchasing this ticket. (optional)

price_display_type

PriceDisplayType

Optional. Predetermined price display type of a single ticket of this type.

option_description

string

Description of any additional option which this ticket type represents, if any. Deprecated, use localized_option_description instead.

localized_option_description

Text

Description of any additional option which this ticket type represents, if any. Separate values could be supplied for each locale.

Additional options are useful when the ticket type represents multiple dimensions.

Example 1: an admission ticket with different types 'adult', 'child' and language as an additional option, the expected TicketType list would be: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

Example 2: an multi-hour kayak rental with optional dry bag add-on, the short_description could be "3 hours" and the option_description could be either "with dry bag" or "without dry bag": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

Optional, but if any ticket type within the service has this field set, we expect all other ticket types to have this field set as well (a default option_description could be used). Eg [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] is not a valid list.

Only two HTML formatting tags are supported: and
. They are intended to be used for specifying options with both a title and detailed description, for example: " Premium Seating
This option offers seating at the private boxes including fully cushioned seats, private TVs, in-seat food and beverage service. These seats provide picturesque views of the field."

inventory_type

InventoryType

Optional. Predetermined inventory type of a single ticket of this type.

InventoryType

Predetermined inventory type of a single ticket of this type.

Перечисления
INVENTORY_TYPE_UNSPECIFIED The inventory type is unspecified.
INVENTORY_TYPE_PRIMARY Primary inventory.
INVENTORY_TYPE_VERIFIED_RESALE Verified resale inventory.
INVENTORY_TYPE_RESALE Resale inventory.
INVENTORY_TYPE_AGGREGATOR Aggregator inventory. Aggregator (eg www.bandsintown.com) means the partner provides events and tickets information. But the tickets are not sold by the partner directly. The actual tickets seller can be primary, verified resale or resale. Now we only differentiate top level partner inventory type and ignore the actual tickets seller inventory type within an aggregator.

PriceDisplayType

Indicates the price format displayed on the landing page.

This field is ignored for non-link-out inventory.

This field allows Google surfaces to show the same price format as used byService the landing page. Consistent price formats improve conversion rate and reduce confusion.

Перечисления
PRICE_DISPLAY_TYPE_UNSPECIFIED The price display type is unspecified. Google will determine which format to show.
PRICE_DISPLAY_TYPE_BASE The price shown on the landing page is the base price.
PRICE_DISPLAY_TYPE_ALL_IN The price shown on the landing page includes all fees and taxes.

TicketingVerticalSpecificData

Additional information unique to the event ticketing vertical.

Поля
event_category

EventCategory

The category of the event. Set only when event falls into one of the predefined categories. (optional)

event_url

string

The URL of the event on the partner's website. (optional)

entity[]

Entity

A list of entities related to the event. (optional)

event_attendance_mode

AttendanceMode

Required. The type of the event attendance.

event_virtual_location_url[]

string

Optional. URL where the event can be watched.

event_organizer

Text

Optional. Organizer who hosts the event.

event_organizer_url

string

Optional. URL of the organizer who hosts the event.

event_organizer_type

OrganizerType

Optional. The type of the organizer.

event_source_url[]

string

Required. URL of the pages where the event information or descriptions can be found.

event_state

EventState

Optional. State of the event.

brand_name

Text

Optional. The localized brand name.

event_creator

EventCreator

Optional. Information about the creator of the event.

AttendanceMode

The type of the event attendance.

Перечисления
ATTENDANCE_MODE_UNSPECIFIED Не указан.
ONLINE For virtual events.
PHYSICAL For physical events.
PHYSICAL_ONLINE_MIXED For events that are both physical and virtual.

Сущность

Represents an entity related to the event.

Поля
id

string

Unique identifier of the entity in the partner's database. (optional)

name

string

Name of the entity. (required)

url

string

Url of the webpage that unambiguously describes the entity. This is the webpage on the partner's website for the entity if any; for other public URLs of the entity, use relevant_url in public_identification_data. (optional)

entity_type

EntityType

The type of the entity. (optional)

entity_role

EntityRole

The role of the entity in the event. (optional)

public_identification_data

PublicIdentificationData

Public references of the entity. (optional)

EntityRole

The role of the entity in the event.

Перечисления
ENTITY_ROLE_UNSPECIFIED Не указан.
ENTITY_ROLE_HEADLINER The entity represents a headliner or leading performer at the event.
ENTITY_ROLE_SUPPORTER The entity represents a supporting performer at the event.
ENTITY_ROLE_HOME_TEAM The entity represents the home team at the (sports) event.
ENTITY_ROLE_AWAY_TEAM The entity represents the away team at the (sports) event.

EntityType

The type of the entity. Note: not intended to be a universal ontology.

Перечисления
ENTITY_TYPE_UNSPECIFIED Not specified. Do not use.
ENTITY_TYPE_PERFORMER The entity represents the artist or group performing at a concert or a show. Only applicable when event category is CONCERT or THEATRE.
ENTITY_TYPE_PLAYER The entity represents the sports team or player at the event. Only applicable when event category is SPORTS.
ENTITY_TYPE_CONCERT_TOUR The entity represents the tour that this event belongs to. Only applicable when event category is CONCERT.
ENTITY_TYPE_SPORTS_SERIES The entity represents a sports tournament that this event belongs to. Only applicable when event category is SPORTS.
ENTITY_TYPE_PLAY The entity represents the type of play (eg, musical, comedy, ballet, etc.) performed at the event. Only applicable when event category is THEATRE.

EventCategory

A subset of event categories for which we customize the product experience. Note: not intended to be a universal ontology of events.

Перечисления
EVENT_CATEGORY_UNSPECIFIED Not specified. Do not use.
EVENT_CATEGORY_CONCERT Concerts.
EVENT_CATEGORY_SPORTS Sports events.
EVENT_CATEGORY_THEATRE Theatre events.
EVENT_CATEGORY_EXHIBITS Экспонаты.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES Workshops and Classes.

EventCreator

Information about the creator of the event. Only relevant for platforms that include user-generated content events.

Поля
name

string

Optional. Name of the event creator. No character restriction.

EventState

State of the event.

Перечисления
EVENT_STATE_UNSPECIFIED Не указан.
SCHEDULED The event is scheduled.
RESCHEDULED The event is rescheduled.
CANCELLED The event is cancelled.
POSTPONED The event is postponed.

OrganizerType

The type of the organizer.

Перечисления
ORGANIZER_TYPE_UNSPECIFIED Не указан.
PERSON For organizer who is a person.
ORGANIZATION For organizer who is an organization.

PublicIdentificationData

Identifiers, webpages, or any other public sources that reference an entity.

Поля
relevant_url[]

string

Public URL of any webpage that is dedicated to only the topic. This could include official websites, discogs, social media platforms, wikipedia or imdb pages, eg https://www.discogs.com/artist/1124645-Taylor-Swift , https://www.wikidata.org/wiki/Q19320959 , https://twitter.com/acmilan . (optional)

musicbrainz_id

string

The 36-character musicbrainz identifier of the artist or other music entities, if applicable. See https://musicbrainz.org/doc/MusicBrainz_Identifier . (optional)

TimeRange

A closed-open time range, ie [start_time, end_time).

Поля
start_time

Timestamp

The lower bound of the time range.

end_time

Timestamp

The upper bound of the time range.

TokenizationConfig

A configuration for payment-processor tokenization, set up on a per-Merchant basis.

Поля
tokenization_parameter

map<string, string>

A tokenization configuration will typically have one tokenization_parameter whose key is "gateway" and whose value is the name of the processor.

The rest of the parameters are dependent on the processor. See Google Pay's documentation for further information.

Braintree example: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Stripe example: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen example: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

billing_information_format

BillingInformationFormat

Include in the payment token the user's billing information as entered into Google Pay with their FOP (see above). Leaving the field empty is equivalent to specifying MIN.

BillingInformationFormat

How much of the Billing Address to require of the user and include in the token. The enum values correspond to parameters in the Google Pay API (see https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters) .

Перечисления
BILLING_INFORMATION_FORMAT_UNSPECIFIED Not specified. Defaults to MIN.
MIN name, country code, and postal code (Google Pay default setting).
FULL name, street address, locality, region, country code, and postal code.

ToursAndActivitiesContent

Content fields specific to Tours and Activities. Each element in the repeated field should be independent to allow separate rendering (eg as a bullet point).

Populating ToursAndActivitiesContent is strongly recommended for tours and activities, but not strictly required. All fields support both plain-text and HTML-like text for basic formatting. Supported HTML-like formatting tags:

Phrase tags:
, , , : Only the three tags mentioned above are supported.
can be used to break lines in paragraphs, and / / can be used to highlight an important text. Any other phrase tags will be ignored.

All other tags and custom styles are not allowed and will be removed. Any URLs, anchors, and links will be stripped, and will never be displayed to end-users.

Important notes: * Don't duplicate data already supplied in highlights , exclusion and other, more specific, fields in the service description. * Avoid using other tags except for the supported ones mentioned above, because the contents within unsupported tags will be stripped, and may lead to an undesirable user experience.

Поля
highlights[]

Text

The user-visible list of highlights.

inclusions[]

Text

The user-visible list of inclusions.

exclusions[]

Text

The user-visible list of exclusions.

must_know[]

Text

The user-visible list of important notes, use for details such as age restrictions or other conditions that make this service unsuitable.

UnsupportedPartySizeOption

Options for parties that are out of range.

Поля
Union field kind . Available options for parties that are out of range. kind can be only one of the following:
call_merchant

CallMerchant

Party sizes that are out of range can call the business. A predefined message will be displayed to the user. Sample text to be displayed: "For parties larger than {waitlist_rules.max_party_size} please call the restaurant at {phone}." CallMerchant must be set, but will be empty.

UpdateAdsAccountLinkRequest

Request message for AdsAccountLinkingService.UpdateAdsAccountLink.

Поля
update_mask

FieldMask

Необязательный параметр. Список полей для обновления.

UpdateBookingRequest

Request to update a google.maps.booking.v1alpha.Booking

Поля
update_mask

FieldMask

Необходимо обновить маску полей всех полей бронирования.

booking

Booking

The booking to be updated

booking_failure

BookingFailure

Если обработка асинхронно подтвержденного запроса на бронирование завершается неудачей и статус бронирования обновляется на «НЕУДАЧНО», это поле должно отражать ошибку бизнес-логики (например, у пользователя уже есть существующее бронирование слишком близко к этому времени). Это поле должно быть установлено только при обновлении статуса бронирования на «НЕУДАЧНО» и будет игнорироваться в противном случае.

UpdateMerchantRequest

The request to update a Merchant .

Поля
merchant

Merchant

The new merchant data.

update_mask

FieldMask

The specific fields to update for the merchant.

UpdateOrderRequest

Request to update a google.maps.booking.v1alpha.Order

Поля
update_mask

FieldMask

Field mask of all order fields to be updated

order

Order

The order to be updated

UpdateServiceRequest

The request to update a Service .

Поля
service

Service

The new service data.

update_mask

FieldMask

The specific fields to update for the service.

UriTemplate

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

Поля
uri_template

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 start_sec field in availability feed 2) (required) {resources_party_size} :: populated from party_size field in availability feed 3) (optional) {availability_slot_duration_seconds} :: populated from duration_sec field in availability feed 4) (optional) {availability_slot_availability_tag} :: populated from availability_tag field in availability feed

Example usage: http://example.com/book/restaurant?start={availability_slot_start_seconds } &num_guests={resources_party_size}

With: * start_sec = 123456 * party_size = 2

https://example.com/book/restaurant?start=123456&num_guests=2

UserPurchaseRestriction

Restricts the users eligible to purchase a payment option.

Поля
new_to_merchant

bool

A payment option that can only be purchased by users who have never purchased from the same merchant before.

new_to_payment_option

bool

A payment option that can only be purchased by users who have never purchased the same payment option before.

VirtualSession

Information about virtual/online session. Eg Online yoga class, virtual cooking class etc.

Поля
session_instructions

Text

Instructions on how this virtual class is set up. If the partner does not include the video URL with the booking, then this text must include when the video URL will be shared with the user. Eg. “Zoom url will be mailed 30 minutes prior to the class”. (Recommended)

session_requirements

Text

Requirements for the given virtual session. Eg. yoga mat, cooking utensils etc. (Recommended)

virtual_platform_info

VirtualPlatformInfo

Information about the virtual platform used in this session. (Required to enable virtual services)

is_session_prerecorded

bool

Required. Set this as true if the virtual session is not live and is pre-recorded.

VirtualPlatformInfo

Information about platform which will be used for this virtual session.

Поля
platform

Platform

Platform used for virtual session.

other_platform_name

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.

WaitlistRules

Rules related to joining the waitlist.

Поля
min_party_size

int32

Required. Must be a positive integer for services providing waitlist functionality. If the service or merchant does not provide waitlist functionality, this must not be populated.

max_party_size

int32

Required. Must be a positive integer for services providing waitlist functionality. If the service or merchant does not provide waitlist functionality, this must not be populated.

supports_additional_request

bool

If true, the user will be able to send a free-form additional text request when joining the waitlist for this service.

above_max_party_size_options[]

UnsupportedPartySizeOption

Set options for parties larger than the set max_party_size. Leave empty if larger parties should not be given alternative options for joining a waitlist.