Индекс
-
AdsAccountLinkingService(интерфейс) -
BookingNotification(интерфейс) -
Feed(интерфейс) -
InvalidationService(интерфейс) -
InventoryStatus(интерфейс) -
InventoryUpdate(интерфейс) -
ActionLink(сообщение) -
ActionLink.ActionLinkType(enum) -
ActionLink.EventMetadata(message) -
ActionLink.EventMetadata.Surface(enum) -
ActionPlatform(enum) -
AdsAccountLink(сообщение) -
AdsAccountLink.State(enum) -
Advisement(сообщение) -
Availability(сообщение) -
Availability.ConfirmationMode(enum) -
Availability.DurationRequirement(enum) -
Availability.LinkoutRequiredReason(enum) -
Availability.Recurrence(сообщение) -
Availability.ScheduleException(message) -
Availability.SchedulingRuleOverrides(message) -
BatchDeleteGenericRecordsRequest(message) -
BatchPushGenericRecordRequest(message) -
BatchReplaceServiceAvailabilityRequest(message) -
BatchReplaceServiceAvailabilityResponse(message) -
Booking(сообщение) -
BookingFailure(message) -
BookingFailure.Cause(enum) -
BookingFailure.PaymentFailureInformation(message) -
BookingFailure.PaymentFailureInformation.ThreeDS1Parameters(message) -
BookingStatus(перечисление) -
CallMerchant(сообщение) -
CancellationPolicy(сообщение) -
CancellationPolicy.RefundCondition(message) -
ClientInformation(сообщение) -
CreateAdsAccountLinkRequest(message) -
CreateMerchantRequest(message) -
CreateServiceRequest(message) -
CreditCardRestrictions(сообщение) -
CreditCardRestrictions.CreditCardType(enum) -
DeleteAdsAccountLinkRequest(message) -
DeleteMerchantRequest(message) -
DeleteServiceRequest(message) -
Deposit(сообщение) -
DirectMerchantPayment(сообщение) -
DurationRange(message) -
EconomicOperator(сообщение) -
ExtendedServiceAvailability(сообщение) -
FeedStatistics(message) -
FeedStatus(message) -
FeedStatus.State(enum) -
FoodOrderingMetadata(сообщение) -
FoodOrderingMetadata.AdvanceOrderDetails(message) -
FoodOrderingMetadata.FeeDetails(message) -
FoodOrderingMetadata.FeeDetails.FeeAmount(сообщение) -
FoodOrderingMetadata.FeeDetails.FeeType(enum) -
FulfillmentOption(сообщение) -
FulfillmentOption.AvailableDay(message) -
FulfillmentOption.FeeDetails(message) -
FulfillmentOption.FixedFee(message) -
FulfillmentOption.FulfillmentType(enum) -
FulfillmentOption.MinimumFee(сообщение) -
FulfillmentOption.NoFee(сообщение) -
GenericDeleteRecord(message) -
GenericRecord(message) -
GeoCoordinates(сообщение) -
GetAdsAccountLinkRequest(message) -
GetMerchantStatusRequest(message) -
GetStatusRequest(message) -
HomeServiceData(message) -
IntegrationType(enum) -
InvalidateResourceRequest(message) -
LineItem(сообщение) -
LineItem.OrderedTickets(message) -
LinkoutTemplate(message) -
ListMerchantStatusesRequest(message) -
ListMerchantStatusesRequest.BookingInventoryStatus(enum) -
ListMerchantStatusesRequest.GeoMatchingStatus(enum) -
ListMerchantStatusesRequest.WaitlistInventoryStatus(enum) -
ListMerchantStatusesResponse(message) -
ListStatusRequest(message) -
ListStatusResponse(message) -
LocalizedString(message) -
Location(сообщение) -
LocationType(перечисление) -
Merchant(сообщение) -
MerchantMatchingHints(message) -
MerchantStatus(message) -
MerchantStatus.BookingStatus(message) -
MerchantStatus.DirectUrl(message) -
MerchantStatus.DirectUrl.UrlType(enum) -
MerchantStatus.LocalServicesMatchInfo(message) -
MerchantStatus.LocalServicesMatchInfo.MatchedProvider(message) -
MerchantStatus.PlaceInfo(message) -
MerchantStatus.ProcessingStatus(enum) -
MerchantStatus.WaitlistStatus(message) -
MoneyRange(сообщение) -
NoShowFee(сообщение) -
Order(сообщение) -
OrderOnlineMetadata(message) -
PaymentInformation(сообщение) -
PaymentOption(сообщение) -
PaymentOption.ActivationType(enum) -
PaymentOption.PaymentOptionType(enum) -
PaymentProcessorConfig(message) -
PaymentProcessorConfig.Processor(enum) -
PaymentRestrictions(сообщение) -
PerOrderFee(сообщение) -
PerTicketFee(сообщение) -
PostalAddress(сообщение) -
Prepayment(сообщение) -
PrepaymentStatus(перечисление) -
Price(сообщение) -
PriceInfo(сообщение) -
PriceInterpretation(перечисление) -
PriceRange(сообщение) -
PriceType(enum) -
QuantitativeValue(message) -
QuantitativeValue.RangeValue(message) -
Rating(сообщение) -
RelatedMedia(message) -
RelatedMedia.Attribution(message) -
RelatedMedia.MediaType(enum) -
ReplaceServiceAvailabilityRequest(message) -
RequireCreditCard(enum) -
Resources(сообщение) -
SchedulingRules(message) -
SchedulingRules.AdmissionPolicy(enum) -
Service(сообщение) -
Service.PrepaymentTerms(сообщение) -
Service.PrepaymentTerms.ChargeTimingВремя начисления платежей (перечисление) -
Service.PrepaymentType(enum) -
Service.ServiceType(enum) -
ServiceAttribute(message) -
ServiceAttribute.Value(message) -
ServiceAttributeValueId(message) -
ServiceAvailability(сообщение) -
ServiceIntakeForm(сообщение) -
ServiceIntakeFormField(message) -
ServiceIntakeFormField.FieldType(enum) -
TaxRate(сообщение) -
Terms(сообщение) -
Text(сообщение) -
TicketType(сообщение) -
TicketType.InventoryType(enum) -
TicketType.PriceDisplayType(enum) -
TicketingVerticalSpecificData(message) -
TicketingVerticalSpecificData.AttendanceMode(enum) -
TicketingVerticalSpecificData.Entity(message) -
TicketingVerticalSpecificData.Entity.EntityRole(enum) -
TicketingVerticalSpecificData.Entity.EntityType(enum) -
TicketingVerticalSpecificData.EventCategory(enum) -
TicketingVerticalSpecificData.EventCreator(message) -
TicketingVerticalSpecificData.EventState(enum) -
TicketingVerticalSpecificData.OrganizerType(enum) -
TicketingVerticalSpecificData.PublicIdentificationData(message) -
TimeRange(message) -
TokenizationConfig(message) -
TokenizationConfig.BillingInformationFormat(enum) -
ToursAndActivitiesContent(message) -
UnsupportedPartySizeOption(message) -
UpdateAdsAccountLinkRequest(message) -
UpdateBookingRequest(message) -
UpdateMerchantRequest(message) -
UpdateOrderRequest(message) -
UpdateServiceRequest(message) -
UriTemplate(message) -
UserPurchaseRestriction(message) -
VirtualSession(сообщение) -
VirtualSession.VirtualPlatformInfo(message) -
VirtualSession.VirtualPlatformInfo.Platform(enum) -
WaitlistRules(сообщение)
AdsAccountLinkingService
Сервис для управления связью аккаунтов между Google Ads и Партнерским центром.
| CreateAdsAccountLink |
|---|
Создает связь между аккаунтом Google Ads и Партнерским центром. Связь будет находиться в состоянии
|
| DeleteAdsAccountLink |
|---|
Удаляет связь между аккаунтом Google Ads и аккаунтом в Партнерском центре.
|
| GetAdsAccountLink |
|---|
Получает ссылку на рекламный аккаунт.
|
| UpdateAdsAccountLink |
|---|
Обновляет ссылку на рекламный аккаунт, добавляя в него товары из наличия. Это обновит ссылку на рекламный аккаунт, указав в ней товары из наличия.
|
Уведомление о бронировании
Получает уведомления о записях на прием от внешних партнеров по планированию. Партнер должен вызвать либо UpdateBooking, либо UpdateOrder в зависимости от того, использует ли он RPC-вызовы на основе бронирования, такие как CreateBooking и CheckAvailability, или RPC-вызовы на основе заказов, такие как CreateOrder и CheckOrderFulfillability.
| Обновление бронирования |
|---|
Обновляет существующее
|
| ОбновитьПорядок |
|---|
Обновляет существующий
|
Кормить
Получение информации о статусе обработки загруженных фидов от внешних партнеров-агрегаторов.
| GetStatus |
|---|
Получает
|
| ListStatus |
|---|
Получает
|
InvalidationService
Получает запросы на аннулирование ресурсов от внешних партнеров.
| InvalidateResource |
|---|
Аннулирует существующий ресурс. Запрос игнорируется, если запрашиваемый ресурс не подписан на сервис Google. Поддерживаемые типы ресурсов: - Самовывоз
|
Статус запасов
Получите информацию об остатках товаров и статусе соответствия загруженных данных продавцов.
| GetMerchantStatus |
|---|
Получите статус
|
| ListMerchantStatuses |
|---|
Перечислите все
|
Обновление инвентаря
Получает обновления информации о наличии товаров от внешних агрегаторов.
| BatchDeleteGenericRecords |
|---|
Удаляет записи указанного типа фида. Выполняет только базовую проверку (например, на наличие некорректного запроса), после чего партнеру немедленно возвращается соответствующий ответ. Google выполняет проверку бизнес-логики запроса асинхронно. Этот пакетный вызов не гарантирует атомарность.
|
| BatchPushGenericRecord |
|---|
Вставляет и/или обновляет записи указанного типа фида. Выполняет только базовую проверку (например, на наличие некорректного запроса), после чего партнеру немедленно возвращается соответствующий ответ. Google выполняет проверку бизнес-логики запроса асинхронно. Этот пакетный вызов не гарантирует атомарность.
|
| BatchReplaceServiceAvailability |
|---|
Заменяет
|
| CreateMerchant |
|---|
Создает нового
|
| Создать сервис |
|---|
Создает новый
|
| Удалить продавца |
|---|
Удаляет существующего
|
| DeleteService |
|---|
Удаляет существующую
|
| ReplaceServiceAvailability |
|---|
Заменяет
|
| Обновить продавца |
|---|
Обновляет существующий
|
| Служба обновления |
|---|
Обновляет существующий
|
ActionLink
URL-адрес действия с указанием языка, списка стран, на которых должно выполняться действие, и необязательной платформы, указывающей, на какой платформе должно быть выполнено это действие.
| Поля | |
|---|---|
url | URL-адрес точки входа для этой ссылки действия. |
language | Языковой тег BCP-47, определяющий язык, на котором доступен контент по этому URI. |
restricted_country[] | Код страны ISO 3166-1 alpha-2. Оставьте поле пустым для неограниченной видимости. |
platform | Платформа, на которой должно быть выполнено это действие. Если это поле не задано, в качестве резервного варианта будет использоваться ACTION_PLATFORM_WEB_APPLICATION. |
action_link_type | Заранее определенный тип действия. |
order_online_metadata | Метаданные для ссылки «Заказать онлайн». Поддерживаются действия с типом ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE. |
food_ordering_metadata | Метаданные для ссылок при заказе еды. Поддерживаются следующие типы действий: * |
event_metadata | Дополнительная информация о ссылке на действие, уникальной для тематического направления «Мероприятия». |
ActionLinkType
Заранее определенный тип действия, связанный с определенной связью действий.
| Перечисления | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED | Тип ссылки для выполнения действия не указан. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT | Тип ссылки для действия — запись на прием. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT | Тип ссылки для действия — онлайн-запись на прием. |
ACTION_LINK_TYPE_ORDER_FOOD | Тип ссылки действия — заказ еды с доставкой, на вынос или и то, и другое. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY | Тип ссылки действия — заказ еды с доставкой. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT | Тип ссылки действия — заказ еды на вынос. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION | Тип ссылки действия — бронирование столика в ресторане. |
ACTION_LINK_TYPE_SHOP_ONLINE | Тип ссылки для оформления заказа — «Оформить заказ», это может быть доставка, самовывоз или и то, и другое. |
Метаданные события
Дополнительная информация о ссылке на действие, уникальной для тематического направления «Мероприятия».
| Поля | |
|---|---|
surface | Заранее определенная поверхность событий, связанная со ссылкой на действие. Это используется только для вертикальной структуры «События». |
Поверхность
Заранее определенная поверхность событий, связанная со ссылкой на действие. Это используется только для вертикальной структуры «События».
| Перечисления | |
|---|---|
SURFACE_UNSPECIFIED | Тип поверхности не указан. |
SURFACE_SEARCH | Ссылка для выполнения действия ведет к бронированию билета на мероприятие в разделе «Поиск». |
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. |
AdsAccountLink
AdsAccountLink — это связь между рекламным аккаунтом и аккаунтом в Партнерском центре, а также между товарами в инвентаре.
| Поля | |
|---|---|
name | Идентификатор. Имя ресурса AdsAccountLink. Формат: |
item_ids[] | Обязательно. Список идентификаторов товаров, которые необходимо связать с аккаунтом Google Ads. |
state | Только вывод. Ссылка на состояние рекламного аккаунта. |
Состояние
Ссылка на страницу состояния аккаунта Ads.
| Перечисления | |
|---|---|
STATE_UNSPECIFIED | Неизвестное состояние. |
LINKED | Аккаунт связан между Партнерским центром и Рекламным порталом. |
PENDING | Аккаунт ожидает одобрения либо в Партнерском центре, либо на Рекламном портале. |
DELETED | Ссылка на аккаунт удалена. |
REJECTED | Запрос на привязку аккаунта отклоняется либо Партнерским центром, либо Рекламным порталом. |
Консультации
Уведомления, отображаемые пользователю при бронировании через сервис «Забронировать через Google».
| Поля | |
|---|---|
text | Пользовательское сообщение, которое будет отображаться при бронировании через сервис «Забронировать через Google». |
Доступность
Указание на доступный временной интервал в услугах продавца, включая время и количество мест.
| Поля | |
|---|---|
start_time | Время начала назначенного приема. |
duration | Продолжительность сеанса приема |
spots_total | Общее количество мест и количество свободных мест в рамках данной вакансии. Примеры:
Примечание: При отправке запросов с использованием формата сжатия доступности, определенного ниже, эти два поля будут определены автоматически.
|
spots_open | Количество свободных мест. |
availability_tag | Необязательная непрозрачная строка для идентификации этого временного интервала доступности. Если она задана, то будет включена в запросы на бронирование/обновление/отмену записей на прием. |
resources | Дополнительные ресурсы используются для различения данного временного интервала доступности от других, когда в рамках обслуживания задействованы разные сотрудники или помещения. Например, один и тот же урок йоги с двумя инструкторами: |
payment_option_id[] | Список идентификаторов, указывающих на способы оплаты, которые можно использовать для данного слота. Фактические способы оплаты определяются на уровне продавца и могут быть общими для нескольких продавцов. Это поле переопределяет любые payment_option_ids, указанные в сообщении сервиса. Аналогично, payment_option_ids, указанные здесь, НЕ обязательно должны присутствовать в сообщении сервиса, хотя их необходимо определить на уровне продавца. |
recurrence | Информация о периодичности доступности, включающая несколько времен начала. Периодичность должна содержать записи на один рабочий день. |
schedule_exception[] | Времена, когда эту услугу невозможно запланировать. Чтобы ограничить количество сообщений schedule_exception, рассмотрите возможность объединения смежных исключений. |
deposit | Внесение необязательного депозита за данную услугу. Заменяет собой депозит за услугу, если он был указан. |
no_show_fee | Дополнительная плата за неявку, если таковая была указана, предоставляется по желанию. Отменяет плату за неявку, если таковая была предусмотрена. |
prepayment | Необязательно. Информация о предоплате за этот вариант размещения необязательна. |
require_credit_card | Указывает, необходимо ли пользователю предоставить данные кредитной карты для бронирования данного временного интервала. Если значение не задано, оно наследуется из уровня обслуживания, если он там указан. (необязательно) |
ticket_type_id[] | Указывает список поддерживаемых типов заявок для данного временного интервала. Если поле не задано, для данного интервала доступны все типы заявок в родительской службе. Обратите внимание, что значения этого поля должны быть определены в родительской службе. Примеры:
Для отображения наличия билетов в будние дни:
Чтобы указать, что все три типа билетов доступны в этот временной интервал, используйте либо (необязательный) |
duration_requirement | Необходимо указать продолжительность и/или время окончания слота. Это поле будет проигнорировано, если слот недоступен. Не используется в разделе «Чем заняться». (необязательно) |
scheduling_rule_overrides | Правила планирования доступности. Если поля заполнены, они переопределят любые соответствующие правила планирования на уровне сервиса в разделе SchedulingRules. |
confirmation_mode | Режим подтверждения, который будет использоваться при бронировании данного варианта размещения. Попытки создания бронирований для вариантов размещения с режимом подтверждения CONFIRMATION_MODE_SYNCHRONOUS должны быть немедленно подтверждены или отклонены. Попытки создания бронирований для вариантов размещения с режимом подтверждения CONFIRMATION_MODE_ASYNCHRONOUS должны быть либо немедленно отклонены, либо созданы со статусом PENDING (ожидание). |
linkout_required_reason | Необязательно. Причина, по которой для этого слота требуется ссылка. Если задано, ресурс продавца для этого слота должен иметь действительный шаблон ссылки (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 затем используются для обозначения забронированных/недоступных временных диапазонов в течение рабочего дня.
Требования:
- Расширение слотов доступности или периодичности НЕ должно приводить к созданию идентичных слотов. Если идентификаторы, время начала, длительность и ресурсы совпадают, слоты считаются идентичными.
- Не следует смешивать стандартный формат доступности и формат с регулярным посещением в рамках одной услуги. Формат с регулярным посещением выгоден продавцам/сервисам, предлагающим запись на прием. Стандартный формат ориентирован на продавцов/сервисы, предлагающие регулярные занятия.
- Продолжительность рецидивов не должна превышать 24 часов.
| Поля | |
|---|---|
repeat_until | Максимальное время доступности, включая временную метку UTC, будет повторяться до тех пор, пока... |
repeat_every | Определяет интервал времени между последовательными временными интервалами доступности. Пример: Доступность с продолжительностью 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 | Временной диапазон исключения. Любые временные интервалы, описываемые повторяющимся событием, которые перекрывают этот закрытый-открытый временной диапазон, будут считаться недоступными. Пример: Если в заданном интервале повторения указано время 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 | Последнее время (в секундах), когда этот слот можно было забронировать. Эта метка времени должна быть до start_sec слота, чтобы ее учитывать (если пользователи должны иметь возможность бронировать после времени начала, используйте SchedulingRules.min_booking_before_end_time уровня сервиса). Если присутствует, переопределит все, что указано в min_booking_buffer правил SchedulingRules соответствующего сервиса. |
first_bookable_sec | Первое время (в секундах), когда этот слот можно забронировать. Эта метка времени должна быть раньше, чем start_sec слота, или last_bookable_sec, если указано. |
last_online_cancellable_sec | Если задано, указывается последнее время (в секундах с начала эпохи Unix), когда этот конкретный слот для записи можно отменить через функцию «Зарезервировать с помощью Google». Это поле переопределяет любые правила отмены на уровне сервиса. (необязательно) |
BatchDeleteGenericRecordsRequest
Пакетный запрос на удаление записей указанного типа потока данных.
| Поля | |
|---|---|
parent | Название ресурса, имеющее формат - |
records[] | Записи, подлежащие удалению. Максимальное количество записей в одном вызове API — 1000. |
BatchPushGenericRecordRequest
Пакетный запрос на вставку и/или обновление записей типа ленты, указанного в URL-адресе запроса.
| Поля | |
|---|---|
parent | Название ресурса, имеющее формат - |
records[] | Записи, которые необходимо вставить и/или обновить. Максимальное количество записей в одном вызове API — 1000. |
BatchReplaceServiceAvailabilityRequest
Пакетный запрос на замену нескольких слотов доступности Service .
| Поля | |
|---|---|
parent | Формат |
extended_service_availability[] | Расширенная доступность услуг, которая используется для замены существующих слотов доступности. |
BatchReplaceServiceAvailabilityResponse
Пакетный ответ для замены нескольких слотов доступности Service . В это сообщение будут включены только успешно обновленные слоты.
| Поля | |
|---|---|
extended_service_availability[] | Успешно обновлены сообщения о доступности расширенного сервиса, которые использовались для замены существующих слотов доступности. |
Бронирование
Бронирование места в товарном запасе
| Поля | |
|---|---|
name | Название ресурса бронирования: |
merchant_id | Идентификатор продавца для игрового автомата |
service_id | Идентификатор сервиса продавца |
start_time | Время начала назначенного приема |
duration | Продолжительность сеанса приема |
client_information | Персональные данные клиента, записывающегося на прием. |
status | Статус бронирования |
payment_information | Информация о платежных операциях, связанных с бронированием. |
party_size | количество человек в группе, забронировавших номер. |
BookingFailure
Данные о статусе, указывающие на причину асинхронной обработки бронирования. BookingFailure предназначен в первую очередь для выявления ошибок бизнес-логики.
| Поля | |
|---|---|
cause | Причина, по которой бронирование не удалось. (обязательно) |
rejected_card_type | (требуется только в том случае, если причиной является PAYMENT_ERROR_CARD_TYPE_REJECTED) |
description | Это необязательное поле используется партнером для предоставления дополнительной информации исключительно в целях отладки. (необязательно) |
payment_failure | Информация о сбоях платежей. |
Причина
Перечисление причин отказов.
| Перечисления | |
|---|---|
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 | Параметры, используемые агрегатором RwG для инициирования протокола аутентификации 3DS1 с пользователем. Будут игнорироваться, если параметр BookingFailure.cause не установлен в значение PAYMENT_REQUIRES_3DS1. |
ThreeDS1Parameters
Параметры, запрашивающие у RwG выполнение проверки 3DS1.
Параметры задаются в соответствии с описанием протокола 3DS1, предоставленным компанией EMVCo.
| Поля | |
|---|---|
acs_url | URL-адрес, с которого будет загружена форма для отображения пользователю в целях аутентификации. |
pa_req | Запрос на аутентификацию платежа. Будет отправлен в форму ACSUrl, если она предоставлена. |
transaction_id | Идентификатор, используемый поставщиком ACS. При необходимости будет отправлен в форму ACSUrl. |
md_merchant_data | Данные продавца. Будут отправлены в форму 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[] | К данному полису не применяются никакие или более условий возврата средств. |
Условия возврата
Определяет одно условие возврата средств. Несколько условий возврата средств могут использоваться вместе для описания «этапов возврата», представляющих собой различные промежутки времени до начала оказания услуги.
| Поля | |
|---|---|
min_duration_before_start_time | Период до начала оказания услуги, до которого клиент может получить возврат части стоимости услуги, указанной в параметре |
refund_percent | Процент, который может быть возвращен при условии отмены бронирования услуги не менее чем за |
Информация о клиенте
Персональные данные лица, осуществляющего бронирование.
| Поля | |
|---|---|
given_name | Имя клиента |
family_name | Фамилия клиента |
address | Адрес клиента |
telephone | Номер телефона клиента |
email | Адрес электронной почты клиента |
CreateAdsAccountLinkRequest
Сообщение запроса для AdsAccountLinkingService.CreateAdsAccountLink.
| Поля | |
|---|---|
parent | Обязательно. Родительский ресурс, где будет создана ссылка на этот рекламный аккаунт. Это тот же идентификатор, что и в Партнерском центре. Формат: partners/{partner} |
ads_account_link_id | Обязательно. Идентификатор, используемый для привязки аккаунта Google Ads. Это тот же идентификатор клиента Google Ads. Подробнее см. https://support.google.com/google-ads/answer/1704344 Формат: xxx-xxx-xxxx. |
ads_account_link | Обязательно. Ссылка на рекламный аккаунт для создания. |
CreateMerchantRequest
Запрос на создание Merchant .
| Поля | |
|---|---|
parent | Имя родительского ресурса для партнера, которому принадлежит данный продавец, в формате |
merchant_id | Идентификатор продавца, который следует использовать для данного продавца. |
merchant | Торговец должен создать. |
CreateServiceRequest
Запрос на создание новой Service .
| Поля | |
|---|---|
parent | Имя родительского ресурса для продавца, которому принадлежит данная услуга, в формате |
service_id | Идентификатор сервиса, который следует использовать для данного сервиса. |
service | Сервис для создания. |
Ограничения по кредитным картам
Ограничения на типы кредитных карт, принимаемых этим продавцом.
| Поля | |
|---|---|
credit_card_type[] | Список поддерживаемых кредитных карт. Если список пуст, поддержка кредитных карт отсутствует. |
Тип кредитной карты
Тип кредитной карты.
| Перечисления | |
|---|---|
CREDIT_CARD_TYPE_UNSPECIFIED | Неиспользованный. |
VISA | Кредитная карта Visa. |
MASTERCARD | Кредитная карта Mastercard. |
AMERICAN_EXPRESS | Кредитная карта American Express. |
DISCOVER | Кредитная карта Discover. |
JCB | Кредитная карта JCB. |
DeleteAdsAccountLinkRequest
Сообщение запроса для AdsAccountLinkingService.DeleteAdsAccountLink.
| Поля | |
|---|---|
name | Обязательно. Название ссылки на рекламный аккаунт, которую нужно удалить. Формат: partners/{partner}/adsAccountLinks/{ads_account_link} |
DeleteMerchantRequest
Запрос на удаление Merchant .
| Поля | |
|---|---|
name | Имя ресурса продавца, которого нужно удалить. В формате partners/{partner_id}/merchants/{merchant_id} |
DeleteServiceRequest
Запрос на удаление Service .
| Поля | |
|---|---|
name | Имя ресурса сервиса, который нужно удалить. В формате |
Вклад
Депозит, с которого с пользователя может быть списана сумма или которая может быть заблокирована на его кредитной карте.
| Поля | |
|---|---|
deposit | Сумма депозита. |
min_advance_cancellation_sec | Минимальный размер предоплаты при отмене заказа для внесения депозита. |
deposit_type | Определяет, как формируется размер депозита в зависимости от доступности средств. |
DirectMerchantPayment
Информация о том, как пользователь может оплатить услугу напрямую продавцу, вместо предварительной оплаты через RwG.
| Поля | |
|---|---|
payment_methods[] | Пользователям рекомендуется оплачивать покупки только с помощью указанных ниже способов оплаты. |
Диапазон продолжительности
Обертка для диапазона продолжительности, который может быть ограниченным или неограниченным. Требуется как минимум один из параметров min_duration и max_duration.
| Поля | |
|---|---|
min_duration | Минимальная продолжительность. |
max_duration | Максимальная продолжительность. |
Экономический оператор
Информация об экономическом операторе для агрегатора.
| Поля | |
|---|---|
text | Обязательно. Наименование, адрес, номер телефона и адрес электронной почты экономического оператора, определяемого как производитель, уполномоченный представитель, импортер, дистрибьютор, поставщик услуг по выполнению заказов или любое другое физическое или юридическое лицо, имеющее обязательства, связанные с производством продукции, ее предоставлением или вводом в эксплуатацию. Строковое представление экономического оператора в произвольном формате. Эта информация может быть отформатирована с использованием символов "" и "\n". |
Расширенная доступность услуг
Список доступных вакансий и информация о том, к кому и когда следует обращаться с заявками.
| Поля | |
|---|---|
merchant_id | Это обязательное поле, в котором необходимо указать, какому продавцу относятся приведенные ниже сообщения о наличии товара. |
service_id | Это обязательное поле, в котором необходимо указать, к какой службе относятся приведенные ниже сообщения о доступности. |
start_time_restrict | Если предоставленные данные о доступности указаны, мы будем рассматривать их как полный снимок состояния на момент времени [start_time_restrict, end_time_restrict]. То есть, вся существующая доступность будет удалена, если выполняется следующее условие: Если задано условие по длительности, то условие дополнительно ограничивается: Если задано сообщение resources_restrict, условие дополнительно ограничивается: Эти поля обычно используются для предоставления полной информации о доступности в заданном временном диапазоне. Установка параметра start_time_restrict при отсутствии параметра end_time_restrict интерпретируется как "все время, начинающееся с start_time_restrict". |
end_time_restrict | Установка параметра end_time_restrict при отсутствии параметра start_time_restrict интерпретируется как "все время до значения end_time_restrict". |
duration_restrict | Установка продолжительности дополнительно ограничивает область действия обновления, позволяя использовать только те версии, которые доступны в течение соответствующего периода времени. |
resources_restrict | Установка параметра resources_restrict дополнительно ограничивает область обновления только этим набором ресурсов. Все поля id ресурсов должны точно совпадать. |
availability[] | Новый список доступных товаров. |
FeedStatistics
Статистические данные, полученные в процессе обработки загруженного видеопотока.
| Поля | |
|---|---|
new_items | Новые товары, добавленные этим лентой. В зависимости от типа ленты, товарами могут быть продавцы, услуги или слоты доступности. |
existing_items | Существующие элементы обновляются по мере необходимости на основе новой информации из ленты. |
deleted_items | Элементы, которые больше не присутствуют в этой ленте и были удалены в результате этого. |
FeedStatus
Статус ленты, загруженной платформой агрегатора.
| Поля | |
|---|---|
name | Название ресурса ленты, имеющее следующий формат:
|
state | Состояние обработки данного потока данных. |
error_details | Удобочитаемая строка, содержащая более подробную информацию в случае, если нам не удалось обработать этот поток данных. |
statistics | Статистика, относящаяся непосредственно к этой ленте. |
Состояние
Перечисление, указывающее на стадию обработки потока данных.
| Перечисления | |
|---|---|
STATE_UNSPECIFIED | Значение по умолчанию. Не используется. |
IN_PROGRESS | Обработка корма еще продолжается. |
SUCCESS | Обработка корма прошла успешно. |
FAILURE | В процессе обработки ленты возникла ошибка. |
Метаданные заказа еды
Метаданные для ссылок, используемых при оформлении заказа еды.
| Поля | |
|---|---|
fee_details[] | Подробная информация о сборах, взимаемых с пользователя сверх общей суммы за товар. Повторяется для разных типов сборов, таких как плата за обслуживание, плата за доставку и т. д. |
advance_order_details | Подробная информация о поддержке расширенного оформления заказов, также известного как предварительный заказ, позволяющего пользователю разместить заказ для выполнения позднее, чем сейчас. |
Поле Union field fulfillment_duration_options . Время выполнения заказа с момента подтверждения заказа. Для заказов с доставкой — время до доставки еды. Для заказов с самовывозом — время до готовности еды к выдаче. fulfillment_duration_options может принимать только одно из следующих значений: | |
fulfillment_lead_time_duration | Фиксированная продолжительность. Например: 30 минут. |
fulfillment_lead_time_duration_range | Диапазон продолжительности. Примеры: * от 30 до 45 минут * Более 30 минут * Менее 50 минут |
Предварительные сведения о заказе
Для оформления предварительного заказа.
| Поля | |
|---|---|
is_supported | Значение True, если поддерживаются предварительные заказы (также известные как заказы заранее). (обязательно) |
Подробности о комиссионных сборах
Подробная информация о платежах.
| Поля | |
|---|---|
type | Тип оплаты. (обязательно) |
fee_amount | Размер комиссии может быть указан в валюте, в процентах от стоимости корзины или в сочетании того и другого. (обязательно) |
Сумма комиссии
Примеры 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 | Комиссия в процентах от стоимости корзины. Поддерживается диапазон (ограниченный и неограниченный) или фиксированный процент. Значение должно быть от 0 до 100. Примеры: * Фиксированная 5,5% * Не менее 5,5% * Не более 5,5% * От 4,5% до 5,5% |
Поле объединения amount_options . Параметры для указания денежной суммы. amount_options может принимать только одно из следующих значений: | |
amount | Фиксированная сумма. Например, 3,5 доллара США. |
amount_range | Диапазон сумм. Примеры: * от 3,5 до 5,5 долларов США * Минимум 3,5 доллара США * Максимум 5,5 доллара США |
amount_unknown | Неизвестная сумма. |
FeeType
Тип оплаты.
| Перечисления | |
|---|---|
FEE_TYPE_UNSPECIFIED | Тип платы не указан. |
DELIVERY | Стоимость доставки. |
SERVICE | Стоимость услуг. |
Вариант выполнения
Ссылка для выполнения онлайн-заказа.
| Поля | |
|---|---|
fulfillment_type | Обязательно. Тип выполнения. |
available_day[] | Обязательно. Список дней, когда доступен данный способ выполнения заказа (желательно не менее 2). |
fee_details | Обязательно. Подробная информация о способе выполнения заказа. |
minimum_order | Обязательно. Минимальная сумма заказа для способа выполнения, связанного со ссылкой на действие. |
Доступный день
Доступно в течение дня.
| Поля | |
|---|---|
fulfillment_date | Обязательно. Доступная дата для способа выполнения заказа. Предполагается, что она находится в часовом поясе продавца. |
last_ordering_time | Обязательно. Временная метка Unix. Последнее время, когда пользователь мог сделать заказ и получить товары до даты Например, если 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 | За использование выбранного метода обработки заказа комиссия не взимается. |
base_fee | Базовая плата, связанная с методом выполнения заказа. |
fixed_fee | Фиксированная плата, связанная с методом выполнения заказа. |
Фиксированная плата
Фиксированная плата, взимаемая за способ выполнения заказа, связанный с ссылкой для совершения действия.
| Поля | |
|---|---|
amount | Обязательно. Размер фиксированной платы за выбранный способ выполнения заказа. |
Тип выполнения
Тип выполнения, связанный со ссылкой для совершения действия.
| Перечисления | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED | Тип выполнения заказа не указан. |
FULFILLMENT_TYPE_DELIVERY | Тип выполнения заказа — доставка. |
FULFILLMENT_TYPE_PICKUP | Тип выполнения заказа — самовывоз. |
Минимальная плата
Минимальная плата, необходимая для способа выполнения заказа, связанного с ссылкой для совершения действия.
| Поля | |
|---|---|
base_fee_amount | Обязательно. Базовая сумма комиссии за выбранный способ выполнения заказа. |
Без комиссии
Этот тип не содержит полей.
За использование метода выполнения заказа, связанного с ссылкой для совершения действия, плата не взимается.
GenericDeleteRecord
Запись, подлежащая удалению, относится к типу ленты, указанному в URL-запросе.
| Поля | |
|---|---|
delete_time | Обязательно. Эта метка времени используется для определения порядка, в котором будут применяться изменения в инвентаре. |
Поле объединения record_type . Инкапсулирует различные типы фидов (ndjson, на основе протоколов и т. д.). Партнер может предоставить полную запись, аналогично тому, как запись предоставляется в фиде или API BatchPush. Партнеры также могут включать только необходимые поля записи, требуемые для ее уникальной идентификации. record_type может принимать только одно из следующих значений: | |
data_record | Для кормов, не основанных на прототипах. |
proto_record | Для кормов на основе прототипов. |
GenericRecord
Запись о типе фида, указанном в URL-запросе.
| Поля | |
|---|---|
generation_timestamp | Обязательно. Эта метка времени используется для обеспечения правильного порядка обновления данных об остатках на складе. |
Поле объединения record_type . Инкапсулирует различные типы фидов (ndjson, на основе прототипов и т. д.). record_type может принимать только одно из следующих значений: | |
data_record | Для кормов, не основанных на прототипах. |
proto_record | Для кормов на основе прототипов. |
Геокоординаты
Географические данные местоположения, включая широту, долготу и адрес.
| Поля | |
|---|---|
latitude | Широта в градусах. (необязательно) |
longitude | Долгота в градусах. (необязательно) |
addresses в объединенных полях. Адрес местоположения может быть как структурированным, так и неструктурированным. addresses может быть только одним из следующих: | |
address | Предпочтительно указать почтовый адрес места жительства. |
unstructured_address | В качестве запасного варианта можно указать неструктурированный адрес. Например: "1600 amphitheatre parkway mountain view, ca 94043" |
GetAdsAccountLinkRequest
Сообщение запроса для AdsAccountLinkingService.GetAdsAccountLink.
| Поля | |
|---|---|
name | Обязательно. Название ссылки на рекламный аккаунт, которую необходимо получить. Формат: |
GetMerchantStatusRequest
Запрос на получение статуса MerchantStatus
| Поля | |
|---|---|
name | Обязательно. Название ресурса в формате partners/{partner_id}/merchants/{merchant_id}/status. |
GetStatusRequest
Запрос на получение Status для конкретного фида, загруженного платформой агрегатора.
| Поля | |
|---|---|
name | Название ресурса ленты, имеющее следующий формат:
|
HomeServiceData
Дополнительная информация, которую необходимо предоставить для направления "Услуги на дому".
| Поля | |
|---|---|
category_type | Категория высокого уровня, к которой относится данная услуга на дому. Например, сантехник, электрик и т. д. |
job_type | Тип задания, относящийся к категории, к которой относится данная услуга для дома. Например, unclog_drain, install_faucet — это типы заданий в категории «сантехник». |
Тип интеграции
Поддерживается глубина интеграции.
| Перечисления | |
|---|---|
INTEGRATION_TYPE_UNSPECIFIED | По умолчанию используется значение END_TO_END. |
INTEGRATION_TYPE_END_TO_END | Полная интеграция, позволяющая осуществлять бронирование от начала до конца через Google. |
INTEGRATION_TYPE_INVENTORY_ONLY | Сервер бронирования не обязан поддерживать эту услугу. Необходимо отправлять только информацию о продавцах, услугах и (при желании) данные о наличии мест. |
InvalidateResourceRequest
Запрос на аннулирование ресурса.
| Поля | |
|---|---|
resource_id | Название ресурса, подлежащего аннулированию. Например, для ресурса Pickup имя должно иметь формат |
Позиция
Отдельный пункт в заказе — бронирование одной услуги в один временной интервал.
| Поля | |
|---|---|
service_id | Идентификатор сервиса продавца. |
start_sec | Время начала назначенного сеанса записи в секундах по UTC с момента начала эпохи Unix. |
duration_sec | Продолжительность сеанса приема в секундах. |
tickets[] | Количество билетов, заказанных по типу билета. |
price | Общая стоимость (без учета налогов) данной позиции. |
status | Статус позиции. |
Заказанные билеты
Количество заказанных билетов по типу билета.
| Поля | |
|---|---|
ticket_id | Идентификатор типа билета. |
count | Количество билетов, заказанных на этот тип. |
LinkoutTemplate
Шаблон, определяющий, как Google должен генерировать URL-адреса для сайта партнера.
| Поля | |
|---|---|
uri_template | Шаблон 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 | Обязательно. Родительская компания, которой принадлежит эта коллекция статусов продавцов. Формат: |
page_size | Обязательно. Максимальное количество возвращаемых элементов. Обратите внимание, что сервер может уменьшить размер страницы. |
page_token | Необязательно. Значение nextPageToken, возвращаемое из предыдущего ListMerchantStatusResponse, если таковое имелось. |
booking_inventory_status_restrict | Необязательно. Дополнительное ограничение для фильтрации результатов по статусу наличия свободных мест для бронирования. |
waitlist_inventory_status_restrict | Необязательно. Дополнительное ограничение для фильтрации результатов по статусу наличия мест в списке ожидания. |
geo_match_restrict | Необязательно. Дополнительное ограничение для фильтрации результатов по статусу географического соответствия. |
Статус бронирования
Полный список доступных для бронирования мест.
| Перечисления | |
|---|---|
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[] | Список статусов продавцов, удовлетворяющих условиям фильтра. |
next_page_token | Токен для перехода на следующую страницу результатов. Если список пуст, в нем больше нет результатов. |
ListStatusRequest
Запрос на получение Status для нескольких каналов, загруженных платформой агрегатора.
| Поля | |
|---|---|
name | Название ресурса ленты, имеющее следующий формат:
|
page_size | Максимальное количество товаров, подлежащих возврату. |
page_token | Значение next_page_token, возвращенное из предыдущего запроса List, если таковой имелся. |
state_restrict | Дополнительное ограничение для фильтрации результатов по состоянию потока. |
time_range_restrict | Необязательный параметр limit для фильтрации результатов по верхнему и нижнему пределам. Если start_time не задано, по умолчанию будет установлено начало времени Unix. Если end_time не задано, по умолчанию будет установлено текущее время. |
ListStatusResponse
Запрос на получение Status для нескольких каналов, загруженных платформой агрегатора.
| Поля | |
|---|---|
status[] | Обратный хронологический список статусов для загруженных лент. Максимальное количество возвращаемых элементов определяется полем page_size в запросе. |
next_page_token | Токен для перехода на следующую страницу результатов. Если список пуст, в нем больше нет результатов. |
LocalizedString
Экземпляр строки в одной локали.
| Поля | |
|---|---|
locale | Языковой код IETF BCP 47, например, "en", "mas", "zh-Hant", "de-CH-1901". См. http://www.w3.org/International/articles/language-tags/ . |
value | Сообщение в указанной выше кодировке (UTF-8). |
Расположение
Географическая информация о местоположении.
| Поля | |
|---|---|
place_id | 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 | 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 | The public telephone number of the location including its country and area codes, eg +14567891234. (optional) |
url | The url of the location's public website. (optional) |
geo | The Geo info of the location, including latitude, longitude, and address. (optional) |
location_type | The type of the location, must be supplied if this location is provided for a Service. |
location_id | 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 | The merchant resource name, which has the format of |
merchant_name | 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 | The public telephone number of the merchant including its country and area codes, eg +14567891234. |
url | The url of the merchant's public website. |
geo | The Geo info of the merchant, including latitude, longitude, and address. |
category | The category of the business in aggregator's platform. |
num_bookings_30d | This field is deprecated. |
tax_rate_basis_points | 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 | 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 | 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[] | 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 | Configuration for a tokenized payment processor, if the merchant has support for it. |
tokenization_config | Configuration for a tokenized payment processor, if the merchant has support for it. Deprecated since E2E payments is no longer supported. |
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 | 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? 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 | 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[] | Definitions for any service attributes used to describe the Services for this Merchant. (optional) |
action_link[] | Optional. An action URL with associated language, list of countries restricted to, type, and optional platform that indicates which platform this action should be performed on, |
reservation_linkout_template[] | 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 | 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 | 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 | 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 | The merchant status resource name, which has the format of |
merchant_name | Name of the merchant provided by partners. |
input_geo_info | Partners provided Geo info of the merchant. |
processing_status | Merchant processing status. |
booking_status | Status related to end-to-end booking integration. |
waitlist_status | Status related to waitlist integration. |
geo_match | Matched Geo place of this merchant. Empty if the merchant is not Geo matched. |
local_services_match | Local services match of this merchant. Empty if it is not a local service merchant or is not matched to any providers. |
direct_urls[] | 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 | 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 | Type of this URL. |
url | 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[] | Matched service providers. A merchant can be matched to multiple service providers. |
MatchedProvider
Local services provider.
| Поля | |
|---|---|
customer_id | Google local services external customer ID. |
categories[] | Local service categories (verticals). Eg "plumber" and "carpet_cleaning". |
PlaceInfo
Information of a matched place.
| Поля | |
|---|---|
name | Name of the place. |
formatted_address | Formatted address in local language. |
place_id | 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 | 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 | Минимальная сумма. |
max_amount | Максимальная сумма. |
NoShowFee
A fee that a user may be charged if they have made a booking but do not show up.
| Поля | |
|---|---|
fee | The amount the user may be charged if they do not show up for their reservation. |
fee_type | Defines how the fee is determined from the availability. |
Заказ
An order for service appointments with a merchant.
| Поля | |
|---|---|
name | Resource name of the order: |
client_information | Personal information of the client making the order. |
payment_information | Information about payment transactions that relate to the order. |
merchant_id | ID of the merchant that all services in this order belong to. |
item[] | Line items in this order. |
Метаданные онлайн-заказа
Метаданные для ссылки, ведущей к онлайн-заказу.
| Поля | |
|---|---|
fulfillment_option[] | Доступные варианты выполнения заказа по ссылке для онлайн-заказа. |
Платежная информация
Payment details that relate to a booking
| Поля | |
|---|---|
prepayment_status | 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 | 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 | 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 | The name of the payment option. This can be user visible. |
description | A description of the payment option. This can be user visible. |
price | The price of the payment option. |
tax_rate | 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 | The type of this payment option. Single-use for drop-ins, multi-use for packs, and unlimited for memberships. |
session_count | How many sessions this payment option can be used for. Valid only for multi-session / packs, where the value should be > 1. |
purchase_interval | The payment option can be purchased within this interval. |
valid_interval | 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 of the payment option validity (eg 30 day membership). |
activation_type | Defines how the validity start date is determined for this payment option. |
user_restriction | 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 | Defines the payment processor partner this configuration applies to. |
public_key | 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 | 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 | 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 | A fee that can vary by delivery method. |
processing_fee | A fee to process the user's payment method. |
PerTicketFee
Fees that must be paid for each ticket the user purchases.
| Поля | |
|---|---|
service_charge | An extra charge assessed for a service. |
facility_fee | A fee that goes to the venue/facility. |
taxes | Per ticket taxes. |
PostalAddress
Address of a customer or a business.
| Поля | |
|---|---|
address_country | The country, specified using its ISO 3166-1 alpha-2 country code, eg "US" (required) |
address_locality | The locality, eg "Mountain View". (required) |
address_region | The region, eg "CA". This field is only required in countries where region is commonly a part of the address. (optional) |
postal_code | The postal code, eg "94043". (required) |
street_address | The street address, eg "1600 Amphitheatre Pkwy". (required) |
Предоплата
A payment the user may be charged as part of their reservation.
| Поля | |
|---|---|
price_info | 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 | 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 | The currency of the price that is defined in ISO 4217. |
pricing_option_tag | An optional and opaque string that identifies the pricing option that is associated with the extended price. |
PriceInfo
Container for price details.
| Поля | |
|---|---|
price_type | 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 | The price of a service or a fee. |
price_range | 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 | Минимальная сумма. |
max_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 | Единственное значение. Например: 5,6 |
value_range | Диапазон значений, который может быть как неограниченным, так и ограниченным. Примеры: * Не менее 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 | Минимальное значение. |
max_value | Максимальное значение. |
Рейтинг
Defines Rating for an entity.
| Поля | |
|---|---|
value | 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 | 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 | URL of this media source. Google will crawl the media hosted at this URL. |
type | Type of this media source. |
localized_caption | Caption of the media that supports i18n, only plain text is supported. Any HTML components will be stripped. (optional) |
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, prefer to use localized_caption. |
Атрибуция
Attribution information for this media.
| Поля | |
|---|---|
localized_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, 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | The minimum advance notice in seconds required to cancel a booked appointment online. (optional) |
late_cancellation_fee | The fee for canceling within the minimum advance notice period. |
noshow_fee | The fee for no-show without canceling. |
admission_policy | The admission policy that applies to this service. If unset, defaults to TIME_STRICT. (optional) |
cancellation_policy | Scheduling rules cancellation policy. (required for Things-to-do) |
Union field 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. Примеры:
| |
min_advance_booking | The duration (in seconds) from when the last booking can be made to when the availability slot starts. |
min_booking_buffer_before_end_time | 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 | The service resource name, which has the format of |
service_name | The name of the service, eg "Men's haircut". Deprecated, use localized_service_name instead. |
localized_service_name | The name of the service, eg "Men's haircut". Possibly in several locales. |
description | The user-visible description of the service. Deprecated, use localized_description instead. |
localized_description | 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> Paragraph tag: <p> List tags: <ul>, <ol>, <li> Division tag: <div> Phrase tags: <br>, <strong>, <em>: Unsupported tags:
Важные примечания:
|
price | The price of the service. |
price_interpretation | 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 | Rules to book/cancel an appointment. |
prepayment_type | Whether a prepayment is required, optional or not supported. |
prepayment_terms | Terms around when the prepayment is completed. |
form[] | Deprecated. Please use intake_form and per_ticket_intake_form. |
intake_form | A form requesting additional information from the user when they book this service. (optional) |
per_ticket_intake_form | 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 | 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[] | 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 | 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 | 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 | 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) |
action_link[] | An action link related to this service. If action link exists, type (see below) must be set in the Service. |
type | The predefined type of this service. (optional) |
ticket_type[] | Types of tickets that can be booked/purchased for this service, if tickets are supported. (optional) |
related_media[] | 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[] | 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 | Rules to joining the waitlist. |
ticketing_vertical_specific_data | Additional information unique to the event ticketing vertical. (optional) |
integration_type | 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 | Order level fees for purchasing this service. (optional) |
tours_and_activities_content | Content fields specific to Tours and Activities. |
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 | User rating for this service as an aggregate metric over all reviews. |
home_service_data | Additional information unique to home service vertical. (optional) |
virtual_session | Optional. Information about virtual session. It is required for enabling virtual services. |
direct_merchant_payment | 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 | Optional. An optional template specifying how Google should generate URLs to external site. |
PrepaymentTerms
Specific information around when prepayment is completed.
| Поля | |
|---|---|
charge_timing | When the charge will occur relative to the purchase time. |
charge_time_before_start_time_sec | 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 | An identifier that uniquely identifies this service attribute among others for the same merchant, eg "account-type". |
attribute_name | A user-visible name for this attribute, eg "Account Type". |
value[] | All possible values for this service attribute. |
Ценить
Represents a possible value for a particular service attribute.
| Поля | |
|---|---|
value_id | An identifier that uniquely identifies this value among others for this service attribute, eg "personal". |
value_name | 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 | ID of an attribute as defined in Merchant.service_attribute, eg "service-type". |
value_id | ID of the value for this attribute, eg "haircut". Must match a value_id in the service attribute definition. |
ServiceAvailability
Список доступных вакансий и информация о том, к кому и когда следует обращаться с заявками.
| Поля | |
|---|---|
name | The resource name of the service to apply this to. In the format of |
start_time_restrict | 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: Если задано условие по длительности, то условие дополнительно ограничивается: If a resources_restrict message is set, the condition is further restricted: Эти поля обычно используются для предоставления полной информации о доступности в заданном временном диапазоне. Setting start_time_restrict while leaving end_time_restrict unset is interpreted to mean all time beginning at start_time_restrict. |
end_time_restrict | Setting end_time_restrict while leaving start_time_restrict unset is interpreted to mean all time up to the end_time_restrict. |
duration_restrict | Установка продолжительности дополнительно ограничивает область действия обновления, позволяя использовать только те версии, которые доступны в течение соответствующего периода времени. |
resources_restrict | 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[] | Новый список доступных товаров. |
ServiceIntakeForm
Defines an intake form that customizes the service provided by a merchant.
| Поля | |
|---|---|
field[] | Fields that will be displayed to the user. |
first_time_customers | If true, this form will be shown to first time customers. Deprecated. This functionality is not supported for intake forms. |
returning_customers | 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 | 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 | The type of this field. |
label | The text shown to the user for this field. Deprecated, please use |
localized_label | The text shown to the user for this field. The field can be supplied in multiple locales. (required) |
value[] | 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[] | Set if and only if the field type is MULTIPLE_CHOICE, CHECKBOXES, or DROPDOWN. Used to enumerate possible choices. |
is_required | Indicates whether an answer to this field is required by a user. |
allow_custom_answer | 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[] | 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[] | 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 | 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. |
LOCATION_SEARCH | A search box that supports finding matched location given user input from provided location list. |
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 | 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 | Optionally, the URL to the Terms and Conditions. |
text | The text to be displayed to the user. Use localized_text below for new integrations. |
localized_text | The localized text to be displayed to the user. |
Текст
A possibly-localized text payload. Some Text fields may contain marked-up content.
| Поля | |
|---|---|
value | Text value in an unknown locale. Required if and only if |
localized_value[] | 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 | 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 | 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 | 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 | 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 | Additional fees for purchasing this ticket. (optional) |
price_display_type | Optional. Predetermined price display type of a single ticket of this type. |
option_description | Description of any additional option which this ticket type represents, if any. Deprecated, use localized_option_description instead. |
localized_option_description | 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 |
inventory_type | 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 | The category of the event. Set only when event falls into one of the predefined categories. (optional) |
event_url | The URL of the event on the partner's website. (optional) |
entity[] | A list of entities related to the event. (optional) |
event_attendance_mode | Required. The type of the event attendance. |
event_virtual_location_url[] | Optional. URL where the event can be watched. |
event_organizer | Optional. Organizer who hosts the event. |
event_organizer_url | Optional. URL of the organizer who hosts the event. |
event_organizer_type | Optional. The type of the organizer. |
event_source_url[] | Required. URL of the pages where the event information or descriptions can be found. |
event_state | Optional. State of the event. |
brand_name | Optional. The localized brand name. |
event_creator | 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 | Unique identifier of the entity in the partner's database. (optional) |
name | Name of the entity. (required) |
url | 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 | The type of the entity. (optional) |
entity_role | The role of the entity in the event. (optional) |
public_identification_data | 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 | 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[] | 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 | 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 | The lower bound of the time range. |
end_time | The upper bound of the time range. |
TokenizationConfig
A configuration for payment-processor tokenization, set up on a per-Merchant basis.
| Поля | |
|---|---|
tokenization_parameter | 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 | 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[] | The user-visible list of highlights. |
inclusions[] | The user-visible list of inclusions. |
exclusions[] | The user-visible list of exclusions. |
must_know[] | 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 | 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.
| Поля | |
|---|---|
ads_account_link | Required. The Ads account link to update. The AdsAccountLink's |
update_mask | Необязательный параметр. Список полей для обновления. |
UpdateBookingRequest
Request to update a google.maps.booking.v1alpha.Booking
| Поля | |
|---|---|
update_mask | Необходимо обновить маску полей всех полей бронирования. |
booking | The booking to be updated |
booking_failure | Если обработка асинхронно подтвержденного запроса на бронирование завершается неудачей и статус бронирования обновляется на «НЕУДАЧНО», это поле должно отражать ошибку бизнес-логики (например, у пользователя уже есть существующее бронирование слишком близко к этому времени). Это поле должно быть установлено только при обновлении статуса бронирования на «НЕУДАЧНО» и будет игнорироваться в противном случае. |
UpdateMerchantRequest
The request to update a Merchant .
| Поля | |
|---|---|
merchant | The new merchant data. |
update_mask | The specific fields to update for the merchant. |
UpdateOrderRequest
Request to update a google.maps.booking.v1alpha.Order
| Поля | |
|---|---|
update_mask | Field mask of all order fields to be updated |
order | The order to be updated |
UpdateServiceRequest
The request to update a Service .
| Поля | |
|---|---|
service | The new service data. |
update_mask | The specific fields to update for the service. |
UriTemplate
A template specifying how Google should generate URLs to external site.
| Поля | |
|---|---|
uri_template | 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 | A payment option that can only be purchased by users who have never purchased from the same merchant before. |
new_to_payment_option | 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 | 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 | Requirements for the given virtual session. Eg. yoga mat, cooking utensils etc. (Recommended) |
virtual_platform_info | Information about the virtual platform used in this session. (Required to enable virtual services) |
is_session_prerecorded | 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 used for virtual session. |
other_platform_name | 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 | 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 | 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 | 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[] | 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. |