הודעות Hint Response

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

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

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

רכיב הבסיס של הודעת Hint Response הוא <Hint>. כדי לבקש עדכון של מלון או מסלול, משתמשים ברכיב <Item> אחד או יותר. בהודעת Hint Response אחת אפשר להגדיר מספר בלתי מוגבל של רכיבי <Item>.

בכל הודעת תגובה להצעה צריך לציין לפחות רכיב <Property> אחד לכל <Item>. השדה <Property> מזהה מלון באמצעות אותם מזהים שמשמשים ברשימת המלונות. כברירת מחדל, מציינים מזהה מלון אחד לכל בלוק <Item>. עם זאת, אם אתם משתמשים בטווחי תאריכים של צ'ק-אין או בטווח של ימי שהייה כדי לשנות את המחירים, אתם יכולים להורות ל-Google לאפשר לכלול כמה מלונות בבלוק פריטים.

תהליך הבקשה והתגובה של מסלול נסיעה מדויק

הודעות ההצעה יכולות להתבסס על מסלולי נסיעה ספציפיים, כמו השילוב של תאריך הצ'ק-אין ומשך השהייה. במקרה כזה, מציינים את תאריך הצ'ק-אין ואת משך השהייה במלונות, ו-Google מאחזרת את נתוני התמחור החדשים רק לאותו מסלול נסיעה.

התגובה של השותף/ה

הודעת התשובה הבאה להצעה מגדירה נכס אחד ומסלול אחד:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

התגובה של Google

Google תגיב להודעת התשובה שלכם להצעה באמצעות <Query> שדומה לזו:

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

יצירה של <Transaction>

לאחר מכן, עליך ליצור <Transaction> עם עדכוני מחירים למלון עבור השהייה הבאה:

5/20/23 - 5/23/23

תהליך הבקשה והתגובה של טווחי תאריכים של צ'ק-אין

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