Method: inventory.partners.merchants.services.availability.replace

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

HTTP-запрос

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace

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

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

Параметры
serviceAvailability.name

string

Имя ресурса сервиса, к которому это нужно применить. В формате partners/{partner_id}/merchants/{merchantId}/services/{serviceId}

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

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

JSON-представление 
{
  "serviceAvailability": {
    "name": string,
    "startTimeRestrict": string,
    "endTimeRestrict": string,
    "durationRestrict": string,
    "resourcesRestrict": {
      "staffId": string,
      "staffName": string,
      "roomId": string,
      "roomName": string,
      "partySize": integer,
      "roomDescription": {
        object (Text)
      }
    },
    "availability": [
      {
        "startTime": string,
        "duration": string,
        "spotsTotal": string,
        "spotsOpen": string,
        "availabilityTag": string,
        "resources": {
          object (Resources)
        },
        "paymentOptionId": [
          string
        ],
        "recurrence": {
          object (Recurrence)
        },
        "scheduleException": [
          {
            object (ScheduleException)
          }
        ],
        "deposit": {
          object (Deposit)
        },
        "noShowFee": {
          object (NoShowFee)
        },
        "prepayment": {
          object (Prepayment)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode),
        "linkoutRequiredReason": enum (LinkoutRequiredReason)
      }
    ]
  }
}
Поля
serviceAvailability.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" .

serviceAvailability.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" .

serviceAvailability.durationRestrict

string ( Duration format)

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

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

serviceAvailability.resourcesRestrict

object ( Resources )

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

serviceAvailability.availability[]

object ( Availability )

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

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

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

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

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

string

Имя ресурса сервиса, к которому это нужно применить. В формате partners/{partner_id}/merchants/{merchantId}/services/{serviceId}

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 )

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

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

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

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