כש-Google שולחת הודעת Hint Request, השרתים שלכם צריכים להשיב עם הודעת Hint Response שמציינת את המלונות שהמחירים שלהם השתנו מאז הפעם האחרונה ש-Google קיבלה מאותם שרתים הודעת Hint Response מוצלחת. אם יש שינויים במחירים, Google שולחת <Query> כדי לאחזר את נתוני התמחור המעודכנים של המלונות ומסלולי הנסיעה שצוינו.
סקירה כללית של תהליך התמחור מחדש זמינה במאמר סקירה כללית על תמחור.
הערה כדי לתמחר מחדש את המלונות שנבחרו ואת תוכניות הנסיעה שלהם, הודעות התגובה משתמשות בשיטות הבאות:
רכיב הבסיס של הודעת Hint Response הוא <Hint>. כדי לבקש עדכון של מלון או מסלול נסיעה, משתמשים באלמנט <Item> אחד או יותר. הודעת Hint
Response אחת יכולה להגדיר כל מספר של רכיבי <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 לילות. משך השהייה שמוגדר כברירת מחדל הוא 30 ימים.
תהליך הבקשה והתגובה לגבי הזמנות עם תאריכים גמישים
הודעת 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