Package google.maps.booking.v1alpha

Индекс

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

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

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

rpc UpdateBooking( UpdateBookingRequest ) returns ( Booking )

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

Области авторизации

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

  • https://www.googleapis.com/auth/mapsbooking
Обновить заказ

rpc UpdateOrder( UpdateOrderRequest ) returns ( Order )

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

Области авторизации

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

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

Кормить

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

GetStatus

rpc GetStatus( GetStatusRequest ) returns ( FeedStatus )

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

Области авторизации

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

  • https://www.googleapis.com/auth/mapsbooking
Списокстатус

rpc ListStatus( ListStatusRequest ) returns ( ListStatusResponse )

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

Области авторизации

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

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

ИнвалидацияСервис

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

Инвалидатересурсе

rpc InvalidateResource( InvalidateResourceRequest ) returns ( Empty )

Делает недействительным существующий ресурс.

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

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

Области авторизации

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

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

Статус инвентаря

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

GetMerchantStatus

rpc GetMerchantStatus( GetMerchantStatusRequest ) returns ( MerchantStatus )

Получите MerchantStatus Merchant .

Области авторизации

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

  • https://www.googleapis.com/auth/mapsbooking
ListMerchantСтатусы

rpc ListMerchantStatuses( ListMerchantStatusesRequest ) returns ( ListMerchantStatusesResponse )

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

Области авторизации

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

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

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

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

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

rpc BatchDeleteGenericRecords( BatchDeleteGenericRecordsRequest ) returns ( Empty )

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

Области авторизации

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

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

rpc BatchPushGenericRecord( BatchPushGenericRecordRequest ) returns ( Empty )

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

Области авторизации

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

  • https://www.googleapis.com/auth/mapsbooking
Доступность пакетаReplaceService

rpc BatchReplaceServiceAvailability( BatchReplaceServiceAvailabilityRequest ) returns ( BatchReplaceServiceAvailabilityResponse )

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

Области авторизации

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

  • https://www.googleapis.com/auth/mapsbooking
СоздатьMerchant

rpc CreateMerchant( CreateMerchantRequest ) returns ( Merchant )

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

Области авторизации

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

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

rpc CreateService( CreateServiceRequest ) returns ( Service )

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

Области авторизации

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

  • https://www.googleapis.com/auth/mapsbooking
УдалитьMerchant

rpc DeleteMerchant( DeleteMerchantRequest ) returns ( Empty )

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

Области авторизации

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

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

rpc DeleteService( DeleteServiceRequest ) returns ( Empty )

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

Области авторизации

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

  • https://www.googleapis.com/auth/mapsbooking
ЗаменитьServiceAvailability

rpc ReplaceServiceAvailability( ReplaceServiceAvailabilityRequest ) returns ( ServiceAvailability )

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

Области авторизации

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

  • https://www.googleapis.com/auth/mapsbooking
ОбновлениеMerchant

rpc UpdateMerchant( UpdateMerchantRequest ) returns ( Merchant )

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

Области авторизации

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

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

rpc UpdateService( UpdateServiceRequest ) returns ( Service )

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

Области авторизации

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

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

ТипДейшнЛинкТип

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

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

Платформа действий

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

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

Совет

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

Поля
text

Text

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

Доступность

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

Поля
start_time

Timestamp

Время начала интервала встречи.

duration

Duration

Продолжительность интервала встречи

spots_total

int64

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

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

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

  • Повторение подразумевает spots_total=1 и spots_open=1 .
  • ScheduleException подразумевает spots_total=1 и spots_open=0 .
spots_open

int64

Количество открытых мест.

availability_tag

string

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

resources

Resources

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

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

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

string

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

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

recurrence

Recurrence

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

schedule_exception[]

ScheduleException

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

deposit

Deposit

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

no_show_fee

NoShowFee

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

require_credit_card

RequireCreditCard

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

ticket_type_id[]

string

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

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

Чтобы представить инвентарь в будние дни: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...} . Чтобы представить инвентарь во время праздников: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...} .

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

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

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

duration_requirement

DurationRequirement

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

scheduling_rule_overrides

SchedulingRuleOverrides

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

confirmation_mode

ConfirmationMode

Режим подтверждения, который будет использоваться при бронировании этой доступности. Попытки создать бронирования для наличия мест с режимом подтверждения CONFIRMATION_MODE_SYNCHRONOUS должны быть немедленно подтверждены или отклонены. Попытки создать бронирования для наличия мест с режимом подтверждения CONFIRMATION_MODE_ASYNCHRONOUS должны быть либо немедленно отклонены, либо созданы со статусом ОЖИДАНИЕ.

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

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

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

ПродолжительностьТребование

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

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

Повторение

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

Требования:

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

Timestamp

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

repeat_every

Duration

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

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

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

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

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

Поля
last_bookable_sec

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 записей.

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

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

Поля
parent

string

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

records[]

GenericRecord

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

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

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

Поля
parent

string

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

extended_service_availability[]

ExtendedServiceAvailability

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

BatchReplaceServiceAvailabilityResponse

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

Поля
extended_service_availability[]

ExtendedServiceAvailability

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

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

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

Поля
name

string

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

merchant_id

string

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.

Три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

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

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

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

Поля
min_duration_before_start_time

Duration

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

refund_percent

uint32

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

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

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

Поля
given_name

string

Имя клиента

family_name

string

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

address

PostalAddress

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

telephone

string

Телефон клиента

email

string

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

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

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

Поля
parent

string

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

merchant_id

string

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

merchant

Merchant

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

CreateServiceRequest

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

Поля
parent

string

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

service_id

string

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

service

Service

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

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

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

Поля
credit_card_type[]

CreditCardType

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

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

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

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

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

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

Поля
name

string

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

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

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

Поля
name

string

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

Депозит

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

Поля
deposit

Price

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

min_advance_cancellation_sec

int64

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

deposit_type

PriceType

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

DirectMerchantОплата

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

Поля
payment_methods[]

Text

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

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

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

Поля
min_duration

Duration

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

max_duration

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

Timestamp

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

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

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

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

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

NoFee

Никакой комиссии за способ выполнения.

base_fee

MinimumFee

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

fixed_fee

FixedFee

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

Фиксированная комиссия

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

Поля
amount

Price

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

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

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

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

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

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

Поля
base_fee_amount

Price

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

Без комиссии

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

GenericDeleteRecord

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

Поля
delete_time

Timestamp

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

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

bytes

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

proto_record

Any

Для фидов на основе прототипов.

Общая запись

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

Поля
generation_timestamp

Timestamp

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

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

bytes

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

proto_record

Any

Для фидов на основе прототипов.

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

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

Поля
latitude

double

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

longitude

double

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

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

PostalAddress

Почтовый адрес места нахождения (желательно).

unstructured_address

string

Неструктурированный адрес также может быть предоставлен в качестве запасного варианта. Например, «Амфитеатр-бульвар, 1600, вид на горы, Калифорния 94043».

GetMerchantStatusRequest

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

Поля
name

string

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

GetStatusRequest

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

Поля
name

string

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

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

ГлавнаяСервисДанные

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

Поля
category_type

string

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

job_type

string

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

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

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

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

Инвалидатересурцерекуест

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

Поля
resource_id

string

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

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

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

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

Поля
service_id

string

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

start_sec

int64

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

duration_sec

int64

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

tickets[]

OrderedTickets

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

price

Price

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

status

BookingStatus

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

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

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

Поля
ticket_id

string

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

count

int32

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

ListMerchantStatusesЗапрос

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

Поля
parent

string

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

page_size

int32

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

page_token

string

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

booking_inventory_status_restrict

BookingInventoryStatus

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

waitlist_inventory_status_restrict

WaitlistInventoryStatus

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

geo_match_restrict

GeoMatchingStatus

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

БронированиеИнвентарьСтатус

Статус инвентаря сквозного бронирования.

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

Статус геосоответствия

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

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

Статус списка ожидания

Статус инвентаря в сквозном списке ожидания.

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

ListMerchantStatusesResponse

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

Поля
merchant_statuses[]

MerchantStatus

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

next_page_token

string

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

ListStatusRequest

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

Поля
name

string

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

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

int32

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

page_token

string

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

state_restrict

State

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

time_range_restrict

TimeRange

Необязательное ограничение для фильтрации результатов по верхней и нижней границе. Если параметр start_time не установлен, по умолчанию будет установлено время начала unix. Если значение end_time не установлено, по умолчанию будет установлено значение «сейчас».

Списокстатусответ

Запрос на получение 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 Адресов и на Картах Google. Дополнительную информацию об идентификаторах мест см. на странице https://developers.google.com/places/web-service/place-id . Если это указано, Google сопоставит местоположение с этим местом.

name

string

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

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

telephone

string

Общественный телефонный номер места, включая коды страны и города, например +14567891234. (необязательный)

url

string

URL общедоступного веб-сайта местоположения. (необязательный)

geo

GeoCoordinates

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

location_type

LocationType

Тип местоположения необходимо указать, если это местоположение предоставляется для Услуги.

location_id

string

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

Тип местоположения

Тип этого местоположения.

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

Торговец

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

Поля
name

string

Имя ресурса продавца в формате partners/{partner_id}/merchants/{merchant_id} .

merchant_name

string

Имя продавца, телефон, URL-адрес и местоположение используются для сопоставления партнерского инвентаря с продавцами, уже представленными на Картах 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

Определения для любых атрибутов сервиса, используемых для описания услуг для этого продавца. (необязательный)

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 может отличаться от общественных видимых.

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

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

Поля
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

Price

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

fee_type

PriceType

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

Заказ

Заказ на сервисное обслуживание у продавца.

Поля
name

string

Имя ресурса заказа: partners/{partner ID}/orders/{order ID}

client_information

ClientInformation

Личная информация клиента, делающего заказ.

payment_information

PaymentInformation

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

merchant_id

string

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

item[]

LineItem

Позиции в этом порядке.

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

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

Поля
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

Price

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

processing_fee

Price

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

Perticketfee

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

Поля
service_charge

Price

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

facility_fee

Price

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

taxes

Price

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

Pestaladdress

Адрес клиента или компании.

Поля
address_country

string

Страна, указанная с использованием кода страны ISO 3166-1 альфа-2, например «США» (обязательно).

address_locality

string

Населенный пункт, например «Маунтин-Вью». (необходимый)

address_region

string

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

postal_code

string

Почтовый индекс, например «94043». (необходимый)

street_address

string

Уличный адрес, например «Амфитеатр Пкви, 1600». (необходимый)

Статус предоплаты

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

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

Цена

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

Поля
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 Примеры: * единственное значение: 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

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

MediaType

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

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

tax_rate

TaxRate

Ставка налога на услугу. Если присутствовать, это поле переопределяет любой налог, установленную на уровне торговца. Пустое сообщение (то есть Tax_rate {}) сбросит прикладную налоговую ставку до нуля.

payment_option_id[]

string

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

deposit

Deposit

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

no_show_fee

NoShowFee

Определяет плату без показа, которая может быть взимана с пользователя. Переопределяет услугу без платы за выставление, если кто -то был указан. Установка этого на пустое сообщение Noshowfee Удаляет любую уровни обслуживания без платы за шоу. (необязательный)

require_credit_card

RequireCreditCard

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

type

ServiceType

Предопределенный тип этой услуги. (необязательный)

ticket_type[]

TicketType

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

related_media[]

RelatedMedia

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

service_attribute_value_id[]

ServiceAttributeValueId

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

waitlist_rules

WaitlistRules

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

ticketing_vertical_specific_data

TicketingVerticalSpecificData

Дополнительная информация Уникальная для билетов на билеты. (необязательный)

integration_type

IntegrationType

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

per_order_fee

PerOrderFee

Плата за заказа за покупку этой услуги. (необязательный)

tours_and_activities_content

ToursAndActivitiesContent

Контентные поля, специфичные для туров и мероприятий.

location[]

Location

Места, связанные с этой услугой. Важные примечания: если есть несколько посещаемых мест, связанных с этой службой, или start_location отличается от посещения_локации, необходимо указать start_location. Пример: - на велосипедной экскурсии с гидом, посещающим три места, необходимо указать место для начала. - Встреча автобусного тура в лобби в отеле, а затем отправиться в посещение места. Место встречи должно быть указано.

rating

Rating

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

home_service_data

HomeServiceData

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

virtual_session

VirtualSession

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

direct_merchant_payment

DirectMerchantPayment

Необязательный. Дополнительная информация, которая должна быть добавлена, если служба требует, чтобы пользователь платил непосредственно торговцу. Важное примечание: RWG не будет участвовать в этой транзакции. Это необходимо, если определен Virtual_session, и служба не является бесплатной или предоплата.

Предоплата

Конкретная информация вокруг получения предоплаты.

Поля
charge_timing

ChargeTiming

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

charge_time_before_start_time_sec

int64

Время за несколько секунд до начала службы, когда пользователь взимается за оплату. Это поле должно быть установлено только тогда, когда chargetiming IS arge_later.

Чаргетинг

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

Перечисления
CHARGE_TIMING_UNSPECIFIED Неиспользованный.
CHARGE_NOW Заказчик будет взиматься немедленно.
CHARGE_LATER Заказчик будет взиматься позже.

Предоплата

Enum, чтобы указать тип предоплаты.

Перечисления
PREPAYMENT_TYPE_UNSPECIFIED По умолчанию мы предположим, что предоплата не является_ обеспечена.
REQUIRED Пользователь должен оплатить эту услугу во время бронирования.
OPTIONAL Пользователь может выбрать предварительную оплату этой службы во время бронирования или позже, но это не требуется для бронирования.
NOT_SUPPORTED Предоставление не поддерживается для этой услуги.

ServiceType

Предопределенные типы услуг.

Перечисления
SERVICE_TYPE_UNSPECIFIED Неиспользованный.
SERVICE_TYPE_DINING_RESERVATION Резервирование.
SERVICE_TYPE_FOOD_ORDERING Заказ еды, может быть либо доставка еды, либо на вынос, либо и то, и другое.
SERVICE_TYPE_FOOD_DELIVERY Доставка еды.
SERVICE_TYPE_FOOD_TAKEOUT Еда на вынос.
SERVICE_TYPE_EVENT_TICKET Билет на мероприятие.
SERVICE_TYPE_TRIP_TOUR Trip Tour.
SERVICE_TYPE_APPOINTMENT Услуга, которая предоставляет встречи или занятия. Рекомендуется для (1) здоровья и физической подготовки, (2) спа -салона и красоты, а также (3) услуг по финансовым консультациям и оценке. Пожалуйста, смотрите поддержанные типы услуг: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT Сервис, который обеспечивает онлайн -встречу для класса или сессии, которая будет полностью виртуальной. Должен быть установлен при включении бронирования виртуальных услуг.
SERVICE_TYPE_SHOPPING Сервис, который позволяет пользователям делать покупки у данного продавца. Это может быть либо доставка, либо пикап.

Serviceattribute

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

Поля
attribute_id

string

Идентификатор, который уникально идентифицирует этот атрибут услуги среди других для одного и того же продавца, например, «Тип аккаунта».

attribute_name

string

Видимое пользователь имя для этого атрибута, например, «Тип учетной записи».

value[]

Value

Все возможные значения для этого атрибута службы.

Ценить

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

Поля
value_id

string

Идентификатор, который уникально идентифицирует эту ценность среди других для этого атрибута услуги, например, «личный».

value_name

string

Пользовательское имя для значения, например, «личный».

ServiceatTributeValueid

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

Поля
attribute_id

string

Идентификатор атрибута, как определено в Merchant.service_attribute, например, "Service-Type".

value_id

string

ID значения для этого атрибута, например, «Стрижка». Должен сопоставить значение value_id в определении атрибута службы.

ServiceAvailability

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

Поля
name

string

Название ресурса Сервиса, чтобы применить это. В формате partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

start_time_restrict

Timestamp

Если предоставлено, мы рассмотрим наличие объектов доступности, предоставленными как полный снимок из [start_time_restrit, 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 unset, интерпретируется как означает, что все время начинается с start_time_restrict.

end_time_restrict

Timestamp

Установка end_time_restrict, оставляя start_time_restrict unset, интерпретируется как все время до end_time_restrict.

duration_restrict

Duration

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

resources_restrict

Resources

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

availability[]

Availability

Новый список наличия.

ServiceIntakeform

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

Поля
field[]

ServiceIntakeFormField

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

first_time_customers
(deprecated)

bool

Если это правда, эта форма будет показана клиентам с первыми. Устарело. Эта функциональность не поддерживается для форм впуска.

returning_customers
(deprecated)

bool

Если это правда, эта форма будет показана повторять клиентов. Устарело. Эта функциональность не поддерживается для форм впуска.

ServiceIntakeformfield

Определяет поле, которое включено в сервисное устройство.

Поля
id

string

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

type

FieldType

Тип этого поля.

label

string

Текст, показанный пользователю для этого поля. Установите, пожалуйста, используйте вместо этого localized_label .

localized_label

Text

Текст, показанный пользователю для этого поля. Поле может быть поставлено в нескольких местах. (необходимый)

value[]

string

Установите, если и только тогда, когда тип поля - location_search. Пожалуйста, используйте «location_id» в поле «Расположение», чтобы указать значение местоположения.

choice_text[]

Text

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

is_required

bool

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

allow_custom_answer

bool

Указывает, разрешено ли пользовательское значение в дополнение к предопределенным ответам. Это применимо только тогда, когда тип поля - location_search. (необязательный)

additional_option[]

Text

Дополнительные варианты, предоставленные в дополнение к предоставленным значениям. Применимо только тогда, когда тип поля является местоположением_SEARCH. Например, в дополнение к предоставленному списку местоположения, еще один доступный вариант может быть «Я свяжусь с поставщиком позже». (необязательный)

ticket_type_restrict[]

string

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

hint

Text

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

FieldType

Перечислять, чтобы указать тип поля.

Перечисления
FIELD_TYPE_UNSPECIFIED Поля неуточненного или неизвестного типа будут игнорироваться.
SHORT_ANSWER Однострочное поле ввода для текста.
PARAGRAPH Многострочное поле ввода для текста.
MULTIPLE_CHOICE Набор радиопроизводительных кнопок, который требует одного выбора из многих вариантов.
CHECKBOXES Один или несколько перечисленных элементов с флажками.
DROPDOWN Выбор из выпадения.
BOOLEAN Да/нет кнопка.

На Taxrate

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

Поля
micro_percent

int32

Ставка налога в миллионах в один процент, эффективно предоставляя 6 десятиков точности. Например, если налоговая ставка составляет 7,253%, это поле должно быть установлено на 7253000.

Если это поле остается бездействующим или устанавливается на 0, общая цена, взимаемая пользователю за любую услугу, предоставленную этим продавцом, является точной ценой, указанной Service.Price. Предполагается, что цена обслуживания освобождается от или уже включающая применимые налоги. Налоги не будут показаны пользователю как отдельную строку.

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

Условия

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

Поля
url

string

Необязательно, URL в условиях.

text

string

Текст, который будет отображаться пользователю. Используйте localize_text ниже для новых интеграций.

localized_text

Text

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

Текст

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

Поля
value

string

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

localized_value[]

LocalizedString

Для перемещения текстовых значений. Необязательный.

TicketType

TicketType используется для дифференциации билетов с различными ценами и/или доступностью из-за разных типов пользователей, разных атрибутов обслуживания или разных вариантов/дополнений.

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

Поля
ticket_type_id

string

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

short_description

string

Краткое описание этого 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.

EntityType

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

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

EventCategory

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

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

EventState

State of the event.

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

OrganizerType

The type of the organizer.

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

PublicIdentificationData

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

Поля
relevant_url[]

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 . (необязательный)

TimeRange

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

Поля
start_time

Timestamp

The lower bound of the time range.

end_time

Timestamp

The upper bound of the time range.

TokenizationConfig

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

Поля
tokenization_parameter

map<string, string>

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

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

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

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

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

billing_information_format

BillingInformationFormat

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

BillingInformationFormat

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

Перечисления
BILLING_INFORMATION_FORMAT_UNSPECIFIED Не указан. 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

FieldMask

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

FieldMask

The specific fields to update for the merchant.

UpdateOrderRequest

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

Поля
update_mask

FieldMask

Маска полей всех полей заказа, которые будут обновлены

order

Order

The order to be updated

UpdateServiceRequest

The request to update a Service .

Поля
service

Service

The new service data.

update_mask

FieldMask

The specific fields to update for the service.

UserPurchaseRestriction

Restricts the users eligible to purchase a payment option.

Поля
new_to_merchant

bool

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

new_to_payment_option

bool

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

VirtualSession

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

Поля
session_instructions

Text

Instructions on how this virtual class is set up. If the partner does not include the video URL with the booking, then this text must include when the video URL will be shared with the user. Например. “Zoom url will be mailed 30 minutes prior to the class”. (рекомендуется)

session_requirements

Text

Requirements for the given virtual session. Например. yoga mat, cooking utensils etc. (Recommended)

virtual_platform_info

VirtualPlatformInfo

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

is_session_prerecorded

bool

Необходимый. Set this as true if the virtual session is not live and is pre-recorded.

VirtualPlatformInfo

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

Поля
platform

Platform

Platform used for virtual session.

other_platform_name

Text

The name of the platform if the platform is set to OTHER. (Required if platform is set to OTHER)

Платформа

Enum to indicate which virtual platform would be used by the merchant.

Перечисления
PLATFORM_UNSPECIFIED Неиспользованный.
FLEXIBLE The merchant is flexible in which video platform they use.
GOOGLE_HANGOUTS Google Hangouts product.
GOOGLE_MEET Google Meet product.
ZOOM Zoom Video Communications.
SKYPE Скайп.
YOUTUBE Livestreaming in YouTube.
OTHER Should be set if the video platform used is different from the ones mentioned here.

WaitlistRules

Rules related to joining the waitlist.

Поля
min_party_size

int32

Необходимый. Must be a positive integer for services providing waitlist functionality. If the service or merchant does not provide waitlist functionality, this must not be populated.

max_party_size

int32

Необходимый. Must be a positive integer for services providing waitlist functionality. If the service or merchant does not provide waitlist functionality, this must not be populated.

supports_additional_request

bool

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

above_max_party_size_options[]

UnsupportedPartySizeOption

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