הודעות Hint Response

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

סקירה כללית של תהליך התמחור מחדש זמינה בסקירה הכללית על התמחור.

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

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

התאריכים בטווח התאריכים של השותף

בדוגמה הבאה להודעת 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