מאפיינים

בדף הזה מתוארים התיאורים, הערכים והדרישות לגבי מאפיינים וגם באלמנטים צאצאים. הערכים האלה רלוונטיים רק לנכסים של Vacation Rentals.

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

אם לא תכללו את פריטי החובה הבאים, תתבצע השבתה אוטומטית של רשימה:

  • רכיבי צאצא נדרשים של XML: id, name, latitude, longitude, address.
  • מאפיינים נדרשים: capacity ו-website. קישורים ישירים ליחידות אירוח בפיד של כרטיסי המוצר. כך המשתמשים יכולים להיכנס לנכס האתר.

לפרטים על רכיבי הצאצא הנדרשים של XML, ראו צאצא XML רכיבים.

למידע נוסף על יחידות אירוח, אפשר לעיין במאמר מאפיינים ייחודיים ליחידות אירוח.

לבסוף, כש-Google קובעת ממקורות אחרים שהערך של attribute[מאפיין] שונה מ- את מה שצוין בפיד לגבי כרטיס של יחידת אירוח, Google מציגה את בערך של הרישום. למשל, אם Google מזהה תמונות בדף פרטי המקום שיש מטבח, אבל המאפיין kitchen חסר או מוגדר ל-No, Google מתייחסת לדף העסקי כאל מטבח. המאפיינים האלה נקראים 'מאפיינים משוערים', והם מוצגים רק כשיש ודאות גבוהה ברמת ההסקה.

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

הטבלה הבאה מספקת רשימה של ערכים חוקיים ל-attribute_name ב- הרכיב <client_attr name="attribute_name">; עם זאת, מומלץ לספק attribute_name נוספים, אם הם זמינים.

ערכים של attribute_name חובה? תיאור ערכי תוכן חוקיים
capacity Required המספר המקסימלי של אורחים שיכולים ללון במלון. הערך הזה צריך להיות שווה ל-"number_of_rooms" או גדול ממנו. 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 מספר רישיון (תיירות או עסק) שנדרש להצגה בנכסים באזורים מסוימים בעולם. ייתכן שהיא תחזור על עצמה, ואם כמה אנשים רישיונות קיימים, אנחנו ממליצים להוסיף סמכות לרישיון בתור הקשר; לדוגמה: "פריז: 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 המדינה שבה נמצא דף האפליקציה הזה. הערך חייב להיות ISO 3116 קוד מדינה בן 2 אותיות; לדוגמה, ארצות הברית היא 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 string or Object

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

לחלופין, אפשר לספק address. שימוש בחשבון צאצא אחד (<component>) כדי לתאר כל אחד מהחלקים הבאים של הכתובת:

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

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

הנה דוגמאות לכתובת מלאה:

<address> 6 Acacia Ave Apt. 2, Sidney, V8L 3B8, Canada</address>
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

הנה דוגמאות לכתובת מלאה תוך שימוש ב-Plus Code:

<address>84WRMJ53+HM, Sidney, V8L 3B8, Canada</address>
<address>
  <component name="addr1">84WRMJ53+HM</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</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>