דף זה תורגם על ידי Cloud Translation API.

הודעות בנושא שאילתות

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

רכיב הבסיס של הודעות Query הוא <Query>.

המבנה של הודעת השאילתה תלוי בסוג ההודעה:

תמחור: Google שולחת הודעת שאילתה שמבקשת עדכוני תמחור למלונות שצוינו.
מטא-נתונים: Google שולחת הודעת שאילתה שמבקשת נתונים על החדר ופרטי החבילה במלונות שצוינו.

במהלך ההגדרה הראשונית, מגדירים את נקודת הקצה שבה Google משתמשת כדי לשלוח הודעות שאילתה ושאילתות מחירים בזמן אמת. למידע נוסף, אפשר לפנות למנהל החשבון הטכני (TAM).

‫Google שולחת הודעת שאילתה כבקשת HTTP POST עם הכותרת Content-Type שמוגדרת לערך application/xml והכותרת User-Agent שמוגדרת לערך Google-HotelAdsPrices. החריג לכלל הזה מתרחש במהלך הבדיקה הידנית של השילוב של נקודת הקצה של המחיר דרך Google-TravelAds-Live. יכול להיות שהשאילתות לדוגמה האלה יכללו את הכותרת User-Agent או לא.

מידע מפורט על הפורמט של הודעות שאילתה מופיע בהפניית XML של שאילתה.

הודעות של שאילתות תמחור

בהודעות של שאילתות תמחור מציינים את השילובים של המלון ומסלול הנסיעה שאתם מספקים להם את המחירים.

כשהשרת מקבל הודעת שאילתה מסוג pricing, הוא צריך להשיב בהודעה מסוג <Transaction> שמכילה את פרטי התמחור המבוקשים.

מידע נוסף זמין במאמר סקירה כללית על התמחור.

יש שלושה סוגים מיוחדים של הודעות שאילתה:

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

שאילתות לגבי מחירים בזמן אמת

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

לכל הבקשות לשאילתות תמחור בזמן אמת יש מגבלת זמן תגובה, שבדרך כלל מגיעה ל-4,000 אלפיות השנייה. המגבלה הזו מצוינת בבקשת השאילתה של תמחור בזמן אמת. אם לא ניתן לספק תשובה במסגרת מגבלת הזמן, לא תהיה אפשרות להשתתף בהזדמנות הספציפית. עם זאת, מומלץ לספק מחיר בכל מקרה כדי שניתן יהיה לשמור אותו במטמון ולהשתמש בו בהזדמנויות עתידיות. החיבור לתשובה נשאר פתוח למשך עשר דקות או למשך הזמן שצוין בהגדרות של השותף.

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

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

כללים לשימוש בשאילתות תמחור בזמן אמת

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

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

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

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

עם שאילתות הקשר

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

אם אתם מעוניינים לקבל שאילתות עם הקשר, אתם יכולים לפנות למנהל החשבונות הטכני (TAM). הם יכולים לאשר שאתם מוכנים לקבל הודעות כאלה, ואז לבצע שינוי בהגדרה כדי להתחיל לשלוח לכם הקשרים של משתמשים בשאילתות.

הודעות של שאילתות לגבי מטא-נתונים

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

כשמקבלים הודעה מסוג שאילתת מטא-נתונים, צריך להגיב בהודעה מסוג <Transaction> שמציינת את התמחור של הנכסים המבוקשים ברכיבי <Result>.

מידע נוסף זמין במאמר הגדרת מטא-נתונים של חדרים וחבילות.

שליטה בשאילתות

בקטע הזה מוסבר איך קובעים אילו נכסים ומסלולי נסיעה יכולים להיות נושא של הודעות שאילתה מ-Google.

גבולות מסלול הנסיעה

אתם קובעים את הגבולות האפשריים של שאילתות תמחור באמצעות <ItineraryCapabilities>. אתם מגדירים כללים שקובעים את טווח התאריכים ואת משך השהייה המקסימלי שאתם תומכים בהם.

אפשר להגדיר ערכי ברירת מחדל לפרמטרים <MaxAdvancePurchase> ו-<MaxLengthOfStay> שחלים על כל השילובים של מלונות או מסלולי נסיעה. אפשר גם להגדיר את ההגדרות האלה לקבוצות של מלונות.

דוגמאות להודעות עם שאילתות

בקטע הזה מוצגות כמה דוגמאות להודעות שאילתת תמחור ולהודעת שאילתת מטא-נתונים. דוגמאות נוספות מופיעות בהפניה ל-XML של שאילתות.

מסלול נסיעה לדוגמה

בדוגמה הבאה מוצגת בקשת מחירים <Query> ל-4 מלונות, לשהייה של 3 לילות, החל מ-23 במאי 2023:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

בדוגמה הזו מוצגת בקשה לעדכוני תמחור לכל מלון:

5/23/18 - 6/26/18

דוגמה לשאילתה לגבי תמחור בזמן אמת

בדוגמה הבאה מוצגת שאילתה לתמחור בזמן אמת עם מגבלת זמן תגובה של 500 מילישניות:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

בדוגמה הזו נשלחת בקשה למחיר של מלון יחיד:

6/23/23 - 6/25/23

אפשר לראות דוגמה לתגובה של הודעת עסקה לשאילתה הזו בקובץ ה-XML עם נתוני תמחור וחדרים פנויים לעיון (עסקאות).

דוגמאות לשאילתות עם הקשר

דוגמאות לשאילתות עם הקשר:

שאילתה בסיסית עם הקשר

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

שאילתה עם הקשר, כולל תפוסה

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2025-07-10</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <Context>
        <UserCountry>US</UserCountry>
      </Context>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="7"/>
        </Children>
      </OccupancyDetails>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Context>
        <UserCountry>GB</UserCountry>
      </Context>
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
    </PropertyContext>
  </PropertyContextList>
</Query>

עם שאילתות הקשר מציינים רק את הקשר של המדינה שבה נמצא המשתמש. בעתיד, יכול להיות ששאילתות כאלה יציינו גם את המכשיר של המשתמש.

טווח תאריכי הצ'ק אין

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

בדוגמה הבאה מוצגת הודעת תמחור <Query> לטווחים של תאריכי צ'ק-אין:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

בדוגמה הזו מופיעה בקשה לעדכוני מחירים לשהיות הבאות (לכל מלון):

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

שהיות עם טווח תאריכים

בדוגמה הבאה מוצגת הודעת תמחור <Query> לשהיות בטווח תאריכים:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>