רשימת מלונות היא קובץ XML אחד או יותר, שמפרט את כל המלונות שתספקו את פרטי המחירים שלהם. קובץ רשימת המלונות עצמו לא מכיל פרטי תמחור.
הרכיב הבסיסי (root) של רשימת מלונות הוא הרכיב <listings>
שמכיל <listing>
רכיבים שמתארים את הנכסים שלכם.
אתם יוצרים רשימת מלונות כחלק מההטמעה הראשונית, ואז מוסיפים לה מלונות או מסירים ממנה מלונות כחלק מהתחזוקה הקבועה.
חשוב לוודא שהקבצים תואמים להנחיות בנושא תחביר.
לדוגמה, אפשר להשתמש בקידוד UTF-8 ולציין את סכימת הקידוד הזו על ידי הכללת המאפיין encoding
בתג ה-XML.
אחרי שיוצרים רשימת מלונות, אפשר להעלות אותה באופן ידני ל-Google באמצעות Hotel Center או לארח אותה בשרת.
איתור ותיקון של בעיות בנתונים
במאמרים הבאים מוסבר איך למצוא ולתקן בעיות בנתונים ברשימת המלונות:
דרישות לגבי הרישום
כדי שתוכלו לפרסם מודעות להזמנת חדרים ב-Google, נכס ברשימת המלונות צריך לעמוד בדרישות הבאות:
- יש בו חדרים שאורחים יכולים לשהות בהם בתשלום
- הנכס נמצא במקום קבוע, יש בו עובדים והוא פתוח לקהל הרחב
- קירות קבועים וצנרת
- הדרישה לאורך שהייה מינימלי שמוגדרת בנכס היא לא יותר מ-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 , אל תכללו את הרכיב <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 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 | המיקום הפיזי המלא של המלון. הרכיב הזה מקבל מאפיין יחיד, לכל הפחות, צריך לציין את הרחוב, העיר, המדינה או האזור
והמיקוד של המלון. צריך להשתמש ברכיבי צאצא
מסוג
למשל: <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 | אחד או יותר ממספרי הטלפון ליצירת קשר של המלון. אם הדף העסקי הוא סניף של העסק, צריך לציין את מספר הטלפון הספציפי של מיקום הסניף (לא את מספר הטלפון של המשרדים הראשיים). המאפיין
למשל: <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> לכל הפחות, עליך לספק סוג |
<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 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 |
Optional | Object | דף האינטרנט אצל הספק שמשויך לדף העסקי. כולל את רכיבי הצאצא הבאים:
הערה: האלמנטים האלה חייבים להופיע בסדר שלמעלה. |
<review |
Optional | <review> |
מכיל ביקורת של משתמש או ביקורת עריכה של דף האפליקציה. הדף העסקי יכול לכלול כמה ביקורות מכל הסוגים. אין צורך לכלול את כל הביקורות על נכס באלמנט
|
<attributes> | Optional | Object | מכיל 0 או יותר רכיבי צאצא של <client_attr name="attribute_name">attribute_value<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 | סוג הביקורת. מגדירים את אחד מהערכים הבאים:
|
רכיבי צאצא
הרכיב <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 | (ביקורות של משתמשים בלבד) תאריך הביקורת, שמציינים עם
המאפיינים הבאים של הרכיב הזה:
לדוגמה, התאריך 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 | ייצוג מקודד של כל השדות שזמינים
ב-proto Lodging . |
מחרוזת בקידוד 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), חשוב לוודא שהוא מכיל אחת משתי האפשרויות הבאות:
מאפשר לסורק Googlebot לסרוק את תוכן האתר שלך, כולל התמונות הכלולות.
- User-agent: Googlebot
- Allow: /
מאפשר לסורק התמונות של 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> | לא נדרש | השם של מחבר התוכן. הערך יכול להיות שם משתמש או שם מלא בפורמט 'שם פרטי שם משפחה'. |
<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, ואפשר להשתמש בקוד הישות או בקוד התו כדי לייצג את התווים המיוחדים האלה. בטבלה הבאה מפורטים קודים נפוצים של ישויות ותווים שבהם אפשר להשתמש:דמות ישות קוד תו אמפרסנד (&) & & גרש יחיד (') ' ' מירכאות כפולות (") " " גדול מ- (>) > > קטן מ- (<) < < השמטת רכיבי 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"/>