הודעות 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

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