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

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

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

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

  • الأسعار: ترسل Google رسالة "طلب بحث" تطلب تعديل أسعار الفنادق المحدّدة.

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

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

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

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

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

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

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

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

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

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

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

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

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

إنّ طلبات البحث عن الأسعار في الوقت الفعلي هي طلبات من 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>

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

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/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

بالإضافة إلى الإقامة التي بدأت قبل (ولكن تشمل) الليلة المحدَّدة:

5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

رسالة طلب البحث عن البيانات الوصفية

يعرض المثال التالي رسالة <Query> تطلب تعديلات البيانات الوصفية للغرفة ومعلومات الحزمة لعدة مواقع:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

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