תמחור & מלאי חדרים (עסקאות) XML עם הפניה

בדף הזה מופיע מידע על הודעות עסקאות מבוססות XML.

<Transaction>

אלמנט השורש של הודעת עסקה הוא <Transaction>. זהו קובץ שמכיל מידע תיאורי על חדרים וחבילות, ועל התמחור והזמינות שלהם.

הרכיב <Transaction> מופיע במיקום הבא בהיררכיית ה-XML של הודעת העסקה:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

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

תחביר

התחביר של רכיב <Transaction> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp" id="transaction_ID">

  <!-- Defines data about a room or package (Room Bundle) -->
  <PropertyDataSet>
    ...
  </PropertyDataSet>

  <!-- Updates/sets prices and availability for rooms and Room Bundles -->
  <!-- (Also removes itineraries from inventory) -->
  <Result>
    ...
  </Result>

</Transaction>

מאפיינים

לרכיב <Transaction> יש את המאפיינים הבאים:

מאפיין חובה? סוג תיאור
id Required string מזהה ייחודי לכל הודעת עסקה.
partner Optional string חשבון השותף שאליו מתייחסת הודעת התמחור והזמינות. בדרך כלל משתמשים באפשרות הזו אם הקצה העורפי מספק פידים של מחירים לכמה חשבונות שותפים. ערך המחרוזת הזה הוא הערך של 'מפתח השותף' שמופיע בדף הגדרות החשבון ב-Hotel Center.
timestamp Required DateTime

המועד שבו נשלחה הודעת העסקה.

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

ההודעות מעובדות לפי הסדר של timestamp ולא לפי הסדר שבו הן מתקבלות. לדוגמה, עדכון מחיר עם חותמת זמן 2019-05-03 14:09:00 שמתקבל אחרי הודעה עם חותמת זמן 2019-05-03 14:10:00 עדיין יעובד לפי הסדר, והמחיר מההודעה עם חותמת הזמן 2019-05-03 14:10:00 ישמש.

רכיבי צאצא

הרכיב <Transaction> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<PropertyDataSet> Optional* <PropertyDataSet>

תיאור של חדר ספציפי וחבילות של חדרים. בדרך כלל משתמשים ברכיב הזה בהודעת עסקה נפרדת כדי להגדיר ערכים משותפים לחבילות חדרים וכדי לצמצם את הגודל של הודעות העסקה.
<Result> Optional* <Result>

נתוני תמחור של מסלול שהייה בחדר או רכיב <RoomBundle> שמגדיר חבילות חדרים וסוגים נוספים של חדרים בנכס. אפשר להשתמש גם ברכיב <Result> כדי להסיר מסלולי נסיעה מהמלאי.
* צריך לספק לפחות אחד מהערכים <PropertyDataSet> או <Result>.

דוגמאות

נתוני החדר

בדוגמה הבאה מוגדרים נתוני חדר בהודעת עסקה:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>5440OF</RoomID>
      <Name>
        <Text text="Single King Bed Room" language="en"/>
        <Text text="Simple Lit de Roi" language="fr"/>
      </Name>
      <Description>
        <Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
          and down comforters (bedspreads). City view. 300 square feet. Desk with
          rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
          complimentary HBO and pay movies." language="en"/>
        <Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Bathroom View" language="en"/>
          <Text text="La salle de baines" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Capacity>4</Capacity>
    </RoomData>
  </PropertyDataSet>
</Transaction>

נתוני תמחור

בדוגמה הבאה מוגדרים נתוני תמחור בהודעת עסקה:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>060773</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">278.33</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="site1"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>052213</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">299.98</Baserate>
    <Tax currency="USD">26.42</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="otto"/>
      <PointOfSale id="simon"/>
    </AllowablePointsOfSale>
    <MilesIncluded>
      <NumberOfMiles>1200</NumberOfMiles>
      <Provider>
        <Text language="en" text="United Airlines"/>
      </Provider>
      <LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
    </MilesIncluded>
  </Result>
</Transaction>

מחירים ללילה

בדוגמה הבאה מוגדרים נתוני תמחור לשהייה של לילה אחד עד 7 לילות החל מ-7 ביוני 2023:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">209.99</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">419.98</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">614.97</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>4</Nights>
    <Baserate currency="USD">819.96</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>5</Nights>
    <Baserate currency="USD">999.95</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>6</Nights>
    <Baserate currency="USD">1193.94</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>7</Nights>
    <Baserate currency="USD">1259.93</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
</Transaction>


תעריפים בסיסיים ותעריפים בלעדיים

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

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>1</Nights>

    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">1.00</OtherFees>

    <Rates>
      <!-- The rate_rule_id is required when using conditional rates -->
      <Rate rate_rule_id="mobile">
        <!-- Override base rate and taxes for conditional rates -->
        <Baserate currency="USD">180.00</Baserate>
        <Tax currency="USD">18.00</Tax>
      </Rate>
    </Rates>

  </Result>
</Transaction>

הסרת מלאי שטחי פרסום

בדוגמה הבאה מוצגות כמה יחידות מלאי שהוסרו (שהייה של לילה אחד בתאריכים שונים) ממלאי של מלון:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-05-23T16:20:00-04:00" id="42">
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-23</Checkin>
    <Nights>1</Nights>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-24</Checkin>
    <Nights>1</Nights>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
  <!---Sending <Baserate> is optional with <Unavailable> -->
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-25</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">-1</Baserate>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
</Transaction>

<PropertyDataSet>

מאגר למידע על חדר ועל חבילה (או חבילת חדרים) בהודעה של <Transaction>. ערכים שמוגדרים ברמת המלון מבטלים ערכים שמוגדרים ברמת השותף. ‫Google מאחסנת את המידע הזה כדי שלא תצטרכו להגדיר אותו בכל פעם שתשלחו עדכוני מחירים.

הרכיב <PropertyDataSet> מופיע במיקום הבא בהיררכיית ה-XML של הודעת העסקה:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>  // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

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

תחביר

התחביר של רכיב <PropertyDataSet> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <PropertyDataSet>
    <!-- (Required) ID that matches the Hotel List Feed -->
    <Property>hotel_ID</Property>

    <!-- (Optional) Defines metadata about a room -->
    <RoomData>
      ...
    </RoomData>

    <!-- (Optional) Defines package metadata to be paired with rooms (Room Bundles) -->
    <PackageData>
      ...
    </PackageData>
  </PropertyDataSet>
  ...
</Transaction>

מאפיינים

לרכיב <PropertyDataSet> אין מאפיינים.

רכיבי צאצא

הרכיב <PropertyDataSet> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<PackageData> Optional* <PackageData> תיאור של חבילת חדרים. הנתונים האלה משויכים לשותף ולמלון, אבל לא למסלול נסיעה. האלמנט הזה דומה ל-<RoomData>, אבל הוא מתאר שירותים ותנאים שלא נכללים בתיאור הפיזי של החדר.

אתם מציינים את מזהה החבילה בעדכוני המחירים.

מידע נוסף אפשר לקרוא במאמר בנושא מטא-נתונים של חבילות חדרים.
<Property> Required string מזהה של מלון שהנתונים המשויכים רלוונטיים לגביו. הערך של הרכיב הזה חייב להיות מחרוזת שתואמת לערך של <id> בפיד רשימת המלונות.
<RoomData> Optional* <RoomData> תיאור של חדר. הנתונים האלה משויכים לשותף ולמלון, אבל לא למסלול נסיעה.

מציינים את מזהה החדר בעדכוני המחירים.
* צריך לספק לפחות אחד מהערכים <PackageData> או <RoomData>.

דוגמאות

נתונים של חדרים וחבילות

בדוגמה הבאה מוצגים נתונים של חדר ושל חבילה ב-<PropertyDataSet>:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>180054</Property>
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Bed Room" language="en"/>
        <Text text="Chambre single" language="fr"/>
      </Name>
      <Description>
        <Text text="Non-smoking" language="en"/>
        <Text text="Pas de fumiers" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>P54321</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
        <Text text="Avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Includes a delightful array of jams and jellies." language="en"/>
        <Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
      </Description>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

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

<RoomData>

הגדרה של מטא-נתונים שלא תלויים במסלול הנסיעה לגבי חדרים, ובהרחבה, לגבי חבילות חדרים (כי חבילות חדרים הן חדרים בתוספת שירותים נוספים). כדי לצמצם את כמות הנתונים שחוזרים על עצמם בפיד המחירים, אפשר להשתמש ב-<RoomData>.

הרכיב <RoomData> מופיע במיקום הבא בהיררכיית ה-XML של הודעת העסקה:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

רכיבי <RoomData> מכילים מידע שמשויך לשותף ולמלון, אבל לא למסלול נסיעה. המטרה היא להשתמש בנתונים האלה לכל מה שלא קשור למסלול הנסיעה.

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

אפשר להגדיר את הרכיבים <RoomData> ו-<PackageData> לאותו חדר או לאותו חבילת חדרים. כש-Google מציגה את החדר או את החבילה בתוצאות החיפוש, היא כוללת את התיאורים משני המקורות, מופרדים במקף.

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

תחביר

התחביר של רכיב <RoomData> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <PropertyDataSet>
    ...
    <RoomData>
      <RoomID>room_ID</RoomID>

      <Name>
        <Text text="room_name" language="language_code"/>
        ...
      </Name>

      <Description>
        <Text text="room_description" language="language_code"/>
        ...
      </Description>

      <Capacity>max_number_of_occupants</Capacity>
      <Occupancy>max_number_of_intended_occupants</Occupancy>
      <OccupancyDetails> <!-- optional info about the types of guests,
      whether adults, children, or seniors --></OccupancyDetails>
      <OccupancySettings>
        <MinOccupancy>min_number_of_occupants</MinOccupancy>
        <MinAge>min_age_of_occupants</MinAge>
      </OccupancySettings>

      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
          ...
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      <RoomFeatures>
        ...
      </RoomFeatures>
    </RoomData>
    ...
  </PropertyDataSet>
</Transaction>

מאפיינים

לרכיב <RoomData> אין מאפיינים.

רכיבי צאצא

הרכיב <RoomData> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<Capacity> Optional integer מספר האורחים המקסימלי שיכולים להתארח בחדר. בחדר, הקיבולת גדולה ממספר האורחים או שווה לו.

אם מציינים את הערך הזה, הוא צריך להיות שווה לערך של רכיב <Occupancy> או גדול ממנו. הערך הזה הוא מספר האורחים המיועד לחדר מסוים. לדוגמה, יכול להיות שדירוג <Capacity> של סוויטה גדולה יהיה 6, אבל דירוג <Occupancy> שלה יהיה 4.

הערך של <Capacity> חייב להיות מספר שלם חיובי בין 1 ל-20, כולל.
<Description> Optional Object תיאור מפורט של החדר. הרכיב הזה צריך להכיל מידע שלא מתואר על ידי רכיבים אחרים או על ידי הרכיב <Name>. כשמציינים את תיאור החדר, לא צריך להשתמש באותיות רישיות.

הרכיב <Description> מקבל רכיב צאצא יחיד, <Text>, שיש לו שני מאפיינים נדרשים:

  • ‫text: תיאור מפורט של החדר.
  • ‫language: קוד שפה בן שתי אותיות. לדוגמה, fr.

משתמשים ברכיב <Text> נפרד לכל שפה שבה המודעה או הקישור החינמי להזמנה עשויים להופיע (עם ערכים שונים למאפייני language).

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

<Description>
  <Text text="Two queen-sized beds" language="en"/>
  <Text text="Deux lits de la reine" language="fr"/>
</Description>
<Name> Required string השם של קטגוריית החדר. הערך הזה צריך להיות זהה לערך שמופיע בדף הנחיתה של המלון (לשעבר נקודת המכירה). אל תגדירו את הערך של הרכיב הזה באותיות גדולות בלבד.

הרכיב הזה מקבל רכיב צאצא יחיד, <Text>, שכולל את שני מאפייני החובה הבאים:

  • ‫text: שם החדר.
  • ‫language: קוד שפה בן שתי אותיות. לדוגמה, fr.

משתמשים ברכיב <Text> נפרד לכל שפה שבה המודעה או הקישור החינמי להזמנה עשויים להופיע (עם ערכים שונים למאפיינים language).

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

<Name>
  <Text text="Standard Double Room" language="en"/>
  <Text text="Le chambre double" language="fr"/>
</Name>
<Occupancy> Optional integer מספר האורחים המקסימלי שהחדר מיועד להם. לדוגמה, סוויטה גדולה יכולה להכיל פיזית 6 אורחים (קיבולת = 6), אבל היא מיועדת לעד 4 אורחים בלבד.

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

הערך של <Occupancy> חייב להיות מספר שלם חיובי בין 1 ל-99, כולל.

‫<Occupancy> may be accompanied by <OccupancyDetails>, which specifies the type of guests (adults or children). מידע על התחביר ותיאור של רכיבי צאצא זמין במאמר בנושא <OccupancyDetails>.
<OccupancySettings> Optional Object הגדרות שיכולות להגביל או לשנות את דרישות התפוסה של חדר.

הרכיב <OccupancySettings> מקבל את רכיבי הצאצא הבאים:

  • ‫<MinOccupancy>: מספר האורחים המינימלי שיכולים לשהות בחדר. לדוגמה, אם הערך שמוגדר הוא 2, אי אפשר להזמין את החדר הזה לאורח אחד.

    הערך של <MinOccupancy> חייב להיות מספר שלם חיובי בין 1 ל-99, כולל.

  • ‫<MinAge>: הגיל המינימלי של כל האורחים שמתארחים בחדר. לדוגמה, אם הערך שמוגדר הוא 18, אפשר להזמין את החדר הזה רק לקבוצות שבהן כל האורחים הם בני 18 ומעלה.

    הערך של <MinAge> חייב להיות מספר שלם חיובי בין 0 ל-99, כולל.

<OccupancySettings>
  <MinOccupancy>2</MinOccupancy>
  <MinAge>16</MinAge>
</OccupancySettings>

לא צריך לכלול את כל רכיבי הצאצא.
<PhotoURL> Optional Object כתובת URL וכיתוב אופציונלי לתמונה של החדר או של חבילת החדר. אפשר לציין יותר מ-<PhotoURL> לחדר או לחבילת חדר. כל כתובת URL של תמונה צריכה להיות בתג <PhotoURL> משלה.

הרכיב הזה מקבל את רכיבי הבן הבאים:

  • ‫<URL>: ציון המיקום של התמונה. המיקום צריך להיות ציבורי (לא מוגן בחומת אש) ולכלול את הפרוטוקול (לדוגמה, https://). צריך להשתמש רק ב-<URL> אחד לכל <PhotoURL>.
  • ‫<Caption>: מגדיר את הכיתוב של התמונה. האלמנט הזה מקבל רכיב צאצא יחיד, <Text>, שכולל שני מאפיינים נדרשים: text ו-language. המאפיין text הוא הכיתוב, והמאפיין language מציין קוד שפה בן שתי אותיות, כמו en.

דוגמה:

<PhotoURL>
  <URL>https://www.example.com/static/bar/image1234.jpg</URL>
  <Caption>
    <Text text="A bright and breezy way to enjoy your mornin'
      cuppa tea." language="en"/>
    <Text text="Une façon lumineuse et aérée pour profiter
      de votre journée tasse de thé." language="fr"/>
  </Caption>
</PhotoURL>
<PhotoURL>
  <URL>https://www.foo.com/static/bar/image5678.jpg</URL>
  <Caption>
    <Text text="Or, perhaps you prefer coffee." language="en"/>
    <Text text="Ou peut-être préférez-vous le café." language="fr"/>
  </Caption>
</PhotoURL>
<RoomFeatures> Optional <RoomFeatures> מכיל מידע על התכונות של החדר.
<RoomID> Required string המזהה הייחודי של החדר. משתמשים במזהה הזה כדי להתאים את נתוני החדרים לבלוקים <Result> בעדכוני המחירים. מידע נוסף זמין במאמר מטא-נתונים של חבילות חדרים. (אפשר גם להשתמש במזהה הזה כדי להפנות להגדרה של חדר משותף בהודעת עסקה אחת כשמגדירים נתוני חדרים בתוך ההודעה).

דוגמאות

נתוני החדר

בדוגמה הבאה מוגדרים נתוני חדר:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>5440OF</RoomID>
      <Name>
        <Text text="Single King Bed Room" language="en"/>
        <Text text="Simple Lit de Roi" language="fr"/>
      </Name>
      <Description>
        <Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
          and down comforters (bedspreads). City view. 300 square feet. Desk with
          rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
          complimentary HBO and pay movies." language="en"/>
        <Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Bathroom View" language="en"/>
          <Text text="La salle de baines" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Capacity>4</Capacity>
    </RoomData>
  </PropertyDataSet>
</Transaction>

מטא-נתונים של חדרים וחבילות

בדוגמה הבאה מוגדרים מטא-נתונים של חדר ושל חבילה:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>180054</Property>
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Bed Room" language="en"/>
        <Text text="Chambre single" language="fr"/>
      </Name>
      <Description>
        <Text text="Non-smoking" language="en"/>
        <Text text="Pas de fumiers" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>P54321</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
        <Text text="Avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Includes a delightful array of jams and jellies." language="en"/>
        <Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
      </Description>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

חבילות לכמה חדרים

בדוגמה הבאה מוגדרים מטא-נתונים של חדרים וחבילות לכמה חבילות של חדרים:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <!-- A transaction message with room types result. -->
  <PropertyDataSet>
    <Property>12345</Property>
    <RoomData>
      <RoomID>single</RoomID>
      <Name>
        <Text text="Single room" language="en"/>
        <Text text="Chambre simple" language="fr"/>
      </Name>
      <Description>
        <Text text="A single room" language="en"/>
        <Text text="Le chambre simple" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image1235.jpg</URL>
      </PhotoURL>
      <Capacity>2</Capacity>
    </RoomData>
    <RoomData>
      <RoomID>double</RoomID>
      <Name>
        <Text text="Double room" language="en"/>
        <Text text="Chambre double" language="fr"/>
      </Name>
      <Occupancy>1</Occupancy>
    </RoomData>
    <PackageData>
      <PackageID>refundbreakfast</PackageID>
      <Name>
        <Text text="Refundable Room with Breakfast" language="en"/>
        <Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Continental Breakfast" language="en"/>
        <Text text="Petit déjeuner continental" language="fr"/>
      </Description>
      <ChargeCurrency>hotel</ChargeCurrency>
      <Refundable available="1" refundable_until_days="3"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>prepaid</PackageID>
      <Name>
        <Text text="Nonrefundable" language="en"/>
        <Text text="Non remboursable" language="fr"/>
      </Name>
      <Description>
        <Text text="Blah blah blad" language="en"/>
        <Text text="Le blah blah blad" language="fr"/>
      </Description>
      <Occupancy>2</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="0"/>
    </PackageData>
  </PropertyDataSet>
</Transaction>

<RoomFeatures>

המאפיין הזה מגדיר את התכונות שנמצאות בחדר.

הרכיב <RoomFeatures> מופיע במיקום הבא בהיררכיית ה-XML של הודעת העסקה:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
            + <RoomFeatures>

תחביר

התחביר של רכיב <RoomFeatures> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <PropertyDataSet ... >
    ...
    <RoomData>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle>
        <Beds>
           <Bed size="[single|semi_double|double|queen|king]">
             <Width unit="cm" number="width"/>
             <Length unit="cm" number="length"/>
           </Bed>
           <!-- Include with any additional beds. -->
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>[shared|private]</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>[smoking|non_smoking]</Smoking>
        <BathAndToilet relation="[together|separate]">
          <Bath bathtub="[false|true]" shower="[false|true]"/>
          <Toilet electronic_bidet="[false|true]" mobility_accessible="[false|true]"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <!-- (Optional) Defines the type of views from the room. -->
          <!-- Example: <OceanView/> -->
        </Views>

      </RoomFeatures>
      ...
    </RoomData>
    ...
  </PropertyDataSet>
</Transactions>

מאפיינים

לרכיב <RoomFeatures> אין מאפיינים.

רכיבי צאצא

הרכיב <RoomFeatures> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<JapaneseHotelRoomStyle> Optional enum

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

הערכים החוקיים כוללים:

  • western: חדר בסגנון מערבי עם מיטות.
  • ‫japanese: חדר בסגנון יפני עם מיטות פוטון.
  • japanese_western: חדר בסגנון יפני-מערבי עם מיטות בסגנון מערבי ופוטונים בסגנון יפני.
<Beds> Optional Object מכיל מספר <Bed> כמספר החדרים. הערה: אין לכלול כאן את הפוטונים היפניים.

לכל <Bed> יש את המאפיינים הבאים:

  • ‫size (אופציונלי): הערכים התקפים הם single, semi_double, ‏ double, ‏ queen, ו-king.
לכל תג <Bed> יש את רכיבי הצאצא הבאים:
  • ‫<Width> (אופציונלי): מציין את רוחב המיטה. חובה לציין את מאפיין unit עם הערך cm ואת מאפיין number עם רוחב המיטה בסנטימטרים שלמים.
  • ‫<Length> (אופציונלי): מציין את אורך המיטה. חייב לכלול את המאפיין unit עם הערך cm ואת המאפיין number עם אורך המיטה בסנטימטרים של מספר שלם.
דוגמה: 
<Beds>
  <Bed size="double">
    <Width unit="cm" number="140"/>
    <Length unit="cm" number="195"/>
  </Bed>
  <Bed/> <!-- Size unknown -->
</Beds>
<Suite> Optional empty צריך לספק את הרכיב הזה אם החדר הוא סוויטה.
<Capsule> Optional empty צריך לספק את הרכיב הזה אם החדר הוא חדר קפסולה.
<Roomsharing> Optional enum האם החדר הזה משותף עם דיירים אחרים, כמו בעלים או אורחים אחרים. הערכים החוקיים הם shared ו-private.
<Outdoor> Optional empty צריך לספק את האלמנט הזה אם החדר הוא מקום לינה חיצוני ללא קירות קבועים, אינסטלציה ובקרת אקלים. לדוגמה, חדרי מלון לא נחשבים ליחידות אירוח חיצוניות, אבל אתרי קמפינג שבהם האורחים ישנים באוהלים ופארקים לקרוואנים שבהם האורחים מביאים את הקרוואן שלהם נחשבים ליחידות אירוח חיצוניות.
<MobilityAccessible> Optional empty צריך לספק את האלמנט הזה אם החדר מתאים לשימוש של אנשים עם מוגבלויות בניידות.
<Smoking> Optional enum האם החדר הזה הוא חדר ללא עישון או חדר עם עישון. הערכים התקינים הם non_smoking ו-smoking.
<BathAndToilet> Optional Object מכיל מידע על אמבטיה ושירותים בחדר.

המאפיין הוא:

  • ‫relation (אופציונלי): מציין איך האמבטיה והשירותים ממוקמים זה מול זה. הערכים התקפים הם together (גם האמבטיה וגם השירותים ממוקמים יחד באותו חדר, למשל חדר אמבטיה, זה לצד זה) ו-separate (לאמבטיה ולשירותים יש מקומות ייעודיים). אסור להגדיר את המאפיין הזה אם בחדר אין אמבטיה ושירותים.

הרכיב יכול לכלול את רכיבי הצאצא הבאים:

  • ‫<Bath> (אופציונלי): אם הרכיב הזה קיים, זה מצביע על כך שיש בחדר אמבטיה.

    אלה המאפיינים:

    • ‫bathtub (אופציונלי): מציין שיש אמבטיה בחדר הרחצה. הערכים התקינים הם 0 (או false) ו-1 (או true).
    • ‫shower (אופציונלי): מציין שיש מקלחת באמבטיה. הערכים התקינים הם 0 (או false) ו-1 (או true).
  • ‫<Toilet> (אופציונלי): אם הרכיב הזה קיים, זה אומר שיש בחדר הזה שירותים.

    אלה המאפיינים:

    • ‫electronic_bidet (אופציונלי): מציין שלאסלה יש בידה אלקטרוני. הערכים התקינים הם 0 (או false) ו-1 (או true).
    • ‫mobility_accessible (אופציונלי): מציין שהשירותים מותאמים למוגבלים בניידות. הערכים התקינים הם 0 (או false) ו-1 (או true).

דוגמה:

<BathAndToilet relation="separate">
  <Bath bathtub="1" shower="1"/>
  <Toilet
    electronic_bidet="1"
    mobility_accessible="1"/>
</BathAndToilet>
<OpenAirBath> Optional empty צריך לספק את הרכיב הזה אם בחדר יש אמבטיה פרטית בחוץ.
<AirConditioning> Optional empty צריך לספק את הרכיב הזה אם בחדר יש מיזוג אוויר.
<Balcony> Optional empty צריך לספק את הרכיב הזה אם בחדר יש מרפסת או מרפסת מקורה.
<Views> Optional Object האפשרויות התקינות כוללות:

<AirportView/>
<BayView/>
<BeachView>/>
<CastleView/>
<CityView/>
<CountrysideView/>
<CourtyardView/>
<DuneView/>
<ForestView/>
<GardenView/>
<GolfCourseView/>
<HarborView/>
<LagoonView/>
<LakeView/>
<MarinaView/>
<MountainView/>
<NatureView/>
<OceanView/>
<ParkView/>
<PartialOceanView/>
<PisteView/>
<PoolView/>
<PyramidView/>
<RiverView/>
<StreetView/>

דוגמאות

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

שתי מיטות יחיד

בדוגמה הבאה מוצג אופן השימוש בפונקציה <RoomFeatures>:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two single beds -->
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>private</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>non_smoking</Smoking>
        <BathAndToilet relation="separate">
          <Bath bathtub="1" shower="1"/>
          <Toilet electronic_bidet="1" mobility_accessible="1"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <LakeView/>
          <MarinaView/>
          <BeachView/>
          <ForestView/>
          <MountainView/>
          <NatureView/>
        </Views>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

שתי מיטות זוגיות

הדוגמה הבאה היא של חדר בסגנון יפני עם שתי מיטות double.western

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two double beds-->
          <Bed size="double"></Bed>
          <Bed size="double"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>


בסגנון יפני ללא מיטה

הדוגמה הבאה היא של חדר בסגנון יפני ללא מיטה. לא נדרש מידע על המיטה בחדר בסגנון japanese.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

חדר בסגנון יפני-מערבי עם מיטה

דוגמה לחדר בסגנון japanese_western עם מיטה בגודל king 

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
        <Beds>
          <Bed size="king"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

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

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

<PackageData>

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

הרכיב <PackageData> מופיע במיקום הבא בהיררכיית ה-XML של הודעת העסקה:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

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

אפשר להגדיר את הרכיבים <RoomData> ו-<PackageData> לאותו חדר או לאותו חבילת חדרים. כש-Google מציגה את החדר או את החבילה בתוצאות החיפוש, היא כוללת את התיאורים משני המקורות, מופרדים במקף.

אם מעדכנים רכיב <PackageData> יחיד של נכס, צריך לעדכן את כל הרכיבים <PackageData> ו-<RoomData> של הנכס. כל <PropertyDataSet> נחשב לכל הנתונים לגבי הנכס, והוא מחליף את כל הנתונים הקיימים.

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

תחביר

התחביר של רכיב <PackageData> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <PropertyDataSet ... >
    <PackageData>
      <PackageID>package_ID</PackageID>
      <Name>
        <Text text="package_name" language="language_code"/>
        ...
      </Name>
      <Description>
        <Text text="package_description" language="language_code"/>
        ...
      </Description>
      <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
      <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
      <Occupancy>max_number_of_intended_occupants</Occupancy>
      <OccupancyDetails><!-- optional info about the types of guests,
      whether adults or children --></OccupancyDetails>
      <!-- For these next 3 elements, boolean_value can be 0/1 or true/false -->
      <BreakfastIncluded>boolean_value</BreakfastIncluded>
      <InternetIncluded>boolean_value</InternetIncluded>
      <ParkingIncluded>boolean_value</ParkingIncluded>
      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
          ...
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      ...
      <Meals>
        <Breakfast
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
        <Dinner
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
      </Meals>
      <CheckinTime>checkin_time</CheckinTime>
      <CheckoutTime>checkout_time</CheckoutTime>
      <MembershipBenefitsIncluded>
        <ProgramName>
          <Text language="en" text="Special Rewards">
        </ProgramName>
        <ProgramLevel>
          <Text language="en" text="Platinum">
        </ProgramLevel>
      </MembershipBenefitsIncluded>
      <OnPropertyCredit>
        <Amount currency="USD">123.45</Amount>
      </OnPropertyCredit>
    </PackageData>
    <!-- a PackageID with a MilesIncluded rate feature -->
    <PackageData>
      <PackageID>room_with_miles</PackageID>
      <Name>
       <Text text="Room with Bundled Miles" language="en">
      </Name>
      <ChargeCurrency>hotel </ChargeCurrency>
      <MilesIncluded>
        <NumberOfMiles>integer</NumberOfMiles>
        <Provider>
          <Text language="en" text="provider-name">
        </Provider>
        <!-- Add Loyalty point information -->
        <LoyaltyCampaignID>campaign_ID</LoyaltyCampaignID>
      </MilesIncluded>
    </PackageData>
    ...
    ...
  </PropertyDataSet>
  ...
</Transaction>

מאפיינים

לרכיב <PackageData> אין מאפיינים.

רכיבי צאצא

הרכיב <PackageData> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<BreakfastIncluded> Optional boolean השדה מציין אם המחיר של החבילה כולל ארוחת בוקר. הערכים התקינים הם 0 (או false) ו-1 (או true).

מומלץ להשתמש ב-<Meals> במקום ב-<BreakfastIncluded>.
<ChargeCurrency> Optional enum מתי ואיפה המשתמש משלם על הזמנה. הרכיב הזה משתמש באותו תחביר כמו <ChargeCurrency> ב-<Result>.

ערך ברירת המחדל הוא web.
<CheckinTime> Optional Time השעה המוקדמת ביותר שאפשר לבצע בה צ'ק-אין. השעה חייבת להיות לפני 24:00 בשעון המקומי של המלון.
<CheckoutTime> Optional Time השעה המאוחרת ביותר שאפשר לעשות בה צ'ק-אאוט, לפי השעה המקומית במלון.
<Description> Optional Object תיאור מפורט של החבילה. הרכיב הזה צריך להכיל מידע שלא מתואר על ידי רכיבים אחרים או על ידי הרכיב <Name>. כשמציינים את תיאור החדר, לא צריך להשתמש באותיות רישיות.

הרכיב <Description> מקבל רכיב צאצא יחיד, <Text>, שיש לו שני מאפייני חובה, text ו-language. text המאפיין text הוא התיאור, והמאפיין language מציין קוד שפה בן שתי אותיות, כמו בדוגמה הבאה:

<Description>
  <Text text="Two breakfast buffet certificates for
    each night of stay." language="en"/>
  <Text text="Deux certificats petit-déjeuner buffet
    pour chaque nuit de séjour." language="fr"/>
</Description>
<InternetIncluded> Optional boolean אם חבילה כוללת גישה לאינטרנט ללא תשלום, בעוד שחבילות אחרות לא כוללות את השירות הזה. אל תגדירו את הרכיב הזה לחבילות חדרים במלון שמספק אינטרנט בחינם בכל החדרים. האלמנט הזה לא רלוונטי לאינטרנט קווי בחדר או לאינטרנט אלחוטי שלא זמין בחדרי האורחים. הערכים התקינים הם: 0 (או false) ו-1 (או true).
<Meals> Optional Object כולל מידע על הארוחות בחבילה הזו.

הרכיב <Meals> מקבל שני רכיבי צאצא אופציונליים, <Breakfast> ו-<Dinner>, עם המאפיינים הבאים:

  • ‫included (חובה): מגדירים את הערך 1 (או true) אם המחיר כולל ארוחת בוקר או ארוחת ערב, אחרת מגדירים את הערך 0 או false.
  • ‫in_room (אופציונלי): מגדירים את הערך 1 (או true) אם לאורחים יש אפשרות לאכול ארוחת בוקר או ארוחת ערב בחדר שבו הם מתארחים, אחרת מגדירים את הערך 0 (או false).
  • ‫in_private_space (אופציונלי): מגדירים את הערך 1 (או true) אם לאורחים יש אפשרות לאכול ארוחת בוקר או ארוחת ערב במרחב (חוץ מהחדר שבו הם מתארחים) שבו הם יכולים להימנע ממגע עם אורחים אחרים. אחרת, מגדירים את הערך 0 (או false).
  • ‫buffet (אופציונלי): מגדירים את הערך 1 (או true) אם ארוחת הבוקר או ארוחת הערב מוגשות בסגנון מזנון, אחרת מגדירים את הערך 0 (או false).

המאפיינים האופציונליים משמשים רק אם הערך של included הוא true.

כדי שהמסננים של הארוחות (no meals, breakfast only, dinner only ו-breakfast and dinner) יפעלו, צריך לספק את המאפיינים <Breakfast> ו-<Dinner> עם המאפיין included.
<Name> Required string שם החבילה. הערך הזה צריך להיות זהה לערך שמופיע בדף הנחיתה של המלון. אל תגדירו את הערך של הרכיב הזה באותיות גדולות בלבד.

הרכיב הזה מקבל רכיב צאצא יחיד, <Text>, שכולל שני מאפיינים, text ו-language. המאפיין text הוא התיאור, והמאפיין language מציין קוד שפה בן שתי אותיות, כמו בדוגמה הבאה:

<Name>
  <Text text="Bed and Breakfast" language="en"/>
  <Text text="Lit et petit déjeuné" language="fr"/>
</Name>
<Occupancy> Optional integer מספר האורחים המקסימלי שחבילת החדרים מיועדת להם. לדוגמה, יכול להיות שסוויטה גדולה תוכל להכיל פיזית 6 אורחים, אבל היא מיועדת ל-4 אורחים בלבד.

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

הערך של <Occupancy> חייב להיות מספר שלם חיובי בין 1 ל-99, כולל.

אם מציינים את הרכיב הזה גם ב-<RoomBundle> וגם ב-<PackageData>, הערך ב-<RoomBundle> מקבל עדיפות.

הערה:

‫<Occupancy> may be accompanied by <OccupancyDetails>,which specifies the type of guests (adults or children). מידע על התחביר ותיאור של רכיבי צאצא זמין במאמר בנושא <OccupancyDetails>.
<PackageID> Required string

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

(אפשר גם להשתמש במזהה הזה כדי להפנות להגדרה נפוצה של חבילת חדרים שמשמשת בהודעת עסקה יחידה כשמגדירים נתונים של חבילת חדרים בשורה).
<ParkingIncluded> Optional boolean אם חבילת החדרים כוללת חניה ללא תשלום, במקרים שבהם החניה היא שירות בתשלום במלון. אל תציינו ערך לרכיב הזה במלון שמציע חניה בחינם.

הערכים האפשריים הם 0 (או false) ו-1 (או true). ערך ברירת המחדל הוא false.
<PhotoURL> Optional Object (אותו דבר כמו <PhotoURL> ב-<RoomData>, אבל לגבי החבילה (לדוגמה, תמונות של ארוחות)).
<Refundable> Optional Object מאפשר להציג מחיר עם החזר כספי מלא או עם אפשרות ביטול ללא תשלום. אם לא מספקים את הפרטים האלה, לא מוצג מידע על החזר כספי. מדיניות החזרים כספיים ברמת <PackageData> מבטלת את מדיניות ההחזרים הכספיים ברמת <Result>. מדיניות החזרים כספיים ברמת <Rates> מבטלת את מדיניות ההחזרים הכספיים ברמת <PackageData>. אפשר גם להדגיש למשתמשים מחירים שניתן לקבל עליהם החזר כספי באמצעות אפשרויות חלופיות, בלי לשנות ישירות את סכימת הודעות העסקה. מידע נוסף על המדיניות בנושא מחירים עם אפשרות להחזר

בדוגמה הבאה מוצג הרכיב <Refundable> עם כל המאפיינים שלו:

<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>

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

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

  • ‫available: (חובה) מגדירים את הערך 1 או true כדי לציין אם התעריף מאפשר החזר מלא. אחרת, מגדירים את הערך 0 או false.
  • ‫refundable_until_days: (חובה אם available הוא true) מציין את מספר הימים לפני הצ'ק-אין שבהם אפשר לבקש החזר מלא. הערך של refundable_until_days חייב להיות מספר שלם בין 0 ל-330, כולל.
  • ‫refundable_until_time: (מומלץ מאוד אם הערך של available הוא true) מציין את השעה המאוחרת ביותר ביום, בזמן המקומי של המלון, שבה יכבדו בקשה להחזר כספי מלא. אפשר לשלב את התג הזה עם התג refundable_until_days כדי לציין, לדוגמה, שאפשר לקבל החזר כספי עד השעה 16:00 יומיים לפני הצ'ק-אין. אם לא מגדירים את refundable_until_time, ערך ברירת המחדל הוא חצות.

    הערך של המאפיין הזה הוא בפורמט זמן.

כשמגדירים את המאפיינים, חשוב לשים לב לנקודות הבאות:

  • אם לא מוגדרים הערכים available או refundable_until_days, המחיר לא מוצג כמחיר שניתן להחזר.
  • אם הערך של available הוא 0 או false, המערכת מתעלמת מהמאפיינים האחרים. המחיר לא יוצג כמחיר שניתן לקבל עליו החזר כספי גם אם אחד מהמאפיינים האחרים או שניהם מוגדרים.
<MembershipBenefits Included> Optional boolean המחיר כולל הטבות של סטטוס מועדון חברים למשך השהייה. כולל את הפרמטרים הבאים:
  • ‫ProgramName: שם תוכנית הסטטוס של חברי מועדון
  • ‫ProgramLevel: הרמה בתוכנית. לדוגמה: "Gold."
  • ‫NightlyValue (optional): הערך הלילי של ההטבות.
<CarRentalIncluded> Optional boolean המחיר כולל השכרת רכב חינם למשך השהייה.
<MilesIncluded> Optional boolean המחיר כולל מיילים של נוסע מתמיד. הפרמטרים כוללים:
  • ‫NumberOfMiles: מספר המיילים לכל מסלול.
  • ‫Provider: ספק של מיילים של נוסע מתמיד.
  • ‫LoyaltyCampaignID: מזהה ייחודי שמציין את מועדון הלקוחות הספציפי שהוגדר ועודכן ב-Google. המערכת מוסיפה את נקודות המועדון למחיר המלון.

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

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

    <MilesIncluded>
  <LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
  <NumberOfMiles>1200</NumberOfMiles>
  <Provider>
    <Text language="en" text="United Airlines">
  </Provider>
</MilesIncluded>

    • הערה: <NumberOfMiles> ו-<Provider> הם אופציונליים.
<OnPropertyCredit> Optional boolean המחיר כולל זיכוי לשימוש באתר (במסעדות, באתר הנופש, בספא וכו'). פרמטר:
  • ‫Amount: ערך הזיכוי לכל מסלול, במטבע המקומי.
<AirportTransportationIncluded> Optional Object המחיר כולל הסעה חינם אל נמל תעופה סמוך וממנו. המאפיין האופציונלי direction מציין את כיוון התנועה של התחבורה. הערכים התקפים כוללים:
    from: תחבורה מסופקת משדה התעופה אל מקום האירוח. זהו ערך ברירת המחדל אם לא צוין כיוון. ‫to: יש שירות הסעות מהמקום אל שדה התעופה. ‫round_trip: יש שירות הסעות אל שדה התעופה וממנו.

דוגמאות

חבילה של חדר יחיד

בדוגמה הבאה מוגדר חבילת חדרים אחת, עם תפוסה של 2 (מבוגר אחד וילד אחד) שכוללת ארוחת בוקר:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <Occupancy>2</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
        <Children>
          <Child age="17"/>
        </Children>
      </OccupancyDetails>
      <PackageID>P54321</PackageID>
      <Name>
         <Text text="Breakfast Included" language="en"/>
         <Text text="Avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Two certificates for continental
          breakfast will be provided." language="en"/>
        <Text text="Deux certificats pour le petit déjeuner
          continental seront fournis." language="fr"/>
      </Description>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

מטא-נתונים של חדרים וחבילות

בדוגמה הבאה מוגדרים מטא-נתונים של חדר ושל חבילה:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>180054</Property>
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Bed Room" language="en"/>
        <Text text="Chambre single" language="fr"/>
      </Name>
      <Description>
        <Text text="Non-smoking" language="en"/>
        <Text text="Pas de fumiers" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>P54321</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
        <Text text="Avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Includes a delightful array of jams and jellies." language="en"/>
        <Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
      </Description>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

חבילות לכמה חדרים

בדוגמה הבאה מוגדרים מטא-נתונים של חדרים וחבילות לכמה חבילות של חדרים:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <!-- A transaction message with room types result. -->
  <PropertyDataSet>
    <Property>12345</Property>
    <RoomData>
      <RoomID>single</RoomID>
      <Name>
        <Text text="Single room" language="en"/>
        <Text text="Chambre simple" language="fr"/>
      </Name>
      <Description>
        <Text text="A single room" language="en"/>
        <Text text="Le chambre simple" language="fr"/>
      </Description>
      <PhotoURL>
        <Caption>
          <Text text="Living area" language="en"/>
          <Text text="Le chambre" language="fr"/>
        </Caption>
        <URL>http://www.foo.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image1235.jpg</URL>
      </PhotoURL>
      <Capacity>2</Capacity>
    </RoomData>
    <RoomData>
      <RoomID>double</RoomID>
      <Name>
        <Text text="Double room" language="en"/>
        <Text text="Chambre double" language="fr"/>
      </Name>
      <Occupancy>1</Occupancy>
    </RoomData>
    <PackageData>
      <PackageID>refundbreakfast</PackageID>
      <Name>
        <Text text="Refundable Room with Breakfast" language="en"/>
        <Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
      </Name>
      <Description>
        <Text text="Continental Breakfast" language="en"/>
        <Text text="Petit déjeuner continental" language="fr"/>
      </Description>
      <ChargeCurrency>hotel</ChargeCurrency>
      <Refundable available="1" refundable_until_days="3"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>prepaid</PackageID>
      <Name>
        <Text text="Nonrefundable" language="en"/>
        <Text text="Non remboursable" language="fr"/>
      </Name>
      <Description>
        <Text text="Blah blah blad" language="en"/>
        <Text text="Le blah blah blad" language="fr"/>
      </Description>
      <Occupancy>2</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="0"/>
    </PackageData>
  </PropertyDataSet>
</Transaction>


חבילת חדר עם מחירים

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

<Transaction timestamp="2010-04-24T20:44:56-04:00" id="TXNID">
  <PropertyDataSet>
    <Property>12345</Property>
    <RoomData>
     ...
    </RoomData>
<!-- definitions of PackageData types including rate features -->
    <PackageData>
      <PackageID>room_with_addl_benefits</PackageID>
      <Name>
        <Text text="Acme Hotels 2017 Promotion Package" language="en"/>
      </Name>
      <ChargeCurrency>hotel</ChargeCurrency>
      <BreakfastIncluded>1</BreakfastIncluded>
      <MembershipBenefitsIncluded>
        <ProgramName>
          <Text language="en" text="Marriott Rewards"/>
        </ProgramName>
        <ProgramLevel>
          <Text language="en" text="Platinum"/>
        </ProgramLevel>
      </MembershipBenefitsIncluded>
      <OnPropertyCredit>
        <Amount currency="USD">123.45</Amount>
      </OnPropertyCredit>
    </PackageData>
    <PackageData>
      <PackageID>room_with_miles</PackageID>
      <Name>
        <Text text="Room with Bundled Miles" language="en"/>
      </Name>
      <ChargeCurrency>hotel</ChargeCurrency>
      <MilesIncluded>
        <NumberOfMiles>1000</NumberOfMiles>
        <LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
      </MilesIncluded>
      <AirportTransportationIncluded direction="from"/>
    </PackageData>
  </PropertyDataSet>

<!-- The actual list of prices -->
  <Result>
…
  </Result>
</Transaction>

ארוחות ותמונות

בדוגמה הבאה מוגדרים מטא-נתונים של חדרים וחבילות לגבי ארוחות, תמונות ושעות הצ'ק-אין והצ'ק-אאוט:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Meals Included" language="en"/>
      </Name>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <!-- Guests can choose to have breakfast in their room or in another
        space to avoid contact with other guests. -->
        <Breakfast included="1" in_room="1" in_private_space="1"/>
        <Dinner included="1" buffet="1"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

ארוחת בוקר

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
      </Name>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <Breakfast included="true"/>
        <!-- Dinner not included needs to be explicitly specified -->
        <Dinner included="false"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

<Result>

קונטיינר לעדכוני מחירים וזמינות בהודעה <Transaction>

הרכיב <Result> מופיע במיקום הבא בהיררכיית ה-XML של הודעת העסקה:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

משתמשים בלחצן <Result> כדי להגדיר או לעדכן את מחירי החדרים ולהגדיר את המלאי הזמין. הפריטים שמוגדרים ברכיב הזה בדרך כלל מפנים למטא-נתונים שלא קשורים למסלול הנסיעה לגבי חדר או חבילה (כמו תיאור או רשימת שירותים) שמוגדרים ברכיבים <PackageData> ו-<RoomData>.

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

אפשר להשתמש ב-<Result> בהודעה על עסקה כדי להסיר מסלולי נסיעה, כמו שמתואר במאמר הסרת מלאי. מידע נוסף על שימוש בהודעות על עסקאות לעדכון מחירים וזמינות זמין במאמר הוספה ועדכון של מלאי.

הודעה אחת של טרנזקציה יכולה לכלול כל מספר של רכיבי <Result>, כל עוד גודל ההודעה לא חורג מ-100MB.

תחביר

התחביר של רכיב <Result> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
    <!-- Required -->
    <Property>hotel_ID</Property>
    <!-- Required -->
    <Checkin>YYYY-MM-DD</Checkin>
    <!-- Required -->
    <Nights>number_of_nights</Nights>

    <Baserate currency="currency_code">price</Baserate>
    <!-- Only required when <Baserate> contains a real price -->
    <Tax currency="currency_code">tax_amount</Tax>
    <!-- Only required when <Baserate> contains a real price  -->
    <OtherFees currency="currency_code">fee_amount</OtherFees>
    <Refundable available="[false|true]" refundable_until_days="number_of_days"
      refundable_until_time="time"/>

    <RoomID>room_ID</RoomID>
    <PackageID>package_ID</PackageID>
    <ExpirationTime>expiration_time</ExpirationTime>
    <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>

    <Occupancy>max_number_of_intended_occupants</Occupancy>
    <!-- For Baserate, occupancy value must be greater than or equal to 2.
         If a value is not provided for occupancy, it defaults to 2. -->
    <!-- Child occupancy rates should only be sent through Live pricing
         with context and not through Pull or Changed pricing -->
    <OccupancyDetails>occupancy_info</OccupancyDetails>

    <Rates>...</Rates>

    <RoomBundle>...</RoomBundle>

    <AllowablePointsOfSale>
      <PointOfSale id="landing_page_identifier"/>
      ...
    </AllowablePointsOfSale>

    <MilesIncluded>
      <NumberOfMiles>integer</NumberOfMiles>
      <Provider>
        <Text language="en" text="provider-name">
      </Provider>
      <!-- Add Loyalty point information -->
      <LoyaltyCampaignID>campaign_ID</LoyaltyCampaignID>
    </MilesIncluded>
  </Result>
  ...
  </Transaction>

מאפיינים

לרכיב <Result> יש את המאפיינים הבאים:

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

רכיבי צאצא

הרכיב <Result> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<AllowablePointsOfSale> Optional Object דף נחיתה אחד או יותר שעומדים בדרישות של המלון. דף נחיתה הוא אתר שיכול לטפל בתהליך ההזמנה עבור משתמש הקצה. כדי לכלול באופן מפורש דף נחיתה מסוים (ולהחריג אחרים), מוסיפים לקובץ דפי הנחיתה רכיב <AllowablePointsOfSale> אחד או יותר שתואם למאפיין id של רכיב <PointOfSale>.

אם לא כוללים את הרכיב הזה, כל דפי הנחיתה שמוגדרים בקובץ דפי הנחיתה נחשבים ככשירים לשימוש בהזמנת החדר. מידע נוסף זמין במאמר בנושא תחביר של קובצי דפי נחיתה.
<Baserate> Optional float

המחיר של החדר לשהייה. הערך של הרכיב הזה צריך לשקף את הפרטים הבאים:

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

אם החדר לא זמין בתאריכי השהייה, צריך להשמיט את <Baserate> או להגדיר אותו כ--1, ולציין את <Unavailable>, יחד עם כל הסיבות הידועות לאי-הזמינות.

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

במאפיין <Baserate> אסור להשתמש בסמלים של קיבוץ ספרות, כמו פסיק (,) או נקודה (.). תמיד צריך להפריד בין שברים באמצעות נקודה (.) בתור סימן עשרוני. לדוגמה, כדי לייצג סכום של 1,200.40$, צריך להשתמש בערכים הבאים:

<Baserate currency="USD">1200.40</Baserate>

הרכיב <Baserate> כולל את המאפיינים האופציונליים הבאים:

  • ‫all_inclusive: ערך בוליאני שמציין אם המחיר הזה כולל מיסים ועמלות. באופן כללי, צריך להגדיר את הערך הזה ל-false עבור משתמשי קצה בארה"ב ובקנדה, ולספק ערכים לרכיבים <Tax> ו-<OtherFees>. אם אתם משתמשים במחירים שכוללים הכול, יכול להיות שלא תעמדו בדרישות להצגת המוצרים בכרטיסי מוצר אם המחירים שלכם לא מציגים בנפרד את המיסים והעמלות למשתמשים בקנדה.

    המחירים של חבילות הכול כלול מוצגים עכשיו למשתמשים בארה"ב.

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

    ערך ברירת המחדל הוא false.

  • ‫currency: קוד המטבע בן שלוש האותיות. לדוגמה, USD לדולר ארה"ב.
<ChargeCurrency> Optional enum מתי ואיפה המשתמש משלם על הזמנה. אפשר להשתמש ברכיב הזה בהודעה על עסקה ברכיב <Result> עבור מחיר המלון או בבלוק <PackageData> עבור חבילת חדרים.

הערכים החוקיים כוללים:

  • web: המשתמש מחויב אונליין בזמן ההזמנה. זהו ערך ברירת המחדל. דף הנחיתה בפועל מוגדר על ידי קובץ דף הנחיתה, ויכול להיות מושפע מהמטבע, מהמיקום, מהשפה או מגורמים אחרים של המשתמש.
  • ‫hotel: המשתמש מחויב בזמן הצ'ק-אין במלון. אם התשלום צריך להתבצע תמיד במטבע של המלון, צריך להגדיר את הערך של <ChargeCurrency> בתור hotel. המטבע של המשתמש לא משפיע על דף הנחיתה בפועל.
  • ‫deposit: המשתמש מחויב בחלק מהסכום באופן מיידי, והיתרה מחויבת בשלב מאוחר יותר, בדרך כלל כשהוא עוזב את המלון.
  • ‫installments: המשתמש מחויב בשבר ראשוני מסכום החיוב הכולל, וצפוי לשלם באופן שוטף יתרה קבועה במשך תקופה קבועה.

ערך ברירת המחדל הוא web.
<Checkin> Required Date תאריך הצ'ק-אין לתוכנית הנסיעה בפורמט Date. השילוב של הרכיב <Nights> והרכיב <Checkin> יוצר מסלול טיול.
Optional string הוצא משימוש: הגדרה של שדה מותאם אישית שאפשר להשתמש בו כדי להעביר נתונים נוספים שמשויכים למלון. אפשר להעביר עד חמישה ערכים מותאמים אישית עם שמות הרכיבים הבאים:
  • <Custom1>
  • <Custom2>
  • <Custom3>
  • <Custom4>
  • <Custom5>

רכיבי <Custom> מאפשרים להעביר נתונים שרירותיים. לדוגמה, אפשר לציין בשדה הזה ערך שישמש את קובץ דפי הנחיתה כדי ליצור כתובת URL מותאמת אישית לדף נחיתה. כל שדה מותאם אישית יכול להכיל עד 200 תווים. מידע נוסף זמין במאמר בנושא קבצים של דפי נחיתה . רכיבי <Custom> שסופקו ברכיב <Rate> לא עוברים בירושה לרכיב <RoomBundle>. צריך להגדיר את מאפיין ה-<Custom> בנפרד בכל <RoomBundle>.

חשוב: אם אתם רוצים להשתמש במשתני CUSTOM, עליכם לפנות אל מנהל החשבון הטכני (TAM).
<ExpirationTime> Optional DateTime התאריך והשעה שבהם המחיר נחשב כלא תקף (מינימום 3 שעות).

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

‫Google לא מציגה מחירים שתוקפם פג, וכל מסלול נסיעה שהמחיר שלו פג יהיה זמין ל שאילתות מחירים בזמן אמת.
<MilesIncluded> Optional boolean המחיר כולל מיילים של נוסע מתמיד. הפרמטרים כוללים:
  • ‫NumberOfMiles: מספר המיילים לכל מסלול.
  • ‫Provider: ספק של מיילים של נוסע מתמיד.
  • ‫LoyaltyCampaignID: מזהה ייחודי שמציין את מועדון הלקוחות הספציפי שהוגדר ועודכן ב-Google. המערכת מוסיפה את נקודות המועדון למחיר המלון.

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

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

    <MilesIncluded>
  <LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
  <NumberOfMiles>1200</NumberOfMiles>
  <Provider>
    <Text language="en" text="United Airlines">
  </Provider>
</MilesIncluded>

    • הערה: <NumberOfMiles> ו-<Provider> הם אופציונליים.
<Nights> Required integer מספר הלילות במסלול הנסיעה. הערך של רכיב <Nights> חייב להיות מספר שלם חיובי. השילוב של <Nights> ושל <Checkin> יוצר מסלול טיול.
<OtherFees> Optional float עמלות שאינן המחיר הבסיסי ומיסים שמשפיעים על המחיר הסופי של חדר. רכיב <OtherFees> מקבל מאפיין חובה יחיד, currency, שמגדיר את קוד המטבע בן שלוש האותיות של העמלות. לדוגמה, USD.

רכיב <OtherFees> הוא חובה אם הערך של <Baserate> גדול מאפס.
<Occupancy> Optional integer מציין את מספר האורחים המקסימלי שמותר לכלול במחיר הזה. אם <Occupancy> מופיע ישירות מתחת ל-<Result>, צריך לציין 2 או יותר. ‫<Occupancy> may be accompanied by <OccupancyDetails>, which specifies the type of guests (adults or children). אם לא מציינים סוגי אורחים, ברירת המחדל היא מבוגרים. אפשר לעיין ב-<OccupancyDetails> כדי לקבל מידע על התחביר ועל תיאור של רכיבי צאצא. אם לא מציינים את הרכיב <Occupancy>, ברירת המחדל של מספר האורחים היא 2.

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

הערה: כדי להפעיל את התכונה לשליחת מחירים ללא תפוסה כפולה, צריך לפנות לצוות התמיכה.
<PackageID> Optional string המזהה הייחודי של החבילה למיפוי לנתוני חבילה מוגדרים מראש. משמש גם לאכלוס המשתנה PACKAGE-ID של דף הנחיתה. מידע נוסף אפשר לקרוא במאמר בנושא מטא-נתונים של חבילות חדרים.

חובה לכלול את <RoomBundle> כדי להגדיר את <PackageID> ואת <RoomID> ברכיב <Result>. עם זאת, מומלץ לציין את מזהי החבילה והחדר רק ברכיב <RoomBundle> ולא ברכיב <Result>.
<Property> Required string מזהה המלון שמושפע מהנתונים המשויכים (מחיר, מסלול נסיעה, חבילת חדרים או מטא-נתונים). הערך של הרכיב הזה חייב להיות מחרוזת. הערך של הרכיב הזה צריך להיות זהה לערך של פרטי המלון <id> שהגדרתם בפיד רשימת המלונות.
<Rates> Optional <Rates> קונטיינר של בלוק אחד או יותר של <Rate>. כל <Rate> ב-<Rates> מגדיר מחיר שונה לשילוב של חדר/מסלול.

משתמשים באלמנט <Rates> כשיש כמה תעריפים לאותו שילוב של חדר/מסלול נסיעה, או כשאי אפשר לציין תעריף ברמה של <Result>. לדוגמה, אתם מגדירים כמה תעריפים ל חבילות חדרים, תעריפים פרטיים, תעריפים בלעדיים או תעריפים שונים לתפוסות שונות.

הערה: ב-<Result>, אפשר לציין מחירים לחדר ליחיד רק ב-<Rates>. כדי לאפשר הצגת מחירים לחדרים לא זוגיים, צריך ליצור איתנו קשר.
<Refundable> Optional Object מאפשר להציג מחיר עם החזר כספי מלא או עם אפשרות ביטול ללא תשלום. אם לא מספקים את הפרטים האלה, לא מוצג מידע על החזר כספי. מדיניות החזרים כספיים ברמת <PackageData> מבטלת את מדיניות ההחזרים הכספיים ברמת <Result>. מדיניות החזרים כספיים ברמת <Rates> מבטלת את מדיניות ההחזרים הכספיים ברמת <PackageData>. אפשר גם להדגיש למשתמשים מחירים שניתן לקבל עליהם החזר כספי באמצעות אפשרויות חלופיות, בלי לשנות ישירות את סכימת הודעות העסקה. מידע נוסף על מדיניות התעריפים עם אפשרות להחזר כספי

בדוגמה הבאה מוצג הרכיב <Refundable> עם כל המאפיינים שלו:

<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>

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

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

  • ‫available: (חובה) מגדירים את הערך 1 (או true) כדי לציין אם התעריף מאפשר החזר כספי מלא, אחרת מגדירים את הערך 0 (או false).
  • ‫refundable_until_days: (חובה אם available הוא true) מציין את מספר הימים לפני הצ'ק-אין שבהם אפשר לבקש החזר מלא. הערך של refundable_until_days חייב להיות מספר שלם בין 0 ל-330, כולל.
  • ‫refundable_until_time: (מומלץ מאוד אם הערך של available הוא true) מציין את השעה המאוחרת ביותר ביום, בזמן המקומי של המלון, שבה יכבדו בקשה להחזר כספי מלא. אפשר לשלב את התג הזה עם התג refundable_until_days כדי לציין, לדוגמה, שאפשר לקבל החזר כספי עד השעה 16:00 יומיים לפני הצ'ק-אין. אם לא מגדירים את refundable_until_time, ערך ברירת המחדל הוא חצות.

    הערך של המאפיין הזה הוא בפורמט זמן.

כשמגדירים את המאפיינים, חשוב לשים לב לנקודות הבאות:

  • אם לא מוגדרים הערכים available או refundable_until_days, המחיר לא מוצג כמחיר שניתן להחזר.
  • אם הערך של available הוא 0 (או false), המערכת מתעלמת משאר המאפיינים. המחיר לא יוצג כמחיר שניתן לקבל עליו החזר כספי גם אם אחד מהמאפיינים האחרים או שניהם מוגדרים.
<RoomBundle> Optional <RoomBundle> מאגר מידע על תיאורים פיזיים של חדרים עם מחירים, על חבילות שירותים ועל פרטים מסוימים של מדיניות הרכישה במלון ובמסלול הנסיעה שצוינו.

באופן כללי, משתמשים ברכיב הזה כדי להגדיר מחירים לחדר הבסיסי ולסוגים שונים של חדרים באותו נכס. אפשר להגדיר תיאורים של חבילות חדרים בשורה, אבל מומלץ להשתמש בהודעת עסקה נפרדת כדי להגדיר את המידע הזה. ‫Google תשמור את המטא-נתונים כדי שתוכלו להפנות אליהם ולא לחזור עליהם בכל עדכוני התמחור העתידיים.
<RoomID> Optional string המזהה הייחודי של החדר למיפוי לנתוני חדר מוגדרים מראש. משמש גם לאכלוס המשתנה PARTNER-ROOM-ID של דף הנחיתה. מידע נוסף אפשר לקרוא במאמר בנושא מטא-נתונים של חבילות חדרים.

חובה לכלול את <RoomBundle> כדי להגדיר את <PackageID> ואת <RoomID> ברכיב <Result>. עם זאת, מומלץ לציין את מזהי החבילה והחדר רק ברכיב <RoomBundle> ולא ברכיב <Result>.
<Tax> Optional float המיסים שמחושבים במחיר הסופי של החדר. רכיב <Tax> מקבל מאפיין חובה יחיד, currency, שמגדיר את קוד המטבע בן שלוש האותיות של המיסים. לדוגמה, USD. האלמנט <Tax> הוא חובה אם הערך של <Baserate> גדול מאפס.

אם המאפיין all_inclusive של רכיב <Baserate> מוגדר במפורש כ-true, הגדרת הערך הזה היא אופציונלית.
<Unavailable> Optional Object מציין שאי אפשר להזמין את מסלול הנסיעה. משמש כמאגר לסיבות מפורטות יותר לכך שהמסלול לא היה זמין. יכולות להיות כמה סיבות לזמינות של מוצר, שמופיעות בתוך תג <Unavailable>:
  • ‫<NoVacancy/>: אין יותר חדרים זמינים למכירה ללילה אחד או יותר מתוך תקופת השהייה.
  • ‫<MinNightStay value=N/>: מספר הלילות בתוכנית הנסיעה היה נמוך ממספר הלילות המינימלי לשהייה של N בתאריכי השהייה.
  • ‫<MaxNightStay value=N/>: מספר הלילות בתוכנית הנסיעה היה גבוה ממספר הלילות המקסימלי לשהייה של N בתאריכי השהייה.
  • <MinAdvancePurchase value=N/>: מסלול הנסיעה היה קצר יותר מחלון ההזמנה המוקדמת המינימלי של N לשהייה בתאריכים האלה.
  • ‫<MaxAdvancePurchase value=N/>: מסלול הנסיעה היה מעל החלון המקסימלי להזמנה מראש של N לתאריכי השהייה.
  • ‫<ClosedToArrival/>: אי אפשר לבצע צ'ק אין בנכס בתאריך ההגעה שצוין בתוכנית הנסיעה.
  • ‫<ClosedToDeparture/>: אי אפשר לבצע צ'ק אאוט בנכס בתאריך היציאה שמופיע בתוכנית הנסיעה.
  • ‫<PropertyClosed first_open="YYYY-MM-DD" first_closed="YYYY-MM-DD"/>: מקום האירוח סגור בחלק מהתקופה או בכל התקופה. מאפייני החובה first_open ו-first_closed מציינים את התאריכים הראשונים שגדולים מתאריך ההגעה או שווים לו, שבהם הנכס פתוח או סגור, בהתאמה. אם המלון נסגר אחרי תאריך ההגעה, הערך של first_open צריך להיות זהה לתאריך ההגעה, והערך של first_closed צריך להיות התאריך שבו המלון נסגר. אם הנכס סגור בתאריך ההגעה, הערך של first_closed צריך להיות זהה לתאריך ההגעה, והערך של first_opened צריך להיות התאריך הבא שבו הנכס פתוח.
  • ‫<NotFetched/>: מקורות נתונים במורד הזרם לא סיפקו מחיר לתוכנית הנסיעה.
  • ‫<InvalidProperty/>: מזהה הנכס המבוקש לא זוהה.
  • ‫<InvalidOccupancy/>: הנכס לא תומך במספר האורחים המבוקש.
  • ‫<PriceIssue/>: בעיה במחיר גרמה לכך שהוא לא נשלח.
  • ‫<InternalError reason=""/>: אירעה שגיאה לא מפורטת. מאפיין הסיבה האופציונלי יכול לדווח על השגיאה כטקסט.
  • ‫<OtherRestriction restriction=""/>: מסלול הנסיעה לא היה זמין בגלל מגבלת הזמנה שלא צוינה. מאפיין ההגבלה האופציונלי מאפשר לדווח על ההגבלה כטקסט.

דוגמאות

דוגמה לשימוש בכמה נכסים

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

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>060773</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">278.33</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="site1"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>052213</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">299.98</Baserate>
    <Tax currency="USD">26.42</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="otto"/>
      <PointOfSale id="simon"/>
    </AllowablePointsOfSale>
    <MilesIncluded>
      <NumberOfMiles>1200</NumberOfMiles>
      <Provider>
        <Text language="en" text="United Airlines"/>
      </Provider>
      <LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
    </MilesIncluded>
  </Result>
</Transaction>

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

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

דוגמה לשימוש בכמה תעריפים

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

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2021-01-13</Checkin>
    <Nights>9</Nights>
    <Baserate currency="USD">3196.1</Baserate>
    <Tax currency="USD">559.49</Tax>
    <OtherFees currency="USD">543.34</OtherFees>
    <Occupancy>2</Occupancy>
    <Rates>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>1</Occupancy>
      </Rate>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>3</Occupancy>
      </Rate>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>4</Occupancy>
      </Rate>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>5</Occupancy>
      </Rate>
      <Rate>
        <Baserate currency="USD">3196.1</Baserate>
        <Tax currency="USD">559.49</Tax>
        <OtherFees currency="USD">543.34</OtherFees>
        <Occupancy>6</Occupancy>
      </Rate>
    </Rates>
  </Result>
</Transaction>

דוגמה למוצר לא זמין

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

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>060773</Property>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Unavailable>
      <NotFetched/>
    </Unavailable>
  </Result>
  <Result>
    <Property>073313</Property>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Unavailable>
      <NoVacancy/>
      <MinNightStay value=3/>
    </Unavailable>
  </Result>
  <Result>
    <Property>052213</Property>
    <Checkin>2018-06-10</Checkin>
    <Nights>10</Nights>
    <Unavailable>
      <PropertyClosed first_open="2018-06-15" first_closed="2018-06-10"/>
    </Unavailable>
  </Result>
</Transaction>

<Rates>

קונטיינר של בלוק אחד או יותר של <Rate>. כל <Rate> ב-<Rates> מגדיר מחיר שונה לשילוב של החדר או מסלול הנסיעה.

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

הרכיב <Rates> מופיע במיקום הבא בהיררכיית ה-XML של הודעת העסקה:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>         // Pricing and availability
        + <Rates>
        + <RoomBundle> (Can also contain <Rates>)
        + ...

ערכים שמוגדרים בתג <Rate> מבטלים ערכים שקשורים לתמחור בתג האב <Result> או בתג <RoomBundle>. אם הם לא מוגדרים ב-<Rate>, הם יורשים את הערך שלהם מרכיב ההורה. רק התג <AllowablePointsofSale> מועבר בירושה לרכיב <RoomBundle>.

תחביר

התחביר של רכיב <Rates> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
    <Rates>
      <Rate rate_rule_id="rate_rule_id">
        <Baserate currency="currency_code">price</Baserate>
        <Tax currency="currency_code">tax_amount</Tax>
        <OtherFees currency="currency_code">fee_amount</OtherFees>
        <ExpirationTime>expiration_time</ExpirationTime>
        <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
        <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
        <AllowablePointsOfSale>
          <PointOfSale id="landing_page_identifier"/>
        </AllowablePointsOfSale>
        <Occupancy>max_number_of_intended_occupants</Occupancy>
        <OccupancyDetails> <!-- optional info about the types of guests,
      whether adults or children --></OccupancyDetails>
          ...
        <MilesIncluded>
          <NumberOfMiles>integer</NumberOfMiles>
          <Provider>
            <Text language="en" text="provider-name">
          </Provider>
          <LoyaltyCampaignID>campaign_ID</LoyaltyCampaignID>
        </MilesIncluded>
          ...
      </Rate>
      ...
    </Rates>
  </Result>
  ...
</Transaction>

מאפיינים

לרכיב <Rates> יש את המאפיינים הבאים:

מאפיין חובה? תיאור
rate_rule_id Optional במקרה של מחירים מותנים, המזהה הזה תואם להגדרה בקובץ Rate Rule Definition. מגבלת התווים בשדה הזה היא 40.

רכיבי צאצא

הרכיב <Rates> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<AllowablePointsOfSale> Optional Object דף נחיתה אחד או יותר שעומדים בדרישות של המלון. הרכיב הזה משתמש באותו תחביר כמו <AllowablePointsOfSale> ב-<Result>.
<Baserate> Required float המחיר של החדר לשהייה. הרכיב הזה משתמש באותו תחביר כמו <Baserate> ב-<Result>.

הערה: אי אפשר להגדיר את רכיב הצאצא <Baserate> מתחת ל-<Rate> כלא זמין.
<ChargeCurrency> Optional enum מתי ואיפה המשתמש משלם על הזמנה. הרכיב הזה משתמש באותו תחביר כמו <ChargeCurrency> ב-<Result>.
Optional string הוצא משימוש: שדות בהתאמה אישית שאפשר להשתמש בהם כדי להעביר נתונים נוספים שמשויכים למלון לדף נחיתה. הרכיב הזה משתמש באותו תחביר כמו <Custom[1‑5]> ב-<Result>. כל שדה מותאם אישית יכול להכיל עד 200 תווים. מידע נוסף זמין במאמר בנושא קובצי דפי נחיתה. אם רכיבי <Custom> מסופקים ברכיב <Result>, הם לא עוברים בירושה לרכיב <RoomBundle> וצריך להגדיר אותם בנפרד לכל רכיב <RoomBundle>, או שאפשר לכלול אותם ברכיב <PackageData> אם יש צורך בכך.

חשוב: אם אתם רוצים להשתמש במשתני CUSTOM, עליכם לפנות אל מנהל החשבון הטכני (TAM).
<ExpirationTime> Optional DateTime התאריך והשעה שבהם התעריף נחשב כלא תקף. הרכיב הזה משתמש באותו תחביר כמו <ExpirationTime> ב-<Result>.
<MilesIncluded> Optional boolean המחיר כולל מיילים של נוסע מתמיד. הפרמטרים כוללים:
  • ‫NumberOfMiles: מספר המיילים לכל מסלול.
  • ‫Provider: ספק של מיילים של נוסע מתמיד.
  • ‫LoyaltyCampaignID: מזהה ייחודי שמציין את מועדון הלקוחות הספציפי שהוגדר ועודכן ב-Google. המערכת מוסיפה את נקודות המועדון למחיר המלון.

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

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

    <MilesIncluded>
  <LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
  <NumberOfMiles>1200</NumberOfMiles>
  <Provider>
    <Text language="en" text="United Airlines">
  </Provider>
</MilesIncluded>

    • הערה: <NumberOfMiles> ו-<Provider> הם אופציונליים.
<Occupancy> Optional integer

מציין את מספר האורחים המקסימלי שמותר לכלול במחיר הזה. אם לא מציינים זאת, המערכת מניחה שהתדירות זהה לתדירות של ההורה. ‫<Occupancy> may be accompanied by <OccupancyDetails>, which specifies the type of guests (adults or children). כדאי לעיין ב-<OccupancyDetails> כדי לקבל מידע על התחביר ועל רכיבי הצאצא.
<OtherFees> Required float עמלות אחרות, מלבד המחיר הבסיסי ומיסים, שמשפיעות על המחיר הסופי של חדר. הרכיב הזה משתמש באותו תחביר כמו <OtherFees> ב-<Result>.

אם המאפיין all_inclusive של רכיב <Baserate> מוגדר במפורש כ-true, הגדרת הערך הזה היא אופציונלית.
<Refundable> Optional Object מאפשר להציג מחיר עם החזר כספי מלא או עם אפשרות ביטול ללא תשלום. אם לא מספקים את הפרטים האלה, לא מוצג מידע על החזר כספי. מדיניות החזרים כספיים ברמת <PackageData> מבטלת את מדיניות ההחזרים הכספיים ברמת <Result>. מדיניות החזרים כספיים ברמת <Rates> מבטלת את מדיניות ההחזרים הכספיים ברמת <PackageData>. אפשר גם להדגיש למשתמשים מחירים שניתן לקבל עליהם החזר כספי באמצעות אפשרויות חלופיות, בלי לשנות ישירות את סכימת הודעות העסקה. מידע נוסף על המדיניות בנושא מחירים עם אפשרות להחזר

בדוגמה הבאה מוצג הרכיב <Refundable> עם כל המאפיינים שלו:

<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>

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

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

  • ‫available: (חובה) מגדירים את הערך 1 (או true) כדי לציין אם התעריף מאפשר החזר כספי מלא, אחרת מגדירים את הערך 0 (או false).
  • ‫refundable_until_days: (חובה אם available הוא true) מציין את מספר הימים לפני הצ'ק-אין שבהם אפשר לבקש החזר מלא. הערך של refundable_until_days חייב להיות מספר שלם בין 0 ל-330, כולל.
  • ‫refundable_until_time: (מומלץ מאוד אם הערך של available הוא true) מציין את השעה המאוחרת ביותר ביום, בזמן המקומי של המלון, שבה יכבדו בקשה להחזר כספי מלא. אפשר לשלב את התג הזה עם התג refundable_until_days כדי לציין, לדוגמה, שאפשר לקבל החזר כספי עד השעה 16:00 יומיים לפני הצ'ק-אין. אם לא מגדירים את refundable_until_time, ערך ברירת המחדל הוא חצות.

    הערך של המאפיין הזה הוא בפורמט זמן.

כשמגדירים את המאפיינים, חשוב לשים לב לנקודות הבאות:

  • אם לא מוגדרים הערכים available או refundable_until_days, המחיר לא מוצג כמחיר שניתן להחזר.
  • אם הערך של available הוא 0 (או false), המערכת מתעלמת משאר המאפיינים. המחיר לא יוצג כמחיר שניתן לקבל עליו החזר כספי גם אם אחד מהמאפיינים האחרים או שניהם מוגדרים.
<Tax> Required float המיסים שמחושבים במחיר הסופי של החדר. הרכיב הזה משתמש באותו תחביר כמו <Tax> ב-<Result>.

דוגמאות

תעריף בסיס ותעריף בלעדי

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

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>1</Nights>

    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">1.00</OtherFees>

    <Rates>
      <!-- The rate_rule_id is required when using conditional rates -->
      <Rate rate_rule_id="mobile">
        <!-- Override base rate and taxes for conditional rates -->
        <Baserate currency="USD">180.00</Baserate>
        <Tax currency="USD">18.00</Tax>
      </Rate>
    </Rates>

  </Result>
</Transaction>

תעריפים בלעדיים מרובים

בדוגמה הבאה מוגדרים תעריף בסיסי ומספר תעריפים מותנים בתוך <RoomBundle>:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>2</Nights>
    <!-- When Google receives new room bundle information for an itinerary, all
    previous room bundle pricing is dropped from Google's cache. Thus, if you
    want to delete a specific room bundle from Google's cache, you may do so
    by simply not providing that specific room bundle in subsequent transaction
    messages. -->
    <RoomBundle>
     ...
      <!-- RoomID is required, PackageID is recommended. -->
      <RoomID>5</RoomID>
      <PackageID>ABC</PackageID>
      <!-- Baserate is required. -->
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>

      <!-- RatePlanID is optional and represents the unique identifier for a
      room and package data combination. We strongly recommend using RatePlanID
      as a variable to build your dynamic landing page (formerly Point of Sale)
      URL. For details, see Using Variables and Conditions. -->
      <RatePlanID>5-ABC</RatePlanID>

      <!-- Occupancy is mandatory for RoomBundle elements. -->
      <!-- Elements below will get inherited to nested rate elements. -->
      <Occupancy>2</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
      </OccupancyDetails>
      <InternetIncluded>1</InternetIncluded>

      <!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
      <ChargeCurrency>web</ChargeCurrency>

      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">258.33</Baserate>
          <Tax currency="USD">25.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides ChargeCurrency from roombundle. -->
          <ChargeCurrency>hotel</ChargeCurrency>
        </Rate>
        <Rate rate_rule_id="us_or_gb">
          <Baserate currency="USD">268.33</Baserate>
          <Tax currency="USD">26.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
        </Rate>
      </Rates>
    </RoomBundle>
  </Result>
</Transaction>

<RoomBundle>

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

הרכיב <RoomBundle> מופיע במיקום הבא בהיררכיית ה-XML של הודעת העסקה:

+ <Transaction>
    + <PropertyDataSet>  // Room and package metadata
        + <Property>
        + <RoomData>
        + <PackageData>
    + <Result>           // Pricing and availability
        + <Rates>
        + <RoomBundle>
        + ...

מידע נוסף זמין במאמר שימוש בחבילות של ציוד לחדרים.

תחביר

התחביר של רכיב <RoomBundle> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
    ...
    <RoomBundle>
      <!-- Required unless specified inline under <RoomData> -->
      <RoomID>room_ID</RoomID>
      <!-- Required  <PackageData> -->
      <PackageID>package_ID</PackageID>

      <!-- Add Loyalty point information -->
      <MilesIncluded>
        <NumberOfMiles>integer</NumberOfMiles>
        <Provider>
          <Text language="en" text="provider-name">
        </Provider>
        <LoyaltyCampaignID>campaign_ID</LoyaltyCampaignID>>
      </MilesIncluded>

      <!-- Required -->
      <Baserate currency="currency_code">price</Baserate>
      <!-- Required -->
      <Tax currency="currency_code">taxes</Tax>
      <!-- Required -->
      <OtherFees currency="currency_code">other_fees</OtherFees>

      <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
      <!-- Required -->
      <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
      <Occupancy>max_number_of_intended_occupants</Occupancy>
      <OccupancyDetails> <!-- optional info about the types of guests,
      whether adults or children --></OccupancyDetails>

      <BreakfastIncluded>boolean_value</BreakfastIncluded>
      <InternetIncluded>boolean_value</InternetIncluded>
      <ParkingIncluded>boolean_value</ParkingIncluded>

      <RatePlanID>rate_plan_ID</RatePlanID>

      <Rates>...</Rates>

    </RoomBundle>
    ...
  </Result>
</Transaction>

מאפיינים

לרכיב <RoomBundle> אין מאפיינים.

רכיבי צאצא

הרכיב <RoomBundle> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<Baserate> Required float המחיר של חבילת החדר לשהייה. הרכיב הזה משתמש באותו תחביר כמו <Baserate> ב-<Result>, עם היוצא מן הכלל הבא:
  • אם החדר לא זמין למסלול הנסיעה, צריך להסיר את הרכיב <RoomBundle> כדי לציין שהחדר לא נמצא יותר במלאי. מידע נוסף זמין במאמר בנושא הסרת חבילת ציוד לחדר.
<BreakfastIncluded> Optional boolean השדה מציין אם חבילת החדרים הזו כוללת ארוחת בוקר במחיר.
<ChargeCurrency> Optional enum מתי ואיפה המשתמש משלם על הזמנה. הרכיב הזה משתמש באותו תחביר כמו <ChargeCurrency> ב-<Result>.

ערך ברירת המחדל הוא web.
Optional string הוצא משימוש: שדות מותאמים אישית להעברת נתונים נוספים לדפי הנחיתה של חבילת החדרים. האלמנטים האלה משתמשים באותו תחביר כמו <Custom[1-5]> ב-<Result>. יש מגבלה של 200 תווים לכל שדה מותאם אישית. מידע נוסף זמין במאמר בנושא קובצי דפי נחיתה. משתנים מותאמים אישית מופיעים רק כששולחים את המחירים בהודעת העסקה. אם רכיבי <Custom> מסופקים ברכיב <Result>, הם לא עוברים בירושה לרכיב <RoomBundle> וצריך להגדיר אותם בנפרד לכל רכיב <RoomBundle>, או שאפשר לכלול אותם ברכיב <PackageData> אם יש צורך בכך.

חשוב: אם אתם רוצים להשתמש במשתני CUSTOM, עליכם לפנות אל מנהל החשבון הטכני (TAM).
<InternetIncluded> Optional boolean אם חבילת חדרים כוללת גישה לאינטרנט ללא תשלום, בעוד שחבילות אחרות לא כוללות את השירות הזה. אל תגדירו את הרכיב הזה לחבילות חדרים במלון שמספק אינטרנט בחינם בכל החדרים. האלמנט הזה לא רלוונטי לאינטרנט קווי בחדר או לאינטרנט אלחוטי שלא זמין בחדרי האורחים.
<MilesIncluded> Optional boolean המחיר כולל מיילים של נוסע מתמיד. הפרמטרים כוללים:
  • ‫NumberOfMiles: מספר המיילים לכל מסלול.
  • ‫Provider: ספק של מיילים של נוסע מתמיד.
  • ‫LoyaltyCampaignID: מזהה ייחודי שמציין את מועדון הלקוחות הספציפי שהוגדר ועודכן ב-Google. המערכת מוסיפה את נקודות המועדון למחיר המלון.

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

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

    <MilesIncluded>
  <LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
  <NumberOfMiles>1200</NumberOfMiles>
  <Provider>
    <Text language="en" text="United Airlines">
  </Provider>
</MilesIncluded>

    • הערה: <NumberOfMiles> ו-<Provider> הם אופציונליים.
<Occupancy> Required integer מציין את מספר האורחים המקסימלי שמותר לכלול במחיר הזה. לדוגמה, יכול להיות שסוויטה גדולה תתאים ל-6 אורחים, אבל חבילת ירח הדבש מאפשרת רק ל-2 אורחים.

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

כשמגדירים את מספר האורחים בכתובת דף הנחיתה, צריך להשתמש במשתנים NUM-ADULTS ו-NUM-CHILDREN, כמו שמתואר במאמר שימוש במשתנים ובתנאים. ערך ברירת המחדל הוא 2מבוגרים ו0 ילדים.

הערך של <Occupancy> חייב להיות מספר שלם חיובי בין 1 ל-99, כולל.

הערות:

  • מומלץ מאוד להשתמש ב-<Occupancy> עבור <RoomBundle>, ולכן הוא מסומן כנדרש. אם לא תציינו אותו, תוצג שגיאה 1097.
  • ‫<Occupancy> מגיע מאובייקט הנתונים בסדר הזה: <RoomBundle>,‏ <PackageData> ואז = <RoomData>. אם לא מופיע ערך באף אחד מהם, ערך ברירת המחדל הוא 2.
  • ‫<Occupancy> may be accompanied by <OccupancyDetails>, which specifies the type of guests (adults or children). אם לא מציינים סוגי אורחים, ברירת המחדל היא מבוגרים. כדאי לעיין ב-<OccupancyDetails> כדי לקבל מידע על התחביר ועל תיאור של רכיבי צאצא.
  • אם מגדירים את <Occupancy> גם ב-<RoomBundle> וגם ב-<PackageData>, הערך ב-<RoomBundle> מקבל עדיפות.
<OtherFees> Required float עמלות שאינן המחיר הבסיסי ומיסים שמשפיעים על המחיר הסופי של חדר. רכיב <OtherFees> מקבל מאפיין חובה יחיד, currency, שמגדיר את קוד המטבע בן שלוש האותיות של העמלות. לדוגמה, משתמשים ב-USD לדולר ארה"ב.
<PackageID> Optional (recommended) string המזהה הייחודי של נתוני החבילה. אפשר להשתמש במזהה הזה כדי להשוות את נתוני חבילת החדר לנתונים שנשלחו ב-<PackageData>. מידע נוסף זמין במאמר מטא-נתונים של חבילות חדרים. (אפשר גם להשתמש במזהה הזה כדי להפנות להגדרה משותפת של חבילת חדרים שמשמשת בהודעת עסקה יחידה כשמגדירים נתונים של חבילת חדרים בשורה.)
<ParkingIncluded> Optional boolean אם חבילת החדרים כוללת חניה ללא תשלום, במקרים שבהם החניה היא שירות בתשלום במלון. אל תציינו ערך לרכיב הזה במלון שמציע חניה בחינם.

הערכים האפשריים הם 0 (או false) ו-1 (או true). ערך ברירת המחדל הוא false.
<RatePlanID> Optional string מזהה תוכנית המחירים מייצג את המזהה הייחודי של שילוב בין חדר לחבילה. לדוגמה, אם הערך של <RoomID> הוא 5 והערך של <PackageID> הוא ABC, אפשר להשתמש בערך 5-ABC בשביל <RatePlanID>. מומלץ מאוד להשתמש ב-RatePlanID כמשתנה כדי ליצור את כתובת דף הנחיתה הדינמי (לשעבר נקודת המכירה).

מידע נוסף זמין במאמר בנושא שימוש במשתנים ובתנאים.
<Rates> Optional <Rates> מחירים שמבטלים את ברירות המחדל של חבילת החדרים הזו. הרכיב הזה משתמש באותו תחביר כמו <Rates> ב-<Result>.
<Refundable> Optional Object מאפשר להציג מחיר עם החזר כספי מלא או עם אפשרות ביטול ללא תשלום. אם לא מספקים את הפרטים האלה, לא מוצג מידע על החזר כספי. מדיניות החזרים כספיים ברמת <PackageData> מבטלת את מדיניות ההחזרים הכספיים ברמת <Result>. מדיניות החזרים כספיים ברמת <Rates> מבטלת את מדיניות ההחזרים הכספיים ברמת <PackageData>. אפשר גם להדגיש למשתמשים מחירים שניתן לקבל עליהם החזר כספי באמצעות אפשרויות חלופיות, בלי לשנות ישירות את סכימת הודעות העסקה. מידע נוסף על המדיניות בנושא מחירים עם אפשרות להחזר

בדוגמה הבאה מוצג הרכיב <Refundable> עם כל המאפיינים שלו:

<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>

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

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

  • ‫available: (חובה) מגדירים את הערך 1 (או true) כדי לציין אם התעריף מאפשר החזר כספי מלא, אחרת מגדירים את הערך 0 (או false).
  • ‫refundable_until_days: (חובה אם available הוא true) מציין את מספר הימים לפני הצ'ק-אין שבהם אפשר לבקש החזר מלא. הערך של refundable_until_days חייב להיות מספר שלם בין 0 ל-330, כולל.
  • ‫refundable_until_time: (מומלץ מאוד אם הערך של available הוא true) מציין את השעה המאוחרת ביותר ביום, בזמן המקומי של המלון, שבה יכבדו בקשה להחזר כספי מלא. אפשר לשלב את התג הזה עם התג refundable_until_days כדי לציין, לדוגמה, שאפשר לקבל החזר כספי עד השעה 16:00 יומיים לפני הצ'ק-אין. אם לא מגדירים את refundable_until_time, ערך ברירת המחדל הוא חצות.

    הערך של המאפיין הזה הוא בפורמט זמן.

כשמגדירים את המאפיינים, חשוב לשים לב לנקודות הבאות:

  • אם לא מגדירים את available או את refundable_until_days המחיר לא יוצג כמחיר שניתן להחזר.
  • אם הערך של available הוא 0 (או false), המערכת מתעלמת משאר המאפיינים. המחיר לא יוצג כמחיר שניתן לקבל עליו החזר כספי גם אם אחד מהמאפיינים האחרים או שניהם מוגדרים.
<RoomID> Required string המזהה הייחודי של נתוני החדר. אפשר להשתמש במזהה הזה כדי להתאים את נתוני חבילת החדר לנתונים ששלחתם ב-<RoomData>. מידע נוסף אפשר לקרוא במאמר בנושא מטא-נתונים של חבילות חדרים. (אפשר גם להשתמש במזהה הזה כדי להפנות להגדרה של חדר משותף בהודעת עסקה אחת כשמגדירים נתוני חדרים בתוך ההודעה).
<Tax> Required float המיסים שמחושבים במחיר הסופי של החדר. רכיב <Tax> מקבל מאפיין חובה יחיד, currency, שמגדיר את קוד המטבע בן שלוש האותיות של המיסים. לדוגמה, משתמשים ב-USD לדולר ארה"ב.

דוגמאות

חבילה לחדר ליחיד

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

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

בדוגמה הזו יש הפניה למטא-נתונים מוגדרים מראש של חדר וחבילה באמצעות הרכיבים <RoomID> ו-<PackageID>. כדי להגדיר את המידע הזה, משתמשים ברכיבים <RoomData> ו-<PackageData>.

<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 1 example ----->

<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
  <!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
  <!-- Note:  Once defined it does not have to be repeated for future
              Transaction Messages.
              PropertyDataSets can also be defined and sent in their own
              Transaction Message separately from pricing. Google can be
              configured to pull just PropertyDataSets once per day
              (or on a predefined frequency). -->
  <PropertyDataSet>
    <Property>180054</Property>
    <!-- Can be reused by multiple Room Bundles -->
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Queen Room - Non-Smoking" language="en"/>
        <Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <!-- Room can accommodate up to 4, but package data specifies occupancy
           between 1 to 4 -->
      <Capacity>4</Capacity>
    </RoomData>
    <RoomData>
      <RoomID>436233</RoomID>
      <Name>
        <Text text="Premium King Room - Non-Smoking" language="en"/>
        <Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <Capacity>4</Capacity>
    </RoomData>
    <!-- Can be reused by multiple Room Bundles -->
    <PackageData>
      <PackageID>P11111</PackageID>
      <Occupancy>1</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="7"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
    <PackageData>
      <PackageID>P54321</PackageID>
      <Occupancy>2</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="7"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
    <PackageData>
      <PackageID>P12345</PackageID>
      <Occupancy>4</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="1"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
  </PropertyDataSet>

    <!-- Efficient method of defining Room Bundles -->
    <!-- Part 2: Reference RoomData and PackageData through ID -->
  <Result>
    <!-- Single occupancy pricing will be specified in a room bundle below -->
    <Property>180054</Property>
    <Checkin>2017-10-07</Checkin>
    <Nights>2</Nights>
    <!-- Base Room Bundle -->
    <RoomBundle>
      <RoomID>060773</RoomID>
      <PackageID>P54321</PackageID>
      <Baserate currency="USD">199.99</Baserate>
      <Tax currency="USD">25.12</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RatePlanID>060773-P54321</RatePlanID>
    </RoomBundle>
    <RoomBundle>
      <RoomID>060773</RoomID>
      <PackageID>P11111</PackageID>
      <!-- Price for 1 ("occupancy") is the lowest price and will be
           displayed -->
      <Baserate currency="USD">174.99</Baserate>
      <Tax currency="USD">22.08</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RatePlanID>060773-P11111</RatePlanID>
    </RoomBundle>
    <!-- Premium Room Bundle -->
    <RoomBundle>
      <RoomID>436233</RoomID>
      <PackageID>P12345</PackageID>
      <!-- Price for 4 ("occupancy"), any eligible room bundle with 1 or more
           occupancy will be displayed-->
      <Baserate currency="USD">298.88</Baserate>
      <Tax currency="USD">42.12</Tax>
      <OtherFees currency="USD">10.00</OtherFees>
      <RatePlanID>436233-P12345</RatePlanID>
    </RoomBundle>
    <!-- ..Continue providing all available RoomBundle rates under matched
         property for 1 or more occupancies..-->
  </Result>
</Transaction>

שני סוגי אירוח או יותר

בדוגמה הבאה מוגדרת תשובה שמכילה שני נתוני תפוסה או יותר.

בדוגמה הזו יש הפניה למטא-נתונים מוגדרים מראש של חדר וחבילה באמצעות הרכיבים <RoomID> ו-<PackageID>. כדי להגדיר את המידע הזה, משתמשים ברכיבים <RoomData> ו-<PackageData>.

<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 3 example ----->

<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
  <!-- Efficient method of defining Room Bundles-->
  <!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
  <PropertyDataSet>
    <Property>180054</Property>
    <!-- Can be reused by multiple Room Bundles -->
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Queen Room - Non-Smoking" language="en"/>
        <Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <!-- Room can accommodate up to 4, but package data specifies occupancy
           between 1 to 4 -->
      <Capacity>4</Capacity>
    </RoomData>
    <RoomData>
      <RoomID>436233</RoomID>
      <Name>
        <Text text="Premium King Room - Non-Smoking" language="en"/>
        <Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <Capacity>4</Capacity>
    </RoomData>
    <!-- Can be reused by multiple Room Bundles -->
    <PackageData>
      <PackageID>P33333</PackageID>
      <Occupancy>3</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="7"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
    <PackageData>
      <PackageID>P12345</PackageID>
      <Occupancy>4</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="1"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
  </PropertyDataSet>

  <Result>
    <Property>180054</Property>
    <Checkin>2017-10-07</Checkin>
    <Nights>2</Nights>
    <!-- Efficient method of defining Room Bundles -->
    <!-- Part 2: Reference RoomData and PackageData through ID -->
    <!-- Base Room Bundle -->
    <RoomBundle>
      <!-- Baserate above and attributes must match atleast one room bundle
           below -->
      <RoomID>060773</RoomID>
      <PackageID>P33333</PackageID>
      <Baserate currency="USD">499.99</Baserate>
      <Tax currency="USD">55.12</Tax>
      <OtherFees currency="USD">22.00</OtherFees>
    </RoomBundle>
    <!-- Premium Room Bundle -->
    <RoomBundle>
      <RoomID>436233</RoomID>
      <PackageID>P12345</PackageID>
      <!-- Lowest price for 3 ("occupancy"), shown below, will be displayed -->
      <Baserate currency="USD">598.88</Baserate>
      <Tax currency="USD">62.12</Tax>
      <OtherFees currency="USD">30.00</OtherFees>
    </RoomBundle>
    <!-- ..Continue providing all available RoomBundle rates under matched
         property for 2 or more occupancies..-->
  </Result>
</Transaction>


חבילות לכמה חדרים

בדוגמה הבאה מוגדרת תפוסה בכמה חבילות של חדרים כדי להמחיש תמחור אפשרי של חדרים באכסניה.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
    ...
    <!-- Suite Room Bundle -->
    <RoomBundle>
      <RoomID>suite1</RoomID>
      <PackageID>standard</PackageID>
      <Occupancy>2</Occupancy>
      <!-- Price for room -->
      <Baserate currency="USD">80.00</Baserate>
      <Tax currency="USD">5.12</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RoomData>
        <Name>
          <Text text="Suite for 2" language="en"/>
        </Name>
      </RoomData>
    </RoomBundle>

    <!-- Small Dorm Room Bundle -->
    <RoomBundle>
      <RoomID>small_dorm</RoomID>
      <PackageID>economy</PackageID>
      <Occupancy>1</Occupancy>
      <!-- Price per bed -->
      <Baserate currency="USD">35.00</Baserate>
      <Tax currency="USD">3.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RoomData>
        <Name>
          <Text text="1 bed in small dorm" language="en"/>
        </Name>
      </RoomData>
    </RoomBundle>

    <!-- Large Dorm Room Bundle -->
    <RoomBundle>
      <RoomID>large_dorm</RoomID>
      <PackageID>economy</PackageID>
      <Occupancy>1</Occupancy>
      <!-- Price per bed -->
      <Baserate currency="USD">20.00</Baserate>
      <Tax currency="USD">2.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <RoomData>
        <Name>
          <Text text="1 bed in large dorm" language="en"/>
        </Name>
      </RoomData>
    </RoomBundle>
    ...
  </Result>
</Transaction>

תעריפים בלעדיים מרובים

בדוגמה הבאה מוגדרים תעריף בסיסי ומספר תעריפים מותנים בתוך <RoomBundle>:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>2</Nights>
    <!-- When Google receives new room bundle information for an itinerary, all
    previous room bundle pricing is dropped from Google's cache. Thus, if you
    want to delete a specific room bundle from Google's cache, you may do so
    by simply not providing that specific room bundle in subsequent transaction
    messages. -->
    <RoomBundle>
     ...
      <!-- RoomID is required, PackageID is recommended. -->
      <RoomID>5</RoomID>
      <PackageID>ABC</PackageID>
      <!-- Baserate is required. -->
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>

      <!-- RatePlanID is optional and represents the unique identifier for a
      room and package data combination. We strongly recommend using RatePlanID
      as a variable to build your dynamic landing page (formerly Point of Sale)
      URL. For details, see Using Variables and Conditions. -->
      <RatePlanID>5-ABC</RatePlanID>

      <!-- Occupancy is mandatory for RoomBundle elements. -->
      <!-- Elements below will get inherited to nested rate elements. -->
      <Occupancy>2</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
      </OccupancyDetails>
      <InternetIncluded>1</InternetIncluded>

      <!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
      <ChargeCurrency>web</ChargeCurrency>

      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">258.33</Baserate>
          <Tax currency="USD">25.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides ChargeCurrency from roombundle. -->
          <ChargeCurrency>hotel</ChargeCurrency>
        </Rate>
        <Rate rate_rule_id="us_or_gb">
          <Baserate currency="USD">268.33</Baserate>
          <Tax currency="USD">26.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
        </Rate>
      </Rates>
    </RoomBundle>
  </Result>
</Transaction>

<OccupancyDetails>

‫<Occupancy> בהודעת עסקה מציין את מספר האורחים המקסימלי בחדר או בחבילה. ‫<OccupancyDetails> יכול להכיל מידע נוסף, כמו מספר האורחים וסוגם (מבוגרים או ילדים).

אם התגים <Occupancy> ו-<OccupancyDetails> מופיעים בתוך רכיב <Rates> של <Result> או <RoomBundle>, המשמעות היא שהמחיר מוגבל על ידי פרטי התפוסה.

אם כוללים את התג <OccupancyDetails> בתוך התג <RoomBundle>, יחד עם רכיב <Rate> מקונן, אי אפשר לשלוח <Occupancy> בסיסי בתוך <Rate>. במקום זאת, מומלץ להשתמש באחת מהאפשרויות הבאות:

  • השמטת נתוני התפוסה מ-<Rate>: במקרה הזה, <Rate> מקבל את <OccupancyDetails> ישירות מ-<RoomBundle>

או

  • כפילות <OccupancyDetails>: במקרה הזה, שולחים עוד <OccupancyDetails> זהים גם ברכיב <RoomBundle> וגם ברכיב <Rate> המקונן

תחביר

כשמופיע <OccupancyDetails>, הוא תמיד מופיע אחרי <Occupancy>. שימו לב לתחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
  <Result>
  ...
    <Occupancy>max_number_of_intended_occupants</Occupancy>
    <OccupancyDetails>
      <NumAdults>number_of_adults</NumAdults>
      <Children>
        <Child age=age_of_one_child_guest/>
        <Child age=age_of_one_child_guest/>
      </Children>
    </OccupancyDetails>
  </Result>
</Transaction>

רכיבי צאצא

הרכיב <OccupancyDetails> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<NumAdults> Required integer מספר האורחים המבוגרים. מינימום:1, מקסימום:20.
<Children> Optional Object קונטיינר של רכיב <Child> אחד או יותר.
<Child age> Optional integer הגיל המקסימלי של הילד או הילדה – לדוגמה, <Child age="17">.

דוגמאות

בדוגמאות הבאות אפשר לראות איך <OccupancyDetails> יכול להופיע בתוך <Results>, <RoomBundle> או רכיב הבן <Rates>.

תשובה לתוצאה

בדוגמה הבאה מוגדר מסלול נסיעה אחד והתמחור שלו לנכס אחד בתגובה לשאילתת מחירים בזמן אמת, שבה המשתמש ציין את מספר האורחים ואת סוגי האורחים. בדוגמה הזו, <OccupancyDetails> – 2 מבוגרים וילד אחד – מוחזרים ב-<Result>.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>060773</Property>
    <RoomID>RoomType101</RoomID>
    <PackageID>Package101</PackageID>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">278.33</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="site1"/>
    </AllowablePointsOfSale>
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="17"/>
      </Children>
    </OccupancyDetails>
  </Result>
</Transaction>

תשובות לגבי תעריפים

בדוגמה הבאה מוגדר מסלול נסיעה אחד והתמחור שלו למבוגר אחד וילד אחד. כאן, הערכים של <OccupancyDetails> מוחזרים ברכיב <Rates> של <Result>.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Transaction id="Wtdj8QoQIWcAAbaTGlIAAAC4" timestamp="2018-04-18T11:27:45-04:00">
  <Result>
    <Property>8251</Property>
    <Checkin>2018-06-20</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">62.18</Baserate>
    <Tax currency="USD">2.45</Tax>
    <OtherFees currency="USD">0.00</OtherFees>
    <Rates>
      <Rate rate_rule_id="rule-951">
        <Occupancy>2</Occupancy>
        <OccupancyDetails>
          <NumAdults>1</NumAdults>
          <Children>
            <Child age="17"/>
          </Children>
        </OccupancyDetails>
        <Baserate currency="USD">42.61</Baserate>
        <Tax currency="USD">5.70</Tax>
        <OtherFees currency="USD">0.00</OtherFees>
        <AllowablePointsOfSale>
          <PointOfSale id="yourhotelpartnersite.com"/>
        </AllowablePointsOfSale>
      </Rate>
    </Rates>
  </Result>
</Transaction>

חבילת חדר

בדוגמה הבאה מוגדרת תפוסה של 2 מבוגרים וילד אחד למשך שני לילות, עם תעריף שניתן להחזר. בדוגמה הזו, התווים <OccupancyDetails> מופיעים בתוך <RoomBundle>

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
  <Result>
    <Property>6781291</Property>
    <Checkin>2017-08-05</Checkin>
    <Nights>2</Nights>
    ...
    <RoomBundle>
      <RoomID>10291</RoomID>
      <RatePlanID>564739</RatePlanID>
      <PackageID>564739</PackageID>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="17"/>
        </Children>
      </OccupancyDetails>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="true" refundable_until_days="1" refundable_until_time="23:59:00" />
      <Baserate currency="USD">185.34</Baserate>
      <Tax currency="USD">37.06</Tax>
      <OtherFees currency="USD">2.22</OtherFees>
    </RoomBundle>
  </Result>
</Transaction>

חבילות לכמה חדרים

בדוגמה הבאה מוגדרים כמה תעריפים של <RoomBundle> שמוגבלים לתפוסה של 2 מבוגרים ו-2 ילדים. כאן, הערכים של <OccupancyDetails> מופיעים ברכיב <Rates> של <RoomBundle>.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">275.00</Baserate>
    <Tax currency="USD">27.50</Tax>
    <OtherFees currency="USD">0</OtherFees>
    <RoomBundle>
      <RoomID>5</RoomID>
      <PackageID>STD</PackageID>
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <OtherFees currency="USD">0</OtherFees>
      <InternetIncluded>1</InternetIncluded>
      <ChargeCurrency>web</ChargeCurrency>
      <Occupancy>4</Occupancy>
      <OccupancyDetails>
          <NumAdults>2</NumAdults>
          <Children>
              <Child age="17"/>
              <Child age="17"/>
          </Children>
      </OccupancyDetails>
      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">258.33</Baserate>
          <Tax currency="USD">25.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <ChargeCurrency>hotel</ChargeCurrency>
        </Rate>
        <Rate rate_rule_id="us_or_gb">
          <Baserate currency="USD">268.33</Baserate>
          <Tax currency="USD">26.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
        </Rate>
      </Rates>
    </RoomBundle>
  </Result>
</Transaction>