Индекс
-
AdsAccountLinkingService
(интерфейс) -
BookingNotification
(интерфейс) -
Feed
(интерфейс) -
InvalidationService
(интерфейс) -
InventoryStatus
(интерфейс) -
InventoryUpdate
(интерфейс) -
ActionLink
(сообщение) -
ActionLink.ActionLinkType
(перечисление) -
ActionLink.EventMetadata
(сообщение) -
ActionLink.EventMetadata.Surface
(перечисление) -
ActionPlatform
(перечисление) -
AdsAccountLink
(сообщение) -
AdsAccountLink.State
(перечисление) -
Advisement
(сообщение) -
Availability
(сообщение) -
Availability.ConfirmationMode
(перечисление) -
Availability.DurationRequirement
(перечисление) -
Availability.LinkoutRequiredReason
(перечисление) -
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
(сообщение) -
CreateAdsAccountLinkRequest
(сообщение) -
CreateMerchantRequest
(сообщение) -
CreateServiceRequest
(сообщение) -
CreditCardRestrictions
(сообщение) -
CreditCardRestrictions.CreditCardType
(перечисление) -
DeleteAdsAccountLinkRequest
(сообщение) -
DeleteMerchantRequest
(сообщение) -
DeleteServiceRequest
(сообщение) -
Deposit
(сообщение) -
DirectMerchantPayment
(сообщение) -
DurationRange
(сообщение) -
EconomicOperator
(сообщение) -
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
(сообщение) -
GetAdsAccountLinkRequest
(сообщение) -
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
(сообщение) -
Prepayment
(сообщение) -
PrepaymentStatus
(перечисление) -
Price
(сообщение) -
PriceInfo
(сообщение) -
PriceInterpretation
(перечисление) -
PriceRange
(сообщение) -
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
(сообщение) -
TicketType.InventoryType
(перечисление) -
TicketType.PriceDisplayType
(перечисление) -
TicketingVerticalSpecificData
(сообщение) -
TicketingVerticalSpecificData.AttendanceMode
(перечисление) -
TicketingVerticalSpecificData.Entity
(сообщение) -
TicketingVerticalSpecificData.Entity.EntityRole
(перечисление) -
TicketingVerticalSpecificData.Entity.EntityType
(перечисление) -
TicketingVerticalSpecificData.EventCategory
(перечисление) -
TicketingVerticalSpecificData.EventCreator
(сообщение) -
TicketingVerticalSpecificData.EventState
(перечисление) -
TicketingVerticalSpecificData.OrganizerType
(перечисление) -
TicketingVerticalSpecificData.PublicIdentificationData
(сообщение) -
TimeRange
(сообщение) -
TokenizationConfig
(сообщение) -
TokenizationConfig.BillingInformationFormat
(перечисление) -
ToursAndActivitiesContent
(сообщение) -
UnsupportedPartySizeOption
(сообщение) -
UpdateAdsAccountLinkRequest
(сообщение) -
UpdateBookingRequest
(сообщение) -
UpdateMerchantRequest
(сообщение) -
UpdateOrderRequest
(сообщение) -
UpdateServiceRequest
(сообщение) -
UriTemplate
(сообщение) -
UserPurchaseRestriction
(сообщение) -
VirtualSession
(сообщение) -
VirtualSession.VirtualPlatformInfo
(сообщение) -
VirtualSession.VirtualPlatformInfo.Platform
(перечисление) -
WaitlistRules
(сообщение)
Служба связывания аккаунтов Ads
Сервис для управления связью аккаунтов между Google Рекламой и Партнерским центром.
CreateAdsAccountLink |
---|
Создает ссылку на рекламный аккаунт. Это приведет к установлению связи между учетной записью Google Рекламы и Партнерским центром. Ссылка будет находиться в состоянии
|
Удалить ссылку на аккаунт AdsAccount |
---|
Удаляет ссылку на рекламный аккаунт. Это приведет к отмене связи между учетной записью Google Рекламы и учетной записью Партнерского центра.
|
GetAdsAccountLink |
---|
Получает ссылку на рекламный аккаунт.
|
Обновить рекламный аккаунтссылка |
---|
Обновляет ссылку на рекламный аккаунт с товарами. В связи с этим в ссылке на рекламный аккаунт будут добавлены предоставленные товары.
|
Уведомление о бронировании
Получает уведомления о встречах от внешних партнеров по планированию. Партнер должен вызвать 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 | Метаданные для ссылок для заказа еды. Поддерживает тип действия: * |
event_ 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 | Тип ссылки действия — заказ на покупку, может быть доставка, самовывоз или и то, и другое. |
Метаданные событий
Дополнительная информация о ссылке на действие, которая является уникальной для вертикали событий.
Поля | |
---|---|
surface | Заранее определенная поверхность событий, связанная со ссылкой действия. Используется только для вертикали «События». |
Поверхность
Заранее определенная поверхность событий, связанная со ссылкой действия. Используется только для вертикали «События».
Перечисления | |
---|---|
SURFACE_UNSPECIFIED | Поверхность не указана. |
SURFACE_SEARCH | Ссылка на действие — бронирование билета на мероприятие в Поиске. |
SURFACE_YOUTUBE | Ссылка на действие — бронирование билета на мероприятие на YouTube. |
SURFACE_ADS | Ссылка на действие — нажатие на рекламу мероприятия. |
Платформа действий
Платформа, на которой выполняется действие. Веб-приложение — это общий запасной вариант. Рекомендуется иметь хотя бы один ActionLink с ACTION_PLATFORM_WEB_APPLICATION. Ссылки с Android и iOS в качестве платформы используются только в соответствующей системе.
Перечисления | |
---|---|
ACTION_PLATFORM_UNSPECIFIED | Платформа не указана. |
ACTION_PLATFORM_WEB_APPLICATION | Платформой действий в целом является Интернет. |
ACTION_PLATFORM_MOBILE_WEB | Платформа действий доступна в Интернете на мобильных устройствах. |
ACTION_PLATFORM_ANDROID | Платформой действия является ОС Android. |
ACTION_PLATFORM_IOS | Платформа действий — iOS. |
Рекламный аккаунтСсылка
AdsAccountLink — это связь между учетной записью Рекламы и учетной записью Партнерского центра вместе с элементами инвентаря.
Поля | |
---|---|
name | Идентификатор. Имя ресурса AdsAccountLink. Формат: |
item_ ids[] | Необходимый. Список идентификаторов элементов инвентаря, которые будут связаны с аккаунтом Google Рекламы. |
state | Только вывод. Состояние ссылки на рекламный аккаунт. |
Состояние
Состояние ссылки на рекламный аккаунт.
Перечисления | |
---|---|
STATE_UNSPECIFIED | Неизвестное государство. |
LINKED | Учетная запись связана между Партнерским центром и рекламным порталом. |
PENDING | Учетная запись ожидает одобрения либо в Партнерском центре, либо на рекламном портале. |
DELETED | Ссылка на аккаунт удалена. |
REJECTED | Запрос на привязку учетной записи отклонен либо Центром партнеров, либо Порталом объявлений. |
Совет
Рекомендации, которые отображаются пользователю при бронировании через «Забронировать через 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 | Дополнительная плата за незаезд при наличии возможности. Отменяет плату за неявку за услугу, если она была указана. |
prepayment | Необязательный. Дополнительная информация о предоплате для этого наличия. |
require_ credit_ card | Указывает, должен ли пользователь предоставить кредитную карту, чтобы забронировать этот слот доступности. Если значение не установлено, оно наследуется от уровня обслуживания, если оно там установлено. (необязательный) |
ticket_ type_ id[] | Указывает список поддерживаемых типов билетов для этого слота доступности. Если значение не установлено, для этого слота доступны все типы билетов родительской службы. Обратите внимание, что значения этого поля должны быть определены в родительском сервисе. Примеры:
Чтобы представить инвентарь в будние дни:
Чтобы указать, что все три типа билетов доступны для этого временного интервала, используйте либо (необязательный) |
duration_ requirement | Требование показывать продолжительность и/или время окончания слотов. Это поле будет игнорироваться, если слот недоступен. Не используется в вертикали «Что нужно сделать». (необязательный) |
scheduling_ rule_ overrides | Правила планирования доступности. Если поля заполнены, они переопределяют любые соответствующие правила планирования в SchedulingRules уровня службы. |
confirmation_ mode | Режим подтверждения, который будет использоваться при бронировании этой доступности. Попытки создать бронирования для наличия мест с режимом подтверждения CONFIRMATION_MODE_SYNCHRONOUS должны быть немедленно подтверждены или отклонены. Попытки создать бронирования для наличия мест с режимом подтверждения CONFIRMATION_MODE_ASYNCHRONOUS должны быть либо немедленно отклонены, либо созданы со статусом ОЖИДАНИЕ. |
linkout_ required_ reason | Необязательный. Причина, по которой для этого слота требуется ссылка. Если установлено, ресурс продавца для этого слота должен иметь действительный LinkoutTemplate. (необязательный) |
Режим подтверждения
Режимы подтверждения, используемые при бронировании мест.
Перечисления | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED | Не указан режим подтверждения. Предполагается синхронное подтверждение. |
CONFIRMATION_MODE_SYNCHRONOUS | Бронирование на эту доступность будет подтверждено синхронно. |
CONFIRMATION_MODE_ASYNCHRONOUS | Бронирование на эту доступность будет подтверждено асинхронно. |
ПродолжительностьТребование
Это перечисление указывает, какие требования существуют для пользователя для подтверждения или просмотра продолжительности/времени окончания запрошенных интервалов.
Перечисления | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED | Обработка времени окончания не указана. Это значение по умолчанию. |
DO_NOT_SHOW_DURATION | Время окончания не отображается пользователю. |
MUST_SHOW_DURATION | Время окончания должно быть показано пользователю, прежде чем можно будет назначить встречу. |
LinkoutRequiredReason
Причина, по которой в слоте есть возможность ссылки.
Перечисления | |
---|---|
LINKOUT_REQUIRED_REASON_UNSPECIFIED | Значение по умолчанию: Не использовать, соответствует неизвестному. |
PAYMENT_REQUIRED | Для бронирования слота требуется оплата на партнерской платформе. |
Повторение
Сообщения о повторении не являются обязательными, но позволяют более компактно представить постоянно повторяющиеся интервалы доступности. Обычно они представляют собой рабочий график дня. Сообщения ScheduleException затем используются для представления зарезервированных/недоступных диапазонов времени в течение рабочего дня.
Требования:
- Расширение слотов доступности или повторений НЕ должно создавать идентичные слоты. Если идентификаторы, 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 | Адрес электронной почты клиента |
CreateAdsAccountLinkRequest
Сообщение запроса для AdsAccountLinkingService.CreateAdsAccountLink.
Поля | |
---|---|
parent | Необходимый. Родительский ресурс, в котором будет создана ссылка на этот аккаунт Google Рекламы. Это тот же идентификатор учетной записи Центра партнеров. Формат: партнеры/{партнер} |
ads_ account_ link_ id | Необходимый. Идентификатор, который будет использоваться для ссылки на рекламный аккаунт. Это то же самое, что идентификатор клиента Google Рекламы. Подробную информацию см. на странице https://support.google.com/google-ads/answer/1704344 . Формат: xxx-xxx-xxxx. |
ads_ account_ link | Необходимый. Создаваемая ссылка AdsAccountLink. |
Создать запрос продавца
Запрос на создание 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. |
УдалитьAdsAccountLinkRequest
Сообщение запроса для AdsAccountLinkingService.DeleteAdsAccountLink.
Поля | |
---|---|
name | Необходимый. Имя AdsAccountLink, которую нужно удалить. Формат: Partners/{partner}/adsAccountLinks/{ads_account_link}. |
Удалить запрос продавца
Запрос на удаление 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 | Максимальная продолжительность. |
ЭкономическийОператор
Информация экономического оператора для агрегатора.
Поля | |
---|---|
text | Необходимый. Имя, адрес, номер телефона и адрес электронной почты экономического оператора, определяемого как производитель, уполномоченный представитель, импортер, дистрибьютор, поставщик услуг выполнения или любое другое физическое или юридическое лицо, на которое возложены обязательства, связанные с производством продукции, предоставлением ее, или ввести их в эксплуатацию. Строковое представление Economic_operator в произвольной форме. Эта информация может быть отформатирована с использованием « » и «\n». |
Экстендедсервицедоступность
Список доступности и к кому/когда их следует применять.
Поля | |
---|---|
merchant_ id | Это обязательное поле, необходимое для указания продавца, которому принадлежат приведенные ниже сообщения о доступности. |
service_ id | Это обязательное поле, необходимое для указания того, к какой службе относятся приведенные ниже сообщения о доступности. |
start_ time_ restrict | Если предоставлено, мы будем считать предоставленные объекты доступности полным снимком из [start_time_restrict, 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 дополнительно ограничивает объем обновления только для этого набора ресурсов. Все поля ID ресурсов должны точно соответствовать. |
availability[] | Новый список доступности. |
Питательная статистика
Статистика, полученная при обработке загруженного канала.
Поля | |
---|---|
new_ items | Недавно добавленные элементы по этому каналу. Предметы могут быть торговцы, услуги или слоты доступности, в зависимости от типа канала. |
existing_ items | Существующие элементы, обновляемые по мере необходимости из более новой информации из канала. |
deleted_ items | Элементы больше не присутствуют в этом канале, и которые были удалены в результате. |
Сырье
Состояние подачи, загруженное платформой агрегатора.
Поля | |
---|---|
name | Название ресурса Feed, которое имеет формат
|
state | Состояние обработки этого корма. |
error_ details | Человеческая читаемая строка, предоставляющая более подробную информацию, если нам не удалось обработать этот канал. |
statistics | Статистика, специфичная для этого канала. |
Состояние
Enum, чтобы указать состояние обработки корма.
Перечисление | |
---|---|
STATE_UNSPECIFIED | Значение по умолчанию. Неиспользованный. |
IN_PROGRESS | Корм все еще обрабатывается. |
SUCCESS | Корм был успешно обработан. |
FAILURE | Мы столкнулись с ошибкой при обработке подачи. |
FoodorderingMetadata
Метаданные для заказа пищи.
Поля | |
---|---|
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 минут |
AdvanceDordEdets
За заказ вперед поддержки.
Поля | |
---|---|
is_ supported | Верно, если предварительные заказы, также известные как предстоящий заказ, поддерживаются. (необходимый) |
Feedetails
Детали платы.
Поля | |
---|---|
type | Тип платы. (необходимый) |
fee_ amount | Сумма платы либо в валюте единицы, процент от стоимости телеги или комбинации обоих. (необходимый) |
Feeamount
Примеры FeeAmount
: * Фиксированная плата: 0 долларов США (без платы), 1,5 доллара США. 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 долларов США. |
amount_ unknown | Неизвестная сумма. |
Ноги
Тип платы.
Перечисление | |
---|---|
FEE_TYPE_UNSPECIFIED | Тип платы не указан. |
DELIVERY | За доставку. |
SERVICE | За оплату услуг. |
Fulfillmentoption
Вариант выполнения для ссылки на онлайн -действия заказа.
Поля | |
---|---|
fulfillment_ type | Необходимый. Тип исполнения. |
available_ day[] | Необходимый. Список дней, в которые существует доступность для этого метода выполнения (предпочтительно как минимум 2). |
fee_ details | Необходимый. Детали платы за метод выполнения. |
minimum_ order | Необходимый. Минимальный порядок для метода выполнения, связанного со ссылкой на действие. |
Доступен
Дневная доступность уровня.
Поля | |
---|---|
fulfillment_ date | Необходимый. Доступная дата для метода выполнения. Предполагается, что он находится в часовом поясе Торгона. |
last_ ordering_ time | Необходимый. Unix TimeStamp. Последний раз, когда пользователь может заказать, и получать элементы от Например, если fulfillment_date-2020-08-10:-значение последнего_ордорга_ времени 2020-08-10 18:00 означает, что для получения своего заказа на 2020-08-10 клиент должен сделать этот заказ к 18:00 в тот же день. -Значение последнего_ dordering_time 2020-08-08 20:00 означает, что для получения своего заказа на 2020-08-10 клиент должен сделать этот заказ к 8 вечера два дня назад. |
Feedetails
Подробная информация о плате за метод выполнения, связанный со ссылкой на действие.
Поля | |
---|---|
Союз поля fee_details . Модель платы за метод выполнения. fee_details может быть только одним из следующих: | |
no_ fee | Нет платы за метод выполнения. |
base_ fee | Базовая плата, связанная с методом выполнения. |
fixed_ fee | Фиксированная плата, связанная с методом выполнения. |
FixedFee
Фиксированная плата, необходимая для метода выполнения, связанного со ссылкой на действие.
Поля | |
---|---|
amount | Необходимый. Сумма фиксированной платы за метод выполнения. |
FulfillmentType
Тип исполнения, связанный со ссылкой на действие.
Перечисление | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED | Тип исполнения не указан. |
FULFILLMENT_TYPE_DELIVERY | Тип исполнения - доставка. |
FULFILLMENT_TYPE_PICKUP | Тип исполнения - это пикап. |
Минимальный
Минимальная плата, необходимая для метода выполнения, связанного со ссылкой на действие.
Поля | |
---|---|
base_ fee_ amount | Необходимый. Базовая сумма плата за метод выполнения. |
Nofee
Этот тип не имеет полей.
Не требуется плата за метод выполнения, связанный со ссылкой на действие.
GenericDeletetereCord
Запись должна быть удалена из типа подачи, упомянутого в запросе URL.
Поля | |
---|---|
delete_ time | Необходимый. Эта временная метка используется для определения порядка, в котором удаление будет применяться к инвентаризации. |
Союз полевой record_type . Инкапсулирует различные типы пищи (NDJSON, Proto на основе и т. Д.) Партнер может предоставить полную запись, аналогичную тому, как записи предоставляются в API Feed или Batchpush. Партнеры также имеют возможность включить только основные области записи, необходимых для уникальной идентификации. record_type может быть только одним из следующих: | |
data_ record | Для непротологических каналов. |
proto_ record | Для прото на основе каналов. |
GenericRecord
Запись типа канала, упомянутого в запросе URL.
Поля | |
---|---|
generation_ timestamp | Необходимый. Эта метка времени используется для обеспечения правильного упорядочения обновлений инвентаризации. |
Союз полевой record_type . Инкапсуляции различных типов подачи (NDJSON, Proto на основе и т. Д.) record_type может быть только одним из следующих: | |
data_ record | Для непротологических каналов. |
proto_ record | Для прото на основе каналов. |
Геодоординаты
Данные гео местоположения, включая широту, долготу и адрес.
Поля | |
---|---|
latitude | Широта в градусах. (необязательный) |
longitude | Долгота в градусах. (необязательный) |
Полевые addresses профсоюза. Адрес для местоположения, может быть структурирован или неструктурирован. addresses могут быть только одним из следующих: | |
address | Почтовый адрес местоположения, предпочтительный. |
unstructured_ address | Неструктурированный адрес также может быть предоставлен в качестве запасного. Например "1600 Amphitheater Parkway Mountain View, CA 94043" |
GetAdsaccountlinkRequest
Запросить сообщение для adsaccountlinglingservice.getadsaccountlink.
Поля | |
---|---|
name | Необходимый. Название ссылки аккаунта рекламы для извлечения. Формат: |
GetmerchantstatusRequest
Просьба получить MerchantStatus
Поля | |
---|---|
name | Необходимый. Имя ресурса, в формате партнеров/{partner_id}/merchants/{merchant_id}/status. |
GetStatusRequest
Запрос на получение Status
для конкретного подачи, загруженного платформой агрегатора.
Поля | |
---|---|
name | Название ресурса Feed, которое имеет формат
|
HomeServicedata
Дополнительная информация, которая должна быть предоставлена для вертикальной службы дома.
Поля | |
---|---|
category_ type | Категория высокого уровня, к которой принадлежит этот домашний сервис. Например, сантехник, электрик и т. Д. |
job_ type | Тип работы в соответствии с категорией, которой принадлежит данное домашнее обслуживание. Например, unclog_drain, install_faucet - типы заданий в категории сантехника. |
IntegrationType
Глубина интеграции поддерживается.
Перечисление | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED | По умолчанию end_to_end. |
INTEGRATION_TYPE_END_TO_END | Полная интеграция, которая позволяет конец завершить бронирование через Google. |
INTEGRATION_TYPE_INVENTORY_ONLY | Сервер бронирования не нуждается в поддержке этой службы. Необходимо отправить только продавцы, услуги и (необязательно) доступность. |
InvalidateresourceRequest
Запрос на признание ресурса.
Поля | |
---|---|
resource_ id | Название ресурса, которое будет признано недействительным. Например, для ресурса пикапа имя должно иметь формат |
LineItem
Один предмет в заказе-бронирование одного сервиса за один раз.
Поля | |
---|---|
service_ id | Удостоверение личности торговой службы. |
start_ sec | Начало время назначения слота в считанные секунды времени UTC со времен Unix Epoch. |
duration_ sec | Продолжительность слота назначения за считанные секунды. |
tickets[] | Количество билетов, заказанных типом билета. |
price | Общая цена (за исключением налогов) этой позиции. |
status | Статус позиции. |
Заказано
Количество заказанных билетов по типу билета.
Поля | |
---|---|
ticket_ id | Удостоверение личности типа билета. |
count | Количество билетов, заказанных для этого типа. |
ListmerChantStatusErquest
Запрос получить список MerchantStatus
Поля | |
---|---|
parent | Необходимый. Родитель, который владеет этой коллекцией статуса продавца. Формат: |
page_ size | Необходимый. Максимальное количество элементов для возврата. Обратите внимание, что сервер может уменьшить размер страницы. |
page_ token | Необязательный. Значение NextPageToken, возвращаемое из предыдущего ListMerChantStatusResponse, если таковые имеются. |
booking_ inventory_ status_ restrict | Необязательный. Необязательное ограничение для фильтрации результатов путем бронирования статуса инвентаря. |
waitlist_ inventory_ status_ restrict | Необязательный. Необязательное ограничение для фильтрации результатов по статусу инвентаризации ожидания. |
geo_ match_ restrict | Необязательный. Необязательное ограничение для фильтрации результатов с помощью статуса сопоставления GEO. |
BookingInventoryStatus
Статус инвентаризации сквозного бронирования.
Перечисление | |
---|---|
BOOKING_INVENTORY_STATUS_UNSPECIFIED | Не указан. |
NO_VALID_FUTURE_INVENTORY | У продавца нет инвентаря в течение следующих 30 дней. |
HAS_VALID_FUTURE_INVENTORY | У продавца есть инвентарь в течение следующих 30 дней. |
Geomatchingstatus
Торговый статус сопоставления гео.
Перечисление | |
---|---|
GEO_MATCHING_STATUS_UNSPECIFIED | Не указан. |
GEO_UNMATCHED | Торговец не сочетается с гео. |
GEO_MATCHED | Торговец подходит к гео. |
WATLISTINVENTORYSTATUS
Статус инвентаризации инвентаризации в списке ожидания.
Перечисление | |
---|---|
WAITLIST_INVENTORY_STATUS_UNSPECIFIED | Не указан. |
NO_VALID_WAITLIST_SERVICE | У продавца нет услуг, поддерживающих список ожидания. |
HAS_VALID_WAITLIST_SERVICE | У Merchant есть сервис, поддерживающий список ожидания. |
ListmerChantStatusEsresponse
Ответ на список MerchantStatus
.
Поля | |
---|---|
merchant_ statuses[] | Список статусов продавца, которые удовлетворяют условиям фильтра. |
next_ page_ token | Токен, чтобы получить следующую страницу результатов. В списке больше нет результатов, если пустые. |
ListStatusRequest
Запрос на получение Status
для нескольких каналов, загруженных платформой агрегатора.
Поля | |
---|---|
name | Название ресурса Feed, которое имеет формат
|
page_ size | Максимальное количество элементов для возврата. |
page_ token | Значение next_page_token возвращается из предыдущего запроса списка, если таковые имеются. |
state_ restrict | Дополнительное ограничение для фильтрации результатов с помощью состояния подачи. |
time_ range_ restrict | Необязательное ограничение для фильтрации результатов по верхней и нижней границе. Если start_time не истекает, это по умолчанию в начале Unix Time. Если End_time не будет, он будет по умолчанию. |
ListStatusResponse
Запрос на получение 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 Place и на картах Google. См . Если это будет предоставлено, Google будет соответствовать местоположению с этим местом. |
name | Название местоположения, телефон, URL и GEO используются для поддержки сопоставления местоположения с местами, уже присутствующими на картах Google. Это поле не является обязательным, но может потребоваться в некоторых контекстах. Например, услуга. Расположение без имени не будет сопоставлена с бизнесом, даже если они расположены по одному и тому же адресу. (необязательный) |
telephone | Общественный номер телефона места, включая его коды страны и зоны, например, +14567891234. (необязательный) |
url | URL -адрес общественного сайта местоположения. (необязательный) |
geo | Гео информация о местоположении, включая широту, долготу и адрес. (необязательный) |
location_ type | Тип местоположения должен быть предоставлен, если это место предоставляется для обслуживания. |
location_ id | Уникальная ссылка на местоположение в службе. Этот идентификатор может быть использован для обозначения этого места в других областях обслуживания. Например, в пользовательской форме впуска можно использовать набор идентификаторов местоположения для указания параметров местоположения. Если установлен, этот идентификатор должен быть уникальным в той же службе. (необязательный) |
LocationType
Тип этого места.
Перечисление | |
---|---|
LOCATION_TYPE_UNSPECIFIED | Тип местоположения неопределен. |
VISITED_LOCATION | Место, где этот сервис посещает. |
START_LOCATION | Место, где начинается эта служба, также служит в качестве встречи. |
END_LOCATION | Место, где заканчивается этот сервис. |
Торговец
Информация о продавцах, который находится на платформе агрегатора.
Поля | |
---|---|
name | Имя ресурса продавца, которое имеет формат |
merchant_ name | Merchant_Name, телефон, URL и GEO используются для поддержки подходящего инвентаря партнеров с продавцами, уже присутствующими на картах 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 байтов. |
economic_ operator | Необязательный. Информация об экономическом операторе, связанная с этим конкретным продавцом, необходимая для соблюдения нормативных требований. (необязательный) |
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 может отличаться от общественных видимых. |
BookingStatus
Статус, связанный с комплексной интеграцией бронирования.
Поля | |
---|---|
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[] | Статьи в этом порядке. |
Orderonlinemetadata
Метаданные для ссылки на Online Action Online.
Поля | |
---|---|
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 амфитеатр pkwy". (необходимый) |
Предоплата
Оплата, которую пользователь может взиматься как часть их бронирования.
Поля | |
---|---|
price_ info | Контейнер для деталей цен. |
Предоплата
Статус предоплаты бронирования.
Перечисление | |
---|---|
PREPAYMENT_STATUS_UNSPECIFIED | Не указано, по умолчанию предоплате_not_provided. |
PREPAYMENT_PROVIDED | Плата за бронирование была оплачена заранее. |
PREPAYMENT_NOT_PROVIDED | Плата за бронирование не была оплачена заранее. |
PREPAYMENT_REFUNDED | Плата ранее была предоплачена, но теперь была возвращена. |
Цена
Цена услуги или плата.
Поля | |
---|---|
price_ micros | Цена в микро-единицах валюты. Фракции самого маленького валютного блока будут округлены с использованием ближайшего даже округления. (Например, за 2,5 цента в 2,5 цента, округлые до 2 центов, 3,5 цента округливы до 4 центов, 0,5 цента округливы до 0 центов, 2,51 цента округливы до 3 центов). |
currency_ code | Валюта цены, которая определена в ISO 4217. |
pricing_ option_ tag | Необязательная и непрозрачная строка, которая идентифицирует вариант ценообразования, который связан с расширенной ценой. |
Прайонфо
Контейнер для деталей цен.
Поля | |
---|---|
price_ type | Определяет, как применяется ценовая или ценовая диапазон (на человека или фиксированное) |
Союз Филд price_options . Варианты цен должны указать точную цену или диапазон. price_options может быть только одним из следующих: | |
price | Цена услуги или плата. |
price_ range | Верхняя и/или нижняя граница услуги или плата. |
Цена интерпретации
Описывает, как цена должна быть интерпретирована и отображается пользователю.
Перечисление | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED | Интерпретация цен не указана, по умолчанию exact_amount. |
EXACT_AMOUNT | Когда цена должна интерпретироваться как конкретное значение. Примеры: $ 20 для занятий йогой; 15 долларов за стрижку ребенка |
STARTS_AT | Когда цена обслуживания переменная, но минимальная цена известна и отображается потребителям. Потребители могут сделать выбор, которые повышают цену. Обратите внимание, что любая услуга, которая использует эту цену интерпретации, должна использовать предоплату not_supported. Примеры: 30 долларов за уход за собаками, но дополнительный выбор потребителей может повысить цену |
NOT_DISPLAYED | Когда цена услуги является переменной, а информация о цене не отображается потребителям заранее. Обратите внимание, что любая услуга, которая использует эту цену интерпретации, должна использовать предоплату not_supported, и цена должна быть пустой. Примеры: консультация по домашнему обслуживанию |
Приход
Обертка для диапазона денежного количества, обработанного как неограниченное, если оба значения не установлены. По крайней мере, один из min_amount и max_amount требуется.
Поля | |
---|---|
min_ price | Минимальная сумма. |
max_ price | Максимальная сумма. Всегда должен быть> min_price. |
Причетип
Определяет, как общая цена определяется по доступности.
Перечисление | |
---|---|
FIXED_RATE_DEFAULT | Цена на фиксированную сумму. Это значение по умолчанию, если поле не установлено. Примеры: зарезервированный зарезервированный таблицу за 50 долларов; $ 20 НЕТ ПРОТИВОСТА |
PER_PERSON | Указанная цена на человека, а общая цена рассчитывается в соответствии с размером стороны, указанным в ресурсах, как цена_micros * party_size. Цена Per_person должна сопровождаться размером партии в ресурсах доступности. Если это не так, используется размер партии. Примеры: по 10 долларов за билеты в музей |
QuantitativeValue
Обертка для численного значения, которое может быть диапазоном или фиксированным значением. 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 человека, могут сидеть с бронированием. |
room_ description | Необязательный. Локализованное описание комнаты. If set, a default value must be provided. It is preferred to also provide common languages for the merchant's locale. (необязательный) |
SchedulingRules
The scheduling rules for a service.
Поля | |
---|---|
min_ advance_ online_ canceling | The minimum advance notice in seconds required to cancel a booked appointment online. (необязательный) |
late_cancellation_fee | The fee for canceling within the minimum advance notice period. |
noshow_fee | The fee for no-show without canceling. |
admission_ policy | The admission policy that applies to this service. If unset, defaults to TIME_STRICT. (необязательный) |
cancellation_ policy | Scheduling rules cancellation policy. (required for Things-to-do) |
Union field If "min_advance_booking" is set, the last bookable time is calculated as (<slot start time> - "min_advance_booking"). If "min_booking_buffer_before_end_time" is set, the last bookable time is calculated as (<slot end time> - "min_booking_buffer_before_end_time"). Note that the value of "min_booking_buffer_before_end_time" must be positive if set. If both are unset, the slot is bookable until the slot begin time. If both fields are set, only one value will be picked while the other value ignored--we cannot reliably predict which value is chosen. Примеры:
| |
min_ advance_ booking | The duration (in seconds) from when the last booking can be made to when the availability slot starts. |
min_ booking_ buffer_ before_ end_ time | The duration (in seconds) from when the last booking can be made to when the availability slot ends. If this field is set, the "admission_policy" field must be set to TIME_FLEXIBLE to indicate that users can use the purchased tickets after slots start. |
AdmissionPolicy
The admission policy of this service.
Enums | |
---|---|
ADMISSION_POLICY_UNSPECIFIED | Неиспользованный. |
TIME_STRICT | Customers are required to be present at the start time of the availability slot, and the service is expected to finish at the end time of the slot. Examples of TIME_STRICT use cases: * A tour that starts at 9am that requires all attendees to arrive at the start time, and returns at around 12pm. * A haircut reservation at 3pm on Saturday that will take approximately 30 minutes. * A fitness class from 6pm to 8pm. |
TIME_FLEXIBLE | Customers can arrive at any time between the start and end time of the availability slot to use this booking. Examples of TIME_FLEXIBLE use cases: * A museum ticket that can be used during any time on the purchase date. * An afternoon admission to an amusement park that can be used from 12pm to 9pm. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION | Customers need to arrive at the merchant at the start time of the availability slot but can leave any time they want. For example, in the museum admission scenario, a timed entry ticket for 10am requires the user to be at the museum at 10am. The start time of availability slots for this service represents the designated entry time. The end time, however, is used solely as a key to identify the availability slot for booking. |
Услуга
Info about a service that is provided by the merchant, eg haircut.
Поля | |
---|---|
name | The service resource name, which has the format of |
service_ name | The name of the service, eg "Men's haircut". Deprecated, use localized_service_name instead. |
localized_ service_ name | The name of the service, eg "Men's haircut". Possibly in several locales. |
description | The user-visible description of the service. Deprecated, use localized_description instead. |
localized_ description | The user-visible description of the service. This field supports both plain-text and HTML-like formatting. Unlike plain text sections, customized layouts can be created here using headings, paragraphs, lists and some phrase tags. Please read the following instructions and notes carefully to ensure you create the best user-experience. Supported HTML-like formatting tags: Heading tags: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Paragraph tag: <p> List tags: <ul>, <ol>, <li> Division tag: <div> Phrase tags: <br>, <strong>, <em>: Unsupported tags:
Important notes:
|
price | The price of the service. |
price_ interpretation | Describes how the price is interpreted and displayed to the user. Can be used by any vertical except Dining and Things To Do to configure display of the service price. |
rules | Rules to book/cancel an appointment. |
prepayment_ type | Whether a prepayment is required, optional or not supported. |
prepayment_ terms | Terms around when the prepayment is completed. |
form[] | Deprecated. Please use intake_form and per_ticket_intake_form. |
intake_ form | A form requesting additional information from the user when they book this service. (необязательный) |
per_ ticket_ intake_ form | A form requesting additional information from the user when they book this service. This form must be filled out once for each ticket the user is booking. (необязательный) |
tax_ rate | The service's tax rate. If present this field overrides any tax_rate set at the merchant level. An empty message (ie tax_rate { }) will reset the applied tax rate to zero. |
payment_ option_ id[] | A list of ids referencing the payment options which can be used to pay for this service. The actual payment options are defined at the Merchant level, and can also be shared among multiple Merchants. |
deposit | Defines how a deposit may be charged to the user. Overrides the service deposit if one was specified. Setting this to an empty Deposit message removes any service-level deposit. (необязательный) |
no_ show_ fee | Defines a no show fee that may be charged to the user. Overrides the service no show fee if one was specified. Setting this to an empty NoShowFee message removes any service-level no show fee. (необязательный) |
require_ credit_ card | Indicates whether the user must provide a credit card in order to book this service. This field can be overridden at the availability level. (необязательный) |
action_ link[] | An action link related to this service. If action link exists, type (see below) must be set in the Service. |
type | The predefined type of this service. (необязательный) |
ticket_ type[] | Types of tickets that can be booked/purchased for this service, if tickets are supported. (необязательный) |
related_ media[] | Photos related to this service. Google will crawl and store the media to ensure that they are displayed to end-users in the most efficient way. (необязательный) |
service_ attribute_ value_ id[] | Service attribute values that apply to this service (optional). Each Service may have zero or more values for each service attribute defined in the corresponding Merchant. (необязательный) |
waitlist_ rules | Rules to joining the waitlist. |
ticketing_ vertical_ specific_ data | Additional information unique to the event ticketing vertical. (необязательный) |
integration_ type | Depth of integration we support for this service. (optional) Irrelevant for partners with the starter integration. End to end will always be disabled for these partners. |
per_ order_ fee | Order level fees for purchasing this service. (необязательный) |
tours_ and_ activities_ content | Content fields specific to Tours and Activities. |
location[] | Locations related to this service. IMPORTANT NOTES: If there are multiple visited locations related to this service, or the START_LOCATION is different from the VISITED_LOCATION, the START_LOCATION must be specified. Example: - A guided biking tour visiting three venues, the start venue needs to be specified. - A bus tour meeting at a hotel lobby and then head to the visited venue. The meeting location needs to be specified. |
rating | User rating for this service as an aggregate metric over all reviews. |
home_ service_ data | Additional information unique to home service vertical. (необязательный) |
virtual_ session | Необязательный. Information about virtual session. It is required for enabling virtual services. |
direct_ merchant_ payment | Необязательный. Additional information which needs to be added if the service requires the user to pay directly to the merchant. IMPORTANT NOTE: RwG would not be involved in this transaction. It is required if virtual_session is defined and the service is not free or prepayment_type is NOT set to REQUIRED. |
uri_ template | Необязательный. An optional template specifying how Google should generate URLs to external site. |
PrepaymentTerms
Specific information around when prepayment is completed.
Поля | |
---|---|
charge_ timing | When the charge will occur relative to the purchase time. |
charge_ time_ before_ start_ time_ sec | Time in seconds before the service start time that the user is charged for payment. This field should only be set when ChargeTiming is CHARGE_LATER. |
ChargeTiming
Enum to specify when the charge will occur relative to the purchase time.
Enums | |
---|---|
CHARGE_TIMING_UNSPECIFIED | Неиспользованный. |
CHARGE_NOW | Customer will be charged immediately. |
CHARGE_LATER | Customer will be charged later. |
PrepaymentType
Enum to indicate the prepayment type.
Enums | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED | By default we will assume that the prepayment is NOT_SUPPORTED. |
REQUIRED | The user has to pay this service at the booking time. |
OPTIONAL | The user can choose to pre-pay this service at the booking time or later, but it is not required in order to book. |
NOT_SUPPORTED | The prepayment is not supported for this service. |
ServiceType
Predefined service types.
Enums | |
---|---|
SERVICE_TYPE_UNSPECIFIED | Неиспользованный. |
SERVICE_TYPE_DINING_RESERVATION | Dining reservation. |
SERVICE_TYPE_FOOD_ORDERING | Food ordering, could be either food delivery or takeout or both. |
SERVICE_TYPE_FOOD_DELIVERY | Food delivery. |
SERVICE_TYPE_FOOD_TAKEOUT | Food takeout. |
SERVICE_TYPE_EVENT_TICKET | Event ticket. |
SERVICE_TYPE_TRIP_TOUR | Trip tour. |
SERVICE_TYPE_APPOINTMENT | Service that provides appointments or classes. Recommended for (1) health and fitness, (2) spa and beauty, and (3) financial consults and evaluations services. Please see the supported service types: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT | Service that provides online appointment for a class or session which will be fully virtual. Must be set if enabling virtual service bookings. |
SERVICE_TYPE_SHOPPING | Service that allows users to shop from the given merchant. It could either be delivery or pickup. |
ServiceAttribute
Service attributes are partner-defined categories that describe the Services for a Merchant. For example, a bank may define an "Account Type" service attribute with possible values of "Personal" and "Business", while a hair salon may define a "Service Type" service attribute with possible values of "Haircut", "Color", and "Style".
Поля | |
---|---|
attribute_ id | An identifier that uniquely identifies this service attribute among others for the same merchant, eg "account-type". |
attribute_ name | A user-visible name for this attribute, eg "Account Type". |
value[] | All possible values for this service attribute. |
Ценить
Represents a possible value for a particular service attribute.
Поля | |
---|---|
value_ id | An identifier that uniquely identifies this value among others for this service attribute, eg "personal". |
value_ name | A user-visible name for the value, eg "Personal". |
ServiceAttributeValueId
Identifies a particular value of a service attribute to be applied to a Service.
Поля | |
---|---|
attribute_ id | ID of an attribute as defined in Merchant.service_attribute, eg "service-type". |
value_ id | ID of the value for this attribute, eg "haircut". Must match a value_id in the service attribute definition. |
ServiceAvailability
A list of availability and who/when they should be applied to.
Поля | |
---|---|
name | The resource name of the service to apply this to. In the format of |
start_ time_ restrict | If provided, we will consider the Availability entities provided to be a complete snapshot from [start_time_restrict, end_time_restrict). That is, all existing availability will be deleted if the following condition holds true:
If a duration message is set, the condition is further restricted:
If a resources_restrict message is set, the condition is further restricted:
These fields are typically used to provide a complete update of availability in a given time range. Setting start_time_restrict while leaving end_time_restrict unset is interpreted to mean all time beginning at start_time_restrict. |
end_ time_ restrict | Setting end_time_restrict while leaving start_time_restrict unset is interpreted to mean all time up to the end_time_restrict. |
duration_ restrict | Setting duration further restricts the scope of the update to just the availability with matching duration. |
resources_ restrict | Setting resources_restrict further restricts the scope of the update to just this set of resources. All id fields of the resources must match exactly. |
availability[] | The new list of availability. |
ServiceIntakeForm
Defines an intake form that customizes the service provided by a merchant.
Поля | |
---|---|
field[] | Fields that will be displayed to the user. |
first_time_customers | If true, this form will be shown to first time customers. Deprecated. This functionality is not supported for intake forms. |
returning_customers | If true, this form will be shown to repeat customers. Deprecated. This functionality is not supported for intake forms. |
ServiceIntakeFormField
Defines a field that is included in a ServiceIntakeForm.
Поля | |
---|---|
id | A string from an aggregator partner which uniquely identifies a form field. This id should be the same as the id in the corresponding form field answer and must be unique across both the service level and per ticket intake forms. (необходимый) |
type | The type of this field. |
label | The text shown to the user for this field. Deprecated, please use |
localized_ label | The text shown to the user for this field. The field can be supplied in multiple locales. (необходимый) |
value[] | Set if and only if the field type is LOCATION_SEARCH. Please use the "location_id" in the "location" field to specify the location value. |
choice_ text[] | Set if and only if the field type is MULTIPLE_CHOICE, CHECKBOXES, or DROPDOWN. Used to enumerate possible choices. |
is_ required | Indicates whether an answer to this field is required by a user. |
allow_ custom_ answer | Indicates whether a custom value is allowed in additional to predefined answers. This is only applicable when the field type is LOCATION_SEARCH. (необязательный) |
additional_ option[] | Additional options provided in addition to the provided values. Only applicable when the field type is LOCATION_SEARCH. Eg in addition to the provided location list, another available option can be "I will contact supplier later". (необязательный) |
ticket_ type_ restrict[] | If this question should only be shown when the user books certain ticket types, this field should be set as the set of applicable ticket type ids. Leave the field empty if the question is always applicable. |
hint | The hint text for input, which shows up as a text placeholder. This is only applicable when the field type is SHORT_ANSWER or PARAGRAPH. (необязательный) |
FieldType
Enum to indicate the type of field.
Enums | |
---|---|
FIELD_TYPE_UNSPECIFIED | Fields of unspecified or unknown type will be ignored. |
SHORT_ANSWER | A one-line input field for text. |
PARAGRAPH | A multi-line input field for text. |
MULTIPLE_CHOICE | A set of radio buttons that requires one choice from many options. |
CHECKBOXES | One or more enumerated items with checkboxes. |
DROPDOWN | A selection from a dropdown. |
BOOLEAN | A yes/no button. |
LOCATION_SEARCH | A search box that supports finding matched location given user input from provided location list. |
TaxRate
A tax rate applied when charging the user for a service, and which can be set on either a per merchant, or per service basis.
Поля | |
---|---|
micro_ percent | A tax rate in millionths of one percent, effectively giving 6 decimals of precision. For example, if the tax rate is 7.253%, this field should be set to 7253000. If this field is left unset or set to 0, the total price charged to a user for any service provided by this merchant is the exact price specified by Service.price. The service price is assumed to be exempt from or already inclusive of applicable taxes. Taxes will not be shown to the user as a separate line item. If this field is set to any nonzero value, the total price charged to a user for any service provided by this merchant will include the service price plus the tax assessed using the tax rate provided here. Fractions of the smallest currency unit (for example, fractions of one cent) will be rounded using nearest even rounding. Taxes will be shown to the user as a separate line item. |
Условия
A set of rules and guidelines that are displayed to the user in order to make a booking through Reserve with Google.
Поля | |
---|---|
url | Optionally, the URL to the Terms and Conditions. |
text | The text to be displayed to the user. Use localized_text below for new integrations. |
localized_ text | The localized text to be displayed to the user. |
Текст
A possibly-localized text payload. Some Text fields may contain marked-up content.
Поля | |
---|---|
value | Text value in an unknown locale. Required if and only if |
localized_ value[] | Per-locale text values. Необязательный. |
TicketType
TicketType is used to differentiate among tickets with different prices and/or availabilities due to different user types, different service attributes, or different options/add-ons.
A ticket is the minimal bookable unit to a service, eg a spot on a rafting trip, an admission to a museum, a full day double kayak rental.
Поля | |
---|---|
ticket_ type_ id | The ticket id is used to differentiate among different ticket types of the same service, and is only expected to be unique within a service. |
short_ description | A short description to this TicketType. This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Deprecated, use localized_short_description instead. |
localized_ short_ description | A short description to this TicketType with i18n support. This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Separate values could be supplied for each locale. |
price | The price of a single ticket of this type, exclusive of any taxes. The tax rate of Service is applied to its tickets. |
per_ ticket_ fee | Additional fees for purchasing this ticket. (необязательный) |
price_ display_ type | Необязательный. Predetermined price display type of a single ticket of this type. |
option_ description | Description of any additional option which this ticket type represents, if any. Deprecated, use localized_option_description instead. |
localized_ option_ description | Description of any additional option which this ticket type represents, if any. Separate values could be supplied for each locale. Additional options are useful when the ticket type represents multiple dimensions. Example 1: an admission ticket with different types 'adult', 'child' and language as an additional option, the expected TicketType list would be: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } } Example 2: an multi-hour kayak rental with optional dry bag add-on, the short_description could be "3 hours" and the option_description could be either "with dry bag" or "without dry bag": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } } Optional, but if any ticket type within the service has this field set, we expect all other ticket types to have this field set as well (a default option_description could be used). Eg [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] is not a valid list. Only two HTML formatting tags are supported: and |
inventory_ type | Необязательный. Predetermined inventory type of a single ticket of this type. |
InventoryType
Predetermined inventory type of a single ticket of this type.
Enums | |
---|---|
INVENTORY_TYPE_UNSPECIFIED | The inventory type is unspecified. |
INVENTORY_TYPE_PRIMARY | Primary inventory. |
INVENTORY_TYPE_VERIFIED_RESALE | Verified resale inventory. |
INVENTORY_TYPE_RESALE | Resale inventory. |
INVENTORY_TYPE_AGGREGATOR | Aggregator inventory. |
PriceDisplayType
Indicates the price format displayed on the landing page.
This field is ignored for non-link-out inventory.
This field allows Google surfaces to show the same price format as used byService the landing page. Consistent price formats improve conversion rate and reduce confusion.
Enums | |
---|---|
PRICE_DISPLAY_TYPE_UNSPECIFIED | The price display type is unspecified. Google will determine which format to show. |
PRICE_DISPLAY_TYPE_BASE | The price shown on the landing page is the base price. |
PRICE_DISPLAY_TYPE_ALL_IN | The price shown on the landing page includes all fees and taxes. |
TicketingVerticalSpecificData
Additional information unique to the event ticketing vertical.
Поля | |
---|---|
event_ category | The category of the event. Set only when event falls into one of the predefined categories. (необязательный) |
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. |
brand_ name | Необязательный. The localized brand name. |
event_ creator | Необязательный. Information about the creator of the event. |
AttendanceMode
The type of the event attendance.
Enums | |
---|---|
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.
Enums | |
---|---|
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.
Enums | |
---|---|
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.
Enums | |
---|---|
EVENT_CATEGORY_UNSPECIFIED | Не указан. Не используйте. |
EVENT_CATEGORY_CONCERT | Концерты. |
EVENT_CATEGORY_SPORTS | Sports events. |
EVENT_CATEGORY_THEATRE | Theatre events. |
EVENT_CATEGORY_EXHIBITS | Exhibits. |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES | Workshops and Classes. |
EventCreator
Information about the creator of the event. Only relevant for platforms that include user-generated content events.
Поля | |
---|---|
name | Необязательный. Name of the event creator. No character restriction. |
EventState
State of the event.
Enums | |
---|---|
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.
Enums | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED | Не указан. |
PERSON | For organizer who is a person. |
ORGANIZATION | For organizer who is an organization. |
PublicIdentificationData
Identifiers, webpages, or any other public sources that reference an entity.
Поля | |
---|---|
relevant_ url[] | Public URL of any webpage that is dedicated to only the topic. This could include official websites, discogs, social media platforms, wikipedia or imdb pages, eg https://www.discogs.com/artist/1124645-Taylor-Swift , https://www.wikidata.org/wiki/Q19320959 , https://twitter.com/acmilan . (необязательный) |
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) .
Enums | |
---|---|
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.
Поля | |
---|---|
Union field kind . Available options for parties that are out of range. kind can be only one of the following: | |
call_ merchant | Party sizes that are out of range can call the business. A predefined message will be displayed to the user. Sample text to be displayed: "For parties larger than {waitlist_rules.max_party_size} please call the restaurant at {phone}." CallMerchant must be set, but will be empty. |
UpdateAdsAccountLinkRequest
Request message for AdsAccountLinkingService.UpdateAdsAccountLink.
Поля | |
---|---|
ads_ account_ link | Необходимый. The Ads account link to update. The AdsAccountLink's |
update_ mask | Необязательный. The list of fields to update. |
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 | Field mask of all order fields to be updated |
order | The order to be updated |
UpdateServiceRequest
The request to update a Service
.
Поля | |
---|---|
service | The new service data. |
update_ mask | The specific fields to update for the service. |
UriTemplate
A template specifying how Google should generate URLs to external site.
Поля | |
---|---|
uri_ template | Необязательный. The uri template must follow the RFC6570, see https://datatracker.ietf.org/doc/html/rfc6570 . Supports Level 2 templates. These parameters will be resolved to their values specified in their respective entities. 5 available parameters for Dining Reservation Linkout: 1) (required) {availability_slot_start_seconds} :: populated from start_sec field in availability feed 2) (required) {availability_slot_duration_seconds} :: populated from duration_sec field in availability feed 3) (optional) {resources_party_size} :: populated from party_size field in availability feed 4) (optional) {availability_availability_tag} :: populated from availability_tag field in availability feed 5) (optional) {resources_room_id} :: populated from room_id field in availability feed Example Usage: http://example.com/book/restaurant?start={availability_slot_start_seconds } &num_guests={resources_party_size} * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&num_guests=2 |
UserPurchaseRestriction
Restricts the users eligible to purchase a payment option.
Поля | |
---|---|
new_ to_ merchant | A payment option that can only be purchased by users who have never purchased from the same merchant before. |
new_ to_ payment_ option | A payment option that can only be purchased by users who have never purchased the same payment option before. |
VirtualSession
Information about virtual/online session. Eg Online yoga class, virtual cooking class etc.
Поля | |
---|---|
session_ instructions | Instructions on how this virtual class is set up. If the partner does not include the video URL with the booking, then this text must include when the video URL will be shared with the user. Например. “Zoom url will be mailed 30 minutes prior to the class”. (Recommended) |
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.
Enums | |
---|---|
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 | 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. |