הודעות Hint Response

כש-Google שולחת בקשת רמז הודעה, השרתים שלכם חייבים להשיב עם הודעת Hint Response שמציינת את המלונות המחירים השתנו מאז הפעם האחרונה ש-Google קיבלה רמז מוצלח התשובה מאותם שרתים. אם יהיו שינויים במחירים, Google נשלחת <Query> שמאחזרת את נתוני התמחור המעודכנים מלונות ותוכניות טיול.

לסקירה כללית של תהליך התמחור מחדש אפשר להיכנס סקירה כללית של התמחור.

נקודה חשובה: אם לא מטמיעים שינוי בתמחור, Google אחזור נתונים לגבי כל המלונות ברשימת המלונות.

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

• מסלולי נסיעה מדויקים
• טווחי תאריכים של צ'ק-אין
• שהיות בטווחי

הערה: משך השהייה שמוגדר כברירת מחדל כשמשתמשים ב'מחיר השתנה' הוא 5 ימים.

רכיב הבסיס של הודעת 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

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