הודעות Hint Response

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