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

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

رسائل الاستعلام هي طلبات من Google لتعديل الأسعار أو البيانات الوصفية. ويتم استخدامها مع طريقتَي العرض "جذب العملاء" و"تغيير في السعر".

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

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

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

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

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

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

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

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

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

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

عند تلقّي رسالة طلب بيانات وصفية، عليك الردّ برسالة <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, 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>

طلب بحث مع سياق يتضمّن الإشغال

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2025-07-10</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <Context>
        <UserCountry>US</UserCountry>
      </Context>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="7"/>
        </Children>
      </OccupancyDetails>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Context>
        <UserCountry>GB</UserCountry>
      </Context>
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
    </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

Ranged Stays

يعرض المثال التالي رسالة <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>