כש-Google שולחת בקשת רמז
הודעה, השרתים שלכם
חייבים להשיב עם הודעת Hint Response שמציינת את המלונות
המחירים השתנו מאז הפעם האחרונה ש-Google קיבלה רמז מוצלח
התשובה מאותם שרתים. אם יהיו שינויים במחירים, Google
נשלחת <Query>
שמאחזרת את נתוני התמחור המעודכנים
מלונות ותוכניות טיול.
סקירה כללית על תהליך שינוי התמחור מפורטת במאמר סקירה כללית על תמחור.
בהודעות Hint Response נעשה שימוש בשיטות הבאות כדי לתמחר מחדש את המלונות שנבחרו ומסלולי הנסיעה שלהם:
רכיב הבסיס של הודעת Hint Response הוא <Hint>
. כדי לבקש עדכון של מלון או מסלול, משתמשים ברכיב <Item>
אחד או יותר. רמז אחד
הודעת התשובה יכולה להגדיר כל מספר של רכיבי <Item>
.
כל הודעת Hint Response חייבת לציין לפחות רכיב <Property>
אחד עבור
בכל <Item>
. השדה <Property>
מזהה מלון באמצעות אותם מזהים כמו
ברשימת המלונות. כברירת מחדל, צריך לציין מזהה מלון אחד לכל <Item>
חסימה. עם זאת, אפשר להורות ל-Google לאשר כמה מלונות בפריט אחד
מומלץ לחסום את האפשרות אם משתמשים בטווחי תאריכים של צ'ק-אין או בשהיות בטווח מסוים לצורך תמחור מחדש.
הבקשה המדויקת של מסלול הנסיעה ותהליך התגובה
אפשר לבסס הודעות על רמזים על סמך מסלולי נסיעה ספציפיים, כמו השילוב של תאריך הצ'ק אין ומשך השהייה. במקרה כזה, מציינים את תאריך הצ'ק-אין ואת משך השהייה במלונות, ו-Google מאחזרת את נתוני התמחור החדשים רק לאותו מסלול נסיעה.
התגובה של השותף/ה
הודעת Hint Response הבאה מגדירה נכס יחיד ונכס מסלול נסיעה:
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2023-05-20</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
</Hint>
התגובה של Google
Google משיבה להודעת Hint Response באמצעות <Query>
שדומה לזו
הבאים:
<Query>
<Checkin>2023-05-20</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
יצירה של <Transaction>
אחר כך צריך ליצור <Transaction>
עם עדכוני מחירים עבור
מלון לשהייה הבאה:
5/20/23 - 5/23/23
בקשה לטווחי תאריכים של צ'ק-אין ותהליך תגובה
הודעת Hint Response יכולה לציין טווח של תאריכי צ'ק-אין, שמתחיל ב- תאריך הצ'ק אין הראשון ומסתיים בתאריך הצ'ק אין האחרון. כש-Google מאחזרת נתוני תמחור חדשים, Google מאחזרת מסלולי נסיעה לכל תאריך צ'ק-אין המלון החל מהתאריכים האלה ועד למשך השהייה שציינת.
טווח התאריכים של השותף
הדוגמה הבאה של הודעת Hint Response מגדירה נכס יחיד עם טווח תאריכים לביצוע הצ'ק-אין:
<Hint>
<Item>
<Property>12345</Property>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</Item>
</Hint>
התגובה של Google
Google תגיב להודעת ה-Hint Response הזו באמצעות <Query>
שדומה לזה:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<Nights>5</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
יצירה של <Transaction>
אחר כך צפויה ליצור <Transaction>
עם עדכוני מחירים
לשהייה הבאה במלון הזה:
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23
5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23
בדוגמה הזו נעשה שימוש בברירת המחדל של שהייה של 5 לילות.
תהליך הבקשה לשהייה בטווח מסוים ותהליך התגובה
הודעת Hint Response יכולה לכלול טווח תאריכים שהשתנו. הזה מודיעה ל-Google שהיא צריכה לאחזר כל מסלול נסיעה שמושפע מאחד מהסוגים האלה תאריכים. קבוצת מסלולי הנסיעה בפועל שאוחזרה היא פונקציה של קבוצת התאריכים עם השינויים ושל משך השהייה המקסימלי.
שהיות של שותפים לטווח ארוך
בדוגמה הבאה בהודעת Hint Response נעשה שימוש בשהיות בטווח מסוים:
<Hint>
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</StaysIncludingRange>
</Item>
</Hint>
התגובה של Google
Google משיבה להודעת Hint Response באמצעות <Query>
שדומה לזו
הבאים:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>12345</Property>
<Property>67891</Property>
</PropertyList>
</Query>
יצירה של <Transaction>
אחר כך צריך ליצור <Transaction>
עם עדכוני מחירים עבור
מלון לשהיות הבאות:
5/17/23 - 5/20/23
5/18/23 - 5/20/23
5/18/23 - 5/21/23
5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/21/23 - 5/22/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
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23