מאפיינים

בדף הזה מתוארים התיאורים, הערכים והדרישות למאפיינים ולרכיבי צאצא. הערכים האלה רלוונטיים רק לנכסים של 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

המיקום הפיזי המלא של הנכס.

הרכיב הזה מקבל מאפיין יחיד, 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>

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

דוגמה לרישום יחידות אירוח

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