בדף הזה מתוארים התיאורים, הערכים והדרישות למאפיינים ולרכיבי צאצא. הערכים האלה רלוונטיים רק לנכסים של Vacation Rentals.
למבנה ה-XML הכללי יש פורמט דומה לזה של פידים של כרטיסי מוצר של מלונות. מידע נוסף זמין בחומר העזר בנושא XML של רשימת המלונות.
אם לא תכללו את הפריטים הנדרשים הבאים, הדף העסקי יושבת באופן אוטומטי:
- רכיבי צאצא נדרשים של XML:
id
,name
,latitude
,longitude
,address
. - מאפיינים נדרשים:
capacity
ו-website
. עיינו בקטע קישורים ישירים של יחידות אירוח בפיד של כרטיסי המוצר. כך המשתמשים יכולים להיכנס לאתר של הנכס.
לפרטים על רכיבי הצאצא הנדרשים של XML, עיינו במאמר רכיבי צאצא של XML.
למידע נוסף על יחידות אירוח, קראו את המאמר מאפיינים ייחודיים ליחידות אירוח.
לסיום, כש-Google קובעת ממקורות אחרים שהערך של
מאפיין שונה מהערך שצוין בפיד עבור כרטיס מוצר של יחידת אירוח, Google מציגה את הערך של כרטיס המוצר. לדוגמה, אם Google מזהה מהתמונות בדף העסקי שיש מטבח, אבל המאפיין kitchen
חסר או מוגדר ל-No
, Google תתייחס לדף האפליקציה כאל מטבח. המאפיינים האלה נקראים
'מאפיינים משוערים', והם מוצגים רק כשיש ודאות גבוהה
שרמת הדיוק של ההסקה.
ערכים של ה-placeholder של שם המאפיין [attribute_name]
הטבלה הבאה מספקת רשימה של הערכים התקינים ל-attribute_name
ברכיב <client_attr name="attribute_name">
. עם זאת, מומלץ לספק את הערך הנוסף של attribute_name
, אם הוא זמין.
ערכים של attribute_name |
חובה? | תיאור | ערכי תוכן חוקיים |
---|---|---|---|
capacity | Required | מספר האורחים המקסימלי במלון יכול ללון בו. הערך הזה צריך להיות שווה ל-"number_of_bedrooms" או גדול ממנו. | Non-negative integer value |
website | Required | כתובת האתר של הנכס. | Free text |
partner_hygiene_link | Strongly recommended | קישור לאתר חיצוני של שותף שמספק מידע נוסף על פרטי התקינות של כרטיס המוצר. | Free text (the site's URL) |
number_of_bathrooms | Strongly recommended | מספר חדרי הרחצה. | Non-negative float value, for example, 1, 1.5, 2 |
number_of_bedrooms | Strongly recommended | מספר חדרי השינה. | Non-negative integer value |
number_of_beds | Strongly recommended | מספר המיטות בכל החדרים. | Non-negative integer value |
self_checkin_checkout | Recommended | האם אפשר לעשות צ'ק-אין עצמי וצ'ק אאוט בנכס. | Yes/No/Unknown |
rating | Strongly recommended | מספר של נקודה צפה (floating-point) שמייצג את דירוג הנכס המצטבר. המספר הזה הוא בדרך כלל בין 0-5, 0-10 או 0-100, אבל אפשר להשתמש בכל טווח שמייצג את מערכת הסיווג שלכם. | Non-negative float value |
rating_num | Strongly recommended | מספר הדירוגים שיש לנכס. | Non-negative integer value |
rating_scale | Strongly recommended | הדירוג המקסימלי האפשרי לנכס | Non-negative integer value |
instant_bookable | Strongly recommended | האם ניתן להזמין את הנכס באופן מיידי באמצעות תהליך הצ'ק אאוט. החלופה ממתינה לאישור. | Yes/No/Unknown |
description | Strongly recommended | טקסט חופשי שמתאר את התכונות הייחודיות של הנכס | Free text |
category | Strongly recommended | סוג הנכס, כגון וילה, בונגלו, בקתה או דירה | Free text |
ac | Recommended | האם בנכס יש מיזוג אוויר. | Yes/No/Unknown |
beach_access | Recommended | האם יש לנכס גישה לחוף ציבורי בקרבת הנכס. | Yes/No/Unknown |
check_in_time | Recommended | השעה המדויקת ביום לצ'ק-אין לנכס. מותר להשתמש בפורמטים HHMM, HH:MM או HH:MM:SS. לדוגמה, ב-14:00 במקום ב-14:00 או 14:00. כל הפורמטים האחרים לא ינותחו או יוצגו. | Time |
check_out_time | Recommended | השעה המדויקת ביום לצ'ק אאוט מהנכס. מותר להשתמש בפורמט HHMM, HH:MM או HH:MM:SS. לדוגמה, להשתמש ב-11:00 במקום ב-11:00 או 11:00. כל הפורמטים האחרים לא ינותחו או יוצגו. | Time |
child_friendly | Recommended | האם הנכס מתאים לילדים. | Yes/No/Unknown |
crib | Recommended | האם בנכס יש עריסה. | Yes/No/Unknown |
elevator | Recommended | האם יש בנכס מעלית. | Yes/No/Unknown |
gym_fitness_equipment | Recommended | האם יש בנכס מכון כושר או ציוד כושר אחר. | Yes/No/Unknown |
heating | Recommended | האם בנכס יש חימום. | Yes/No/Unknown |
hot_tub | Recommended | האם יש במקום ג'קוזי. | Yes/No/Unknown |
ironing_board | Recommended | האם יש במקום קרשי גיהוץ זמינים. | Yes/No/Unknown |
kitchen | Recommended | האם בנכס יש מטבח. | Yes/No/Unknown |
microwave | Recommended | האם יש במקום מיקרוגל. | Yes/No/Unknown |
min_days_advance_purchase | Recommended | מספר הימים המינימלי מראש שבהם אפשר להזמין את הנכס. | Non-negative integer value |
min_night_stay | Recommended | המספר המינימלי של לילות שאורחים יכולים להזמין במלון. | Positive integer (more than zero) |
max_night_stay | Recommended | מספר הלילות המקסימלי שאורחים יכולים להזמין במלון. | Positive integer (more than zero) |
outdoor_grill | Recommended | האם בנכס יש מסעדת גריל. | Yes/No/Unknown |
oven_stove | Recommended | האם בנכס יש כיריים. | Yes/No/Unknown |
parking_type | Recommended | סוג החניה הזמינה בנכס. | Free/Paid/None |
patio | Recommended | האם יש לנכס פטיו. | Yes/No/Unknown |
pets_allowed | Recommended | בחלק מהחדרים או כולם אפשר להביא חיות מחמד – כלבים או חתולים שהם לא חיות שירות – לאורחים. | Yes/No/Unknown |
pool_type | Recommended | סוג הבריכה (גישה למאגר) שיש בנכס. | Indoors, Outdoors, Indoors/Outdoors, None |
smoking_free_property | Recommended | האם העישון אסור בנכס או ללא עישון. | Yes/No/Unknown |
special_service_level | Recommended | האם רמת השירות של דף האפליקציה מיוחדת באופן כלשהו.
לדוגמה, verified , luxury , premium |
Yes/No/Unknown |
square_footage | Recommended | שטח הנכס במטרים רבועים. | Non-negative float value |
square_meters | Recommended | שטח הנכס במטרים רבועים. | Non-negative float |
tv | Recommended | האם בנכס יש טלוויזיה. | Yes/No/Unknown |
washer_dryer | Recommended | האם יש בנכס מכונות כביסה. | Yes/No/Unknown |
wheelchair_accessible | Recommended | האם הנכס נגיש לכיסא גלגלים. | Yes/No/Unknown |
internet_type | Recommended | סוג הגישה ל-Wi-Fi שהנכס מספק. | Free/Paid/None |
airport_shuttle | Optional | אם המארח מספק הסעות אל נמל התעופה או אל טרמינלים אחרים, או ממנו. | Yes/No/Unknown |
balcony | Optional | האם יש בנכס מרפסת קטנה. | Yes/No/Unknown |
fire_place | Optional | האם בנכס יש קמין. | Yes/No/Unknown |
free_breakfast | Optional | האם המחיר כולל ארוחת בוקר בחינם בנכס. | Yes/No/Unknown |
host_description | Optional | תיאור של מארח יחידת האירוח. | Free text |
host_language | Optional | השפות שהמארח יכול לדבר בהן. | רשימה של
קודי שפה שמופרדים בפסיקים. לדוגמה: de , en |
host_name | Optional | השם של המארח של יחידת האירוח. | Free text |
host_response_rate | Optional | שיעור התגובה הממוצע של המארח. | Non-negative float value, for example, 1, 0.75, 0.5 |
host_response_time | Optional | זמן התגובה הממוצע של המארח. | Free text |
license_num | Optional | מספר הרישיון (תיירות או עסק) שנדרש להצגה בנכסים באזורים מסוימים בעולם. זה יכול לקרות שוב ושוב, ואם קיימים כמה רישיונות, מומלץ להוסיף את הסמכות לרישיון בתור הקשר. לדוגמה: "Paris: 123456ABC". | Free text |
number_of_half_bathrooms | Optional | מספר חדרי הרחצה בשימוש. | Non-negative integer value |
number_of_living_rooms | Optional | מספר הסלון. | Non-negative integer value |
private_beach_access | Optional | האם לנכס יש גישה ייעודית לחוף שאינו ציבורי. | Yes/No/Unknown |
refund_policy | Optional | מדיניות ההחזרים הכספיים על הנכס. | Free text |
רכיבי צאצא של XML
יש צורך ברכיבי הצאצא הבאים של XML:
רכיב צאצא | חובה? | סוג | תיאור |
---|---|---|---|
<country> | Strongly recommended | string | המדינה שבה נמצא דף האפליקציה הזה. הערך צריך להיות
קוד מדינה בן 2 אותיות לפי תקן ISO 3116. לדוגמה, ארצות הברית היא US
וקנדה היא CA :
<country>US</country> |
<id> | Required | string | המזהה הייחודי של הנכס. לתשומת ליבך, לכל יחידת אירוח צריך להיות מזהה ייחודי לאתר שלך, ואסור שייעשה שימוש חוזר במזהה הזה. |
<latitude> | Required | float | קו הרוחב שבו נמצא המיקום של הנכס. לדוגמה:
<latitude>37.423738</latitude> ניתן ליצור את הערך הזה באמצעות כלי GeoCoding כמו Google Maps API. |
<longitude> | Required | float | קו האורך שבו נמצא המיקום של הנכס. לדוגמה:
<longitude>-122.090101</longitude> ניתן ליצור את הערך הזה באמצעות כלי GeoCoding כמו Google Maps API. |
<name> | Required | string | שם הנכס. עד 300 תווים. |
<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> חשוב לשים לב שתיבות דואר או כתובות אחרות למשלוח דואר לא נחשבות לכתובות פיזיות מלאות. |
דוגמה לרישום יחידות אירוח
<?xml version="1.0" encoding="UTF-8"?> <listings> <language>en</language> <listing> <id>123456</id> <name>Apartment Name</name> <address format="simple"> <component name="addr1">18733 Clark Way</component> <component name="addr2">#C10</component> <component name="city">Mountain View</component> <component name="postal_code">94043</component> <component name="province">California</component> </address> <country>US</country> <latitude>37.4182515</latitude> <longitude>-122.0742354</longitude> <phone type="main">12345678</phone> <category>vacation_villa</category> <date day="21" month="12" year="2017"/> <content> <text type="description"> <link>https://list_url</link> <title>Description Title</title> <body>Description Body</body> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE</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="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com/123456</website> <client_attr name="capacity">7</client_attr> <client_attr name="cleaning_disinfection">Yes</client_attr> <client_attr name="min_days_between_stays">3</client_attr> <client_attr name="enhanced_cleaning_practices">Yes</client_attr> <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr> <client_attr name="number_of_bathrooms">2</client_attr> <client_attr name="number_of_bedrooms">3</client_attr> <client_attr name="number_of_beds">4</client_attr> <client_attr name="self_checkin_checkout">Yes</client_attr> <client_attr name="rating">4.8</client_attr> <client_attr name="rating_num">5373</client_attr> <client_attr name="rating_scale">5</client_attr> <client_attr name="ac">Yes</client_attr> <client_attr name="airport_shuttle">Yes</client_attr> <client_attr name="balcony">No</client_attr> <client_attr name="beach_access">Yes</client_attr> <client_attr name="check_in_time">15:00</client_attr> <client_attr name="check_out_time">11:00</client_attr> <client_attr name="child_friendly">Yes</client_attr> <client_attr name="crib">Unknown</client_attr> <client_attr name="elevator">Yes</client_attr> <client_attr name="fire_place">Unknown</client_attr> <client_attr name="free_breakfast">Yes</client_attr> <client_attr name="gym_fitness_equipment">Yes</client_attr> <client_attr name="heating">Yes</client_attr> <client_attr name="host_description">A short description about the host and their interests</client_attr> <client_attr name="host_name">The name of the host</client_attr> <client_attr name="host_language">en, da, el</client_attr> <client_attr name="host_response_rate">0.75</client_attr> <client_attr name="host_response_time">1 hour</client_attr> <client_attr name="hot_tub">Yes</client_attr> <client_attr name="instant_bookable">Yes</client_attr> <client_attr name="internet_type">Free</client_attr> <client_attr name="ironing_board">No</client_attr> <client_attr name="kitchen">Yes</client_attr> <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr> <client_attr name="license_num">Paris: 123456ABC</client_attr> <client_attr name="microwave">Yes</client_attr> <client_attr name="max_night_stay">7</client_attr> <client_attr name="min_days_advance_purchase">2</client_attr> <client_attr name="min_night_stay">3</client_attr> <client_attr name="number_of_living_rooms">1</client_attr> <client_attr name="outdoor_grill">No</client_attr> <client_attr name="oven_stove">Yes</client_attr> <client_attr name="parking_type">Free</client_attr> <client_attr name="patio">Unknown</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="pool_type">Indoors</client_attr> <client_attr name="private_beach_access">Unknown</client_attr> <client_attr name="room_type">Entire Place</client_attr> <client_attr name="refund_policy">The refund policy for the property</client_attr> <client_attr name="smoking_free_property">Yes</client_attr> <client_attr name="special_service_level">No</client_attr> <client_attr name="square_footage">1200</client_attr> <client_attr name="tv">Yes</client_attr> <client_attr name="washer_dryer">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> </attributes> </content> </listing> </listings>