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: قيمة السلسلة هذه هي "رقم تعريف الحساب". مدرجة في صفحة "إعدادات الحساب" في "مركز إدارة معلومات الفنادق".

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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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: قيمة السلسلة هذه هي "رقم تعريف الحساب". مدرجة في صفحة "إعدادات الحساب" في "مركز إدارة معلومات الفنادق".

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

المعرّف الفريد للغرفة التي يشير إليها هذا السعر. يمكنك استخدام رقم التعريف هذا لمطابقة بيانات "حزمة الغرف" مع ما أرسلته في بيانات الغرف. لمزيد من المعلومات، يُرجى الاطّلاع على البيانات الوصفية لحزمة الغرف.

إذا تمت تعبئة roomTypeId، يجب أيضًا تعبئة ratePlanId.
ratePlanId

string

المعرّف الفريد لبيانات الحزمة التي يشير إليها هذا السعر. استخدِم رقم التعريف هذا لمطابقة بيانات "حزمة الغرف" مع ما أرسلته في بيانات الحزمة. لمزيد من المعلومات، يُرجى الاطّلاع على البيانات الوصفية لحزمة الغرف.

إذا تمت تعبئة ratePlanId، يجب أيضًا تعبئة roomTypeId.

LosOccupancyPrices

أسعار مدة الإقامة، مجمّعة حسب عدد سعر الإقامة للبالغين

تمثيل JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
الحقول
prices[]

object (LosPrices)

أسعار مدة الإقامة تنطبق جميع الأسعار في prices على فندق معيّن وتاريخ وصول ومنتج وإقامة.
adults

integer

الحدّ الأقصى لعدد النزلاء الذين يمكن حجزهم في كل غرفة، بما في ذلك البالغين والأطفال يتم ضبط هذه القيمة لجميع الأسعار ضمن حقل "إشغال الأسعار" المقابل ويجب أن تكون عددًا صحيحًا موجبًا بين 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، سنخفض أي أسعار ترسلها بما يزيد عن السعر الثلاثين.

ويجب تمثيل مُدد الإقامة غير المتاحة باستخدام 0.
taxes[]

number

تمثّل هذه السمة العنصر الضريبي لأسعار مدة الإقامة.

يجب أن تكون قائمة الضرائب مفصولة بفواصل. تتوافق القيمة في الفهرس n مع مدة الإقامة n+1.
fees[]

number

اختياريّ. تمثّل هذه السمة الرسوم الخاصة بمدة الإقامة.

يجب أن تكون قائمة الرسوم مفصولة بفواصل. تتوافق القيمة في الفهرس n مع مدة الإقامة n+1.
rateRuleId

string

بالنسبة إلى الأسعار المشروطة، يطابق هذا المعرّف سعرًا مع تعريف في ملف "تعريف قاعدة السعر".

عدد الأحرف المسموح به لهذا الحقل هو 40 حرفًا.
currencyCode

string

رمز العملة المكوَّن من ثلاثة أحرف الذي يتم تقديم الأسعار والضرائب به. على سبيل المثال، "USD" للدولار الأمريكي.

ينطبق هذا الإعداد على rates وtaxes.