קובץ XML עם נתוני שאילתות ורמזים לעיון

בקטע הזה מופיע מידע על הודעות בקשה לרמז, הודעות תגובה לרמז והודעות שאילתה מבוססות-XML של Google.

<Hint> (הודעת Hint Response)

רכיב הבסיס של הודעת Hint Response. הודעות תגובה עם רמזים מציינות אילו שילובים של בתי מלון או של מסלולי נסיעה צריך לתמחר מחדש. הן התשובה שלכם להודעת Hint Request מ-Google.

הודעת Hint Response צריכה לציין רק את המלונות שהמחירים שלהם השתנו מאז הפעם האחרונה שבה Google קיבלה הודעת Hint Response מוצלחת מהשרתים שלכם.

Query

הודעות התגובה של ההצעה לשיפור משתמשות באחת מהשיטות הבאות כדי לציין אילו מלונות ומסלולי נסיעה Google צריכה לתמחר מחדש:

  • מסלולי נסיעה מדויקים: שילוב של תאריך הצ'ק-אין ומשך השהייה.

  • טווח תאריכי הצ'ק אין: מציין טווח של תאריכי צ'ק אין, החל מתאריך הצ'ק אין הראשון ועד תאריך הצ'ק אין האחרון.

  • שהיות עם טווח תאריכים (או לוחות זמנים לטיול עם טווח תאריכים)

כל אחת מהשיטות האלה דורשת תחביר שונה להודעת התגובה של הרמז.

מידע נוסף זמין במאמר בנושא הודעות תגובה של רמזים.

תחביר

תחביר הרכיב <Hint> משתנה בהתאם לסוג ההודעה Hint Response:

מסלולי נסיעה מדויקים

הדוגמה הבאה מציגה את התחביר של מסלולים מדויקים בהודעת תשובה עם רמז:

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>hotel_ID</Property>
    ...
    <Stay>
      <CheckInDate>checkin_date</CheckInDate>
      <LengthOfStay>number_of_nights</LengthOfStay>
    </Stay>
  </Item>
  ...
</Hint>

טווחים של צ'ק-אין

בדוגמה הבאה מוצג התחביר של טווחי הצ'ק-אין בהודעת תגובה עם רמז:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <Property>hotel_ID</Property>
    [...]

    <!-- Required -->
    <FirstDate>first_checkin_date</FirstDate>
    <!-- Required -->
    <LastDate>last_checkin_date</LastDate>
  </Item>
  ...
</Hint>

שהיות עם טווח תאריכים

בדוגמה הבאה מוצג התחביר של שהיות בטווח מסוים בהודעת Hint Response (תשובה עם רמז):

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <Property>1458700</Property>
    <Property>5418701</Property>
    <StaysIncludingRange>
      <!-- Required -->
      <FirstDate>2025-04-28</FirstDate>
      <!-- Optional -->
      <LastDate>2025-04-29</LastDate>
    </StaysIncludingRange>
  </Item>
  ...
</Hint>

מאפיינים

הרכיב <Hint> מכיל מאפיין אופציונלי: id. אם מספקים את הערך הזה, הוא נכלל כמאפיין hintId בהודעות <Query> שנשלחות על סמך <Hint>.

רכיבי צאצא

הרכיב <Hint> כולל את רכיבי הצאצא הבאים:

רכיב צאצא חובה? סוג סוג התשובה של ההצעה תיאור
<CheckInDate> Required Date מסלולי נסיעה מדויקים תאריך הצ'ק-אין של תוכנית הנסיעה.
<FirstDate> Required Date טווחים של צ'ק-אין ומסלולי נסיעה עם טווחים התאריך הראשון בטווח התאריכים של טווח הצ'ק-אין או של הודעת Hint Response לגבי שהייה בטווח תאריכים. התאריכים כוללים את היום הראשון והיום האחרון.
<Item> Required Object הכול קונטיינר של המלון או תוכנית הנסיעה שרוצים לעדכן.
<LastDate> Required* Date טווחים של צ'ק-אין ומסלולי נסיעה עם טווחים

התאריך האחרון בטווח התאריכים של טווח צ'ק-אין או של הודעת Hint Response לגבי שהייה בטווח. התאריכים כוללים את היום הראשון והיום האחרון.

* האלמנט הזה הוא אופציונלי לשהיות עם טווח תאריכים.
<LengthOfStay> Required integer מסלולי נסיעה מדויקים מספר הלילות במסלול הנסיעה, כמספר שלם חיובי.
<Property> Required string הכול

המזהה של המלון, שזהה למזהה שמופיע ברשימת המלונות. מספר הרכיבים מסוג <Property> שאפשר לציין בבלוק <Item> יחיד נקבע לפי סוג הודעת התשובה של ההצעה:

  • תוכניות נסיעה מדויקות: עד 100 מלונות.
  • טווחים של צ'ק-אין: יותר מאחד אם מגדירים את הערך <MultipleItineraries> ל-"checkin_range" בהודעה <QueryControl>.
  • שהייה בטווח: יותר מאחד אם מגדירים את <MultipleItineraries> ל-"affected_dates" בהודעה <QueryControl>.
<Stay> Required Object מסלולי נסיעה מדויקים קונטיינר של הרכיבים <CheckinDate> ו-<LengthOfStay> בהודעת תגובה של רמז לתוכנית נסיעה מדויקת. כל <Item> יכול להכיל רק <Stay> אחד.
<StaysIncludingRange> Required Object מסלולי נסיעה עם טווח תאריכים קונטיינר לרכיבים <FirstDate> ו-<LastDate> בהודעת תגובה להצגת רמז בטווח.

דוגמאות

מסלולי נסיעה מדויקים

בדוגמה הבאה מוגדרים כמה מסלולי נסיעה לנכס יחיד הודעת Hint Response:

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>4</LengthOfStay>
    </Stay>
  </Item>
</Hint>

טווחים של צ'ק-אין

בדוגמה הבאה מפורטים שני מלונות שהמחירים שלהם השתנו וצריך לאחזר אותם מחדש. ‫Google מקבלת את כל מסלולי הנסיעה בין 3 ביולי ל-6 ביולי עבור נכסים 12345 ו-67890:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Property>67890</Property>
    <FirstDate>2018-07-03</FirstDate>
    <LastDate>2018-07-06</LastDate>
  </Item>
</Hint>

שהיות עם טווח תאריכים

בדוגמה הבאה מוצגים שני שימושים שונים בשהיות בטווח תאריכים, אחד לטווח של לילות והשני ללילה בודד:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <!-- Google fetches prices for all itineraries (first and last date are set) -->
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
      <LastDate>2018-07-06</LastDate>
    </StaysIncludingRange>
  </Item>

  <!-- Google fetches prices for a single night (first date only) -->
  <Item>
    <Property>67890</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
    </StaysIncludingRange>
  </Item>
</Hint>

לכל אחת מהדוגמאות האלה, Google משיבה עם <Query>, ואתם צריכים להשיב עם <Transaction> שכולל עדכוני מחירים למלונות או למסלולי הנסיעה שצוינו.

<HintRequest>

רכיב הבסיס של הודעת Hint Request. ‫Google שולחת לשרת בקשת רמז ומצפה לקבל תגובה שמציינת את המלונות ואת תוכניות הנסיעה שהמחירים שלהם השתנו מאז הפעם האחרונה ש-Google קיבלה מהשרת תגובה מוצלחת של רמז.

אם יש שינויים במחירים, Google שולחת <Query> שמביא את נתוני התמחור המעודכנים של המלונות ומסלולי הנסיעה שצוינו.

מידע נוסף זמין במאמר בנושא הודעות בקשה לרמזים.

תחביר

התחביר של רכיב <HintRequest> הוא:

תחביר

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest>
  <LastFetchTime>last_fetch_time</LastFetchTime>
</HintRequest>

מאפיינים

לרכיב <HintRequest> אין מאפיינים.

רכיבי צאצא

הרכיב <HintRequest> כולל את רכיבי הצאצא הבאים:

רכיב צאצא סוג תיאור
<LastFetchTime> DateTime הפעם האחרונה שבה Google הצליחה לקבל הודעת Hint Response בתגובה להודעת Hint Request.

אם חלף זמן רב יותר מאז הפעם האחרונה שעדכנתם את המחירים בשרת, עליכם להשיב עם הודעת רמז שמציינת אילו מלונות השתנו.

אם לא היה אחזור מוצלח לאחרונה, הערך הזה יוגדר כערך קבוע של מרווח זמן (כדי למנוע בעיות חמורות יותר עם הצטברות גדולה של נתונים). ערך המרווח הקבוע הנוכחי הוא 1,000 שניות, אבל הוא עשוי להשתנות.

מידע נוסף זמין במאמר בנושא הודעות תגובה של רמזים.

דוגמאות

בדוגמה הבאה מוצגת הודעת Hint Request:

הודעת Hint Request

הנה דוגמה להודעת Hint Request:

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="ABCDEF" timestamp="2018-06-07T16:20:00Z">
  <LastFetchTime>2018-03-25T00:04:09Z</LastFetchTime>
</HintRequest>

<Query>

רכיב הבסיס של הודעת Query. הודעות Query הן בקשות מ-Google לעדכוני תמחור או מטא-נתונים. הם משמשים גם עם מצבי המסירה 'שליפה' ו'שינוי מחיר'.

הודעות של שאילתות תמחור

בהודעות של שאילתות תמחור מציינים את שילובי המלונות והמסלולים שאתם מספקים להם מחירים.

כשהשרת מקבל הודעת שאילתה מסוג pricing, הוא צריך להשיב בהודעה מסוג <Transaction> שמכילה את פרטי התמחור המבוקשים.

מידע נוסף מופיע במאמר סקירה כללית על התמחור.

יש שלושה סוגים מיוחדים של הודעות Query:

  • תמחור בזמן אמת: Google מגיבה לבקשה ספציפית של משתמש ומבקשת עדכון מחיר בזמן אמת. כששותפים מקבלים הודעת Live pricing query הודעה, הם צריכים להשיב בהודעת <Transaction> שכוללת את פרטי התמחור המבוקשים ברכיבי <Result>.

  • עם תמחור לפי הקשר: Google מעדכנת את מטמון המחירים שלה על סמך הקשרים שהיו פופולריים בעבר. כשמקבלים הודעה, צריך להשיב עם הודעת <Transaction> שמכילה את פרטי התמחור המבוקשים ברכיבי <Result>.With Context query

    • עם שאילתות לפי הקשר לחדרים ליחידים

      כשמספקים מחירים בתגובה לשאילתות עם הקשר, צריך לשלוח רק את המחיר שמתאים להקשר שצוין. התעריף הבסיסי לחדר זוגי מחייב לפחות 2 אורחים, כך שאם תעבירו תעריף בסיסי לאורח יחיד, המערכת תתעלם ממנו ותתייחס לחדר כחדר זוגי. במקרה כזה, צריך להעביר את התעריף הבסיסי כלא זמין ולהשתמש בתעריף מקונן בתוך התעריף לחדר ליחיד. אפשר לעיין בדוגמה לתשובה עם הקשר. אפשר להשתמש בתמחור משתנה עם הקשר כדי למזג מחירים על ידי הגדרת המאפיין mergeable לערך "true". מידע נוסף

    • תמחור עדכני (נקרא בעבר 'שליפה עם רמזים') עם הקשר

      כששולחים <Transaction> תגובה להודעה על שינוי מחירים עם שאילתת הקשר, Google מתייחסת אליה כאל החלפה מלאה של נתוני המחירים והזמינות של מלון או מסלול נסיעה מסוימים, וכל המחירים שרלוונטיים להקשר מסוים לא נכללים בתגובה ומוסרים מהזיכרון מטמון.

      כדי למנוע החלפה, צריך להגדיר את המאפיין mergeable לערך "true" באלמנט <Result> בהודעה <Transaction>. ‫Google מוסיפה את שיעורי ההמרה לשיעורי ההמרה הקיימים ששמורים במטמון עבור ההקשר שצוין בתגובה. אם לא משתמשים במאפיין שאפשר למזג, צריך לשלוח בתגובה את כל המחירים לכל ההקשרים הרלוונטיים.

    • שאילתת תמחור בזמן אמת עם הקשר

      שאילתת תמחור בזמן אמת עם הקשר כוללת כברירת מחדל את אופן הפעולה של מאפיין שניתן למיזוג, ולכן אין צורך להגדיר את המאפיין הזה. צריך לשלוח את התעריפים רק עבור הקשרים הספציפיים ש-Google ביקשה, אם כל שאר ההקשרים נשארים זהים. אם השתנו הקשרים האחרים, צריך לשלוח את השינויים האלה באופן מפורש. אחרת, התעריפים החדשים לא יתעדכנו במטמון של Google.

  • מטא-נתונים: Google מבקשת עדכונים של המטא-נתונים של החדרים ושל חבילות החדרים במלונות שצוינו. כשמקבלים הודעת Metadata Query, צריך להשיב בהודעת <Transaction> שמציינת נתונים על החדרים ועל חבילות החדרים ברכיבי <PropertyDataSet>. מידע נוסף זמין במאמר מטא-נתונים של חבילות לחדרים.

תחביר

התחביר של רכיב <Query> הוא:

שאילתת תמחור

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
</Query>

מחיר בזמן אמת

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
  <!-- See documentation below for <Context> -->
  <Context>
   ...
  </Context>
</Query>

עם שאילתת הקשר

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyContextList>
    <PropertyContext>
      <Property>hotel_id</Property>
      ...
      <!-- See documentation below for <Context> -->
      <Context>
      ...
      </Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

מטא-נתונים

<HotelInfoProperties>
  <Property>property_ID</Property>
  ...
</HotelInfoProperties>

מאפיינים

רכיב <Query> יכול להכיל מאפיין אחד: latencySensitive.

המאפיין latencySensitive הוא אופציונלי. אם הערך שמוגדר הוא true, זה אומר שהשאילתה היא Live Pricing Query. כדי ש-Google תשלח שאילתות עם מאפיין latencySensitive, צריך לפנות למנהל החשבונות הטכני.

רכיבי צאצא

הרכיב <Query> כולל את רכיבי הצאצא הבאים:

רכיב צאצא סוג השאילתה סוג תיאור
<AffectedNights> Pricing integer מספר הלילות לשהייה בטווח תאריכים. הרכיב הזה משמש רק בשאילתות של תמחור שהייה עם טווח תאריכים, שמשמשות עם שינוי במחיר.
<Checkin> Pricing Date התאריכים של שינוי מחיר ספציפי.
<Context> Pricing (Live Pricing Queries only) <Context> בשאילתות של תמחור בזמן אמת, מציינים פרמטרים מסוימים שלפיהם השאילתה מתבצעת. רכיבי הצאצא כוללים:
  • <Occupancy>: המספר הכולל של האורחים
  • ‫<OccupancyDetails>: סוג האורחים, למשל מבוגרים או ילדים
  • ‫<UserCountry>: המדינה שבה נמצא המשתמש
  • ‫<UserDevice>: סוג המכשיר שבו האורח השתמש כדי לחפש מלון, כמו "mobile,‏ 'tablet' או 'desktop'.

אפשר לחזור על הרכיב <Context> בבקשה אחת, כדי לאפשר שאילתות לגבי תפוסות שונות. <Context> כולל רשימה של רכיבי צאצא, תחביר ודוגמאות.
<FirstDate> Pricing Date תאריך ההתחלה של טווח מסלולי הנסיעה שעליהם חל התמחור. הרכיב הזה משמש רק בשאילתות של תמחור לפי טווח תאריכים של תאריך הצ'ק אין, שמשמשות עם שינוי במחיר.
<HotelInfoProperties> Metadata string נכס אחד או יותר ש-Google רוצה לקבל לגביו מטא-נתונים מעודכנים של חדר ושל חבילת חדרים בהודעת מטא-נתונים Query. האלמנט הזה יכול להכיל אלמנט אחד או יותר של <Property> שמציינים מזהי נכסים של מלונות.
<LastDate> Pricing Date תאריך הסיום של טווח תוכניות הנסיעה שאליהן המחיר מתייחס. הרכיב הזה משמש רק לשאילתות של טווח תאריכים לביצוע צ'ק-אין, שמשמשות עם Pull + Hints.
<Nights> Pricing integer מספר הלילות במסלול מסוים, עד 30.
<PropertyList> Pricing Object

מזהה אחד או יותר של מלונות שנדרשים עדכוני מחירים לגביהם.

מגדירים כל מלון באלמנט <Property>. הערך הוא מחרוזת שזהה למזהה של מלון ברשימת המלונות. לדוגמה:

<PropertyList>
  <Property>pid1</Property>
  <Property>pid2</Property>
</PropertyList>

דוגמאות

שאילתת תמחור

בדוגמה הבאה מוצגת הודעת שאילתת תמחור שמבקשת עדכוני מחירים עבור קבוצה של מלונות, לשהייה של 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>

שאילתה לגבי מחיר בזמן אמת

בדוגמה הבאה מוצגת שאילתת תמחור בזמן אמת עם מגבלת זמן תגובה של 500 אלפיות השנייה:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="8"/>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

עם שאילתת הקשר

<?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>

עם תשובה בהקשר

בדוגמה הבאה מוסבר איך להגדיר את המחיר הבסיסי ל-unavailable(-1) לחדר עם אדם אחד, ואיך להציב את המחירים בתוך רכיב <Occupancy>.

<?xml version="1.0" encoding="UTF-8"
<Transaction id="Wtdj8QoQIWcAAbaTGlIAAAC4" timestamp="2025-11-19T18:36:48Z">
<Result>
  <Property>6781291</Property>
  <Checkin>2026-01-15</Checkin>
  <Nights>1</Nights>
  <!-- Base rate is set to -1 to indicate unavailability for the default (2-person) occupancy -->
  <Baserate currency="USD">-1</Baserate>
  <Tax currency="USD">0</Tax>
  <OtherFees currency="USD">0</OtherFees>
  <Rates>
    <!-- Nested Rate for Single Occupancy -->
    <Rate rate_rule_id="rule-951">
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
      <Baserate currency="USD">150.00</Baserate>
      <Tax currency="USD">15.00</Tax>
      <OtherFees currency="USD">5.00</OtherFees>
    </Rate>
  <!-- Other nested rates for different occupancies or room types could be included here if available -->
  </Rates>
</Result>
</Transaction>

שאילתה לקבלת מטא נתונים

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

דוגמאות נוספות, כולל שאילתות תמחור של שהייה בטווח תאריכים וטווח תאריכי הצ'ק אין, זמינות בQuery דוגמאות להודעות.

<Context>

רכיב  מתאר מידע על , כולל מספר האורחים וסוגם, המדינה של המשתמש והמכשיר של המשתמש.<Context>Live pricing query

לעולם לא ייעשה שימוש בכמה מכשירי <Context> עם מדינות משתמשים שונות או מכשירי משתמשים שונים. אם משתמשים בכמה <Context> כדי לשלוח שאילתה לגבי כמה תפוסות, צריך לספק את המחיר לכל תפוסה כחבילת חדרים נוספת לנכס או למסלול הטיול המתאימים. לכל נכס או מסלול נסיעה צריך להיות בלוק <Result> אחד עם המחירים לכמה אנשים בחדר.

פרטי התשובה לשאילתת <Context> מופיעים ב<OccupancyDetails>.

תחביר

התחביר של רכיב <Context> הוא:

תחביר

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>date</Checkin>
  <Nights>number_of_nights</Nights>
  <DeadlineMs>number_of_milliseconds</DeadlineMs>
  <PropertyList>
    <Property>property_ID</Property>
  </PropertyList>
  <Context>
    <Occupancy>total_number_of_guests</Occupancy>
    <OccupancyDetails>
      <NumAdults>number_of_adults</NumAdults>
      <Children>
        <Child age=age_of_one_child_guest/>
        <Child age=age_of_one_child_guest/>
      </Children>
    </OccupancyDetails>
    <UserCountry>end_user_country</UserCountry>
    <UserDevice>user_device_type</UserDevice>
  </Context>
</Query>

רכיבי צאצא

הרכיב <Context> כולל את רכיבי הצאצא הבאים:

רכיב צאצא סוג השאילתה סוג תיאור
<Occupancy> Pricing integer מציין את מספר האורחים הכולל.

למרות שזה לא חובה, שאילתות עם <Occupancy> צריכות להחזיר הודעת עסקה עם חבילות החדרים המתאימות שמוגדרות לכל <Occupancy>, אבל אם חבילות החדרים לא זמינות, מומלץ לציין את הרכיב <Occupancy>.

הערה: יכול להיות שהסמל <Occupancy> לא תמיד יופיע בשאילתה. במקרים כאלה, צריך להחזיר את המחירים של כל התפוסות.
<OccupancyDetails> Pricing Object הוא קודם ל-<Occupancy>. מציין אורחים לפי סוג, כולל:
  • ‫<NumAdults>: מספר האורחים המבוגרים
  • ‫<Children> and <Child="age">: מציין אילו אורחים הם ילדים (בדרך כלל בגיל 0 עד 17), ואפשר גם לציין את הגיל של כל ילד.

אף על פי שאין חובה להשתמש ב-<OccupancyDetails>, מומלץ להשתמש בו כדי להגדיר את חבילות החדרים המתאימות לכל <Occupancy>. אם חבילות החדרים לא זמינות, מומלץ לציין את הרכיב <OccupancyDetails>.

הערה: יכול להיות שהפונקציה <OccupancyDetails> לא תמיד תופיע בשאילתה. במקרים כאלה, צריך להניח שכל האורחים הם מבוגרים.
<UserCountry> Pricing string

מסנן את המחירים לפי המדינה שבה נמצא המשתמש. הערך הוא קוד מדינה בן 2 אותיות, כמו "US" לארצות הברית, או קוד אזור, כמו "EU" לאירופה.

שאילתות עם <UserCountry> מוגדר צריך להניב הודעת עסקה עם הבלוק המתאים <Rates> שמוגדר למדינה שנשאלה.
<UserDevice> Pricing string

מסננים את המחירים לפי סוג המכשיר שממנו המשתמש מחפש. ערכים אפשריים:

  • mobile
  • desktop
  • tablet

שאילתות עם <UserDevice> מוגדרות צריכות להניב הודעת עסקה עם בלוק <Rates> מתאים שמוגדר לסוג המכשיר שנשלחה לגביו השאילתה.

דוגמאות

תפוסה

בדוגמה הבאה מוצגת שאילתת מחירים בזמן אמת עבור <Occupancy> בתוך <Context>. השאילתה לתמחור בזמן אמת היא ל-3 אורחים מבוגרים.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

פרטי התפוסה

בדוגמה הבאה מוצגת שאילתה לקבלת מחירים בזמן אמת עם <OccupancyDetails> בתוך <Context>. שאילתת המחירים בזמן אמת היא ל-4 אורחים, מתוכם 2 ילדים, והיא מחפשת תעריף שרלוונטי להזמנה של אורח מארה"ב ממכשיר נייד:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="4"/>
        <Child age="12"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

הקשרים מרובים

בדוגמה הבאה מוצג שימוש ברכיב <Context> נוסף בשאילתת מחירים בזמן אמת.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
  <Context>
    <Occupancy>6</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
      <Children>
        <Child age="6"/>
        <Child age="10"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>