Method: accounts.properties.ingestLosPropertyPrices

با استفاده از قیمت‌های قالب‌بندی شده برای مدت اقامت، قیمت‌های یک ملک را به‌روزرسانی کنید. برای یک ملک معین، هر تاریخ ورود در محدوده درخواستی، تمام قیمت‌های LOS، از جمله همه محصولات و اشغال‌ها، جایگزین می‌شود. قیمت هایی که تاریخ ورود آنها خارج از محدوده تاریخ مشخص شده است، تحت تأثیر قرار نمی گیرند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
propertyPrices.property

string

نام منبع PropertyPrices . دارای فرم accounts/{account_id}/properties/{property_id} .

account_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 ​​Price به صورت رشته ای با فرمت RFC 3339 بیان می شود.

هر پیامی که با requestTime در 24 ساعت قبل ارسال شود، پردازش می‌شود و پیام‌هایی که ارسال نشده‌اند، نادیده گرفته می‌شوند.

پیام‌ها به ترتیب requestTime پردازش می‌شوند، بدون توجه به ترتیبی که دریافت می‌شوند. به عنوان مثال، یک به‌روزرسانی قیمت با requestTime 2019-05-03T14:09:00Z که پس از پیامی برای همان برنامه‌های سفر با requestTime 2019-05-03T14:10:00Z دریافت می‌شود، به نفع بعداً نادیده گرفته می‌شود. پیام مهر زمانی

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "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 مراجعه کنید.

LosPropertyPrices

قیمت مدت اقامت، مشخص شده در سطح ملک.

نمایندگی JSON 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
فیلدها
arrivalDatePrices[]

object ( LosArrivalDatePrices )

قیمت برای تاریخ ورود همه قیمت‌ها در این arrivalDayPrices قیمت‌ها برای یک ملک خاص اعمال می‌شود، اما تاریخ‌های ورود متفاوت است.

property

string

نام منبع PropertyPrices . دارای فرم accounts/{account_id}/properties/{property_id} .

account_id : این مقدار رشته، مقدار "Account ID" است که در صفحه تنظیمات حساب در Hotel Center فهرست شده است.

property_id : مقدار این عنصر باید رشته ای باشد که با شناسه فهرست در فید فهرست هتل شما مطابقت داشته باشد.

LosArrivalDatePrices

قیمت‌های مدت اقامت، گروه‌بندی شده بر اساس محدوده تاریخ ورود.

نمایندگی 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 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.

LosProductPrices

قیمت‌های مدت اقامت، گروه‌بندی شده بر اساس نوع محصول (ترکیبات roomTypeId/ratePlanId).

نمایندگی JSON 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
فیلدها
occupancyPrices[]

object ( LosOccupancyPrices )

قیمت برای یک اشغال همه قیمت ها در این occupancyPrices قیمت ها برای یک ملک خاص، تاریخ ورود، ترکیب محصول، اما برای اشغال های مختلف اعمال می شود.

roomTypeId

string

شناسه منحصر به فرد اتاقی که این قیمت به آن اشاره دارد. از این شناسه برای مطابقت دادن داده‌های Room Bundle با آنچه در داده‌های اتاق ارسال کرده‌اید، استفاده کنید. برای اطلاعات بیشتر، به فراداده اتاق بسته مراجعه کنید.

اگر roomTypeId پر شده باشد، ratePlanId نیز باید پر شود.

ratePlanId

string

شناسه منحصربه‌فرد برای داده‌های بسته که این قیمت به آن اشاره دارد. از این شناسه برای مطابقت دادن داده‌های Room Bundle با آنچه در داده‌های بسته ارسال کرده‌اید استفاده کنید. برای اطلاعات بیشتر، به فراداده اتاق بسته مراجعه کنید.

اگر ratePlanId پر شده باشد، roomTypeId نیز باید پر شود.

LosOccupancyPrices

قیمت‌های مدت اقامت، گروه‌بندی شده بر اساس تعداد افراد بزرگسال.

نمایندگی JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
فیلدها
prices[]

object ( LosPrices )

قیمت مدت اقامت تمام قیمت ها در prices برای یک ملک خاص، تاریخ ورود، محصول و ترکیب اشغال اعمال می شود.

adults

integer

حداکثر تعداد مهمان هایی که می توان در هر اتاق رزرو کرد، شامل بزرگسالان و کودکان. این مقدار برای همه نرخ‌ها در قسمت occupancyPrices مربوطه تنظیم شده است و باید یک عدد صحیح مثبت بین 1 و 99 باشد.

LosPrices

قیمت مدت اقامت

نمایندگی JSON 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
فیلدها
rates[]

number

جزء نرخ پایه قیمت مدت اقامت.

در صورت ارائه ارزش taxes مربوطه، این نرخ بدون احتساب مالیات است (قیمت کل حاصل جمع نرخ و مالیات مربوطه خواهد بود).

باید لیستی از نرخ ها با کاما جدا شده باشد. مقدار در شاخص n مربوط به مدت اقامت n+1 است.

شما باید مجموعه کامل LoS از 30 قیمت را در یک زمان ارسال کنید. اگر کمتر از 30 عدد ارسال کنید، همه قیمت‌های LoS ارائه‌شده را به‌صورت عادی پردازش می‌کنیم و نرخ‌های باقی‌مانده را تا سقف 30 LoS در دسترس نیست. اگر بیش از 30 ارسال کنید، قیمت‌هایی را که بیش از نرخ 30 ارسال کنید، کاهش می‌دهیم.

مدت اقامت غیرقابل دسترس باید با 0 نشان داده شود.

taxes[]

number

جزء مالیاتی قیمت مدت اقامت.

باید فهرستی از مالیات ها با کاما باشد. مقدار در شاخص n مربوط به مدت اقامت n+1 است.

fees[]

number

اختیاری. جزء هزینه قیمت های مدت اقامت.

باید لیستی از هزینه ها با کاما جدا شده باشد. مقدار در شاخص n مربوط به مدت اقامت n+1 است.

rateRuleId

string

برای نرخ‌های شرطی ، این شناسه نرخی را با تعریفی در فایل تعریف قانون نرخ شما مطابقت می‌دهد.

محدودیت کاراکتر برای این فیلد 40 کاراکتر است.

currencyCode

string

کد ارز سه حرفی که در آن نرخ ها و مالیات ها ارائه می شود. به عنوان مثال، "USD" برای دلار آمریکا.

برای rates و taxes اعمال می شود.