Method: inventory.partners.availability.replace

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

HTTP-запрос

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

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

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Поля
extendedServiceAvailability[]

object ( ExtendedServiceAvailability )

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

Ответный текст

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

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Поля
extendedServiceAvailability[]

object ( ExtendedServiceAvailability )

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

Области полномочий

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

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

Расширенная доступность услуг

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

JSON-представление 
{
  "merchantId": string,
  "serviceId": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
Поля
merchantId

string

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

serviceId

string

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

startTimeRestrict

string ( Timestamp format)

Если предоставленные данные о доступности указаны, мы будем рассматривать их как полный снимок состояния на момент времени [startTimeRestrict, endTimeRestrict]. То есть, вся существующая доступность будет удалена, если выполняется следующее условие:

   startTimeRestrict <= availability.start_sec &&
   availability.start_sec < endTimeRestrict

Если задано условие по длительности, то условие дополнительно ограничивается:

  availability.duration == durationRestrict

Если задано сообщение resourcesRestrict, условие дополнительно ограничивается:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

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

Установка параметра startTimeRestrict при отсутствии параметра endTimeRestrict интерпретируется как указание на все время, начинающееся с startTimeRestrict.

Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

endTimeRestrict

string ( Timestamp format)

Установка параметра endTimeRestrict при отсутствии параметра startTimeRestrict интерпретируется как отображение всего времени до значения endTimeRestrict.

Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

durationRestrict

string ( Duration format)

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

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « s ». Пример: "3.5s" .

resourcesRestrict

object ( Resources )

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

availability[]

object ( Availability )

Новый список доступных товаров.