Индекс
-
BookingNotification
(интерфейс) -
Feed
(интерфейс) -
InvalidationService
(интерфейс) -
InventoryStatus
(интерфейс) -
InventoryUpdate
(интерфейс) -
ActionLink
(сообщение) -
ActionLink.ActionLinkType
(перечисление) -
ActionPlatform
(перечисление) -
Advisement
(сообщение) -
Availability
(сообщение) -
Availability.ConfirmationMode
(перечисление) -
Availability.DurationRequirement
(перечисление) -
Availability.Recurrence
(сообщение) -
Availability.ScheduleException
(сообщение) -
Availability.SchedulingRuleOverrides
(сообщение) -
BatchDeleteGenericRecordsRequest
(сообщение) -
BatchPushGenericRecordRequest
(сообщение) -
BatchReplaceServiceAvailabilityRequest
(сообщение) -
BatchReplaceServiceAvailabilityResponse
(сообщение) -
Booking
(сообщение) -
BookingFailure
(сообщение) -
BookingFailure.Cause
(перечисление) -
BookingFailure.PaymentFailureInformation
(сообщение) -
BookingFailure.PaymentFailureInformation.ThreeDS1Parameters
(сообщение) -
BookingStatus
(перечисление) -
CallMerchant
(сообщение) -
CancellationPolicy
(сообщение) -
CancellationPolicy.RefundCondition
(сообщение) -
ClientInformation
(сообщение) -
CreateMerchantRequest
(сообщение) -
CreateServiceRequest
(сообщение) -
CreditCardRestrictions
(сообщение) -
CreditCardRestrictions.CreditCardType
(перечисление) -
DeleteMerchantRequest
(сообщение) -
DeleteServiceRequest
(сообщение) -
Deposit
(сообщение) -
DirectMerchantPayment
(сообщение) -
DurationRange
(сообщение) -
ExtendedServiceAvailability
(сообщение) -
FeedStatistics
(сообщение) -
FeedStatus
(сообщение) -
FeedStatus.State
(перечисление) -
FoodOrderingMetadata
(сообщение) -
FoodOrderingMetadata.AdvanceOrderDetails
(сообщение) -
FoodOrderingMetadata.FeeDetails
(сообщение) -
FoodOrderingMetadata.FeeDetails.FeeAmount
(сообщение) -
FoodOrderingMetadata.FeeDetails.FeeType
(перечисление) -
FulfillmentOption
(сообщение) -
FulfillmentOption.AvailableDay
(сообщение) -
FulfillmentOption.FeeDetails
(сообщение) -
FulfillmentOption.FixedFee
(сообщение) -
FulfillmentOption.FulfillmentType
(перечисление) -
FulfillmentOption.MinimumFee
(сообщение) -
FulfillmentOption.NoFee
(сообщение) -
GenericDeleteRecord
(сообщение) -
GenericRecord
(сообщение) -
GeoCoordinates
(сообщение) -
GetMerchantStatusRequest
(сообщение) -
GetStatusRequest
(сообщение) -
HomeServiceData
(сообщение) -
IntegrationType
(перечисление) -
InvalidateResourceRequest
(сообщение) -
LineItem
(сообщение) -
LineItem.OrderedTickets
(сообщение) -
ListMerchantStatusesRequest
(сообщение) -
ListMerchantStatusesRequest.BookingInventoryStatus
(перечисление) -
ListMerchantStatusesRequest.GeoMatchingStatus
(перечисление) -
ListMerchantStatusesRequest.WaitlistInventoryStatus
(перечисление) -
ListMerchantStatusesResponse
(сообщение) -
ListStatusRequest
(сообщение) -
ListStatusResponse
(сообщение) -
LocalizedString
(сообщение) -
Location
(сообщение) -
LocationType
(перечисление) -
Merchant
(сообщение) -
MerchantMatchingHints
(сообщение) -
MerchantStatus
(сообщение) -
MerchantStatus.BookingStatus
(сообщение) -
MerchantStatus.DirectUrl
(сообщение) -
MerchantStatus.DirectUrl.UrlType
(перечисление) -
MerchantStatus.LocalServicesMatchInfo
(сообщение) -
MerchantStatus.LocalServicesMatchInfo.MatchedProvider
(сообщение) -
MerchantStatus.PlaceInfo
(сообщение) -
MerchantStatus.ProcessingStatus
(перечисление) -
MerchantStatus.WaitlistStatus
(сообщение) -
MoneyRange
(сообщение) -
NoShowFee
(сообщение) -
Order
(сообщение) -
OrderOnlineMetadata
(сообщение) -
PaymentInformation
(сообщение) -
PaymentOption
(сообщение) -
PaymentOption.ActivationType
(перечисление) -
PaymentOption.PaymentOptionType
(перечисление) -
PaymentProcessorConfig
(сообщение) -
PaymentProcessorConfig.Processor
(перечисление) -
PaymentRestrictions
(сообщение) -
PerOrderFee
(сообщение) -
PerTicketFee
(сообщение) -
PostalAddress
(сообщение) -
PrepaymentStatus
(перечисление) -
Price
(сообщение) -
PriceInterpretation
(перечисление) -
PriceType
(перечисление) -
QuantitativeValue
(сообщение) -
QuantitativeValue.RangeValue
(сообщение) -
Rating
(сообщение) -
RelatedMedia
(сообщение) -
RelatedMedia.Attribution
(сообщение) -
RelatedMedia.MediaType
(перечисление) -
ReplaceServiceAvailabilityRequest
(сообщение) -
RequireCreditCard
(перечисление) -
Resources
(сообщение) -
SchedulingRules
(сообщение) -
SchedulingRules.AdmissionPolicy
(перечисление) -
Service
(сообщение) -
Service.PrepaymentTerms
(сообщение) -
Service.PrepaymentTerms.ChargeTiming
(перечисление) -
Service.PrepaymentType
(перечисление) -
Service.ServiceType
(перечисление) -
ServiceAttribute
(сообщение) -
ServiceAttribute.Value
(сообщение) -
ServiceAttributeValueId
(сообщение) -
ServiceAvailability
(сообщение) -
ServiceIntakeForm
(сообщение) -
ServiceIntakeFormField
(сообщение) -
ServiceIntakeFormField.FieldType
(перечисление) -
TaxRate
(сообщение) -
Terms
(сообщение) -
Text
(сообщение) -
TicketType
(сообщение) -
TicketingVerticalSpecificData
(сообщение) -
TicketingVerticalSpecificData.AttendanceMode
(перечисление) -
TicketingVerticalSpecificData.Entity
(сообщение) -
TicketingVerticalSpecificData.Entity.EntityRole
(перечисление) -
TicketingVerticalSpecificData.Entity.EntityType
(перечисление) -
TicketingVerticalSpecificData.EventCategory
(перечисление) -
TicketingVerticalSpecificData.EventState
(перечисление) -
TicketingVerticalSpecificData.OrganizerType
(перечисление) -
TicketingVerticalSpecificData.PublicIdentificationData
(сообщение) -
TimeRange
(сообщение) -
TokenizationConfig
(сообщение) -
TokenizationConfig.BillingInformationFormat
(перечисление) -
ToursAndActivitiesContent
(сообщение) -
UnsupportedPartySizeOption
(сообщение) -
UpdateBookingRequest
(сообщение) -
UpdateMerchantRequest
(сообщение) -
UpdateOrderRequest
(сообщение) -
UpdateServiceRequest
(сообщение) -
UserPurchaseRestriction
(сообщение) -
VirtualSession
(сообщение) -
VirtualSession.VirtualPlatformInfo
(сообщение) -
VirtualSession.VirtualPlatformInfo.Platform
(перечисление) -
WaitlistRules
(сообщение)
Уведомление о бронировании
Получает уведомления о встречах от внешних партнеров по планированию. Партнер должен вызвать UpdateBooking или UpdateOrder в зависимости от того, реализует ли партнер RPC на основе резервирования, такие как CreateBooking и CheckAvailability, или базовые RPC заказа, такие как CreateOrder и CheckOrderFulfillability.
ОбновлениеБронирование |
---|
Обновляет существующее
|
Обновить заказ |
---|
Обновляет существующий
|
Кормить
Получайте статус обработки загруженных каналов внешними партнерами-агрегаторами.
GetStatus |
---|
Получает
|
Списокстатус |
---|
Получает
|
ИнвалидацияСервис
Получает запросы на недействительность ресурсов от внешних партнеров.
Инвалидатересурсе |
---|
Делает недействительным существующий ресурс. Запрос игнорируется, если запрашиваемый ресурс не подписан на сервис Google. Поддерживаемые типы ресурсов: - Самовывоз.
|
Статус инвентаря
Получите инвентарь и соответствующий статус загруженных продавцов.
GetMerchantStatus |
---|
Получите
|
ListMerchantСтатусы |
---|
Перечислите все
|
Обновление инвентаря
Получает обновления инвентаря от внешних агрегаторов.
Пакетное удалениеGenericRecords |
---|
Удаляет записи указанного типа фида. Выполняет только базовую проверку (например, неверный запрос), после чего партнеру немедленно возвращается соответствующий ответ. Google выполняет проверку бизнес-логики запроса асинхронно. Этот пакетный вызов не гарантирует атомарность.
|
BatchPushGenericRecord |
---|
Вставляет и/или обновляет записи указанного типа канала. Выполняет только базовую проверку (например, неверный запрос), после чего партнеру немедленно возвращается соответствующий ответ. Google выполняет проверку бизнес-логики запроса асинхронно. Этот пакетный вызов не гарантирует атомарность.
|
Доступность пакетаReplaceService |
---|
Заменяет
|
СоздатьMerchant |
---|
Создает нового
|
СоздатьСервис |
---|
Создает новый
|
УдалитьMerchant |
---|
Удаляет существующего
|
УдалитьСервис |
---|
Удаляет существующую
|
ЗаменитьServiceAvailability |
---|
Заменяет
|
ОбновлениеMerchant |
---|
Обновляет существующего
|
Служба обновления |
---|
Обновляет существующую
|
ActionLink
URL-адрес действия с соответствующим языком, списком стран, в которых ограничено действие, и дополнительной платформой, указывающей, на какой платформе следует выполнить это действие.
Поля | |
---|---|
url | URL-адрес точки входа для этой ссылки действия. |
language | Языковой тег BCP-47, определяющий язык, на котором доступен контент из этого URI. |
restricted_country[] | Код страны ISO 3166-1 альфа-2. Оставьте пустым для неограниченной видимости. |
platform | Платформа, на которой должно быть выполнено это действие. Если это поле не установлено, ACTION_PLATFORM_WEB_APPLICATION будет использоваться в качестве резервного варианта. |
action_link_type | Предопределенный тип действия. |
order_online_metadata | Метаданные для ссылки онлайн-заказа. Поддерживает действие с ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE. |
food_ordering_metadata | Метаданные для ссылок для заказа еды. Поддерживает тип действия: * |
ТипДейшнЛинкТип
Заранее определенный тип действия, связанный со ссылкой действия.
Перечисления | |
---|---|
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 | Тип ссылки действия — заказ на покупку, может быть доставка, самовывоз или и то, и другое. |
Платформа действий
Платформа, на которой выполняется действие. Веб-приложение — это общий запасной вариант. Рекомендуется иметь хотя бы один 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. |
Совет
Рекомендации, которые отображаются пользователю при бронировании через «Забронировать через Google».
Поля | |
---|---|
text | Специальное сообщение, которое будет отображаться пользователю при бронировании через «Забронировать через Google». |
Доступность
Слот доступности сервиса продавца с указанием времени и количества мест.
Поля | |
---|---|
start_time | Время начала интервала встречи. |
duration | Продолжительность интервала встречи |
spots_total | Общее количество мест и открытых мест данного наличия. Примеры:
Примечание. При отправке запросов с использованием формата сжатия доступности, определенного ниже, будут выведены эти два поля.
|
spots_open | Количество открытых мест. |
availability_tag | Необязательная непрозрачная строка для идентификации этого слота доступности. Если установлено, оно будет включено в запросы на бронирование/обновление/отмену встреч. |
resources | Дополнительные ресурсы, используемые для устранения неоднозначности этого интервала доступности среди других, когда разные сотрудники или помещения являются частью службы. Например, один и тот же урок йоги с двумя инструкторами:
|
payment_option_id[] | Список идентификаторов, ссылающихся на варианты оплаты, которые можно использовать для оплаты этого слота. Фактические варианты оплаты определяются на уровне продавца, а также могут использоваться несколькими продавцами. Это поле переопределяет любые идентификаторы pay_option_ids, указанные в служебном сообщении. Аналогичным образом, указанные здесь идентификаторы pay_option_ids НЕ обязательно должны присутствовать в служебном сообщении, хотя они должны быть определены на уровне продавца. |
recurrence | Информация о повторении доступности, представляющая более одного времени начала. Повторение должно содержать записи на один рабочий день. |
schedule_exception[] | Времена, когда эту услугу нельзя запланировать. Чтобы ограничить количество сообщений Schedule_Exception, рассмотрите возможность объединения соседних исключений. |
deposit | Дополнительный залог за это наличие. Переопределяет депозит за обслуживание, если он был указан. |
no_show_fee | Дополнительная плата за незаезд при наличии возможности. Отменяет плату за неявку за услугу, если она была указана. |
require_credit_card | Указывает, должен ли пользователь предоставить кредитную карту, чтобы забронировать этот слот доступности. Если значение не установлено, оно наследуется от уровня обслуживания, если оно там установлено. (необязательный) |
ticket_type_id[] | Указывает список поддерживаемых типов билетов для этого слота доступности. Если значение не установлено, для этого слота доступны все типы билетов родительской службы. Обратите внимание, что значения этого поля должны быть определены в родительском сервисе. Примеры:
Чтобы представить инвентарь в будние дни:
Чтобы указать, что все три типа билетов доступны для этого временного интервала, используйте либо (необязательный) |
duration_requirement | Требование показывать продолжительность и/или время окончания слотов. Это поле будет игнорироваться, если слот недоступен. Не используется в вертикали «Что нужно сделать». (необязательный) |
scheduling_rule_overrides | Правила планирования доступности. Если поля заполнены, они переопределяют любые соответствующие правила планирования в SchedulingRules уровня службы. |
confirmation_mode | Режим подтверждения, который будет использоваться при бронировании этой доступности. Попытки создать бронирования для наличия мест с режимом подтверждения CONFIRMATION_MODE_SYNCHRONOUS должны быть немедленно подтверждены или отклонены. Попытки создать бронирования для наличия мест с режимом подтверждения CONFIRMATION_MODE_ASYNCHRONOUS должны быть либо немедленно отклонены, либо созданы со статусом ОЖИДАНИЕ. |
Режим подтверждения
Режимы подтверждения, используемые при бронировании мест.
Перечисления | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED | Не указан режим подтверждения. Предполагается синхронное подтверждение. |
CONFIRMATION_MODE_SYNCHRONOUS | Бронирование на эту доступность будет подтверждено синхронно. |
CONFIRMATION_MODE_ASYNCHRONOUS | Бронирование на эту доступность будет подтверждено асинхронно. |
ПродолжительностьТребование
Это перечисление указывает, какие требования существуют для пользователя для подтверждения или просмотра продолжительности/времени окончания запрошенных интервалов.
Перечисления | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED | Обработка времени окончания не указана. Это значение по умолчанию. |
DO_NOT_SHOW_DURATION | Время окончания не отображается пользователю. |
MUST_SHOW_DURATION | Время окончания должно быть показано пользователю, прежде чем можно будет назначить встречу. |
Повторение
Сообщения о повторении не являются обязательными, но позволяют более компактно представить постоянно повторяющиеся интервалы доступности. Обычно они представляют собой рабочий график дня. Сообщения ScheduleException затем используются для представления зарезервированных/недоступных диапазонов времени в течение рабочего дня.
Требования:
- Расширение слотов доступности или повторений НЕ должно создавать идентичные слоты. Если идентификаторы, start_time, продолжительность и ресурсы совпадают, слоты считаются идентичными.
- НЕ смешивайте стандартный формат доступности и повторяемость в слотах одной услуги. Повторение приносит пользу продавцам/службам, которые предлагают встречи. Стандартный формат ориентирован на продавцов/услуги с регулярными занятиями.
- Рецидивы не должны длиться более 24 часов.
Поля | |
---|---|
repeat_until | Включающая максимальная временная метка UTC, до которой доступность будет повторяться. |
repeat_every | Определяет время между последовательными интервалами доступности. Пример: доступность с продолжительностью 20 минут, повтор_каждый из 30 минут, начальное_время 9:00 и повтор_до 11:00 даст слоты в 9–9:20, 9:30–9:50, 10. -10:20, 10:30-10:50, 11-11:20. (необходимый) |
РасписаниеИсключение
Сообщения ScheduleException представляют собой зарезервированные/недоступные диапазоны времени в течение рабочего дня, которые являются исключениями из описанного выше повторения. По мере резервирования временных интервалов список исключений следует обновлять, чтобы отразить новые недоступные временные диапазоны. Само повторение не должно изменяться.
Поля | |
---|---|
time_range | Временной диапазон исключения. Любые слоты, описанные повторением, которые перекрывают этот диапазон времени закрытия-открытия, будут считаться недоступными. Пример. Если для повторения указана продолжительность 20 минут, параметр повтор_каждый – 30 минут, время начала – 9:00 утра и значение повторения_до 11:00, то исключение ScheduleException с диапазоном времени (время_диапазона) 9:45–11:00 сделает недоступным слоты с 9:30 до 9:50, с 10 до 10:20 и с 10:30 до 10:50. Обратите внимание: поскольку временной диапазон закрыт-открыт, интервал, начинающийся в 11 утра, не будет затронут. |
ПланированиеRuleOverrides
Правила планирования уровня доступности.
Поля | |
---|---|
last_bookable_sec | Последний раз (в секундах), когда этот слот можно зарезервировать. Эта временная метка должна быть раньше start_sec интервала, который необходимо учитывать (если пользователи должны иметь возможность бронировать после времени начала, используйте уровень обслуживания SchedulingRules.min_booking_before_end_time). Если он присутствует, он переопределяет все, указанное в min_booking_buffer правил планирования соответствующей службы. |
first_bookable_sec | Первый раз (в секундах), когда этот слот можно зарезервировать. Эта временная метка должна быть до start_sec слота или Last_bookable_sec, если указано. |
last_online_cancellable_sec | Если установлено, это последний раз (в секундах с эпохи Unix), когда этот конкретный интервал встречи можно отменить с помощью функции «Зарезервировать в Google». Это поле будет иметь приоритет над любыми правилами отмены на уровне обслуживания. (необязательный) |
Пакетное удалениеGenericRecordsRequest
Пакетный запрос на удаление записей указанного типа фида.
Поля | |
---|---|
parent | Имя ресурса в формате — |
records[] | Записи, подлежащие удалению. В одном вызове API допускается максимум 1000 записей. |
Пакетный пушдженерикрекреквест
Пакетный запрос на вставку и/или обновление записей типа фида, указанного в URL-адресе запроса.
Поля | |
---|---|
parent | Имя ресурса в формате — |
records[] | Записи, которые необходимо вставить и/или обновить. В одном вызове API допускается максимум 1000 записей. |
Пакетная заменаServiceAvailabilityRequest
Пакетный запрос на замену нескольких слотов доступности Service
.
Поля | |
---|---|
parent | Формат |
extended_service_availability[] | Расширенная доступность службы, которая используется для замены существующих слотов доступности. |
BatchReplaceServiceAvailabilityResponse
Пакетный ответ на замену нескольких слотов доступности Service
. В это сообщение будут включены только успешно обновленные слоты.
Поля | |
---|---|
extended_service_availability[] | Успешно обновленные расширенные сообщения о доступности службы, которые использовались для замены существующих слотов доступности. |
Бронирование
Бронирование слота инвентаря
Поля | |
---|---|
name | Имя ресурса бронирования: |
merchant_id | ID торговца для слота |
service_id | Идентификатор мерчант-сервиса |
start_time | Время начала интервала встречи |
duration | Продолжительность интервала встречи |
client_information | Персональные данные клиента, записывающегося на прием |
status | Статус бронирования |
payment_information | Информация о платежных операциях, связанных с бронированием. |
party_size | Размер вечеринки при бронировании |
Ошибка бронирования
Данные о состоянии, показывающие, почему обработка бронирования не удалась асинхронно. 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 | При обработке платежа произошла ошибка, поскольку указанный тип кредитной карты не был принят продавцом. Тип кредитной карты должен быть указан в поле ignore_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. |
ТриDS1Параметры
Параметры, требующие от RwG выполнения запроса 3DS1.
Параметры устанавливаются описанием EMVCo протокола 3DS1.
Поля | |
---|---|
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 | Адрес электронной почты клиента |
Создать запрос продавца
Запрос на создание Merchant
.
Поля | |
---|---|
parent | Имя родительского ресурса для партнера, которому принадлежит этот продавец, в формате |
merchant_id | Идентификатор продавца, который будет использоваться для этого продавца. |
merchant | Торговец для создания. |
CreateServiceRequest
Запрос на создание нового Service
.
Поля | |
---|---|
parent | Имя родительского ресурса для продавца, которому принадлежит эта услуга, в формате |
service_id | Идентификатор службы, который будет использоваться для этой службы. |
service | Сервис для создания. |
Кредитная картаОграничения
Ограничения на типы кредитных карт, которые принимает этот продавец.
Поля | |
---|---|
credit_card_type[] | Список поддерживаемых кредитных карт. Кредитные карты не поддерживаются, если они пусты. |
Тип кредитной карты
Тип кредитной карты.
Перечисления | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED | Неиспользованный. |
VISA | Кредитная карта Visa. |
MASTERCARD | Кредитная карта Мастеркард. |
AMERICAN_EXPRESS | Кредитная карта American Express. |
DISCOVER | Кредитная карта Discover. |
JCB | Кредитная карта JCB. |
Удалить запрос продавца
Запрос на удаление Merchant
.
Поля | |
---|---|
name | Имя ресурса продавца, которого требуется удалить. В формате партнеры/{partner_id}/merchants/{merchant_id} |
Удалить запрос службы
Запрос на удаление Service
.
Поля | |
---|---|
name | Имя ресурса службы, которую необходимо удалить. В формате |
Депозит
Депозит, который с пользователя может быть снят или заморожен на его кредитной карте.
Поля | |
---|---|
deposit | Сумма депозита. |
min_advance_cancellation_sec | Минимальная предварительная отмена депозита. |
deposit_type | Определяет способ определения депозита на основе доступности. |
DirectMerchantОплата
Информация о том, как пользователь может оплатить услугу напрямую продавцу вместо предварительной оплаты услуги через RwG.
Поля | |
---|---|
payment_methods[] | Пользователям рекомендуется осуществлять оплату только способами оплаты, указанными ниже. |
Диапазон длительности
Обертка для диапазона продолжительности, который может быть ограничен или неограничен. Требуется хотя бы одна из продолжительностей min_duration и max_duration.
Поля | |
---|---|
min_duration | Минимальная продолжительность. |
max_duration | Максимальная продолжительность. |
Экстендедсервицедоступность
Список доступности и к кому/когда их следует применять.
Поля | |
---|---|
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 дополнительно ограничивает область обновления только этим набором ресурсов. Все поля идентификаторов ресурсов должны точно совпадать. |
availability[] | Новый список наличия. |
FeedStatistics
Статистика, полученная при обработке загруженного фида.
Поля | |
---|---|
new_items | Недавно добавленные элементы из этого фида. В зависимости от типа фида элементами могут быть торговцы, услуги или слоты доступности. |
existing_items | Существующие элементы, обновляемые по мере необходимости на основе новой информации из канала. |
deleted_items | Элементы больше не присутствуют в этом фиде и в результате были удалены. |
Статус фида
Статус фида, загруженного платформой агрегатора.
Поля | |
---|---|
name | Имя ресурса канала, имеющее формат
|
state | Статус обработки этого фида. |
error_details | Читаемая человеком строка, предоставляющая более подробную информацию, если нам не удалось обработать этот канал. |
statistics | Статистика, специфичная для этого фида. |
Состояние
Перечисление для обозначения состояния обработки канала.
Перечисления | |
---|---|
STATE_UNSPECIFIED | Значение по умолчанию. Неиспользованный. |
IN_PROGRESS | Фид все еще обрабатывается. |
SUCCESS | Фид успешно обработан. |
FAILURE | При обработке фида произошла ошибка. |
ЕдаЗаказМетаданные
Метаданные для ссылок на действия по заказу еды.
Поля | |
---|---|
fee_details[] | Подробная информация о комиссиях, взимаемых с пользователя сверх общей суммы товара. Повторяется для различных типов сборов, таких как плата за обслуживание, плата за доставку и т. д. |
advance_order_details | Подробная информация о расширенной поддержке заказа, также известной как предварительный заказ, когда пользователь может разместить заказ для выполнения в более позднее время, чем прямо сейчас. |
Поле объединения 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 | Неизвестная сумма. |
Тип комиссии
Тип комиссии.
Перечисления | |
---|---|
FEE_TYPE_UNSPECIFIED | Тип комиссии не указан. |
DELIVERY | За оплату доставки. |
SERVICE | За плату за обслуживание. |
Вариант исполнения
Вариант выполнения для ссылки действия онлайн-заказа.
Поля | |
---|---|
fulfillment_type | Необходимый. Тип выполнения. |
available_day[] | Необходимый. Список дней, в которые доступен данный способ выполнения (желательно не менее 2). |
fee_details | Необходимый. Детали комиссии для метода выполнения. |
minimum_order | Необходимый. Минимальный заказ для метода выполнения, связанного со ссылкой действия. |
Доступный день
Доступность дневного уровня.
Поля | |
---|---|
fulfillment_date | Необходимый. Доступная дата для метода выполнения. Предполагается, что он находится в часовом поясе продавца. |
last_ordering_time | Необходимый. Временная метка Unix. Последний раз, когда пользователь мог заказать и получить товары до Например, если дата выполнения — 10 августа 2020 г.: значение Last_ordering_time 10 августа 2020 г., 18:00 означает, что для получения заказа 10 августа 2020 г. клиент должен сделать заказ до 18:00. в тот же день. - значение Last_ordering_time 20:00 08.08.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 | Для фидов на основе прототипов. |
Общая запись
Запись типа фида, указанного в запросе URL.
Поля | |
---|---|
generation_timestamp | Необходимый. Эта отметка времени используется для обеспечения правильного порядка обновлений инвентаря. |
Поле объединения record_type . Для инкапсуляции различных типов каналов (ndjson, прототипов и т. д.) record_type может иметь только одно из следующих значений: | |
data_record | Для фидов, не основанных на прототипах. |
proto_record | Для фидов на основе прототипов. |
Геокоординаты
Географические данные о местоположении, включая широту, долготу и адрес.
Поля | |
---|---|
latitude | Широта в градусах. (необязательный) |
longitude | Долгота в градусах. (необязательный) |
addresses полей объединения. Адрес местоположения может быть структурированным или неструктурированным. addresses могут быть только одним из следующих: | |
address | Почтовый адрес места нахождения (желательно). |
unstructured_address | Неструктурированный адрес также может быть предоставлен в качестве запасного варианта. Например, «Амфитеатр-бульвар, 1600, вид на горы, Калифорния 94043». |
GetMerchantStatusRequest
Запрос на получение MerchantStatus
Поля | |
---|---|
name | Необходимый. Название ресурса в формате Partners/{partner_id}/merchants/{merchant_id}/status. |
GetStatusRequest
Запрос на получение Status
для конкретного фида, загруженного платформой агрегатора.
Поля | |
---|---|
name | Имя ресурса канала, имеющее формат
|
ГлавнаяСервисДанные
Дополнительная информация, необходимая для вертикали обслуживания на дому.
Поля | |
---|---|
category_type | Категория высокого уровня, к которой относится данная услуга на дому. Например, сантехник, электрик и т. д. |
job_type | Тип задания в категории, к которой принадлежит данная домашняя услуга. Например, unclog_drain, install_faucet — это типы заданий в категории «Сантехник». |
Тип интеграции
Поддерживается глубина интеграции.
Перечисления | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED | По умолчанию END_TO_END. |
INTEGRATION_TYPE_END_TO_END | Полная интеграция, позволяющая осуществлять сквозное бронирование через Google. |
INTEGRATION_TYPE_INVENTORY_ONLY | Сервер бронирования не обязан поддерживать эту услугу. Необходимо отправлять только данные о продавцах, услугах и (необязательно) доступности. |
Инвалидатересурцерекуест
Запрос на аннулирование ресурса.
Поля | |
---|---|
resource_id | Имя ресурса, который будет признан недействительным. Например, для ресурса Pickup имя должно иметь формат |
Линейный элемент
Отдельный элемент в заказе — бронирование одной услуги в одном временном интервале.
Поля | |
---|---|
service_id | Идентификатор торгового сервиса. |
start_sec | Время начала интервала встречи в секундах времени UTC, начиная с эпохи Unix. |
duration_sec | Продолжительность интервала встречи в секундах. |
tickets[] | Количество билетов, заказанных по типу билета. |
price | Общая стоимость (без налогов) этой позиции. |
status | Статус позиции. |
Заказаны билеты
Количество заказанных билетов по Типам билетов.
Поля | |
---|---|
ticket_id | Идентификатор типа билета. |
count | Количество заказанных билетов данного типа. |
ListMerchantStatusesЗапрос
Запрос на получение списка 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 дней. |
Статус геосоответствия
Статус географического соответствия продавца.
Перечисления | |
---|---|
GEO_MATCHING_STATUS_UNSPECIFIED | Не указан. |
GEO_UNMATCHED | Продавец не соответствует географическому положению. |
GEO_MATCHED | Продавец соответствует географическому положению. |
Статус списка ожидания
Статус инвентаря в сквозном списке ожидания.
Перечисления | |
---|---|
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, возвращенное из предыдущего запроса списка, если таковой имеется. |
state_restrict | Необязательное ограничение для фильтрации результатов по состоянию ленты. |
time_range_restrict | Необязательное ограничение для фильтрации результатов по верхней и нижней границе. Если параметр start_time не установлен, по умолчанию будет установлено время начала unix. Если значение end_time не установлено, по умолчанию будет установлено значение «сейчас». |
Списокстатусответ
Запрос на получение Status
для нескольких каналов, загруженных платформой агрегатора.
Поля | |
---|---|
status[] | Обратный хронологический список статусов загруженных каналов. Максимальное количество возвращаемых элементов зависит от поля page_size в запросе. |
next_page_token | Токен для получения следующей страницы результатов. Если список пуст, в списке больше нет результатов. |
Локализованная строка
Экземпляр строки в одной локали.
Поля | |
---|---|
locale | Код языка IETF BCP 47, например «en», «mas», «zh-Hant», «de-CH-1901». См. http://www.w3.org/International/articles/language-tags/ . |
value | Сообщение в указанной выше локали (UTF-8). |
Расположение
Географическая информация о местоположении.
Поля | |
---|---|
place_id | Идентификатор места в базе данных Google Адресов и на Картах Google. Дополнительную информацию об идентификаторах мест см. на странице https://developers.google.com/places/web-service/place-id . Если это указано, Google сопоставит местоположение с этим местом. |
name | Название местоположения, телефон, URL-адрес и геолокация используются для сопоставления местоположения с местами, уже представленными на Картах Google. Это поле является необязательным, но может потребоваться в некоторых контекстах. Например, Service.location без имени не будет сопоставлен с юридическим лицом, даже если они расположены по одному и тому же адресу. (необязательный) |
telephone | Общественный телефонный номер места, включая коды страны и города, например +14567891234. (необязательный) |
url | URL общедоступного веб-сайта местоположения. (необязательный) |
geo | Географическая информация о местоположении, включая широту, долготу и адрес. (необязательный) |
location_type | Тип местоположения необходимо указать, если это местоположение предоставляется для Услуги. |
location_id | Уникальная ссылка на местоположение в рамках сервиса. Этот идентификатор можно использовать для ссылки на это местоположение в других полях службы. Например, в пользовательской форме приема можно использовать набор идентификаторов местоположений для указания вариантов места получения. Если этот идентификатор установлен, он должен быть уникальным в пределах одной службы. (необязательный) |
Тип местоположения
Тип этого местоположения.
Перечисления | |
---|---|
LOCATION_TYPE_UNSPECIFIED | Тип местоположения не указан. |
VISITED_LOCATION | Местоположение, куда посещает эта служба. |
START_LOCATION | Местом запуска этой службы также является MEETING_LOCATION. |
END_LOCATION | Место, где заканчивается эта услуга. |
Торговец
Информация о мерчанте, который есть на платформе агрегатора.
Поля | |
---|---|
name | Имя ресурса продавца в формате |
merchant_name | Имя продавца, телефон, URL-адрес и местоположение используются для сопоставления партнерского инвентаря с продавцами, уже представленными на Картах Google. Эта информация не будет отображаться. Имя торговца. |
telephone | Общественный номер телефона продавца, включая коды страны и города, например +14567891234. |
url | URL общедоступного веб-сайта продавца. |
geo | Географическая информация о продавце, включая широту, долготу и адрес. |
category | Категория бизнеса на платформе агрегатора. |
num_bookings_30d | Это поле устарело. |
tax_rate_basis_points | Ставка налога для торговца в базисных пунктах (одна сотая процента). Например, если ставка налога составляет 7,5%, в этом поле должно быть установлено значение 750. Если это поле не задано или установлено равным 0, общая цена, взимаемая с пользователя за любую услугу, предоставляемую этим продавцом, равна точной цене, указанной в Service.price. Предполагается, что цена услуги освобождена от применимых налогов или уже включена в них. Налоги не будут показаны пользователю отдельной строкой. Если в этом поле установлено любое ненулевое значение, общая цена, взимаемая с пользователя за любую услугу, предоставляемую этим продавцом, будет включать цену услуги плюс налог, начисленный с использованием указанной здесь налоговой ставки. Дроби наименьшей денежной единицы (например, доли одного цента) будут округлены с использованием ближайшего четного округления. Налоги будут показаны пользователю отдельной строкой. Это поле устарело, используйте вместо него Tax_rate. |
tax_rate | Налоговая ставка торговца. Если оно присутствует, оно переопределяет устаревшее поле Tax_rate_basis_points. Пустое сообщение (т. е. Tax_rate { }) сбросит применяемую ставку налога на ноль. |
payment_restrictions | Ограничения на способы оплаты, которые принимает этот продавец. Мы предполагаем, что никаких ограничений не существует, если это поле не установлено. |
payment_option[] | Варианты оплаты, доступные для этого продавца. Сервисы этого продавца смогут индивидуально ограничивать доступные им варианты оплаты. |
payment_processor_config | Конфигурация для процессора токенизированных платежей, если продавец поддерживает его. |
tokenization_config | Конфигурация для процессора токенизированных платежей, если продавец поддерживает его. |
terms | Условия использования конкретного продавца, отображаемые пользователю при бронировании услуги через «Зарезервировать через Google». Помимо этого, пользователю всегда видны Условия и положения партнера-агрегатора, которые не должны быть представлены здесь. |
brand_id | Непрозрачная строка, идентифицирующая бренд, ориентированный на потребителя, который будет использоваться при отображении атрибуции партнера. Это поле позволяет партнерам с несколькими брендами, ориентированными на потребителя, предоставлять информацию о продавцах всех брендов в одном фиде. Бренд состоит из свойств, ориентированных на потребителя, таких как имя, логотип, Условия обслуживания и Политика конфиденциальности. Если существует только один партнерский бренд, ориентированный на потребителя, это поле не нужно задавать, и его можно игнорировать. Если партнер... У вас нет нескольких брендов, ориентированных на потребителя? --> Игнорировать это поле Имеет ли настроено несколько брендов?
Тщательно примечание: большинству партнеров не нужно устанавливать это поле. Если партнер хочет использовать это поле, он должен сначала связаться с нами, чтобы настроить отдельные бренды, включая бренд по умолчанию. |
matching_hints | Намекает, чтобы помочь Google соответствовать продавцу с местом на картах Google. Примечание. Большинству партнеров не нужно устанавливать это поле, так как Google будет совпадать с торговцами с местами на картах Google, используя информацию, представленную выше. (необязательный) |
service_attribute[] | Определения для любых атрибутов сервиса, используемых для описания услуг для этого продавца. (необязательный) |
action_link[] | Необязательный. URL -адрес действия с ассоциированным языком, список стран, ограниченных типом и необязательной платформой, которая указывает, на какую платформу следует выполнять это действие, |
waitlist_advisement | Необязательный. Общие рекомендации от конкретного продавца для пользователя, присоединившегося к списку ожидания через резерв с Google. Индивидуальные текстовые поля в консультировании должны быть ограничены длиной 100 байтов. |
MerchantMatchingHints
Подсказки, используемые для того, чтобы помочь Google соответствовать продавцу с местом на картах Google.
Поля | |
---|---|
place_id | Идентификатор места для места в базе данных Google Place и на картах Google. См . |
Merchantstatus
Статус продавца в резерве с платформой Google.
Поля | |
---|---|
name | Имя ресурса торговца, которое имеет формат |
merchant_name | Название продавца, предоставленного партнерами. |
input_geo_info | Партнеры предоставили GEO Информацию о продавцах. |
processing_status | Торговая обработка статус. |
booking_status | Статус, связанный с комплексной интеграцией бронирования. |
waitlist_status | Статус, связанный с интеграцией ожидания. |
geo_match | Соответствует гео -месту этого продавца. Пусто, если торговец не сопоставлен. |
local_services_match | Местная услуга совпадает с этим продавцом. Пусто, если он не является местным продавцом услуг или не соответствует каким -либо поставщикам. |
direct_urls[] | Список URL -адресов, чтобы продемонстрировать содержание текущего торгового запаса. Обратите внимание, что это не означает, что инвентарь на самом деле обслуживается, а URL может отличаться от общественных видимых. |
Статус бронирования
Статус, связанный с комплексной интеграцией бронирования.
Поля | |
---|---|
has_valid_future_inventory | Правда, если у продавца есть инвентарь в течение следующих 30 дней. Не гарантирует, что торговец фактически обслуживается. |
Directurl
URL, который выдерживает продавца.
Поля | |
---|---|
type | Тип этого URL. |
url | URL, который может вспять этого продавца. |
Urltype
Тип URL -адреса.
Перечисления | |
---|---|
URL_TYPE_UNSPECIFIED | Не указан. |
BOOKING | Сквозное URL. |
WAITLIST | Стоинный URL-адрес ожидания. |
LOCAL_SERVICES | Google Local Services URL. |
LocalServicesMatchInfo
Информация о Mocal Services Services Match (установлена только для местного торговца услуг).
Поля | |
---|---|
matched_providers[] | Сопоставленные поставщики услуг. Торговец может быть сопоставлен с несколькими поставщиками услуг. |
MatchedProvider
Местный поставщик услуг.
Поля | |
---|---|
customer_id | Google Local Services Внешний идентификатор клиента. |
categories[] | Локальные категории обслуживания (вертикали). Например, «Сантехник» и «Carpet_cleaning». |
Placeinfo
Информация о соответствующем месте.
Поля | |
---|---|
name | Название места. |
formatted_address | Отформатированный адрес на местном языке. |
place_id | Google Place ID этого места. Может использоваться для построения URL -адреса Google MAPS или получить более подробную информацию о месте. См. Https://developers.google.com/places/web-service/place-id , например, использование. |
Обработка Status
Торговая обработка статус.
Перечисления | |
---|---|
PROCESSING_STATUS_UNSPECIFIED | Статус не указан. |
IN_PROGRESS | Торговец был получен Мэдденом, но все еще обрабатывается. Торговцы в этом статусе не будут иметь другой статус заселен. |
COMPLETED | Другие статусы продавца были рассчитаны. |
WatlistStatus
Статус, связанный с интеграцией ожидания.
Поля | |
---|---|
has_valid_waitlist_service | Правда, если у продавца есть услуга списка ожидания. Не гарантирует, что торговец фактически обслуживается. |
ДеньгиДиапазон
Оболочка для диапазона денежных сумм, который может быть ограниченным или неограниченным. По крайней мере, один из min_amount и max_amount требуется.
Поля | |
---|---|
min_amount | Минимальная сумма. |
max_amount | Максимальная сумма. |
Noshowfee
Плата, которую пользователь может взиматься, если он сделал бронирование, но не появляется.
Поля | |
---|---|
fee | Сумма, которую пользователь может взиматься, если они не отображаются для бронирования. |
fee_type | Определяет, как плата определяется по доступности. |
Заказ
Заказ на сервисное обслуживание у продавца.
Поля | |
---|---|
name | Имя ресурса заказа: |
client_information | Личная информация клиента, делающего заказ. |
payment_information | Информация о платежных операциях, которые относятся к заказу. |
merchant_id | Идентификатор продавца, которому принадлежат все услуги в этом заказе. |
item[] | Позиции в этом порядке. |
ЗаказонлайнМетаданные
Метаданные для ссылки на действие онлайн-заказа.
Поля | |
---|---|
fulfillment_option[] | Доступные варианты выполнения для ссылки действия онлайн-заказа. |
Информация об оплате
Платежные реквизиты, относящиеся к бронированию
Поля | |
---|---|
prepayment_status | Статус предоплаты бронирования. Если предоплата - предоплата по предоплате или предоплату или предоплату_Рефандированного, то платеж_ transaction_id содержит связанный уникальный идентификатор транзакции. |
payment_transaction_id | Уникальный идентификатор платежной транзакции, связанной с бронированием. Пусто, если неприменимо. |
Платежон
Вариант оплаты, который может быть использован для оплаты услуг, предоставляемых продавцом. Варианты оплаты могут быть переданы среди нескольких торговцев (например, торговцы, принадлежащие к одной и той же цепочке).
Поля | |
---|---|
payment_option_id | Этот идентификатор используется для определения этой опции оплаты. Этот идентификатор является глобальным для всего агрегатора, и повторное использование значения между несколькими торговцами позволит пользователю платить с соответствующим вариантом оплаты в этих продавцах. При повторном использовании идентификатора Accoss несколько продавцов обновление любого значения для опции оплаты под одним продавцом также обновит любой другой вариант оплаты с одним и тем же идентификатором под другим продавцом. Таким образом, наилучшая практика - иметь все варианты оплаты, разделяющие один и тот же идентификатор, всегда обновляются до идентичных значений, чтобы избежать любой возможности подминистского поведения. |
name | Название опции оплаты. Это может быть видимым пользователем. |
description | Описание опции оплаты. Это может быть видимым пользователем. |
price | Цена опции оплаты. |
tax_rate | Налоговая ставка для этого варианта оплаты. Если присутствовать, это поле переопределяет поле Tax_Rate, присутствующее в продавце или услуге. Пустое сообщение (то есть Tax_rate {}) сбросит прикладную налоговую ставку до нуля. |
payment_option_type | Тип этого варианта оплаты. Одноразовое использование для бросков, многофункциональное использование пакетов и неограниченное для членства. |
session_count | Сколько сессий можно использовать этот вариант оплаты. Действительно только для мультисессионных / пакетов, где значение должно быть> 1. |
purchase_interval | Вариант оплаты может быть приобретен в этом интервале. |
valid_interval | Вариант оплаты может использоваться в этом интервале (например, специальная цена за январь 2017 года). Если присутствует, это переопределяет valive_duration и activation_type. |
valid_duration | Продолжительность варианта оплаты (например, 30 -дневное членство). |
activation_type | Определяет, как определяется дата начала достоверности для этого варианта оплаты. |
user_restriction | Ограничивает пользователи, имеющие право на покупку этого варианта оплаты. Может использоваться для ограничения опции рекламного платежа подмножеством пользователей. Если не установлено, все пользователи имеют право. |
ActivationType
Определяет, как определяется дата начала достоверности.
Перечисления | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED | Неиспользованный. |
ACTIVATION_ON_PURCHASE | Достоверность начинается во время покупки. |
ACTIVATION_ON_FIRST_USE | Достоверность начинается, когда вариант оплаты используется в первый раз. |
Платежон
Тип опции оплаты.
Перечисления | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED | Неиспользованный. |
PAYMENT_OPTION_SINGLE_USE | Вариант оплаты может использоваться только один раз. |
PAYMENT_OPTION_MULTI_USE | Вариант оплаты может быть использован, если его сессия> 0. |
PAYMENT_OPTION_UNLIMITED | Вариант оплаты может использоваться в рамках его достоверного диапазона времени - количество сеансов неприменимо. |
Платеж ProcessorConfig
Конфигурация для платежного процессора, настройка для за торговлю.
Поля | |
---|---|
processor | Определяет партнера по обработке платежей, к которой применяется эта конфигурация. |
public_key | Ключ, используемый для идентификации этого продавца с процессором платежей. |
version | Номер версии API, отправленный платежным процессору вместе с запросами на оплату. |
Процессор
Определяет конкретного партнера по обработке платежей.
Перечисления | |
---|---|
PROCESSOR_UNSPECIFIED | Неиспользованный |
PROCESSOR_STRIPE | Конфигурация для платежей с полосой. |
PROCESSOR_BRAINTREE | Конфигурация для платежей с Braintree. |
Платежеса
Ограничения на методы оплаты, которые принимает этот торговец.
Поля | |
---|---|
credit_card_restrictions | Ограничения на кредитные карты, которые принимает этот торговец. Мы предполагаем, что все кредитные карты принимаются, если это поле не установлено. Обратите внимание, что список карт, поддерживаемых CreditCardType, будет расти со временем, что означает, что оставить эти пустые субъекты конфигурацией для будущих изменений. |
Perorderfee
Сборы, которые должны быть уплачены один раз за заказ, независимо от количества билетов.
Поля | |
---|---|
delivery_fee | Плата, которая может варьироваться в зависимости от метода доставки. |
processing_fee | Плата за обработку метода оплаты пользователя. |
Perticketfee
Сборы, которые должны быть оплачены за каждый билет, который покупает пользователь.
Поля | |
---|---|
service_charge | Дополнительная плата оценивается за услугу. |
facility_fee | Плата, которая уходит на место проведения/объекта. |
taxes | За налоги на билеты. |
Pestaladdress
Адрес клиента или компании.
Поля | |
---|---|
address_country | Страна, указанная с использованием кода страны ISO 3166-1 альфа-2, например «США» (обязательно). |
address_locality | Населенный пункт, например «Маунтин-Вью». (необходимый) |
address_region | Регион, например «CA». Это поле требуется только в странах, где регион обычно является частью адреса. (необязательный) |
postal_code | Почтовый индекс, например «94043». (необходимый) |
street_address | Уличный адрес, например «Амфитеатр Пкви, 1600». (необходимый) |
Статус предоплаты
Статус предоплаты бронирования.
Перечисления | |
---|---|
PREPAYMENT_STATUS_UNSPECIFIED | Не указано, по умолчанию PREPAYMENT_NOT_PROVIDED. |
PREPAYMENT_PROVIDED | Плата за бронирование была оплачена заранее. |
PREPAYMENT_NOT_PROVIDED | Плата за бронирование не была оплачена заранее. |
PREPAYMENT_REFUNDED | Ранее плата была равна PREPAYMENT_PROVIDED, но теперь она возвращена. |
Цена
Цена услуги или плата.
Поля | |
---|---|
price_micros | Цена в микро-единицах валюты. Фракции самого маленького валютного блока будут округлены с использованием ближайшего даже округления. (Например, за 2,5 цента в 2,5 цента, округлые до 2 центов, 3,5 цента округливы до 4 центов, 0,5 цента округливы до 0 центов, 2,51 цента округливы до 3 центов). |
currency_code | Валюта цены, которая определена в ISO 4217. |
pricing_option_tag | Необязательная и непрозрачная строка, которая идентифицирует вариант ценообразования, который связан с расширенной ценой. |
Цена интерпретации
Описывает, как цена должна быть интерпретирована и отображается пользователю.
Перечисления | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED | Интерпретация цен не указана, по умолчанию exact_amount. |
EXACT_AMOUNT | Когда цена должна интерпретироваться как конкретное значение. Примеры: $ 20 для занятий йогой; 15 долларов за стрижку ребенка |
STARTS_AT | Когда цена обслуживания переменная, но минимальная цена известна и отображается потребителям. Потребители могут сделать выбор, которые повышают цену. Обратите внимание, что любая услуга, которая использует эту цену интерпретации, должна использовать предоплату not_supported. Примеры: 30 долларов за уход за собаками, но дополнительный выбор потребителей может повысить цену |
NOT_DISPLAYED | Когда цена услуги является переменной, а информация о цене не отображается потребителям заранее. Обратите внимание, что любая услуга, которая использует эту цену интерпретации, должна использовать предоплату not_supported, и цена должна быть пустой. Примеры: консультация по домашнему обслуживанию |
Причетип
Определяет, как общая цена определяется по доступности.
Перечисления | |
---|---|
FIXED_RATE_DEFAULT | Цена на фиксированную сумму. Это значение по умолчанию, если поле не установлено. Примеры: зарезервированный зарезервированный таблицу за 50 долларов; $ 20 НЕТ ПРОТИВОСТА |
PER_PERSON | Указанная цена на человека, а общая цена рассчитывается в соответствии с размером стороны, указанным в ресурсах, как цена_micros * party_size. Цена Per_person должна сопровождаться размером партии в ресурсах доступности. Если это не так, используется размер партии. Примеры: по 10 долларов за билеты в музей |
Количественное значение
Оболочка для числового значения, которое может быть диапазоном или фиксированным значением. QuantitativeValue
Примеры: * единственное значение: value: 10.5
* ограниченный диапазон: value_range {min_value: 5.5, max_value 10.5}
* Нижняя граница: value_range {min_value: 5.5}
* Верхняя граница: value_range {max_value: 10.5}
Поля | |
---|---|
Поле объединения value_options . (обязательно) value_options может быть только одним из следующих: | |
value | Уникальная ценность. Например: 5,6 |
value_range | Диапазон значений, который также может быть открытым или ограниченным. Примеры: * Минимум 5,5 * Максимум 5,5 * От 5,5 до 6,5. |
ДиапазонЗначение
Диапазон значений, таких как min_value
< max_value
. Требуется хотя бы один из min_value
и max_value
.
Поля | |
---|---|
min_value | Минимальное значение. |
max_value | Максимальное значение. |
Рейтинг
Определяет рейтинг для сущности.
Поля | |
---|---|
value | Среднее значение оценки (необходимо, когда number_of_ratings> 0). Значение должно быть в диапазоне [1, 5] и может быть опущено тогда и только тогда, когда number_of_ratings равен нулю. |
number_of_ratings | Количество рейтингов, используемых при расчете значения (требуемого). |
Связанная медиа
Фотографии, связанные с этой услугой. Google будет ползти по этим носителям, чтобы убедиться, что они отображаются правильно для конечных пользователей. (необязательный)
Поля | |
---|---|
url | URL этого источника СМИ. Google будет ползти СМИ, размещенные на этом URL. |
type | Тип этого источника медиа. |
localized_caption | Подпись средств массовой информации, поддерживающей I18N, поддерживается только простой текст. Любые HTML -компоненты будут разделены. (необязательный) |
attribution | Информация о атрибуции об источнике СМИ. Обратите внимание, что если атрибуция требуется для отображения со СМИ, чтобы отдать должное фотографу или агентству, это поле должно быть установлено. (необязательный) |
caption | Установите, предпочитает использовать локализованный |
Атрибуция
Информация о атрибуции для этого СМИ.
Поля | |
---|---|
localized_text | Текст, чтобы отдать должное фотографу или агентству, поддерживающему i18n. Этот текст будет отображаться вместе с исходным носителем. Обратите внимание, что для этого поля поддерживается только простой текст, любые компоненты HTML будут разделены (атрибуция на основе гиперссылки не поддерживается). |
text | Установилось, предпочитает использовать локализованный_текс. |
MediaType
Enum, чтобы указать тип этого источника носителя. Поддерживаются только фотографии. Пожалуйста, обратитесь в резерв с командой Google, если необходимо поддерживать другие медиа -фотографии.
Перечисления | |
---|---|
TYPE_UNSPECIFIED | Неиспользованный. |
PHOTO | Указывает, что СМИ, предоставленные URL -адресом, представляет собой фотографию. |
Заменяет ServiceaVailabilityRequest
Запрос на замену доступности Service
.
Поля | |
---|---|
service_availability | Доступность сервиса, которая используется для замены существующих. |
Reptecreditcard
Определяет, требуется ли кредитная карта, чтобы записаться на прием.
Перечисления | |
---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED | Требование кредитной карты не указано явно, и поведение идентична той, которая указана для условного. |
REQUIRE_CREDIT_CARD_CONDITIONAL | Google потребует кредитной карты для бронирования, если будет выполнено какое -либо из следующих условий: * Доступность имеет цену, и требуется предоплата_type * no_show_fee установлен * Полевое поле депозита. |
REQUIRE_CREDIT_CARD_ALWAYS | Для забронирования этой доступности всегда требуется кредитная карта независимо от других полевых значений. |
Ресурсы
Ресурс используется для устранения устранения слотов доступности друг от друга, когда разные сотрудники или комнаты являются частью обслуживания. Несколько слотов для одного и того же сервиса и временного интервала могут сосуществовать, когда у них разные ресурсы.
Поля | |
---|---|
staff_id | Необязательный идентификатор для сотрудника, предоставляющего услугу. Это поле идентифицирует сотрудника по всем продавцам, услугам и записям доступности. Это также должно быть стабильным с течением времени, чтобы обеспечить корреляцию с прошлыми бронированием. Это поле должно присутствовать, если присутствует персонал. |
staff_name | Необязательное название сотрудника, предоставляющего услугу. Это поле будет отображаться пользователям, делающим бронирование, и должно быть читаемой человек, в отличие от непрозрачного идентификатора. Это поле должно присутствовать, если SHAFS_ID присутствует. |
room_id | Дополнительный идентификатор для комнаты, в которой находится сервис. Это поле идентифицирует комнату для всех торговцев, услуг и записей о доступности. Это также должно быть стабильным с течением времени, чтобы обеспечить корреляцию с прошлыми бронированием. Это поле должно присутствовать, если присутствует rap_name. |
room_name | Необязательное название для комнаты, в которой находится сервис. Это поле будет отображаться пользователям, делающим бронирование, и должно быть чтением человека, в отличие от непрозрачного идентификатора. (Необязательно, но требуется, если присутствует rap_id) При столовой название комнаты следует использовать только для мест для сидения, таких как бар или патио, и не следует использовать для меню с фиксированной ценой, особыми мероприятиями или любой другой ценностью, не являющейся комнатой (например, как бронирование или ужин). Настоятельно рекомендуется, чтобы в зоне отдыха по умолчанию не было места, связанной с этим. |
party_size | Применимо только для столовой: размер вечеринки, который может быть размещен в течение этого времени. Ресторан может быть связан с несколькими слотами за одно и то же время, каждый из которых указывает на другую party_size, если, например, 2, 3 или 4 человека, могут сидеть с бронированием. |
ПЕРЕПОЛНИЕ
Правила планирования для услуги.
Поля | |
---|---|
min_advance_online_canceling | Минимальное предварительное уведомление в секундах, необходимое для отмены забронированного назначения в Интернете. (необязательный) |
late_cancellation_fee | Плата за отмену в течение минимального периода предварительного уведомления. |
noshow_fee | Плата за No-Show без отмены. |
admission_policy | Политика приема, которая применяется к этой услуге. Если вы не поверите по умолчанию time_strict. (необязательный) |
cancellation_policy | Политика отмены правил планирования. (Требуется для вещей-дела) |
Поле Союза Если установлено «min_advance_booking», последнее время книги рассчитывается как (<времена запуска слота> - "min_advance_booking"). Если установлено «min_booking_buffer_before_end_time», последнее время книги рассчитывается как (<<время окончания слота> - "min_booking_buffer_before_end_time"). Обратите внимание, что значение «min_booking_buffer_before_end_time» должно быть положительным, если установлено. Если оба не являются, слот можно бронировать, пока слот не начнет время. Если оба поля установлены, будет выбрано только одно значение, в то время как другое значение игнорируется-мы не можем надежно предсказать, какое значение выбрано. Примеры:
| |
min_advance_booking | Продолжительность (в секунды) с момента последнего бронирования может быть сделано, когда начинается слот доступности. |
min_booking_buffer_before_end_time | Продолжительность (в секунды) с момента того, как может быть сделано последнее бронирование, когда заканчивается слот доступности. Если это поле установлено, поле «Admission_policy» должно быть установлено на Time_flegible, чтобы указать, что пользователи могут использовать приобретенные билеты после начала слотов. |
Приемполитика
Политика приема этой услуги.
Перечисления | |
---|---|
ADMISSION_POLICY_UNSPECIFIED | Неиспользованный. |
TIME_STRICT | Клиенты должны присутствовать во время начала слота доступности, и ожидается, что услуга завершится в конце времени слота. Примеры вариантов использования Time_stric: * Тур, который начинается в 9 утра, который требует от всех участников прибыть во время начала, и возвращается около 12 часов. * Бронирование стрижки в 3 часа дня в субботу, которая займет около 30 минут. * Фитнес -класс с 18:00 до 8 вечера. |
TIME_FLEXIBLE | Клиенты могут прибыть в любое время между началом и окончанием слота доступности, чтобы использовать это бронирование. Примеры сценария time_flexible использования: * Музейный билет, который можно использовать в любое время на дату покупки. * Полученный вступление в парк развлечений, который можно использовать с 12:00 до 21:00. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION | Клиенты должны прийти к продавцу во время начала слота доступности, но могут уйти в любое время. Например, в сценарии входа в музей важный билет на 10 часов утра требует, чтобы пользователь был в музее в 10 часов утра. Время начала слотов доступности для этой услуги представляет собой указанное время входа. Время окончания, однако, используется исключительно в качестве ключа для определения слота доступности для бронирования. |
Услуга
Информация о услуге, предоставляемой продавцом, например, стрижка.
Поля | |
---|---|
name | Имя ресурса службы, которое имеет формат |
service_name | Название службы, например, «Мужская стрижка». Установите, используйте вместо этого Localize_service_name. |
localized_service_name | Название службы, например, «Мужская стрижка». Возможно в нескольких местах. |
description | Пользовательский видимый описание Сервиса. Установите вместо этого, используйте локализованную_description. |
localized_description | Пользовательский видимый описание Сервиса. Это поле поддерживает как простое текстовое, так и HTML-подобное форматирование. В отличие от раздела простого текста, индивидуальные макеты могут быть созданы здесь, используя заголовки, параграфы, списки и некоторые фразы. Пожалуйста, прочитайте следующие инструкции и примечания внимательно, чтобы убедиться, что вы создаете лучший пользовательский опыт. Поддерживаемые HTML-подобные форматирующие теги: Заголовок тегов: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Тег абзаца: <p> Теги списка: <ul>, <ol>, <li> Тег дивизии: <Div> Фразы тегов: <br>, <strong>, <em>: Неподдерживаемые теги:
Важные примечания:
|
price | Цена услуги. |
price_interpretation | Описывает, как цена интерпретируется и отображается пользователю. Может использоваться любой вертикальной, кроме обедов и развлечений, чтобы настроить отображение цены обслуживания. |
rules | Правила, чтобы забронировать/отменить встречу. |
prepayment_type | Требуется ли предоплата, необязательно или не поддерживается. |
prepayment_terms | Условия, когда предоплата завершена. |
form[] | Устарело. Пожалуйста, используйте utake_form и per_ticket_intake_form. |
intake_form | Форма, запрашивающая дополнительную информацию от пользователя при бронировании этой услуги. (необязательный) |
per_ticket_intake_form | Форма, запрашивающая дополнительную информацию от пользователя при бронировании этой услуги. Эта форма должна быть заполнена один раз для каждого билета, который пользователь бронирует. (необязательный) |
tax_rate | Ставка налога на услугу. Если присутствовать, это поле переопределяет любой налог, установленную на уровне торговца. Пустое сообщение (то есть Tax_rate {}) сбросит прикладную налоговую ставку до нуля. |
payment_option_id[] | Список идентификаторов, ссылающихся на варианты оплаты, которые можно использовать для оплаты этой услуги. Фактические варианты оплаты определяются на уровне торговцев, а также могут быть разделены между несколькими торговцами. |
deposit | Определяет, как депозит может быть взимается с пользователя. Переопределяет сервисный депозит, если был указан. Установка этого на пустое депозитное сообщение удаляет любой депозит на уровне обслуживания. (необязательный) |
no_show_fee | Определяет плату без показа, которая может быть взимана с пользователя. Переопределяет услугу без платы за выставление, если кто -то был указан. Установка этого на пустое сообщение Noshowfee Удаляет любую уровни обслуживания без платы за шоу. (необязательный) |
require_credit_card | Указывает, должен ли пользователь предоставить кредитную карту, чтобы забронировать эту услугу. Это поле может быть переопределено на уровне доступности. (необязательный) |
action_link[] | Ссылка действия, связанная с этой услугой. Если ссылка на действие существует, тип (см. Ниже) должен быть установлен в службе. |
type | Предопределенный тип этой услуги. (необязательный) |
ticket_type[] | Типы билетов, которые могут быть забронированы/приобретены для этой услуги, если билеты поддерживаются. (необязательный) |
related_media[] | Фотографии, связанные с этой услугой. Google будет ползти и хранить носители, чтобы убедиться, что они отображаются для конечных пользователей наиболее эффективным способом. (необязательный) |
service_attribute_value_id[] | Значения атрибута службы, которые применяются к этой службе (необязательно). Каждая служба может иметь нулевые или более значений для каждого атрибута службы, определенного в соответствующем продавце. (необязательный) |
waitlist_rules | Правила присоединения к списку ожидания. |
ticketing_vertical_specific_data | Дополнительная информация Уникальная для билетов на билеты. (необязательный) |
integration_type | Глубина интеграции мы поддерживаем эту услугу. (Необязательно) Неактуально для партнеров с интеграцией стартера. Конец до конца всегда будет отключен для этих партнеров. |
per_order_fee | Плата за заказа за покупку этой услуги. (необязательный) |
tours_and_activities_content | Контентные поля, специфичные для туров и мероприятий. |
location[] | Места, связанные с этой услугой. Важные примечания: если есть несколько посещаемых мест, связанных с этой службой, или start_location отличается от посещения_локации, необходимо указать start_location. Пример: - на велосипедной экскурсии с гидом, посещающим три места, необходимо указать место для начала. - Встреча автобусного тура в лобби в отеле, а затем отправиться в посещение места. Место встречи должно быть указано. |
rating | Пользовательский рейтинг для этой службы в качестве совокупного метрика по всем отзывам. |
home_service_data | Дополнительная информация Уникальная для домашней службы вертикально. (необязательный) |
virtual_session | Необязательный. Информация о виртуальной сессии. Это необходимо для включения виртуальных услуг. |
direct_merchant_payment | Необязательный. Дополнительная информация, которая должна быть добавлена, если служба требует, чтобы пользователь платил непосредственно торговцу. Важное примечание: RWG не будет участвовать в этой транзакции. Это необходимо, если определен Virtual_session, и служба не является бесплатной или предоплата. |
Предоплата
Конкретная информация вокруг получения предоплаты.
Поля | |
---|---|
charge_timing | Когда заряд будет происходить относительно времени покупки. |
charge_time_before_start_time_sec | Время за несколько секунд до начала службы, когда пользователь взимается за оплату. Это поле должно быть установлено только тогда, когда chargetiming IS arge_later. |
Чаргетинг
Enum, чтобы указать, когда будет происходить заряд относительно времени покупки.
Перечисления | |
---|---|
CHARGE_TIMING_UNSPECIFIED | Неиспользованный. |
CHARGE_NOW | Заказчик будет взиматься немедленно. |
CHARGE_LATER | Заказчик будет взиматься позже. |
Предоплата
Enum, чтобы указать тип предоплаты.
Перечисления | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED | По умолчанию мы предположим, что предоплата не является_ обеспечена. |
REQUIRED | Пользователь должен оплатить эту услугу во время бронирования. |
OPTIONAL | Пользователь может выбрать предварительную оплату этой службы во время бронирования или позже, но это не требуется для бронирования. |
NOT_SUPPORTED | Предоставление не поддерживается для этой услуги. |
ServiceType
Предопределенные типы услуг.
Перечисления | |
---|---|
SERVICE_TYPE_UNSPECIFIED | Неиспользованный. |
SERVICE_TYPE_DINING_RESERVATION | Резервирование. |
SERVICE_TYPE_FOOD_ORDERING | Заказ еды, может быть либо доставка еды, либо на вынос, либо и то, и другое. |
SERVICE_TYPE_FOOD_DELIVERY | Доставка еды. |
SERVICE_TYPE_FOOD_TAKEOUT | Еда на вынос. |
SERVICE_TYPE_EVENT_TICKET | Билет на мероприятие. |
SERVICE_TYPE_TRIP_TOUR | Trip Tour. |
SERVICE_TYPE_APPOINTMENT | Услуга, которая предоставляет встречи или занятия. Рекомендуется для (1) здоровья и физической подготовки, (2) спа -салона и красоты, а также (3) услуг по финансовым консультациям и оценке. Пожалуйста, смотрите поддержанные типы услуг: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT | Сервис, который обеспечивает онлайн -встречу для класса или сессии, которая будет полностью виртуальной. Должен быть установлен при включении бронирования виртуальных услуг. |
SERVICE_TYPE_SHOPPING | Сервис, который позволяет пользователям делать покупки у данного продавца. Это может быть либо доставка, либо пикап. |
Serviceattribute
Атрибуты обслуживания-это определенные партнерские категории, которые описывают услуги для продавца. Например, банк может определить атрибут услуги «типа аккаунта» с возможными ценностями «личного» и «бизнеса», в то время как парикмахерский салон может определить атрибут услуги «тип услуги» с возможными значениями «Стрижка», «Цвет» и «стиль».
Поля | |
---|---|
attribute_id | Идентификатор, который уникально идентифицирует этот атрибут услуги среди других для одного и того же продавца, например, «Тип аккаунта». |
attribute_name | Видимое пользователь имя для этого атрибута, например, «Тип учетной записи». |
value[] | Все возможные значения для этого атрибута службы. |
Ценить
Представляет возможное значение для конкретного атрибута службы.
Поля | |
---|---|
value_id | Идентификатор, который уникально идентифицирует эту ценность среди других для этого атрибута услуги, например, «личный». |
value_name | Пользовательское имя для значения, например, «личный». |
ServiceatTributeValueid
Определяет определенное значение атрибута сервиса, который будет применен к сервису.
Поля | |
---|---|
attribute_id | Идентификатор атрибута, как определено в Merchant.service_attribute, например, "Service-Type". |
value_id | ID значения для этого атрибута, например, «Стрижка». Должен сопоставить значение value_id в определении атрибута службы. |
ServiceAvailability
Список доступности и к кому/когда их следует применять.
Поля | |
---|---|
name | Название ресурса Сервиса, чтобы применить это. В формате |
start_time_restrict | Если предоставлено, мы рассмотрим наличие объектов доступности, предоставленными как полный снимок из [start_time_restrit, end_time_restrict). То есть вся существующая доступность будет удалена, если выполняется следующее условие:
Если установлено сообщение о продолжительности, условие дополнительно ограничивается:
Если установлено сообщение resources_restrict, условие дополнительно ограничено:
Эти поля обычно используются для предоставления полной информации о доступности в заданном диапазоне времени. Настройка start_time_restrict, оставляя end_time_restrict unset, интерпретируется как означает, что все время начинается с start_time_restrict. |
end_time_restrict | Установка end_time_restrict, оставляя start_time_restrict unset, интерпретируется как все время до end_time_restrict. |
duration_restrict | Установка продолжительности еще больше ограничивает объем обновления только доступностью соответствующей продолжительности. |
resources_restrict | Установка resources_restrict дополнительно ограничивает объем обновления только для этого набора ресурсов. Все поля идентификаторов ресурсов должны точно совпадать. |
availability[] | Новый список наличия. |
ServiceIntakeform
Определяет форму для впуска, которая настраивает сервис, предоставляемый продавцом.
Поля | |
---|---|
field[] | Поля, которые будут отображаться пользователю. |
first_time_customers | Если это правда, эта форма будет показана клиентам с первыми. Устарело. Эта функциональность не поддерживается для форм впуска. |
returning_customers | Если это правда, эта форма будет показана повторять клиентов. Устарело. Эта функциональность не поддерживается для форм впуска. |
ServiceIntakeformfield
Определяет поле, которое включено в сервисное устройство.
Поля | |
---|---|
id | Строка от партнера по агрегатору, которая однозначно идентифицирует поле формы. Этот идентификатор должен быть таким же, как идентификатор в соответствующем ответе на поле формы, и должен быть уникальным как для уровня обслуживания, так и для форм потребления билетов. (необходимый) |
type | Тип этого поля. |
label | Текст, показанный пользователю для этого поля. Установите, пожалуйста, используйте вместо этого |
localized_label | Текст, показанный пользователю для этого поля. Поле может быть поставлено в нескольких местах. (необходимый) |
value[] | Установите, если и только тогда, когда тип поля - location_search. Пожалуйста, используйте «location_id» в поле «Расположение», чтобы указать значение местоположения. |
choice_text[] | Установите, если и только тогда, когда тип поля - несколько_чойс, флажки или выпадающие. Используется для перечисления возможных вариантов. |
is_required | Указывает, требуется ли ответ на это поле пользователем. |
allow_custom_answer | Указывает, разрешено ли пользовательское значение в дополнение к предопределенным ответам. Это применимо только тогда, когда тип поля - location_search. (необязательный) |
additional_option[] | Дополнительные варианты, предоставленные в дополнение к предоставленным значениям. Применимо только тогда, когда тип поля является местоположением_SEARCH. Например, в дополнение к предоставленному списку местоположения, еще один доступный вариант может быть «Я свяжусь с поставщиком позже». (необязательный) |
ticket_type_restrict[] | Если этот вопрос следует отображать только при книгах пользователя определенных типов билетов, это поле должно быть установлено в качестве набора соответствующих идентификаторов типа билета. Оставьте поле пустым, если вопрос всегда применим. |
hint | Подсказка для ввода, который отображается в качестве текстового заполнителя. Это применимо только тогда, когда тип поля является short_answer или абзац. (необязательный) |
FieldType
Перечислять, чтобы указать тип поля.
Перечисления | |
---|---|
FIELD_TYPE_UNSPECIFIED | Поля неуточненного или неизвестного типа будут игнорироваться. |
SHORT_ANSWER | Однострочное поле ввода для текста. |
PARAGRAPH | Многострочное поле ввода для текста. |
MULTIPLE_CHOICE | Набор радиопроизводительных кнопок, который требует одного выбора из многих вариантов. |
CHECKBOXES | Один или несколько перечисленных элементов с флажками. |
DROPDOWN | Выбор из выпадения. |
BOOLEAN | Да/нет кнопка. |
LOCATION_SEARCH | Поле поиска, которое поддерживает поиск соответствующего местоположения, данный пользовательским вводом из предоставленного списка местоположения. |
На Taxrate
Налоговая ставка, применяемая при зарядке пользователя за услугу, и которая может быть установлена либо на продавца, либо на основе услуг.
Поля | |
---|---|
micro_percent | Ставка налога в миллионах в один процент, эффективно предоставляя 6 десятиков точности. Например, если налоговая ставка составляет 7,253%, это поле должно быть установлено на 7253000. Если это поле остается бездействующим или устанавливается на 0, общая цена, взимаемая пользователю за любую услугу, предоставленную этим продавцом, является точной ценой, указанной Service.Price. Предполагается, что цена обслуживания освобождается от или уже включающая применимые налоги. Налоги не будут показаны пользователю как отдельную строку. Если это поле установлено на какую -либо ненулевую стоимость, общая цена, взимаемая пользователю за любую услугу, предоставленную этим продавцом, будет включать цену обслуживания плюс налог, оцененный с использованием налоговой ставки, предоставленной здесь. Фракции самой маленькой валютной единицы (например, фракции одного цента) будут округлены с использованием ближайшего даже округления. Налоги будут показаны пользователю в виде отдельной строки. |
Условия
Набор правил и руководящих принципов, которые отображаются пользователю, чтобы сделать бронирование через резерв с помощью Google.
Поля | |
---|---|
url | Необязательно, URL в условиях. |
text | Текст, который будет отображаться пользователю. Используйте localize_text ниже для новых интеграций. |
localized_text | Локализованный текст, который будет отображаться пользователю. |
Текст
Возможно, локализованная текстовая полезная нагрузка. Некоторые текстовые поля могут содержать маркированный контент.
Поля | |
---|---|
value | Текстовое значение в неизвестной локале. Требуется, если и только тогда, когда |
localized_value[] | Для перемещения текстовых значений. Необязательный. |
TicketType
TicketType используется для дифференциации билетов с различными ценами и/или доступностью из-за разных типов пользователей, разных атрибутов обслуживания или разных вариантов/дополнений.
Билет - это минимальный бронируемый подразделение для обслуживания, например, место в рафтинговой поездке, вход в музей, прокат двойного каяка на целый день.
Поля | |
---|---|
ticket_type_id | Идентификатор билета используется для дифференциации между различными типами билетов одного и того же сервиса и, как ожидается, будет только уникальным в рамках услуги. |
short_description | Краткое описание этого 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. (необязательный) |
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 |
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. (необязательный) |
event_url | The URL of the event on the partner's website. (необязательный) |
entity[] | A list of entities related to the event. (необязательный) |
event_attendance_mode | Необходимый. The type of the event attendance. |
event_virtual_location_url[] | Необязательный. URL where the event can be watched. |
event_organizer | Необязательный. Organizer who hosts the event. |
event_organizer_url | Необязательный. URL of the organizer who hosts the event. |
event_organizer_type | Необязательный. The type of the organizer. |
event_source_url[] | Необходимый. URL of the pages where the event information or descriptions can be found. |
event_state | Необязательный. State 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. (необязательный) |
name | Name of the entity. (необходимый) |
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. (необязательный) |
entity_type | The type of the entity. (необязательный) |
entity_role | The role of the entity in the event. (необязательный) |
public_identification_data | Public references of the entity. (необязательный) |
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 | Не указан. Не используйте. |
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 | Не указан. Не используйте. |
EVENT_CATEGORY_CONCERT | Концерты. |
EVENT_CATEGORY_SPORTS | Sports events. |
EVENT_CATEGORY_THEATRE | Theatre events. |
EVENT_CATEGORY_EXHIBITS | Экспонаты. |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES | Workshops and Classes. |
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 refernece 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 . (необязательный) |
musicbrainz_id | The 36-character musicbrainz identifier of the artist or other music entities, if applicable. See https://musicbrainz.org/doc/MusicBrainz_Identifier . (необязательный) |
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 | Не указан. 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.
Поля | |
---|---|
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. |
UpdateBookingRequest
Request to update a google.maps.booking.v1alpha.Booking
Поля | |
---|---|
update_mask | Field mask of all booking fields to be updated |
booking | The booking to be updated |
booking_failure | If processing of an asynchronously confirmed booking request fails and the booking's status is being updated to FAILED, this field should reflect the business logic error (eg, user has an existing reservation too close to this time). This field should only be set when updating the booking status to FAILED and will be ignored otherwise. |
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 | Маска полей всех полей заказа, которые будут обновлены |
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. |
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. Например. “Zoom url will be mailed 30 minutes prior to the class”. (рекомендуется) |
session_requirements | Requirements for the given virtual session. Например. 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 | Необходимый. 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 | Необходимый. 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 | Необходимый. 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. |