דף זה תורגם על ידי Cloud Translation API.

הפניית XML לשאילתות & רמזים

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

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

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

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

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

מסלולי נסיעה מדויקים: שילוב של תאריך הצ'ק-אין ומשך השהייה.
טווחי תאריכי צ'ק אין: טווח של תאריכי צ'ק אין, החל מתאריך הצ'ק אין הראשון ועד לתאריך הצ'ק אין האחרון.
שהיות בטווח תאריכים (או מסלולי טיול בטווח תאריכים)

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

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

תחביר

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

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

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

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

שהיות בטווח ימים

התחביר של טווחי השהייה בהודעת תגובה עם רמז מופיע בהמשך:

<!-- 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	טווחי צ'ק-אין ומסלולים בטווח זמן	התאריך הראשון בטווח התאריכים של טווח הצ'ק-אין או של הודעת התשובה של ההנחיה לגבי טווח השהייה. התאריכים כוללים את הימים האלה.
<Item>	Required	Object	הכול	מאגר של המלון או של תוכנית הנסיעה שרוצים לעדכן.
<LastDate>	Required*	Date	טווחי צ'ק-אין ומסלולים בטווח זמן	התאריך האחרון בטווח התאריכים של טווח הצ'ק-אין או של טווח השהייה, בהודעת התשובה של ההנחיה. התאריכים כוללים את הימים האלה. * האלמנט הזה הוא אופציונלי לשהיות בטווח ימים.
<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>` בהודעת תגובה לטיפים לגבי טווחי זמן להזמנת אירוח.

דוגמאות

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

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

<!-- 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. אם התאריך הזה ישן יותר מהתאריך שבו עדכנתם בפעם האחרונה את המחירים בשרת, עליכם להשיב עם הודעת Hint Response (תגובה עם רמז) שבה יצוינו המלונות שהשתנו. אם לא בוצע אחזור מוצלח לאחרונה, הערך הזה יוגדר לערך של מרווח זמן קבוע (כדי למנוע בעיות חמורות יותר עם עומסי עבודה גדולים). הערך הנוכחי של מרווח הזמן הקבוע הוא 1,000 שניות, אבל הוא עשוי להשתנות. למידע נוסף, ראו הודעות תגובה עם רמזים.

רכיב צאצא

סוג

תיאור

DateTime

הפעם האחרונה שבה Google הצליחה לקבל הודעת Hint Response בתגובה להודעת Hint Request.

אם התאריך הזה ישן יותר מהתאריך שבו עדכנתם בפעם האחרונה את המחירים בשרת, עליכם להשיב עם הודעת Hint Response (תגובה עם רמז) שבה יצוינו המלונות שהשתנו.

אם לא בוצע אחזור מוצלח לאחרונה, הערך הזה יוגדר לערך של מרווח זמן קבוע (כדי למנוע בעיות חמורות יותר עם עומסי עבודה גדולים). הערך הנוכחי של מרווח הזמן הקבוע הוא 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 מעדכנת את מטמון המחירים שלה על סמך הקשרים שהיו פופולריים בעבר. כשמקבלים הודעת With context query, צריך להשיב לה בהודעת <Transaction> שמכילה את פרטי התמחור המבוקשים ברכיבים <Result>.
מטא-נתונים: 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, צריך לפנות למנהל החשבונות הטכני (TAM).

רכיבי הצאצאים

לרכיב <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	תאריך הסיום של טווח מסלולי הנסיעה שאליו חל התמחור. הרכיב הזה משמש רק לשאילתות תמחור לפי טווח תאריכי צ'ק-אין שמשמשות עם 'משיכה + רמזים'.
<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>

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

<?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>`. הערה: יכול להיות שהשדה `<Occupancy>` לא יופיע תמיד בשאילתה. במקרים כאלה, צריך להחזיר את המחירים של כל רמות התפוסה.
<OccupancyDetails>	Pricing	Object	מופיע לפני `<Occupancy>`. מציין את האורחים לפי סוג, כולל: `<NumAdults>`: מספר האורחים המבוגרים `<Children>` ו-`<Child="age">`: מציינים אילו אורחים הם ילדים (בדרך כלל בגיל 0 עד 17), ואפשר לכלול את הגיל של כל ילד או ילדה. לא חובה להוסיף את השדה `<OccupancyDetails>` לשאילתות, אבל אם תוסיפו אותו, תקבלו הודעת טרנזקציה עם חבילות החדרים המתאימות שמוגדרות לכל `<Occupancy>`. אם חבילות החדרים לא זמינות, מומלץ לציין את האלמנט `<OccupancyDetails>`. הערה: הערך `<OccupancyDetails>` לא תמיד מופיע בשאילתה. במקרים כאלה, צריך להניח שכל האורחים הם מבוגרים.
<UserCountry>	Pricing	string	סינון התעריפים לפי המדינה שבה המשתמש נמצא. הערך הוא קוד מדינה בן שתי אותיות, כמו `"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>

הפניית XML לשאילתות & רמזים קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

תחביר

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

טווחי צ'ק-אין

שהיות בטווח ימים

מאפיינים

רכיבי הצאצאים

דוגמאות

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

טווחי צ'ק-אין

שהיות בטווח ימים

<HintRequest>

תחביר

תחביר

מאפיינים

רכיבי הצאצאים

דוגמאות

הודעת Hint Request

<Query>

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

תחביר

שאילתת תמחור

תמחור בזמן אמת

עם הקשר

מטא-נתונים

מאפיינים

רכיבי הצאצאים

דוגמאות

שאילתת תמחור

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

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

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

<Context>

תחביר

תחביר

רכיבי הצאצאים

דוגמאות

תפוסה

פרטי התפוסה

מספר הקשרים

הפניית XML לשאילתות & רמזים

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

`<HintRequest>`

`<Query>`

`<Context>`