تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

رسائل طلب البحث

رسائل طلبات البحث هي طلبات من Google لتعديلات الأسعار أو البيانات الوصفية. ويُستخدَم هذان الخياران مع كلّ من وضعَي العرض "السعر المسحوب" و"تغيير في السعر".

العنصر الجذر لرسائل طلبات البحث هو <Query>.

تعتمد بنية رسالة الطلب على نوع الرسالة:

الأسعار: تُرسِل Google رسالة طلب تطلب تعديلات الأسعار في الفنادق المحدّدة.
البيانات الوصفية: تُرسِل Google رسالة طلب تطلب فيها بيانات عن الغرفة ومعلومات الحزمة في الفنادق المحدّدة.

يمكنك تحديد نقطة النهاية التي تستخدمها Google لرسائل طلبات البحث وطلبات البحث عن الأسعار المباشرة أثناء الإعداد الأولي. لمزيد من المعلومات، يُرجى التواصل مع مدير الحساب التقني (TAM).

تُرسِل Google رسالة طلب بحث كطلب POST HTTP مع ضبط العنوان Content-Type على "application/xml" وضبط العنوان User-Agent على Google-HotelAdsPrices. يحدث استثناء لهذه القاعدة أثناء الاختبار اليدوي لتكامل نقطة نهاية السعر من خلال Google-TravelAds-Live. قد تحتوي نماذج طلبات البحث هذه على العنوان User-Agent أو لا تحتوي عليه.

يمكن العثور على تنسيق مفصّل لرسائل طلبات البحث في مرجع XML لطلبات البحث.

رسائل طلب الأسعار

تحدِّد رسائل طلب الأسعار مجموعات الفنادق وبرامج الرحلات التي تقدِّم لها الأسعار.

عندما يتلقّى خادمك رسالة طلب الأسعار، من المفترض أن يردّ برسالة <Transaction> تحتوي على معلومات الأسعار المطلوبة.

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على الأسعار.

هناك ثلاثة أنواع خاصة من رسائل الطلب:

الأسعار المباشرة: في حال تفعيلها، يتم إرسال طلبات البحث عندما يتصفّح المستخدم بشكل نشط الأسعار الخاصة بالموقع أو المسار المحدّدَين، ويكون لديك إطار زمني محدّد للردّ.
مع السياق: في حال تفعيل هذه الميزة، يتم تضمين اقتراحات سياق المستخدِم في كل طلب بحث ترسله إليك Google، وتعكس الاقتراحات الأنواع الأكثر شيوعًا من المستخدِمين الذين يبحثون عن مجموعات محددة من الأماكن أو خطط الرحلة. قد يؤدي اتّباع هذه الاقتراحات إلى زيادة كفاءة ردودك.
البيانات الوصفية: هذا طلب للحصول على تفاصيل عن الغرف والحزم للفنادق المحدّدة.

طلبات البحث عن الأسعار في الوقت الفعلي

طلبات السعر في الوقت الفعلي هي طلبات من Google للحصول على تعديلات الأسعار في الوقت الفعلي ردًا على عمليات بحث المستخدمين. تتلقّى Google طلب بحث من أحد المستخدِمين عن مجموعة مؤلفة من فندق أو برنامج رحلة، وبما أنّ بيانات الأسعار غير متاحة أو غير محدّثة، تطلب منك Google تعديل السعر في وقت البحث. من خلال طلبات البحث عن الأسعار المباشرة، يحاول محرّك بحث Google الحصول على سعر وعرضه في النتائج في وقت البحث.

تتسم جميع طلبات البحث عن الأسعار في الوقت الفعلي بحدّ زمني للردّ يبلغ عادةً ما يصل إلى 4,000 ملي ثانية. يتم تحديد هذا الحدّ في طلب البحث عن الأسعار المباشرة. إذا تعذّر تقديم ردّ خلال المدة المحدّدة، سيؤدي ذلك إلى عدم اكتمال مشاركتك في الفرصة المحدّدة. ومع ذلك، ننصحك بتقديم سعر على أي حال حتى يمكن تخزينه مؤقتًا واستخدامه في الفرص المستقبلية. يظلّ الاتصال بالردّ مفتوحًا لمدة عشر دقائق أو كما هو مُحدّد في إعدادات الشريك.

تكون طلبات البحث عن الأسعار المباشرة أيضًا مستندة إلى السياق ويمكنها استرداد الأسعار المتعلّقة بالمَعلمات التالية: بلد المستخدم ونوع الجهاز وعدد النزلاء وما إذا كان هؤلاء النزلاء بالغين أو أطفالًا. باستخدام طلبات البحث عن الأسعار في الوقت الفعلي، يمكنك عرض أسعار محدّثة أكثر تطابقًا مع ما بحث عنه العميل.

تهدف طلبات السعر في الوقت الفعلي إلى أن تكون آلية ثانوية لتعديلات الأسعار. لا تزال الآلية الأساسية لإعادة التسعير هي من خلال "السعر المسحوب" أو "السعر المتغيّر". تساعد طلبات البحث عن الأسعار في الوقت الفعلي في سد الفجوات التي لا تتوفّر فيها أسعار لمجموعات الفنادق أو برامج الرحلات على Google.

قواعد استخدام طلبات البحث عن الأسعار المباشرة

لا تتوفّر بيانات محفوظة مؤقتًا لبرنامج الرحلة المحدّد لأنّ برنامج الرحلة المطلوب غير عادي، مثل تواريخه البعيدة جدًا في المستقبل أو الفندق الذي يتم البحث عنه ببطء شديد.
التاريخ المطلوب ليس التاريخ التلقائي.

: ملاحظة: التواريخ التلقائية غير مؤهّلة لطلبات البحث عن الأسعار في الوقت الفعلي. لا يتم طلب طلبات البحث عن الأسعار في الوقت الفعلي إلا للتواريخ غير التلقائية.

تُخزِّن Google عادةً نتائج الأسعار في الوقت الفعلي لكي لا يتمّ البحث عن الفندق أو الجدول الزمني نفسه مرّة أخرى. ويمكن أن تطلب هذه الطلبات مجموعات مؤلفة من فندق واحد أو برنامج رحلة واحد، بالإضافة إلى مجموعات مؤلفة من عدة فنادق أو برنامج رحلة واحد.

تتيح ميزة الأسعار المباشرة مع السياق لمحرّك بحث Google إرسال طلبات محددة بشأن الأسعار المباشرة استنادًا إلى نوع جهاز المستخدم والبلد الذي يجري فيه البحث وعدد النزلاء، بما في ذلك الأطفال. يتم توسيع كل من رسالة الطلب ورسالة المعاملة لتضمين عنصر <Context> الذي يحدِّد مَعلمات طلب البحث. يمكن تخزين الأسعار التي يتم تلقّيها من طلبات البحث المباشرة عن الأسعار مع السياق مؤقتًا كحزمة غرف، إذا كان السعر خاصًا بإشغال معيّن، وكسعر مشروط، إذا كان السعر خاصًا ببلد أو جهاز مستخدم معيّن.

مع طلبات البحث السياقية

طلبات البحث في السياق هي طلبات عادية لتعديل قاعدة بياناتنا المتعلّقة بالملف الشخصي أو مجموعات خطط الرحلة المحدّدة. وتحتوي هذه القوائم على سياقات مستخدمين رائجة لهذه التركيبات. في حال استخدام الأسعار الشَرطية، قد يكون معدّل إرسال جميع سياقات المستخدِمين المحتمَلة باهظًا، لذلك يمكنك استخدام قائمة سياقات المستخدِمين هذه لتقييد استجابتك. إنّ عرض الأسعار لشدود محددة فقط في سياقات المستخدِمين المحدّدة يغطّي الغالبية العظمى من طلبات بحث المستخدِمين ذات الصلة.

إذا كنت مهتمًا بتلقّي طلبات بحث "مع السياق"، يُرجى التواصل مع مدير حسابك التقني. يمكنهم التأكّد من استعدادك لتلقّي مثل هذه الرسائل، ثم إجراء تعديل على الإعدادات لبدء إرسال سياقات المستخدِمين في طلبات البحث إليك.

رسائل طلب البيانات الوصفية

تحتوي رسائل طلب البيانات الوصفية على تفاصيل عن معلومات الغرف والعروض الترويجية للفنادق المحدّدة.

عند تلقّي رسالة طلب بيانات وصفية، يجب الردّ باستخدام رسالة <Transaction> تحدّد أسعار المواقع المطلوبة في عناصر <Result>.

لمزيد من المعلومات، يُرجى الاطّلاع على تحديد البيانات الوصفية للغرفة والحزمة.

التحكّم في طلبات البحث

يوضّح هذا القسم كيفية التحكّم في الفنادق وبرامج الرحلات التي يمكن أن تكون موضوع رسائل طلبات البحث من Google.

حدود برنامج الرحلة

يمكنك تحديد الحدود المحتملة لطلبات البحث عن الأسعار باستخدام <ItineraryCapabilities>. يمكنك تحديد القواعد التي تحدّد نطاق التواريخ والحد الأقصى لمدّة الإقامة التي يمكنك توفيرها.

يمكنك ضبط قيم تلقائية لكل من <MaxAdvancePurchase> و<MaxLengthOfStay> تنطبق على جميع مجموعات الفنادق أو برامج الرحلات. يمكنك أيضًا تحديد هذه الإعدادات لمجموعات من الفنادق.

أمثلة على رسائل الطلبات

يعرض هذا القسم عدة أمثلة على رسائل طلب الأسعار ورسائل طلب البيانات الوصفية. يمكن العثور على أمثلة إضافية في مرجع طلبات البحث بتنسيق XML.

نموذج برنامج رحلة

يعرض المثال التالي سعرًا <Query> يطلب تعديلات على الأسعار لـ 4 فنادق، متاحة لمدة 3 ليالٍ، وتبدأ من 23 أيار (مايو) 2023:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

يطلب هذا المثال تعديلات الأسعار لكل فندق:

5/23/18 - 6/26/18

مثال على طلب بحث في الأسعار في الوقت الفعلي

يعرض المثال التالي طلب بحث عن الأسعار في الوقت الفعلي بحد زمني للإجابة يبلغ 500 ملي ثانية:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

يطلب هذا المثال سعر فندق واحد:

6/23/23 - 6/25/23

يمكن العثور على نموذج لرسالة المعاملة التي تردّ على هذا الطلب في مرجع XML للأسعار ومستودع الغرف (المعاملات).

مثال على طلب البحث مع السياق

يوضّح المثال التالي مثالاً على طلب بحث باستخدام السياق:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

مع طلبات البحث التي تتضمّن السياق، يتم تحديد سياق بلد المستخدم فقط. في المستقبل، قد تحدِّد هذه الطلبات أيضًا جهاز المستخدم وعدد الأشخاص المقيمين.

النطاقات الزمنية لتسجيل الوصول

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

يعرض المثال التالي رسالة <Query> للأسعار لنطاقات تواريخ تسجيل المغادرة:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

يطلب هذا المثال تعديلات الأسعار للإقامات التالية (لكل فندق):

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

الإقامة على نطاق واسع

يعرض المثال التالي رسالة <Query> للأسعار المتعلّقة بفترة الإقامة:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>