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

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

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

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

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

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

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

במאמרים הבאים מוסבר איך למצוא ולתקן בעיות בנתונים ברשימת המלונות:

דרישות לגבי הרישום

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

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

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

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

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

<listings>

<listings> הוא הרכיב הבסיסי ברשימת מלונות והוא מכיל רכיב <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> רשומה אחת או יותר שמתארת כל מלון בפיד. שימו לב לכל מלון ברשימה חייב להיות מזהה ייחודי לאתר שלכם, וגם שלעולם אין לעשות שימוש חוזר במזהה הזה.

דוגמאות

כתובת מובנית

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

<?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>

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

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

<?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 Unit 3, 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 Unit 3, Boston, MA, 02472</address>

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

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

ניתן ליצור את הערך הזה באמצעות כלי GeoCoding כמו Google Maps API
<location_precision> Optional integer הדיוק של מיקום הנכס במטרים כשקווי הרוחב והאורך של הנכס מעורפלים. המשמעות של אפס (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 סוג הנכס, למשל מלון. השותפים רשאים להשתמש בכל קטגוריות שיש להם לתיאור הנכס שלהם, כמו 'מלונות עסקיים', "resorts," "מוטלים", ודומה.
<content> Optional <content> פרטים אופציונליים שמשמשים לדף האפליקציה, כמו תיאור, דירוגים, והתכונות של הנכס.

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

דוגמאות

כתובת מובנית

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

<?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>

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

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

<?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 Unit 3, 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]

בטבלה הבאה מפורטים הערכים התקפים של המאפיין attribute_name. ב-<client_attr name="attribute_name"> לרכיב מסוים.

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

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

לפרטים נוספים, ניתן לעיין במאפיינים ספציפיים ל-Vacation Rentals ובדוגמה בפורמט 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 בשום מקרה (גם אם הוא תו בריחה (escape)).

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

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

    <!-- This is a comment -->

  • חשוב להקפיד לסגור את הרכיב <date> במשתמש <review>. לדוגמה:

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