Method: accounts.properties.ingestLosPropertyPrices

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

HTTP-запрос

POST https://travelpartnerprices.googleapis.com/v1/{propertyPrices.property=accounts/*/properties/*}:ingestLosPropertyPrices

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

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

Параметры
propertyPrices.property

string

Имя ресурса PropertyPrices . Имеет форму accounts/{account_id}/properties/{property_id} .

account_id : это строковое значение представляет собой значение «Идентификатор учетной записи», указанное на странице настроек учетной записи в Hotel Center.

property_id : значение этого элемента должно представлять собой строку, соответствующую идентификатору объявления в фиде списка отелей.

Тело запроса

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

JSON-представление 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
Поля
requestTime

string ( Timestamp format)

Необходимый. Момент времени отправки сообщения о цене LoS, выраженный в виде строки в формате RFC 3339 .

Любое сообщение, отправленное с requestTime в течение предыдущих 24 часов, будет обработано, а те, которые этого не сделали, будут отброшены.

Сообщения обрабатываются в порядке requestTime независимо от порядка их получения. Например, обновление цены с requestTime 2019-05-03T14:09:00Z , полученное после сообщения для тех же маршрутов с requestTime 2019-05-03T14:10:00Z будет отброшено в пользу более позднего. сообщение с отметкой времени.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

propertyPrices.arrivalDatePrices[]

object ( LosArrivalDatePrices )

Цены на дату заезда. Все цены в пределах этого arrivalDayPrices относятся к конкретному объекту размещения, но к разным датам прибытия.

Тело ответа

В случае успеха тело ответа содержит экземпляр PropertyPrices .

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

ЛосНедвижимостьЦены

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

JSON-представление 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
Поля
arrivalDatePrices[]

object ( LosArrivalDatePrices )

Цены на дату заезда. Все цены в пределах этого arrivalDayPrices относятся к конкретному объекту размещения, но к разным датам прибытия.

property

string

Имя ресурса PropertyPrices . Имеет форму accounts/{account_id}/properties/{property_id} .

account_id : это строковое значение представляет собой значение «Идентификатор учетной записи», указанное на странице настроек учетной записи в Hotel Center.

property_id : значение этого элемента должно представлять собой строку, соответствующую идентификатору объявления в фиде списка отелей.

ЛосПрибытиеДатаЦены

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

JSON-представление 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Поля
productPrices[]

object ( LosProductPrices )

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

startDate

object ( Date )

productPrices будет применяться ко всем датам прибытия между startDate и endDate включительно.

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

endDate

object ( Date )

productPrices будет применяться ко всем датам прибытия между startDate и endDate включительно.

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

Дата

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

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Связанные типы:

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год даты. Должно быть от 1 до 9999 или 0, чтобы указать дату без года.

month

integer

Месяц года. Должно быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должно быть от 1 до 31 и действительно для года и месяца, или 0, чтобы указать год отдельно или год и месяц, если день не имеет значения.

ЛосПродуктЦены

Цены на продолжительность пребывания, сгруппированные по типу продукта (комбинацииroomTypeId/ratePlanId).

JSON-представление 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
Поля
occupancyPrices[]

object ( LosOccupancyPrices )

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

roomTypeId

string

Уникальный идентификатор номера, к которому относится эта цена. Используйте этот идентификатор, чтобы сопоставить данные пакета комнаты с тем, что вы отправили в данных комнаты. Дополнительную информацию см. в метаданных Room Bundle .

Если roomTypeId заполнено, необходимо также заполнить ratePlanId .

ratePlanId

string

Уникальный идентификатор данных пакета, к которым относится эта цена. Используйте этот идентификатор, чтобы сопоставить данные Room Bundle с тем, что вы отправили в packagedata. Дополнительную информацию см. в метаданных Room Bundle .

Если ratePlanId заполнен, необходимо также заполнить roomTypeId .

ЛосЗаселениеЦены

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

JSON-представление 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
Поля
prices[]

object ( LosPrices )

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

adults

integer

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

ЛосПрайс

Цены на продолжительность пребывания.

JSON-представление 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
Поля
rates[]

number

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

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

Должен быть список тарифов, разделенных запятыми. Значение индекса n соответствует продолжительности пребывания n+1 .

Вы должны отправить полный набор LoS из 30 цен одновременно. Если вы отправите менее 30, мы обработаем все предоставленные цены LoS как обычные, а остальные тарифы до уровня LoS 30 будут считаться недоступными. Если вы отправите более 30, мы удалим все отправленные вами цены, превышающие 30-ю ставку.

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

taxes[]

number

Налоговая составляющая стоимости проживания.

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

fees[]

number

Необязательный. Платная составляющая стоимости проживания.

Должен быть указан список комиссий, разделенных запятыми. Значение индекса n соответствует продолжительности пребывания n+1 .

rateRuleId

string

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

Ограничение на количество символов в этом поле составляет 40 символов.

currencyCode

string

Трехбуквенный код валюты, в котором указаны ставки и налоги. Например, «USD» для долларов США.

Применяется к rates и taxes .