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

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

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

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

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

• البيانات الوصفية: ترسل Google رسالة "طلب بحث" تطلب الحصول على بيانات حول الغرفة. ومعلومات الحزمة في الفنادق المحددة.

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

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

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

رسائل طلبات البحث عن السعر

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

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

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

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

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

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

3. البيانات الوصفية: هذه عبارة عن طلب للحصول على تفاصيل حول الغرف والحزم الخصائص المحددة.

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

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

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

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

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

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