קובץ XML של רשימת מלונות

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

רכיב הבסיס של רשימת המלונות הוא הרכיב <listings>, שמכיל רכיבי <listing> שמתארים את הנכסים שלכם.

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

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

אחרי שיוצרים רשימת מלונות, אפשר להעלות אותה ל-Google באופן ידני באמצעות Hotel Center או לארח אותה בשרת שלכם.

איתור ותיקון של בעיות בנתונים

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

דרישות לגבי דף האפליקציה

כדי שתוכלו לפרסם דרך Google Hotel Ads, כל נכס ברשימת המלונות צריך לעמוד בתנאים הבאים:

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

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

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

  • אתרי מחנאות, שבהם האורחים שוהים באוהלים
  • פארקי קרוואנים שאליהם האורחים מביאים קרוואנים משלהם

<listings>

<listings> הוא הרכיב הבסיסי (root) של רשימת מלונות, והוא מכיל את רכיב <language> ולפחות <listing> אחד.

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

+ <listings>
    + <language>
    + <datum>
    + <listing>

תחביר

הרכיב <listings> משתמש בתחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
    xsi:noNamespaceSchemaLocation="schema_xsd">
  <language> language_code</language>
  <datum> datum_code </datum>
  <listing> listing</listing>
  ...
</listings>

מאפיינים

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

מאפיין חובה? תיאור
xmlns:xsi חובה הגדרה לערך http://www.w3.org/2001/XMLSchema-instance.
xsi:noNamespaceSchemaLocation חובה הגדרה לערך http://www.gstatic.com/localfeed/local_feed.xsd.

רכיבי צאצא

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

רכיב צאצא חובה? סוג תיאור
<language> Required string השפה שבה כתוב הפיד. מגדירים את ערך הרכיב הזה כ קוד שפה בן שתי אותיות. לדוגמה, en עבור אנגלית.
<datum> Optional enum הרכיב הזה מציין את הדאטום הגיאו-דאטי או את מודל הייחוס עבור הקואורדינטות של קו הרוחב/קו האורך שצוינו בפיד. אם לא יסופק ערך דאטום, ערך ברירת המחדל של הרכיב הזה הוא WGS84, נמצאים בשימוש ברוב מכשירי ה-GPS המודרניים. הדאטום בטוקיו רלוונטי רק לכתובות ביפן.

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

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
הערה: כדי להשתמש בערך ברירת המחדל של WGS84, אין לכלול את הרכיב <datum> ברשימת המלונות.
<listing> Required <listing> רשומה אחת או יותר שמתארות כל מלון בפיד. חשוב לשים לב שלכל מלון ברשימה צריך להיות מזהה ייחודי לאתר שלך, ואסור לעשות שימוש חוזר במזהה הזה.

דוגמאות

כתובת מובנית

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">6 Acacia Ave</component>
      <component name="addr2">Floor 5</component>
      <component name="city">London</component>
      <component name="province">Greater London</component>
      <component name="postal_code">SW1W 9TQ</component>
    </address>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

כתובת בפריסה גמישה

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>6 Elm Ave, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

תוכן אופציונלי

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<listing>

הגדרת מלון בתוך רכיב של רשימת מלונות <listings>.

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

+ <listings>
    + <language>
    + <listing>

תחביר

הרכיב <listing> משתמש בתחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <!-- Specify <listing>'s child elements in the order shown below. -->
    <id>hotel_ID</id>
    <name>hotel_name</name>
    <address>
      <component name="addr1">street_address_1</component>
      <component name="addr2">street_address_2</component>
      <component name="city">city_name</component>
      <component name="province">province_name</component>
      <component name="postal_code">postal_code</component>
    </address>
    <!-- You can also define an address freeform, although this is not recommended: -->
    <!-- <address>freeform_address</address> -->

    <country>country_code</country>
    <latitude>hotel_latitude</latitude>
    <longitude>hotel_longitude</longitude>
    <phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>content</content>
  </listing>
</listings>

מאפיינים

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

רכיבי צאצא

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

רכיב צאצא חובה? סוג תיאור
<id> Required string מזהה ייחודי של המלון.

הערה: הערך הזה חייב להיות ייחודי לאתר שלכם לכל אורך הדרך. לא לעשות שימוש חוזר במזהים, כי זה עלול לגרום לבעיות כשמנסים לפתור בעיות להתאמת נכסים.
<name> Required string שם המלון. לדוגמה: 
<name>Belgrave House</name>
<address> Required Object or string

המיקום הפיזי המלא של המלון.

לרכיב הזה נדרש מאפיין אחד, format, וצריך להגדיר אותו לערך simple.

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

  • addr1: הרחוב הראשי של המלון.
  • addr2: רחוב משני, אם יש צורך.
  • addr3: חלק שלישי של הכתובת, אם יש צורך.
  • city: שם העיר שבה נמצא המלון.
  • province: שם המדינה, האזור או המחוז שבהם נמצא המלון.
  • postal_code: המיקוד של המלון.

לדוגמה:

<address format="simple">
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Floor 5</component>
  <component name="city">London</component>
  <component name="province">Greater London</component>
  <component name="postal_code">SW1W 9TQ</component>
</address>

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

<address>6 Elm Ave, Boston, MA, 02472</address>

חשוב לציין שתאי דואר או כתובות אחרות למשלוח דואר בלבד לא נחשבים לכתובות פיזיות מלאות.
<country> Required string המדינה שבה נמצא דף האפליקציה הזה. הערך חייב להיות קוד מדינה בן שתי אותיות. לדוגמה, הקוד של ארה"ב הוא "US" והקוד של קנדה הוא "CA". לדוגמה: 
<country>US</country>
<latitude> Required* float קו הרוחב שבו נמצא המיקום של הנכס. לדוגמה: 
<latitude>37.423738</latitude>

ניתן ליצור את הערך הזה באמצעות כלים של GeoCoding, כמו ממשק API של מפות Google.
<longitude> Required* float קו האורך שבו נמצא המיקום של הנכס. לדוגמה: 
<longitude>-122.090101</longitude>

ניתן ליצור את הערך הזה באמצעות כלים של GeoCoding, כמו ממשק API של מפות Google.
<location_precision> Optional integer הדיוק של מיקום הנכס שנשלח במטרים כאשר יש ערפול קוד (obfuscation) לקווי הרוחב והאורך של הנכס. המשמעות של אפס (0) היא שאין ערפול קוד (obfuscation) ושזהו המיקום המדויק. הערה: הרכיב הזה חל רק על יחידות אירוח.
<phone> Required* string

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

המאפיין type יכול להיות אחד מהבאים:

  • fax: מספר טלפון פקס.
  • main: מספר הטלפון הראשי.
  • mobile: מספר טלפון נייד.
  • tdd: מכשיר תקשורת עבור מספר הטלפון הלחירש (TDD).
  • tollfree: מספר טלפון לשיחת חינם.

לדוגמה:

<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

לכל הפחות, יש לציין סוג של main.
<category> Optional string סוג הנכס, למשל מלון. שותפים יכולים להשתמש בקטגוריות הפנימיות שיש להם כדי לתאר את הנכס שלהם, כמו "מלונות עסקיים", "אתרי נופש", "מוטלים" וכו'.
<content> Optional <content> פרטים אופציונליים שמשמשים לדף העסקי, כמו תיאור, דירוגים ותכונות של הנכס.

* צריך לציין מספר טלפון או קו רוחב/קו אורך. מומלץ להגדיר את שניהם.

דוגמאות

כתובת מובנית

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">6 Acacia Ave</component>
      <component name="addr2">Floor 5</component>
      <component name="city">London</component>
      <component name="province">Greater London</component>
      <component name="postal_code">SW1W 9TQ</component>
    </address>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

כתובת בפריסה גמישה

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>6 Elm Ave, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

תוכן אופציונלי

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<content>

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

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

+ <listings>
    + <language>
    + <listing>
        + <content>

תחביר

הרכיב <content> משתמש בתחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      <!-- Specify <text>'s child elements in the order shown below. -->
      <text type="description">
        <link>listing_link</link>
        <title>listing_title</title>
        <author>listing_author</author>
        <body>listing_description</body>
        <date month="MM" day="DD" year="YYYY"/>
      </text>
      <!-- 0 or more reviews: -->
      <review type="[editorial|user]">
        ...
      </review>
      <!-- 0 or more attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="custom_0">custom_attribute_0</client_attr>
        <client_attr name="custom_1">custom_attribute_1</client_attr>
        <client_attr name="custom_2">custom_attribute_2</client_attr>
        <client_attr name="custom_3">custom_attribute_3</client_attr>
        <client_attr name="custom_4">custom_attribute_4</client_attr>
        <client_attr name="hotel_brand">hotel_brand</client_attr>
        <client_attr name="num_reviews">number_of_reviews</client_attr>
        <client_attr name="rating">aggregate_rating</client_attr>
      </attributes>
      <!-- a picture of the hotel or property-->
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main Hotel Picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

מאפיינים

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

רכיבי צאצא

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

רכיב צאצא חובה? סוג תיאור
<text type="description"> Optional Object

דף האינטרנט המשויך לרישום מהספק. כולל את רכיבי הצאצא הבאים:

  • <link>: קישור לתיאור. יש לכלול את "http://" או
    "https://" לרכיב הזה (אופציונלי).
  • <title>: שם התיאור (אופציונלי).
  • <author>: המחבר של התיאור (אופציונלי).
  • <body>: גוף התיאור (חובה).
  • <date>: התאריך של התיאור (אופציונלי).

    • הערה: הרכיבים האלה חייבים להופיע לפי הסדר שלמעלה.
<review type="[editorial|user]"> Optional <review>

מכיל ביקורת משתמש או ביקורת עריכה של הרישום. הדף העסקי שלך יכול לכלול מספר ביקורות מכל סוג.

אין צורך לכלול את כל הביקורות לגבי נכס באלמנט <listing>. הרכיב הזה מיועד לכלול ביקורות נבחרות שמראות את התכונות או האיכות של דף האפליקציה הזה.
<attributes> Optional Object

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

<client_attr name="attribute_name">attribute_value<client_attr>

לרשימה ולתיאור של רכיבי צאצא, עיינו בכתובת <attributes>.

כל רכיבי <client_attr> הם אופציונליים.

אם יש רכיב צאצא <website>, צריך למקם אותו לפני רכיב <client_attr> כלשהו.
<image> Optional Object תג חוזר, מכיל מידע מפורט על התמונה.

דוגמה

בדוגמה הבאה מוצגת רשימה חלקית של מלונות שכוללת את הרכיב <content>:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<review>

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

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

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

תחביר

הרכיב <review> משתמש בתחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <!-- Specify <review>'s child elements in the order shown below. -->
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
        <date>review_date</date>
        <servicedate>review_servicedate</servicedate>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <servicedate month="MM" day="DD" year="YYYY"/>  <!-- Service Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

מאפיינים

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

מאפיין חובה? תיאור
type Required סוג הביקורת. מגדירים לאחד מהערכים הבאים:
  • editorial: ביקורת שנכתבה על ידי אתר או רשות ביקורת אחרת.
  • user: ביקורת מאת משתמש קצה.

רכיבי צאצא

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

רכיב צאצא חובה? סוג תיאור
<link> Optional string קישור לביקורת. יש לכלול את "http://" או "https://" באלמנט הזה.
<title> Optional string (ביקורות עריכה בלבד) שם הביקורת.
<author> Optional string מחבר הביקורת, לדוגמה, "סוזן פון טראפ". הערך הזה יכול להיות גם שם של אתר או פרסום שבהם הביקורת מופיעה, אם היא ללא קרדיט.
<rating> Optional string מספר נקודה צפה (floating-point) מ-0 עד 10 (כולל) שמייצג את ציון הביקורת. לדוגמה, '8.9'.
<body> Optional string הטקסט של הביקורת. הרכיב הזה לא יכול להכיל HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (ביקורות של משתמשים בלבד) תאריך הביקורת, שמציינים עם המאפיינים הבאים של הרכיב הזה:
  • day: היום בחודש. לדוגמה, "7".
  • month: החודש שבו 1 = ינואר ... 12 = דצמבר.
  • year: השנה בת ארבע הספרות. לדוגמה,'2023'.

לדוגמה, התאריך 7 ביוני 2023 ייכתב כך:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (ביקורות של משתמשים בלבד) התאריך שבו הכותב ביקר בדף העסקי שנבדק. הפורמט זהה לפורמט <date> שלמעלה.

לדוגמה, התאריך 7 ביוני 2023 ייכתב כך:

<servicedate month="6" day="7" year="2023"/>

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

לתשומת ליבך, <title> הוא רכיב צאצא חוקי של <review> רק אם הערך של type בביקורת הוא editorial ו-<date> תקף רק אם הערך של type הוא user.

דוגמה

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<attributes>

התג <attributes> יכול לשמש לתיאור שירותי המלון ולסיווג דירוגים וביקורות על הנכס.

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>

רכיבי צאצא

רכיב צאצא חובה? תיאור
<website> Optional האתר הראשי של המלון. אם הוא קיים, צריך למקם אותו לפני הרכיב הראשון של <client_attr>. לדוגמה: 
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional מאפיין או "מאפיין" נוסף של הנכס, שאפשר לציין באמצעות המאפיינים הנתמכים attribute_name או attribute_name עבור יחידות אירוח.

ערכים ל-placeholder של שם המאפיין

בטבלה הבאה מפורטים ערכים חוקיים עבור attribute_name ברכיב <client_attr name="attribute_name">.

ערכים עבור attribute_name תיאור ערכי תוכן חוקיים
alternate_hotel_id מזהה חלופי של הנכס. כדאי להוסיף מזהים נפרדים אם אתם צריכים מזהה נכס אחד לפרטי הפיד, ומזהה נכס אחר למנוע ההזמנות. כל ערך מחרוזת
custom_[0-4] כל מאפיין מותאם אישית מסוג מחרוזת. פרטים אלה לא מוצגים למשתמשים. כל ערך מחרוזת
hotel_brand המותג שהמלון שייך לו. לדוגמה, "Marriott" או "Hilton". השדה הזה לא מוצג למשתמשים, אבל יכול לשמש לקיבוץ מלונות. כל ערך מחרוזת
lodging ייצוג מקודד של כל השדות הזמינים בפרוטוקול Lodging. מחרוזת בקידוד Base64 של הפרמטר מקודד Lodging
num_reviews מספר הביקורות של הרישום. כל מספר שלם שאינו שלילי.
rating מספר נקודה צפה (floating-point) שמייצג את הדירוג המצטבר של הנכס. המספר הזה בדרך כלל נע בין 0-5, 0-10 או 0-100, אבל אפשר להשתמש בכל טווח שמייצג את מערכת הסיווג שלכם.

ערכים של ה-placeholder של המאפיין_name עבור יחידות אירוח

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

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>
            + <image>

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

  • יחס הגובה-רוחב המומלץ לתמונות הוא 4:3.
  • כתובת ה-URL של התמונה חייבת להיות נגישה לסורק התמונות של Googlebot.

  • אם האתר כולל קובץ robots.txt ברמה הבסיסית (root), צריך לוודא שהוא מכיל אחת משתי האפשרויות הבאות:

    1. מאפשר לסורק Googlebot לסרוק את תוכן האתר שלך, כולל התמונות.

      • User-agent: Googlebot
      • Allow: /‎

    2. מאפשר לסורק התמונות של Googlebot לסרוק את התמונות באתר שלך.

      • User-agent: Googlebot-Image
      • Allow: /‎

  • לא ניתן להשתמש בצילומי מסך של תמונות או אתרים. התמונות חייבות להיות מקוריות ותמונות או צילומים אמיתיים.

מאפיינים

  • "ad" אם התמונה היא פרסומת
  • "menu" אם התמונה היא תפריט של מסעדה
  • "photo" אם התמונה היא תמונה של העסק
שם מאפיין חובה? פורמט תיאור
type Required Text

התמונה צריכה להיות אחת מהאפשרויות הבאות:
url Required Text כתובת ה-URL של התמונה בגודל מלא. אפשר להשתמש במאפיין כתובת ה-URL כדי לציין את התמונה שתוצג בדף הזה.
width Required A non-negative integer רוחב התמונה, בפיקסלים (מומלץ יותר מ-720 פיקסלים)
height Required A non-negative integer גובה התמונה, בפיקסלים (מומלץ מעל 720 פיקסלים)

רכיבי צאצא

רכיב צאצא חובה? תיאור
<link> התבקשה, אבל חובה לתמונות מקומיות. התג הזה מכיל את כתובת ה-URL החוקית והעדכנית של הדף באתר שבו התמונה הרלוונטית. הוא לא מכיל את כתובת ה-URL של התמונה עצמה. לדוגמה:
<link><http://www.example.com/magic_pizza/></link>
<title> נשלחה בקשה התג הזה מכיל את כותרת התמונה. לדוגמה: 
<title>"Luxury Apartment"</title>
<author> לא נדרש השם של מחבר התוכן. הערך יכול להיות שם משתמש או שם מלא בפורמט "Firstname Lastname".
<date> חובה

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

<date month="6" day="7" year="2023"/>

דוגמה

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <content>
      <review>
      </review>
      <attributes>
      </attributes>
      <image type="photo" url="https://image_url" width="400" height="300">
        <link>https://image_url</link>
        <title>Apartment at Sandstone</title>
        <author>Jessica Landlord</author>
        <date month="6" day="7" year="2023"/>
      </image>
    </content>
  </listing>
  ...
</listings>

הנחיות תחביר

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

  • מאמתים את קובצי ה-XML של רשימת המלונות באמצעות סכימת ה-XSD של Google.

  • צריך להשתמש בקידוד UTF-8. כדי לציין את סכימת הקידוד הזו, כוללים את המאפיין encoding בתג ה-XML, כמו בדוגמאות הבאות.

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

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

    דמות ישות קוד תו
    אמפרסנד (&) &amp; &#38;
    ציטוט יחיד (') &apos; &#39;
    מירכאות כפולות (") &quot; &#34;
    גדול מ- (>) &gt; &#62;
    קטן מ- (<) &lt; &#60;

  • משמיטים רכיבי XML שלא מכילים נתונים. לדוגמה, אם לא ציינתם את קווי האורך והרוחב של מלון, אין לכלול בו רכיבי <latitude/> ו-<longitude/> ריקים.

  • בשום פנים ואופן אין להשתמש ב-HTML ברכיבי XML (גם אם הוא מסומן בתו בריחה).

  • כדי לאמת את הפיד לפני ההעלאה, אפשר להשתמש בפיד המקומי XSD http://www.gstatic.com/localfeed/local_feed.xsd.

  • כדי להשתמש בתגובות בפיד, צריך להקיף את התגובה בתגים <!-- ו--->, כמו בדוגמה הבאה:

    <!-- This is a comment -->

  • חשוב לוודא שסוגרים את האלמנט <date> ברמת המשתמש <review>. לדוגמה:

    <date day="2" month="12" year="2017"/>