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

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

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

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

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

אחרי שיוצרים רשימת מלונות, אפשר להעלות אותה ל-Google באופן ידני באמצעות https://support.google.com/hotelprices/ או לארח אותה בשרת שלכם.

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

כדי למצוא ולפתור בעיות בנתונים של רשימת המלונות, אפשר לעיין במאמרים הבאים:

הדרישות שצריך לעמוד בהן כדי לפרסם

כדי שתוכלו לפרסם דרך Hotel Ads, כל נכס ברשימת המלונות צריך לעמוד בתנאים הבאים:

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

דוגמאות

כתובת מובְנית

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

<?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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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> child כדי לתאר כל אחד מהחלקים הבאים של הכתובת:

  • 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) מציין שאין טשטוש ושהמיקום הוא המיקום המדויק. הערה: האלמנט הזה רלוונטי רק ליחידות אירוח.
<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 סוג הנכס, למשל מלון. שותפים יכולים להשתמש בכל קטגוריה פנימית שיש להם כדי לתאר את הנכס שלהם, כמו 'מלונות עסקיים', 'אתרי נופש', 'מוטלים' וכדומה.
<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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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>. הרכיב הזה נועד לכלול ביקורות נבחרות שממחישות את התכונות או האיכות של כרטיס המוצר.

נקודה חשובה: את התבנית <review> צריך לשלוח רק לגבי חשבונות של השכרת נופש. למידע נוסף, אפשר לפנות אל מנהל החשבון הטכני (TAM).
<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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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>
            + <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, עליכם לפנות אל מנהל החשבון הטכני (TAM).

 כל ערך מחרוזת
hotel_brand המותג שהמלון שייך לו. לדוגמה, "Marriott" או "Hilton". המידע הזה לא מוצג למשתמשים, אבל אפשר להשתמש בו כדי לקבץ מלונות. כל ערך מחרוזת
lodging ייצוג מקודד של כל השדות שזמינים ב-proto‏ Lodging. מחרוזת בקידוד Base64 של פרוטו Lodging בקידוד
num_reviews מספר הביקורות על כרטיס המוצר.

נקודה חשובה: המאפיין 'מספר הביקורות' (num_reviews) צריך להישלח רק בפידים של השכרת נופש.

 כל מספר שלם לא שלילי.
rating מספר בשיטת נקודה צפה שמייצג את דירוג הנכס המצטבר. המספר הזה הוא בדרך כלל בין 0 ל-5, בין 0 ל-10 או בין 0 ל-100, אבל אפשר להשתמש בכל טווח שמייצג את מערכת הדירוג שלכם. לדוגמה, אם ערך המאפיין rating_scale הוא 5, ערך המאפיין rating צריך להיות 3 או 4.

הערה: אם לא מציינים את ערך ברירת המחדל של rating_scale, הוא יהיה 0-10.

ערכים של placeholder של attribute_name להשכרת יחידות אירוח

אפשר לעיין במאפיינים ספציפיים ליחידות אירוח ובדוגמה ל-XML.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            <!-- <review> is allowed in Vacation Rentals only -->
            + <review>
            + <attributes>
            + <image>

התמונות משמשות להצגת הנכס במזהה כרטיס המוצר. כל התמונות שבהן נעשה שימוש צריכות לעמוד בהנחיות הבאות:

  • יחס הגובה-רוחב המומלץ לתמונות הוא 4:3.
  • לסורק התמונות Googlebot צריכה להיות גישה לכתובת ה-URL של התמונה.

  • אם באתר שלכם יש קובץ robots.txt ברמת הבסיס, צריך לוודא שהוא מכיל אחת משתי האפשרויות שמוצגות:

    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> לא נדרש שם מחבר התוכן. הערך יכול להיות שם משתמש או שם מלא בפורמט 'שם פרטי שם משפחה'.
<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 -->