Package google.maps.booking.v1alpha

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

repeat_every

ExtendedServiceAvailability

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

Пример. Доступность с продолжительностью 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`	`TimeRange` Временной диапазон исключения. Любые слоты, описанные повторением, которые перекрывают этот диапазон времени закрытия-открытия, будут считаться недоступными. Пример. Если для повторения указана продолжительность 20 минут, значение повторения every – 30 минут, время начала – 9:00 утра и значение повтора_до 11:00, то исключение ScheduleException с диапазоном времени (time_range) 9:45–11:00 сделает недоступным слоты с 9:30 до 9:50, с 10 до 10:20 и с 10:30 до 10:50. Обратите внимание: поскольку временной диапазон закрыт-открыт, интервал, начинающийся в 11 утра, не будет затронут.

time_range

TimeRange

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

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

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

ПланированиеRuleOverrides

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

Поля

Поля
`last_bookable_sec`	`int64` Последний раз (в секундах), когда этот слот можно зарезервировать. Эта временная метка должна быть раньше start_sec интервала, который необходимо учитывать (если пользователи должны иметь возможность бронировать после времени начала, используйте уровень обслуживания SchedulingRules.min_booking_before_end_time). Если он присутствует, он переопределяет все, указанное в min_booking_buffer правил планирования соответствующей службы.
`first_bookable_sec`	`int64` Первый раз (в секундах), когда этот слот можно зарезервировать. Эта временная метка должна быть до start_sec слота или Last_bookable_sec, если указано.
`last_online_cancellable_sec`	`int64` Если установлено, это последний раз (в секундах с эпохи Unix), когда этот конкретный интервал встречи можно отменить с помощью функции «Зарезервировать в Google». Это поле будет иметь приоритет над любыми правилами отмены на уровне обслуживания. (необязательный)

last_bookable_sec

int64

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

first_bookable_sec

int64

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

last_online_cancellable_sec

int64

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

Пакетное удалениеGenericRecordsRequest

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

Поля

Поля
`parent`	`string` Имя ресурса в формате — `partners/{partner_id}/feeds/{feed_name}` .
`records[]`	`GenericDeleteRecord` Записи, подлежащие удалению. В одном вызове API допускается максимум 1000 записей.

parent

string

Имя ресурса в формате — partners/{partner_id}/feeds/{feed_name} .

records[]

GenericDeleteRecord

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

Пакетный пушдженерикрекреквест

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

Поля

Поля
`parent`	`string` Имя ресурса в формате — `partners/{partner_id}/feeds/{feed_name}` .
`records[]`	`GenericRecord` Записи, которые необходимо вставить и/или обновить. В одном вызове API допускается максимум 1000 записей.

parent

string

Имя ресурса в формате — partners/{partner_id}/feeds/{feed_name} .

records[]

GenericRecord

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

Пакетная заменаServiceAvailabilityRequest

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

Поля

Поля
`parent`	`string` Формат `partners/{partner_id}` .
`extended_service_availability[]`	`ExtendedServiceAvailability` Расширенная доступность службы, которая используется для замены существующих слотов доступности.

parent

string

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

extended_service_availability[]

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

BatchReplaceServiceAvailabilityResponse

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

Поля

Поля
`extended_service_availability[]`	`ExtendedServiceAvailability` Успешно обновленные расширенные сообщения о доступности службы, которые использовались для замены существующих слотов доступности.

extended_service_availability[]

ExtendedServiceAvailability

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

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

Бронирование слота инвентаря

Поля
`name`	`string` Имя ресурса бронирования: `partners/{partner ID}/bookings/{booking ID}`
`merchant_id`	`string` ID торговца для слота
`service_id`	`string` Идентификатор мерчант-сервиса
`start_time`	`Timestamp` Время начала интервала встречи
`duration`	`Duration` Продолжительность интервала встречи
`client_information`	`ClientInformation` Персональные данные клиента, записывающегося на прием
`status`	`BookingStatus` Статус бронирования
`payment_information`	`PaymentInformation` Информация о платежных операциях, связанных с бронированием.
`party_size`	`int64` Размер вечеринки при бронировании

Ошибка бронирования

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

Поля
`cause`	`Cause` Причина, по которой бронирование не удалось. (необходимый)
`rejected_card_type`	`CreditCardType` (требуется только в том случае, если причина PAYMENT_ERROR_CARD_TYPE_REJECTED)
`description`	`string` Это необязательное поле используется партнером для включения дополнительной информации только в целях отладки. (необязательный)
`payment_failure`	`PaymentFailureInformation` Информация о сбоях в оплате.

Причина

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

Перечисления
`CAUSE_UNSPECIFIED`	Значение по умолчанию: Не использовать; представляет собой «неизвестную ошибку»
`SLOT_UNAVAILABLE`	Указанный интервал доступности больше не доступен.
`SLOT_ALREADY_BOOKED_BY_USER`	Пользователь уже забронировал встречу для указанного интервала доступности.
`LEASE_EXPIRED`	Срок аренды (если предоставлен) истек, и его больше нельзя использовать для завершения запрошенного бронирования.
`OUTSIDE_CANCELLATION_WINDOW`	Запрошенную отмену невозможно выполнить в настоящее время из-за ограничений по времени, установленных политикой отмены продавца.
`PAYMENT_ERROR_CARD_TYPE_REJECTED`	При обработке платежа произошла ошибка, поскольку указанный тип кредитной карты не был принят продавцом. Тип кредитной карты должен быть указан в поле 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`	`ThreeDS1Parameters` Параметры, используемые агрегатором RwG для инициирования протокола аутентификации 3DS1 с пользователем. Будет игнорироваться, если для BookingFailure.cause не установлено значение PAYMENT_REQUIRES_3DS1.

threeds1_parameters

ThreeDS1Parameters

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

ТриDS1Параметры

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

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

Поля
`acs_url`	`string` URL-адрес, с которого можно загрузить форму, которая будет предоставлена Пользователю для аутентификации.
`pa_req`	`string` Запрос аутентификации платежа. Будет опубликовано в форме ACSUrl, если она имеется.
`transaction_id`	`string` Идентификатор, используемый поставщиком ACS. Будет опубликовано в форме ACSUrl, если она имеется.
`md_merchant_data`	`string` Данные о торговце. Будет опубликовано в форме ACSUrl, если она имеется.

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

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

CallMerchant

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

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

Политика отмены услуги.

Поля

Поля
`refund_condition[]`	`RefundCondition` Ноль или более условий возврата, применимых к полису.

refund_condition[]

RefundCondition

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

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

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

Поля

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

min_duration_before_start_time

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

refund_percent

uint32

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

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

Личная информация о лице, осуществляющем бронирование

Поля
`given_name`	`string` Имя клиента
`family_name`	`string` Фамилия клиента
`address`	`PostalAddress` Адрес клиента
`telephone`	`string` Телефон клиента
`email`	`string` Адрес электронной почты клиента

Создать запрос продавца

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

Поля

Поля
`parent`	`string` Имя родительского ресурса для партнера, которому принадлежит этот продавец, в формате `partners/{partner_id}` .
`merchant_id`	`string` Идентификатор продавца, который будет использоваться для этого продавца.
`merchant`	`Merchant` Торговец для создания.

parent

string

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

merchant_id

string

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

merchant

Merchant

Торговец для создания.

CreateServiceRequest

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

Поля

Поля
`parent`	`string` Имя родительского ресурса для продавца, которому принадлежит эта услуга, в формате `partners/{partner_id}/merchants/{merchant_id}` .
`service_id`	`string` Идентификатор службы, который будет использоваться для этой службы.
`service`	`Service` Сервис для создания.

parent

string

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

service_id

string

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

service

Service

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

Кредитная картаОграничения

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

Поля

Поля
`credit_card_type[]`	`CreditCardType` Список поддерживаемых кредитных карт. Кредитные карты не поддерживаются, если они пусты.

credit_card_type[]

CreditCardType

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

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

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

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

Удалить запрос продавца

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

Поля

Поля
`name`	`string` Имя ресурса продавца, которого требуется удалить. В формате партнеры/{partner_id}/merchants/{merchant_id}

name

string

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

Удалить запрос службы

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

Поля

Поля
`name`	`string` Имя ресурса службы, которую необходимо удалить. В формате `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`

name

string

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

Депозит

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

Поля

Поля
`deposit`	`Price` Сумма вклада.
`min_advance_cancellation_sec`	`int64` Минимальная предварительная отмена депозита.
`deposit_type`	`PriceType` Определяет способ определения депозита на основе доступности.

deposit

Сумма вклада.

min_advance_cancellation_sec

int64

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

deposit_type

PriceType

Определяет способ определения депозита на основе доступности.

DirectMerchantОплата

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

Поля

Поля
`payment_methods[]`	`Text` Пользователям рекомендуется осуществлять оплату только способами оплаты, указанными ниже.

payment_methods[]

Text

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

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

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

Поля

Поля
`min_duration`	`Duration` Минимальная продолжительность.
`max_duration`	`Duration` Максимальная продолжительность.

min_duration

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

max_duration

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

Экстендедсервицедоступность

Список доступности и к кому/когда их следует применять.

Поля
`merchant_id`	`string` Это обязательное поле, необходимое для указания продавца, которому принадлежат приведенные ниже сообщения о доступности.
`service_id`	`string` Это обязательное поле, необходимое для указания того, к какой службе относятся приведенные ниже сообщения о доступности.
`start_time_restrict`	`Timestamp` Если предоставлено, мы будем считать предоставленные объекты доступности полным снимком из [start_time_restrict, end_time_restrict). То есть вся существующая доступность будет удалена, если выполняется следующее условие: `start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict` Если установлено сообщение о продолжительности, условие дополнительно ограничивается: `availability.duration == duration_restrict` Если установлено сообщение resources_restrict, условие дополнительно ограничивается: `availability.resources.staff_id == resources_restrict.staff_id && availability.resources.room_id == resources_restrict.room_id` Эти поля обычно используются для предоставления полной информации о доступности в заданном диапазоне времени. Установка start_time_restrict при оставлении end_time_restrict неустановленным интерпретируется как означает все время, начиная с start_time_restrict.
`end_time_restrict`	`Timestamp` Установка end_time_restrict при оставлении start_time_restrict неустановленным интерпретируется как означает все время до end_time_restrict.
`duration_restrict`	`Duration` Установка продолжительности еще больше ограничивает объем обновления только доступностью соответствующей продолжительности.
`resources_restrict`	`Resources` Установка resources_restrict дополнительно ограничивает область обновления только этим набором ресурсов. Все поля идентификаторов ресурсов должны точно совпадать.
`availability[]`	`Availability` Новый список наличия.

FeedStatistics

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

Поля

new_items

int64

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

existing_items

int64

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

deleted_items

int64

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

Статус фида

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

Поля
`name`	`string` Имя ресурса канала, имеющее формат `partners/{partner_id}/feeds/merchants/{file_name}` `partners/{partner_id}/feeds/services/{file_name}` `partners/{partner_id}/feeds/availability/{file_name}`
`state`	`State` Статус обработки этого фида.
`error_details`	`string` Читаемая человеком строка, предоставляющая более подробную информацию, если нам не удалось обработать этот канал.
`statistics`	`FeedStatistics` Статистика, специфичная для этого фида.

Состояние

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

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

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

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

Поля
`fee_details[]`	`FeeDetails` Подробная информация о комиссиях, взимаемых с пользователя сверх общей суммы товара. Повторяется для различных типов сборов, таких как плата за обслуживание, плата за доставку и т. д.
`advance_order_details`	`AdvanceOrderDetails` Подробная информация о расширенной поддержке заказа, также известной как предварительный заказ, когда пользователь может разместить заказ для выполнения в более позднее время, чем прямо сейчас.
Поле объединения `fulfillment_duration_options` . Продолжительность времени выполнения заказа с момента подтверждения заказа. Для заказов на доставку — продолжительность времени до доставки еды. Для заказов на самовывоз — время, в течение которого еда будет готова к самовывозу. `fulfillment_duration_options` может быть только одним из следующих:
`fulfillment_lead_time_duration`	`Duration` Фиксированная продолжительность. Например: 30 минут.
`fulfillment_lead_time_duration_range`	`DurationRange` Диапазон продолжительности. Примеры: * От 30 до 45 минут * Более 30 минут * Менее 50 минут

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

Для поддержки заказа вперед.

Поля

is_supported

bool

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

Подробности о плате

Подробности о плате.

Поля

type

FeeType

Тип комиссии. (необходимый)

fee_amount

FeeAmount

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

Величина платежа

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

Поля
`cart_percentage`	`QuantitativeValue` Комиссия в виде процента от стоимости корзины. Поддерживает диапазон (ограниченный и неограниченный) или фиксированный процент. Значение должно быть от 0 до 100. Примеры: * Фиксировано 5,5 % * Не менее 5,5 % * Не более 5,5 % * От 4,5 % до 5,5 %.
Поле объединения `amount_options` . Варианты указания денежной суммы. `amount_options` может быть только одним из следующих:
`amount`	`Money` Фиксированное количество. Например, 3,5 доллара США.
`amount_range`	`MoneyRange` Диапазон суммы. Примеры: * От 3,5 до 5,5 долларов США * Не менее 3,5 долларов США * Не более 5,5 долларов США
`amount_unknown`	`bool` Неизвестная сумма.

Тип комиссии

Тип комиссии.

Перечисления
`FEE_TYPE_UNSPECIFIED`	Тип комиссии не указан.
`DELIVERY`	За оплату доставки.
`SERVICE`	За плату за обслуживание.

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

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

Поля
`fulfillment_type`	`FulfillmentType` Необходимый. Тип выполнения.
`available_day[]`	`AvailableDay` Необходимый. Список дней, в которые доступен данный способ выполнения (желательно не менее 2).
`fee_details`	`FeeDetails` Необходимый. Детали комиссии для метода выполнения.
`minimum_order`	`Price` Необходимый. Минимальный заказ для метода выполнения, связанного со ссылкой действия.

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

Доступность дневного уровня.

Поля

fulfillment_date

Date

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

last_ordering_time

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

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

Подробности о плате

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

Поля
Поле объединения `fee_details` . Модель вознаграждения для метода выполнения. `fee_details` может быть только одним из следующих:
`no_fee`	`NoFee` Никакой комиссии за способ выполнения.
`base_fee`	`MinimumFee` Базовая комиссия, связанная с методом выполнения.
`fixed_fee`	`FixedFee` Фиксированная комиссия, связанная со способом выполнения.

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

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

Поля

amount

Необходимый. Размер фиксированной комиссии за способ исполнения.

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

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

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

Минимальная комиссия

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

Поля

base_fee_amount

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

Без платы

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

GenericDeleteRecord

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

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

GenericRecord

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

Поля
`generation_timestamp`	`Timestamp` Необходимый. Эта метка времени используется для обеспечения правильного упорядочения обновлений инвентаризации.
Союз полевой `record_type` . Инкапсуляции различных типов подачи (NDJSON, Proto на основе и т. Д.) `record_type` может быть только одним из следующих:
`data_record`	`bytes` Для непротологических каналов.
`proto_record`	`Any` Для прото на основе каналов.

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

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

Поля
`latitude`	`double` Широта в градусах. (необязательный)
`longitude`	`double` Долгота в градусах. (необязательный)
Полевые `addresses` профсоюза. Адрес для местоположения, может быть структурирован или неструктурирован. `addresses` могут быть только одним из следующих:
`address`	`PostalAddress` Почтовый адрес местоположения, предпочтительный.
`unstructured_address`	`string` Неструктурированный адрес также может быть предоставлен в качестве запасного. Например "1600 Amphitheater Parkway Mountain View, CA 94043"

GetmerchantstatusRequest

Просьба получить MerchantStatus

Поля

name

string

Необходимый. Имя ресурса, в формате партнеров/{partner_id}/merchants/{merchant_id}/status.

GetStatusRequest

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

Поля

name

string

Имя ресурса канала, имеющее формат

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

HomeServicedata

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

Поля

category_type

string

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

job_type

string

Тип работы в соответствии с категорией, которой принадлежит данное домашнее обслуживание. Например, unclog_drain, install_faucet - типы заданий в категории сантехника.

IntegrationType

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

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

InvalidateresourceRequest

Запрос на признание ресурса.

Поля

resource_id

string

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

Например, для ресурса пикапа имя должно иметь формат partners/{partner_id}/pickups/{pickup_id} . Реализации должны удалять кэшированные версии идентифицированного ресурса.

Линейный элемент

Один предмет в заказе-бронирование одного сервиса за один раз.

Поля
`service_id`	`string` Удостоверение личности торговой службы.
`start_sec`	`int64` Начало время назначения слота в считанные секунды времени UTC со времен Unix Epoch.
`duration_sec`	`int64` Продолжительность слота назначения за считанные секунды.
`tickets[]`	`OrderedTickets` Количество билетов, заказанных типом билета.
`price`	`Price` Общая цена (за исключением налогов) этой позиции.
`status`	`BookingStatus` Статус позиции.

Заказано

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

Поля

ticket_id

string

Удостоверение личности типа билета.

count

int32

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

ListmerChantStatusErquest

Запрос получить список MerchantStatus

Поля
`parent`	`string` Необходимый. Родитель, который владеет этой коллекцией статуса продавца. Формат: `partners/{partner_id}/merchants`
`page_size`	`int32` Необходимый. Максимальное количество товаров для возврата. Обратите внимание, что сервер может уменьшить размер страницы.
`page_token`	`string` Необязательный. Значение NextPageToken, возвращаемое из предыдущего ListMerChantStatusResponse, если таковые имеются.
`booking_inventory_status_restrict`	`BookingInventoryStatus` Необязательный. Необязательное ограничение для фильтрации результатов путем бронирования статуса инвентаря.
`waitlist_inventory_status_restrict`	`WaitlistInventoryStatus` Необязательный. Необязательное ограничение для фильтрации результатов по статусу инвентаризации ожидания.
`geo_match_restrict`	`GeoMatchingStatus` Необязательный. Необязательное ограничение для фильтрации результатов с помощью статуса сопоставления 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[]

MerchantStatus

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

next_page_token

string

Токен, чтобы получить следующую страницу результатов. В списке больше нет результатов, если пустые.

ListStatusRequest

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

Поля
`name`	`string` Имя ресурса канала, имеющее формат `partners/{partner_id}/feeds/merchants` `partners/{partner_id}/feeds/services` `partners/{partner_id}/feeds/availability`
`page_size`	`int32` Максимальное количество товаров для возврата.
`page_token`	`string` Значение next_page_token возвращается из предыдущего запроса списка, если таковые имеются.
`state_restrict`	`State` Дополнительное ограничение для фильтрации результатов с помощью состояния подачи.
`time_range_restrict`	`TimeRange` Необязательное ограничение для фильтрации результатов по верхней и нижней границе. Если start_time не истекает, это по умолчанию в начале Unix Time. Если End_time не будет, он будет по умолчанию.

ListStatusResponse

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

Поля

status[]

FeedStatus

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

next_page_token

string

Токен, чтобы получить следующую страницу результатов. В списке больше нет результатов, если пустые.

Локализованное построение

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

Поля

locale

string

IETF BCP 47 Языковой код, такой как «en», «mas», «zh-hant», «de-ch-1901». См. Http://www.w3.org/international/articles/language-tags/ .

value

string

Сообщение в локале выше (UTF-8).

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

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

Поля
`place_id`	`string` Идентификатор места для места в базе данных Google Place и на картах Google. См . Если это будет предоставлено, Google будет соответствовать местоположению с этим местом.
`name`	`string` Название местоположения, телефон, URL и GEO используются для поддержки сопоставления местоположения с местами, которые уже присутствуют на картах Google. Это поле не является обязательным, но может потребоваться в некоторых контекстах. Например, услуга. Расположение без имени не будет сопоставлена с бизнесом, даже если они расположены по одному и тому же адресу. (необязательный)
`telephone`	`string` Общественный номер телефона места, включая его коды страны и зоны, например, +14567891234. (необязательный)
`url`	`string` URL -адрес общественного сайта местоположения. (необязательный)
`geo`	`GeoCoordinates` Гео информация о местоположении, включая широту, долготу и адрес. (необязательный)
`location_type`	`LocationType` Тип местоположения должен быть предоставлен, если это место предоставляется для обслуживания.
`location_id`	`string` Уникальная ссылка на местоположение в службе. Этот идентификатор может быть использован для обозначения этого места в других областях обслуживания. Например, в пользовательской форме впуска можно использовать набор идентификаторов местоположения для указания параметров местоположения. Если установлен, этот идентификатор должен быть уникальным в той же службе. (необязательный)

LocationType

Тип этого места.

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

Торговец

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

Поля
`name`	`string` Имя ресурса продавца, которое имеет формат `partners/{partner_id}/merchants/{merchant_id}` .
`merchant_name`	`string` Merchant_Name, телефон, URL и GEO используются для поддержки подходящего инвентаря партнеров с продавцами, уже присутствующими на картах Google. Эта информация не будет отображаться. Имя торговца.
`telephone`	`string` Общественный номер телефона продавца, включая его страну и коды зон, например, +14567891234.
`url`	`string` URL публичного веб -сайта продавца.
`geo`	`GeoCoordinates` Гео информация о продавцах, включая широту, долготу и адрес.
`category`	`string` Категория бизнеса в платформе агрегатора.
`num_bookings_30d (deprecated)`	`int64` Этот товар устарел! Это поле устарело.
`tax_rate_basis_points (deprecated)`	`uint32` Этот товар устарел! Налоговая ставка продавца в базисных пунктах (один сотый процент). Например, если налоговая ставка составляет 7,5%, это поле должно быть установлено на 750. Если это поле остается бездействующим или устанавливается на 0, общая цена, взимаемая пользователю за любую услугу, предоставленную этим продавцом, является точной ценой, указанной Service.Price. Предполагается, что цена обслуживания освобождается от или уже включающая применимые налоги. Налоги не будут показаны пользователю как отдельную строку. Если это поле установлено на какую -либо ненулевую стоимость, общая цена, взимаемая пользователю за любую услугу, предоставленную этим продавцом, будет включать цену обслуживания плюс налог, оцененный с использованием налоговой ставки, предоставленной здесь. Фракции самой маленькой валютной единицы (например, фракции одного цента) будут округлены с использованием ближайшего даже округления. Налоги будут показаны пользователю в виде отдельной строки. Это поле устарело, пожалуйста, используйте вместо этого Tax_Rate.
`tax_rate`	`TaxRate` Налоговая ставка продавца. Если это поле переопределяет устаревшее поле TAX_RATE_BASIS_POINTS. Пустое сообщение (то есть Tax_rate {}) сбросит прикладную налоговую ставку до нуля.
`payment_restrictions`	`PaymentRestrictions` Ограничения на методы оплаты, которые принимает этот торговец. Мы предполагаем, что никаких ограничений не существует, если это поле не установлено.
`payment_option[]`	`PaymentOption` Варианты оплаты доступны для этого продавца. Услуги в соответствии с этим продавцом смогут индивидуально ограничивать варианты оплаты, которые они разрешают.
`payment_processor_config (deprecated)`	`PaymentProcessorConfig` Этот товар устарел! Конфигурация для процессора токенизированного платежа, если продавец имеет поддержку.
`tokenization_config`	`TokenizationConfig` Конфигурация для процессора токенизированного платежа, если продавец имеет поддержку.
`terms`	`Terms` Условия конкретного продавца, отображаемые пользователю, когда сервис забронируется через резерв в Google. В дополнение к этим условия и условия партнера агрегатора всегда отображаются пользователю и не должны быть предоставлены здесь.
`brand_id`	`string` Непрозрачная строка, которая идентифицирует бренд, ориентированную на потребителя, для отображения атрибуции партнера. Это поле позволяет партнерам с несколькими брендами, ориентированными на потребителя, предоставлять продавцов для всех брендов в пределах одного и того же корма. Бренд состоит из свойств, ориентированных на потребителя, таких как название, логотип, условия обслуживания и политика конфиденциальности. Если есть только один партнерский бренд, обращенный на потребителя, это поле не нужно устанавливать и может быть проигнорировано. Если партнер ... У вас нет нескольких брендов, ориентированных на потребителя? -> Игнорировать это поле Настроены несколько брендов? `If this field is set --> Associated consumer-facing brand attribution is used If this field is unset or the empty string --> Default consumer-facing brand attribution is used` Тщательно примечание: большинству партнеров не нужно устанавливать это поле. Если партнер хочет использовать это поле, он должен сначала связаться с нами, чтобы настроить отдельные бренды, включая бренд по умолчанию.
`matching_hints`	`MerchantMatchingHints` Намекает, чтобы помочь Google соответствовать продавцу с местом на картах Google. Примечание. Большинству партнеров не нужно устанавливать это поле, так как Google будет совпадать с торговцами с местами на картах Google, используя информацию, представленную выше. (необязательный)
`service_attribute[]`	`ServiceAttribute` Определения для любых атрибутов сервиса, используемых для описания услуг для этого продавца. (необязательный)
`action_link[]`	`ActionLink` Необязательный. URL -адрес действия с ассоциированным языком, список стран, ограниченных типом и необязательной платформой, которая указывает, на какую платформу следует выполнять это действие,
`waitlist_advisement`	`Advisement` Необязательный. Общие рекомендации от конкретного продавца для пользователя, присоединившегося к списку ожидания через резерв с Google. Индивидуальные текстовые поля в консультировании должны быть ограничены длиной 100 байтов.

MerchantMatchingHints

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

Поля

place_id

string

Идентификатор места для места в базе данных Google Place и на картах Google. См .

Merchantstatus

Статус продавца в резерве с платформой Google.

Поля
`name`	`string` Имя ресурса торговца, которое имеет формат `partners/{partner_id}/merchants/{merchant_id}/status`
`merchant_name`	`string` Название продавца, предоставленного партнерами.
`input_geo_info`	`GeoCoordinates` Партнеры предоставили GEO Информацию о продавцах.
`processing_status`	`ProcessingStatus` Торговая обработка статус.
`booking_status`	`BookingStatus` Статус, связанный с комплексной интеграцией бронирования.
`waitlist_status`	`WaitlistStatus` Статус, связанный с интеграцией ожидания.
`geo_match`	`PlaceInfo` Соответствует гео -месту этого продавца. Пусто, если торговец не сопоставлен.
`local_services_match`	`LocalServicesMatchInfo` Местная услуга совпадает с этим продавцом. Пусто, если он не является местным продавцом услуг или не соответствует каким -либо поставщикам.
`direct_urls[]`	`DirectUrl` Список URL -адресов, чтобы продемонстрировать содержание текущего торгового запаса. Обратите внимание, что это не означает, что инвентарь на самом деле обслуживается, а URL может отличаться от общественных видимых.

BookingStatus

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

Поля

has_valid_future_inventory

bool

Правда, если у продавца есть инвентарь в течение следующих 30 дней. Не гарантирует, что торговец фактически обслуживается.

Directurl

URL, который выдерживает продавца.

Поля

type

UrlType

Тип этого URL.

url

string

URL, который может вспять этого продавца.

Urltype

Тип URL -адреса.

Перечисления
`URL_TYPE_UNSPECIFIED`	Не указан.
`BOOKING`	Сквозное URL.
`WAITLIST`	Стоинный URL-адрес ожидания.
`LOCAL_SERVICES`	Google Local Services URL.

LocalServicesMatchInfo

Информация о Mocal Services Services Match (установлена только для местного торговца услуг).

Поля

matched_providers[]

MatchedProvider

Сопоставленные поставщики услуг. Торговец может быть сопоставлен с несколькими поставщиками услуг.

MatchedProvider

Местный поставщик услуг.

Поля

customer_id

int64

Google Local Services Внешний идентификатор клиента.

categories[]

string

Локальные категории обслуживания (вертикали). Например, «Сантехник» и «Carpet_cleaning».

Placeinfo

Информация о соответствующем месте.

Поля

name

string

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

formatted_address

string

Отформатированный адрес на местном языке.

place_id

string

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

bool

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

Деньги

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

Поля

min_amount

Money

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

max_amount

Money

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

Noshowfee

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

Поля

fee

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

fee_type

PriceType

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

Заказ

Заказ на встречу с продавцом.

Поля
`name`	`string` Имя ресурса заказа: `partners/{partner ID}/orders/{order ID}`
`client_information`	`ClientInformation` Личная информация клиента, делающего заказ.
`payment_information`	`PaymentInformation` Информация о платежных транзакциях, которые относятся к заказу.
`merchant_id`	`string` Удостоверение личности продавца, к которому принадлежат все услуги в этом порядке.
`item[]`	`LineItem` Статьи в этом порядке.

Orderonlinemetadata

Метаданные для ссылки на Online Action Online.

Поля

fulfillment_option[]

FulfillmentOption

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

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

Детали платежа, которые относятся к бронированию

Поля

prepayment_status

PrepaymentStatus

Статус предоплаты бронирования. Если предоплата - предоплата по предоплате или предоплату или предоплату_Рефандированного, то платеж_ transaction_id содержит связанный уникальный идентификатор транзакции.

payment_transaction_id

string

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

Платежон

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

Поля
`payment_option_id`	`string` Этот идентификатор используется для определения этой опции оплаты. Этот идентификатор является глобальным для всего агрегатора, и повторное использование значения между несколькими торговцами позволит пользователю платить с соответствующим вариантом оплаты в этих продавцах. При повторном использовании идентификатора Accoss несколько продавцов обновление любого значения для опции оплаты под одним продавцом также обновит любой другой вариант оплаты с одним и тем же идентификатором под другим продавцом. Таким образом, наилучшая практика - иметь все варианты оплаты, разделяющие один и тот же идентификатор, всегда обновляются до идентичных значений, чтобы избежать любой возможности подминистского поведения.
`name`	`string` Название опции оплаты. Это может быть видимым пользователем.
`description`	`string` Описание опции оплаты. Это может быть видимым пользователем.
`price`	`Price` Цена опции оплаты.
`tax_rate`	`TaxRate` Налоговая ставка для этого варианта оплаты. Если присутствовать, это поле переопределяет поле Tax_Rate, присутствующее в продавце или услуге. Пустое сообщение (то есть Tax_rate {}) сбросит прикладную налоговую ставку до нуля.
`payment_option_type`	`PaymentOptionType` Тип этого варианта оплаты. Одноразовое использование для бросков, многофункциональное использование пакетов и неограниченное для членства.
`session_count`	`int64` Сколько сессий можно использовать этот вариант оплаты. Действительно только для мультисессионных / пакетов, где значение должно быть> 1.
`purchase_interval`	`TimeRange` Вариант оплаты может быть приобретен в этом интервале.
`valid_interval`	`TimeRange` Вариант оплаты может использоваться в этом интервале (например, специальная цена за январь 2017 года). Если присутствует, это переопределяет valive_duration и activation_type.
`valid_duration`	`Duration` Продолжительность варианта оплаты (например, 30 -дневное членство).
`activation_type`	`ActivationType` Определяет, как определяется дата начала достоверности для этого варианта оплаты.
`user_restriction`	`UserPurchaseRestriction` Ограничивает пользователи, имеющие право на покупку этого варианта оплаты. Может использоваться для ограничения опции рекламного платежа подмножеством пользователей. Если не установлено, все пользователи имеют право.

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

Processor

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

public_key

string

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

Для полосы , см .

version

string

Номер версии API, отправленный платежным процессору вместе с запросами на оплату.

Процессор

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

Перечисления
`PROCESSOR_UNSPECIFIED`	Неиспользованный
`PROCESSOR_STRIPE`	Конфигурация для платежей с полосой.
`PROCESSOR_BRAINTREE`	Конфигурация для платежей с Braintree.

Платежеса

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

Поля

credit_card_restrictions

CreditCardRestrictions

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

Perorderfee

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

Поля

delivery_fee

Плата, которая может варьироваться в зависимости от метода доставки.

processing_fee

Плата за обработку метода оплаты пользователя.

Perticketfee

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

Поля

service_charge

Дополнительная плата оценивается за услугу.

facility_fee

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

taxes

За налоги на билеты.

Почтовый адрес

Адрес клиента или бизнес.

Поля
`address_country`	`string` Страна, указанная с использованием его ISO 3166-1 Код страны Альфа-2, например, «США» (обязательно)
`address_locality`	`string` Местность, например, «Маунтин -Вью». (необходимый)
`address_region`	`string` Регион, например, "CA". Эта область требуется только в странах, где регион обычно является частью адреса. (необязательный)
`postal_code`	`string` Почтовый код, например, "94043". (необходимый)
`street_address`	`string` Уличный адрес, например, "1600 амфитеатр pkwy". (необходимый)

Предоплата

Статус предоплаты бронирования.

Перечисления
`PREPAYMENT_STATUS_UNSPECIFIED`	Не указано, по умолчанию предоплате_not_provided.
`PREPAYMENT_PROVIDED`	Плата за бронирование была оплачена заранее.
`PREPAYMENT_NOT_PROVIDED`	Плата за бронирование не была оплачена заранее.
`PREPAYMENT_REFUNDED`	Плата ранее была предоплачена, но теперь была возвращена.

Цена

Цена услуги или плата.

Поля
`price_micros`	`int64` Цена в микро-единицах валюты. Фракции самого маленького валютного блока будут округлены с использованием ближайшего даже округления. (Например, за 2,5 цента в 2,5 цента, округлые до 2 центов, 3,5 цента округливы до 4 центов, 0,5 цента округливы до 0 центов, 2,51 цента округливы до 3 центов).
`currency_code`	`string` Валюта цены, которая определена в ISO 4217.
`pricing_option_tag`	`string` Необязательная и непрозрачная строка, которая идентифицирует вариант ценообразования, который связан с расширенной ценой.

Цена интерпретации

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

Перечисления
`PRICE_INTERPRETATION_UNSPECIFIED`	Интерпретация цен не указана, по умолчанию exact_amount.
`EXACT_AMOUNT`	Когда цена должна интерпретироваться как конкретное значение. Примеры: $ 20 для занятий йогой; 15 долларов за стрижку ребенка
`STARTS_AT`	Когда цена обслуживания переменная, но минимальная цена известна и отображается потребителям. Потребители могут сделать выбор, которые повышают цену. Обратите внимание, что любая услуга, которая использует эту цену интерпретации, должна использовать предоплату not_supported. Примеры: 30 долларов за уход за собаками, но дополнительный выбор потребителей может повысить цену
`NOT_DISPLAYED`	Когда цена услуги является переменной, а информация о цене не отображается потребителям заранее. Обратите внимание, что любая услуга, которая использует эту цену интерпретации, должна использовать предоплату not_supported, и цена должна быть пустой. Примеры: консультация по домашнему обслуживанию

Причетип

Определяет, как общая цена определяется по доступности.

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

FIXED_RATE_DEFAULT

Цена на фиксированную сумму. Это значение по умолчанию, если поле не установлено.

Примеры: зарезервированный зарезервированный таблицу за 50 долларов; $ 20 НЕТ ПРОТИВОСТА

PER_PERSON

Указанная цена на человека, а общая цена рассчитывается в соответствии с размером стороны, указанным в ресурсах, как цена_micros * party_size. Цена Per_person должна сопровождаться размером партии в ресурсах доступности. Если это не так, используется размер партии.

Примеры: по 10 долларов за билеты в музей

QuantitativeValue

Обертка для численного значения, которое может быть диапазоном или фиксированным значением. 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

double

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

value_range

RangeValue

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

Диапазон

Диапазон значений, таких как min_value < max_value . Требуется хотя бы один из min_value и max_value .

Поля

min_value

double

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

max_value

double

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

Рейтинг

Определяет рейтинг для сущности.

Поля

value

double

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

number_of_ratings

uint64

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

Связанная медиа

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

Поля
`url`	`string` URL этого источника СМИ. Google будет ползти СМИ, размещенные на этом URL.
`type`	`MediaType` Тип этого источника медиа.
`localized_caption`	`Text` Подпись средств массовой информации, поддерживающей I18N, поддерживается только простой текст. Любые HTML -компоненты будут разделены. (необязательный)
`attribution`	`Attribution` Информация о атрибуции об источнике СМИ. Обратите внимание, что если атрибуция требуется для отображения со СМИ, чтобы отдать должное фотографу или агентству, это поле должно быть установлено. (необязательный)
`caption (deprecated)`	`string` Этот товар устарел! Установите, предпочитает использовать локализованный

Атрибуция

Информация о атрибуции для этого СМИ.

Поля

localized_text

Text

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

text
 (deprecated)

string

Установилось, предпочитает использовать локализованный_текс.

Медиатип

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

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

Заменяет ServiceaVailabilityRequest

Запрос на замену доступности Service .

Поля

service_availability

ServiceAvailability

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

Reptecreditcard

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

Перечисления
`REQUIRE_CREDIT_CARD_UNSPECIFIED`	Требование кредитной карты не указано явно, и поведение идентична той, которая указана для условного.
`REQUIRE_CREDIT_CARD_CONDITIONAL`	Google потребует кредитной карты для бронирования, если будет выполнено какое -либо из следующих условий: * Доступность имеет цену, и требуется предоплата_type * no_show_fee установлен * Полевое поле депозита.
`REQUIRE_CREDIT_CARD_ALWAYS`	Для забронирования этой доступности всегда требуется кредитная карта независимо от других полевых значений.

Ресурсы

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

Поля
`staff_id`	`string` Необязательный идентификатор для сотрудника, предоставляющего услугу. Это поле идентифицирует сотрудника по всем продавцам, услугам и записям доступности. Это также должно быть стабильным с течением времени, чтобы обеспечить корреляцию с прошлыми бронированием. Это поле должно присутствовать, если присутствует персонал.
`staff_name`	`string` Необязательное название сотрудника, предоставляющего услугу. Это поле будет отображаться пользователям, делающим бронирование, и должно быть читаемой человек, в отличие от непрозрачного идентификатора. Это поле должно присутствовать, если SHAFS_ID присутствует.
`room_id`	`string` Дополнительный идентификатор для комнаты, в которой находится сервис. Это поле идентифицирует комнату для всех торговцев, услуг и записей о доступности. Это также должно быть стабильным с течением времени, чтобы обеспечить корреляцию с прошлыми бронированием. Это поле должно присутствовать, если присутствует rap_name.
`room_name`	`string` Необязательное название для комнаты, в которой находится сервис. Это поле будет отображаться пользователям, делающим бронирование, и должно быть чтением человека, в отличие от непрозрачного идентификатора. (Необязательно, но требуется, если присутствует rap_id) При столовой название комнаты следует использовать только для мест для сидения, таких как бар или патио, и не следует использовать для меню с фиксированной ценой, особыми мероприятиями или любой другой ценностью, не являющейся комнатой (например, как бронирование или ужин). Настоятельно рекомендуется, чтобы в зоне отдыха по умолчанию не было места, связанной с этим.
`party_size`	`int32` Применимо только для столовой: размер вечеринки, который может быть размещен в течение этого времени. Ресторан может быть связан с несколькими слотами за одно и то же время, каждый из которых указывает на другую party_size, если, например, 2, 3 или 4 человека, могут сидеть с бронированием.

ПЕРЕПОЛНИЕ

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

Поля
`min_advance_online_canceling`	`int64` Минимальное предварительное уведомление в секундах, необходимое для отмены забронированного назначения в Интернете. (необязательный)
`late_cancellation_fee (deprecated)`	`Price` Этот товар устарел! Плата за отмену в течение минимального периода предварительного уведомления.
`noshow_fee (deprecated)`	`Price` Этот товар устарел! Плата за No-Show без отмены.
`admission_policy`	`AdmissionPolicy` Политика приема, которая применяется к этой услуге. Если вы не поверите по умолчанию time_strict. (необязательный)
`cancellation_policy`	`CancellationPolicy` Политика отмены правил планирования. (Требуется для вещей-дела)
Поле Союза `min_booking_buffer` . Продолжительность (в секунды) с момента последнего бронирования может быть сделано, когда слот доступности запускается или заканчивается. Если установлено «min_advance_booking», последнее время книги рассчитывается как (<времена запуска слота> - "min_advance_booking"). Если установлено «min_booking_buffer_before_end_time», последнее время книги рассчитывается как (<<время окончания слота> - "min_booking_buffer_before_end_time"). Обратите внимание, что значение «min_booking_buffer_before_end_time» должно быть положительным, если установлено. Если оба не являются, слот можно бронировать, пока слот не начнет время. Если оба поля установлены, будет выбрано только одно значение, в то время как другое значение игнорируется-мы не можем надежно предсказать, какое значение выбрано. Примеры: Стрижка, которую нужно забронировать как минимум за 1 час до начала времени. 'prediculing_rules {min_advance_booking: 3600 ...} ` Музей, в котором можно приобрести последний билет за 30 минут до закрытия: 'prediculing_rules {min_booking_buffer_before_end_time: 1800 ...}' Билет в кино, который необходимо приобрести до начала времени. 'preculing_rules {...}' (оставьте это поле пустым) (необязательно) `min_booking_buffer` может быть только одним из следующих:
`min_advance_booking`	`int64` Продолжительность (в секунды) с момента последнего бронирования может быть сделано, когда начинается слот доступности.
`min_booking_buffer_before_end_time`	`int64` Продолжительность (в секунды) с момента того, как может быть сделано последнее бронирование, когда заканчивается слот доступности. Если это поле установлено, поле «Admission_policy» должно быть установлено на Time_flegible, чтобы указать, что пользователи могут использовать приобретенные билеты после начала слотов.

Приемполитика

Политика приема этой услуги.

Перечисления
`ADMISSION_POLICY_UNSPECIFIED`	Неиспользованный.
`TIME_STRICT`	Клиенты должны присутствовать во время начала слота доступности, и ожидается, что услуга завершится в конце времени слота. Примеры вариантов использования Time_stric: * Тур, который начинается в 9 утра, который требует от всех участников прибыть во время начала, и возвращается около 12 часов. * Бронирование стрижки в 3 часа дня в субботу, которая займет около 30 минут. * Фитнес -класс с 18:00 до 8 вечера.
`TIME_FLEXIBLE`	Клиенты могут прибыть в любое время между началом и окончанием слота доступности, чтобы использовать это бронирование. Примеры сценария time_flexible использования: * Музейный билет, который можно использовать в любое время на дату покупки. * Полученный вступление в парк развлечений, который можно использовать с 12:00 до 21:00.
`TIMED_ENTRY_WITH_FLEXIBLE_DURATION`	Клиенты должны прийти к продавцу во время начала слота доступности, но могут уйти в любое время. Например, в сценарии входа в музей важный билет на 10 часов утра требует, чтобы пользователь был в музее в 10 часов утра. Время начала слотов доступности для этой услуги представляет собой указанное время входа. Время окончания, однако, используется исключительно в качестве ключа для определения слота доступности для бронирования.

Услуга

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

Поля
`name`	`string` Имя ресурса службы, которое имеет формат `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}` .
`service_name`	`string` Название службы, например, «Мужская стрижка». Установите, используйте вместо этого Localize_service_name.
`localized_service_name`	`Text` Название службы, например, «Мужская стрижка». Возможно в нескольких местах.
`description`	`string` Пользовательский видимый описание Сервиса. Установите вместо этого, используйте локализованную_description.
`localized_description`	`Text` Пользовательский видимый описание Сервиса. Это поле поддерживает как простое текстовое, так и HTML-подобное форматирование. В отличие от раздела простого текста, индивидуальные макеты могут быть созданы здесь, используя заголовки, параграфы, списки и некоторые фразы. Пожалуйста, прочитайте следующие инструкции и примечания внимательно, чтобы убедиться, что вы создаете лучший пользовательский опыт. Поддерживаемые HTML-подобные форматирующие теги: Заголовок тегов: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Направленные теги могут использоваться для отображения заголовков и подтурок. Например, <h1> маршрут </h1> отобразит встроенный текст как самый важный заголовок раздела. Обратите внимание, что любые внутренние теги HTML, стили или атрибуты будут проигнорированы. Например, <h1 style = ".."> будет относиться так же, как <h1>. Только чистый текст будет сохранен. Тег абзаца: <p> Тег абзаца можно использовать для выделения подробного введения или содержимого. Любые внутренние теги, стили или атрибуты будут проигнорированы, за несколькими исключениями: <br>, <strong> и <em>. Пожалуйста, смотрите раздел «Фраза» ниже для получения более подробной информации. Теги списка: <ul>, <ol>, <li> Тег <ul> может использоваться с тегом <li> для отображения неупорядоченных списков, а тег <ol> можно использовать с помощью <li> для отображения упорядоченных списков. Это хороший способ отобразить контрольные списки, графики или любые другие списки, которые соответствуют вашим использовам. Пример: чтобы показать список функций круизной поездки: <ol> <li> Замечательный вид на океан и шансы играть с дикой природой. </li> <li> Тщательно спроектированные меры и услуги по путешествиям. </li> <li> Гарантированная самая низкая цена. </li> </ол> Обратите внимание, что только <li> Дети в рамках <ul> или <ol> теги будут преобразованы. Все остальные дети будут сброшены. Кроме того, любые внутренние теги, атрибуты и стили будут проигнорированы; Мы сохраняем только чистое текстовое содержимое. Тег дивизии: <Div> Все поддерживаемые внутренние теги тега <div> будут проанализированы с помощью правил, указанных выше, подразумевать <div> сама тег не означает какую -либо группировку или отступление здесь. Кроме того, любые внутренние атрибуты и стили будут проигнорированы. Фразы тегов: <br>, <strong>, <em>: Поддерживаются только три метки, упомянутые выше. <br> может использоваться для разрыва строк в параграфах, и <strong>/<em> можно использовать для выделения важного текста. Любые другие фразы будут проигнорированы. Неподдерживаемые теги: <html>, <Header> и <Body> теги не допускаются. Любые другие теги, не упомянутые выше, не поддерживаются (например, <table>, <td> ...). Любые URL-адреса, якоря и ссылки будут разделены и никогда не будут отображаться для конечных пользователей. Если вы хотите использовать фотографии для создания богатого пользовательского опыта, используйте поле «Связанная_медия» ниже, чтобы отправить свои URL -адреса фотографии. Важные заметки: Постарайтесь не использовать другие теги, за исключением поддерживаемых выше, потому что содержимое в пределах неподдерживаемых тегов будет разделено и может привести к нежелательному пользовательскому опыту. Попробуйте избежать глубоких вложенных структур, таких как более 3 различных уровней заголовка или вложенные списки. Сохранение структуры плоской, простой и простой, помогает создать лучший пользовательский опыт. Если поддерживаемые в настоящее время макеты недостаточно для ваших вариантов использования, пожалуйста, обратитесь к резерве с командой Google. Рекомендуемый максимальный размер составляет 32 000 символов.
`price`	`Price` Цена услуги.
`price_interpretation`	`PriceInterpretation` Описывает, как цена интерпретируется и отображается пользователю. Может использоваться любой вертикальной, кроме обедов и развлечений, чтобы настроить отображение цены обслуживания.
`rules`	`SchedulingRules` Правила, чтобы забронировать/отменить встречу.
`prepayment_type`	`PrepaymentType` Требуется ли предоплата, необязательно или не поддерживается.
`prepayment_terms`	`PrepaymentTerms` Условия, когда предоплата завершена.
`form[] (deprecated)`	`ServiceIntakeForm` Этот товар устарел! Устарело. Пожалуйста, используйте utake_form и per_ticket_intake_form.
`intake_form`	`ServiceIntakeForm` Форма, запрашивающая дополнительную информацию от пользователя при бронировании этой услуги. (необязательный)
`per_ticket_intake_form`	`ServiceIntakeForm` Форма, запрашивающая дополнительную информацию от пользователя при бронировании этой услуги. This form must be filled out once for each ticket the user is booking. (необязательный)
`tax_rate`	`TaxRate` The service's tax rate. If present this field overrides any tax_rate set at the merchant level. An empty message (ie tax_rate { }) will reset the applied tax rate to zero.
`payment_option_id[]`	`string` A list of ids referencing the payment options which can be used to pay for this service. The actual payment options are defined at the Merchant level, and can also be shared among multiple Merchants.
`deposit`	`Deposit` Defines how a deposit may be charged to the user. Overrides the service deposit if one was specified. Setting this to an empty Deposit message removes any service-level deposit. (необязательный)
`no_show_fee`	`NoShowFee` Defines a no show fee that may be charged to the user. Overrides the service no show fee if one was specified. Setting this to an empty NoShowFee message removes any service-level no show fee. (необязательный)
`require_credit_card`	`RequireCreditCard` Indicates whether the user must provide a credit card in order to book this service. This field can be overridden at the availability level. (необязательный)
`action_link[]`	`ActionLink` An action link related to this service. If action link exists, type (see below) must be set in the Service.
`type`	`ServiceType` The predefined type of this service. (необязательный)
`ticket_type[]`	`TicketType` Types of tickets that can be booked/purchased for this service, if tickets are supported. (необязательный)
`related_media[]`	`RelatedMedia` Photos related to this service. Google will crawl and store the media to ensure that they are displayed to end-users in the most efficient way. (необязательный)
`service_attribute_value_id[]`	`ServiceAttributeValueId` Service attribute values that apply to this service (optional). Each Service may have zero or more values for each service attribute defined in the corresponding Merchant. (необязательный)
`waitlist_rules`	`WaitlistRules` Rules to joining the waitlist.
`ticketing_vertical_specific_data`	`TicketingVerticalSpecificData` Additional information unique to the event ticketing vertical. (необязательный)
`integration_type`	`IntegrationType` Depth of integration we support for this service. (optional) Irrelevant for partners with the starter integration. End to end will always be disabled for these partners.
`per_order_fee`	`PerOrderFee` Order level fees for purchasing this service. (необязательный)
`tours_and_activities_content`	`ToursAndActivitiesContent` Content fields specific to Tours and Activities.
`location[]`	`Location` Locations related to this service. IMPORTANT NOTES: If there are multiple visited locations related to this service, or the START_LOCATION is different from the VISITED_LOCATION, the START_LOCATION must be specified. Example: - A guided biking tour visiting three venues, the start venue needs to be specified. - A bus tour meeting at a hotel lobby and then head to the visited venue. The meeting location needs to be specified.
`rating`	`Rating` User rating for this service as an aggregate metric over all reviews.
`home_service_data`	`HomeServiceData` Additional information unique to home service vertical. (необязательный)
`virtual_session`	`VirtualSession` Необязательный. Information about virtual session. It is required for enabling virtual services.
`direct_merchant_payment`	`DirectMerchantPayment` Необязательный. 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.

PrepaymentTerms

Specific information around when prepayment is completed.

Поля

charge_timing

ChargeTiming

When the charge will occur relative to the purchase time.

charge_time_before_start_time_sec

int64

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

ChargeTiming

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

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

PrepaymentType

Enum to indicate the prepayment type.

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

Тип Обслуживания

Predefined service types.

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

ServiceAttribute

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

Поля

attribute_id

string

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

attribute_name

string

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

value[]

Value

All possible values for this service attribute.

Ценить

Represents a possible value for a particular service attribute.

Поля

value_id

string

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

value_name

string

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

ServiceAttributeValueId

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

Поля

attribute_id

string

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

value_id

string

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

ServiceAvailability

A list of availability and who/when they should be applied to.

Поля
`name`	`string` The resource name of the service to apply this to. In the format of `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`
`start_time_restrict`	`Timestamp` If provided, we will consider the Availability entities provided to be a complete snapshot from [start_time_restrict, end_time_restrict). That is, all existing availability will be deleted if the following condition holds true: `start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict` If a duration message is set, the condition is further restricted: `availability.duration == duration_restrict` If a resources_restrict message is set, the condition is further restricted: `availability.resources.staff_id == resources_restrict.staff_id && availability.resources.room_id == resources_restrict.room_id` 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`	`Timestamp` Setting end_time_restrict while leaving start_time_restrict unset is interpreted to mean all time up to the end_time_restrict.
`duration_restrict`	`Duration` Setting duration further restricts the scope of the update to just the availability with matching duration.
`resources_restrict`	`Resources` Setting resources_restrict further restricts the scope of the update to just this set of resources. All id fields of the resources must match exactly.
`availability[]`	`Availability` The new list of availability.

ServiceIntakeForm

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

Поля

field[]

ServiceIntakeFormField

Fields that will be displayed to the user.

first_time_customers
 (deprecated)

bool

If true, this form will be shown to first time customers. Устарело. This functionality is not supported for intake forms.

returning_customers
 (deprecated)

bool

If true, this form will be shown to repeat customers. Устарело. This functionality is not supported for intake forms.

ServiceIntakeFormField

Defines a field that is included in a ServiceIntakeForm.

Поля
`id`	`string` A string from an aggregator partner which uniquely identifies a form field. This id should be the same as the id in the corresponding form field answer and must be unique across both the service level and per ticket intake forms. (необходимый)
`type`	`FieldType` The type of this field.
`label`	`string` The text shown to the user for this field. Deprecated, please use `localized_label` instead.
`localized_label`	`Text` The text shown to the user for this field. The field can be supplied in multiple locales. (необходимый)
`value[]`	`string` Set if and only if the field type is LOCATION_SEARCH. Please use the "location_id" in the "location" field to specify the location value.
`choice_text[]`	`Text` Set if and only if the field type is MULTIPLE_CHOICE, CHECKBOXES, or DROPDOWN. Used to enumerate possible choices.
`is_required`	`bool` Indicates whether an answer to this field is required by a user.
`allow_custom_answer`	`bool` Indicates whether a custom value is allowed in additional to predefined answers. This is only applicable when the field type is LOCATION_SEARCH. (необязательный)
`additional_option[]`	`Text` Additional options provided in addition to the provided values. Only applicable when the field type is LOCATION_SEARCH. Eg in addition to the provided location list, another available option can be "I will contact supplier later". (необязательный)
`ticket_type_restrict[]`	`string` If this question should only be shown when the user books certain ticket types, this field should be set as the set of applicable ticket type ids. Leave the field empty if the question is always applicable.
`hint`	`Text` The hint text for input, which shows up as a text placeholder. This is only applicable when the field type is SHORT_ANSWER or PARAGRAPH. (необязательный)

FieldType

Enum to indicate the type of field.

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

Ставка налога

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

Поля

micro_percent

int32

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

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

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

Условия

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

Поля

url

string

Optionally, the URL to the Terms and Conditions.

text

string

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

localized_text

Text

The localized text to be displayed to the user.

Текст

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

Поля

value

string

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

localized_value[]

LocalizedString

Per-locale text values. Необязательный.

TicketType

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

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

Поля
`ticket_type_id`	`string` The ticket id is used to differentiate among different ticket types of the same service, and is only expected to be unique within a service.
`short_description`	`string` A short description to this TicketType. This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Deprecated, use localized_short_description instead.
`localized_short_description`	`Text` A short description to this TicketType with i18n support. This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Separate values could be supplied for each locale.
`price`	`Price` The price of a single ticket of this type, exclusive of any taxes. The tax rate of Service is applied to its tickets.
`per_ticket_fee`	`PerTicketFee` Additional fees for purchasing this ticket. (необязательный)
`option_description`	`string` Description of any additional option which this ticket type represents, if any. Deprecated, use localized_option_description instead.
`localized_option_description`	`Text` Description of any additional option which this ticket type represents, if any. Separate values could be supplied for each locale. Additional options are useful when the ticket type represents multiple dimensions. Example 1: an admission ticket with different types 'adult', 'child' and language as an additional option, the expected TicketType list would be: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } } Example 2: an multi-hour kayak rental with optional dry bag add-on, the short_description could be "3 hours" and the option_description could be either "with dry bag" or "without dry bag": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } } Optional, but if any ticket type within the service has this field set, we expect all other ticket types to have this field set as well (a default option_description could be used). Eg [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] is not a valid list. Only two HTML formatting tags are supported: and . They are intended to be used for specifying options with both a title and detailed description, for example: " Premium Seating This option offers seating at the private boxes including fully cushioned seats, private TVs, in-seat food and beverage service. These seats provide picturesque views of the field."

TicketingVerticalSpecificData

Additional information unique to the event ticketing vertical.

Поля
`event_category`	`EventCategory` The category of the event. Set only when event falls into one of the predefined categories. (необязательный)
`event_url`	`string` The URL of the event on the partner's website. (необязательный)
`entity[]`	`Entity` A list of entities related to the event. (необязательный)
`event_attendance_mode`	`AttendanceMode` Необходимый. The type of the event attendance.
`event_virtual_location_url[]`	`string` Необязательный. URL where the event can be watched.
`event_organizer`	`Text` Необязательный. Organizer who hosts the event.
`event_organizer_url`	`string` Необязательный. URL of the organizer who hosts the event.
`event_organizer_type`	`OrganizerType` Необязательный. The type of the organizer.
`event_source_url[]`	`string` Необходимый. URL of the pages where the event information or descriptions can be found.
`event_state`	`EventState` Необязательный. State of the event.

AttendanceMode

The type of the event attendance.

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

Сущность

Represents an entity related to the event.

Поля
`id`	`string` Unique identifier of the entity in the partner's database. (необязательный)
`name`	`string` Name of the entity. (необходимый)
`url`	`string` Url of the webpage that unambiguously describes the entity. This is the webpage on the partner's website for the entity if any; for other public URLs of the entity, use relevant_url in public_identification_data. (необязательный)
`entity_type`	`EntityType` The type of the entity. (необязательный)
`entity_role`	`EntityRole` The role of the entity in the event. (необязательный)
`public_identification_data`	`PublicIdentificationData` Public references of the entity. (необязательный)

EntityRole

The role of the entity in the event.

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

Тип объекта

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

Перечисления
`ENTITY_TYPE_UNSPECIFIED`	Не указан. Не использовать.
`ENTITY_TYPE_PERFORMER`	The entity represents the artist or group performing at a concert or a show. Only applicable when event category is CONCERT or THEATRE.
`ENTITY_TYPE_PLAYER`	The entity represents the sports team or player at the event. Only applicable when event category is SPORTS.
`ENTITY_TYPE_CONCERT_TOUR`	The entity represents the tour that this event belongs to. Only applicable when event category is CONCERT.
`ENTITY_TYPE_SPORTS_SERIES`	The entity represents a sports tournament that this event belongs to. Only applicable when event category is SPORTS.
`ENTITY_TYPE_PLAY`	The entity represents the type of play (eg, musical, comedy, ballet, etc.) performed at the event. Only applicable when event category is THEATRE.

EventCategory

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

Перечисления
`EVENT_CATEGORY_UNSPECIFIED`	Не указан. Не использовать.
`EVENT_CATEGORY_CONCERT`	Концерты.
`EVENT_CATEGORY_SPORTS`	Спортивные мероприятия.
`EVENT_CATEGORY_THEATRE`	Theatre events.
`EVENT_CATEGORY_EXHIBITS`	Exhibits.
`EVENT_CATEGORY_WORKSHOPS_AND_CLASSES`	Workshops and Classes.

EventState

State of the event.

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

OrganizerType

The type of the organizer.

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

PublicIdentificationData

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

Поля

relevant_url[]

string

Public URL of any webpage that is dedicated to only the topic. This could include official websites, discogs, social media platforms, wikipedia or imdb pages, eg https://www.discogs.com/artist/1124645-Taylor-Swift , https://www.wikidata.org/wiki/Q19320959 , https://twitter.com/acmilan . (необязательный)

musicbrainz_id

string

The 36-character musicbrainz identifier of the artist or other music entities, if applicable. See https://musicbrainz.org/doc/MusicBrainz_Identifier . (необязательный)

Временной диапазон

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

Поля

start_time

The lower bound of the time range.

end_time

BillingInformationFormat

The upper bound of the time range.

TokenizationConfig

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

Поля

tokenization_parameter

map<string, string>

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

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

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

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

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

billing_information_format

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

BillingInformationFormat

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

Перечисления
`BILLING_INFORMATION_FORMAT_UNSPECIFIED`	Не указан. Defaults to MIN.
`MIN`	name, country code, and postal code (Google Pay default setting).
`FULL`	name, street address, locality, region, country code, and postal code.

ToursAndActivitiesContent

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

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

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

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

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

Поля
`highlights[]`	`Text` The user-visible list of highlights.
`inclusions[]`	`Text` The user-visible list of inclusions.
`exclusions[]`	`Text` The user-visible list of exclusions.
`must_know[]`	`Text` The user-visible list of important notes, use for details such as age restrictions or other conditions that make this service unsuitable.

UnsupportedPartySizeOption

Options for parties that are out of range.

Поля

call_merchant

CallMerchant

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

UpdateBookingRequest

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

Поля

update_mask

Field mask of all booking fields to be updated

booking

Booking

The booking to be updated

booking_failure

BookingFailure

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

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

Order

The order to be updated

UpdateServiceRequest

The request to update a Service .

Поля

service

Service

The new service data.

update_mask