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

رسائل طلب البحث هي طلبات من 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>

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