مرجع ملف XML لقائمة الفنادق

قائمة الفنادق هي ملف واحد أو أكثر بتنسيق XML يضم جميع الفنادق التي ستقدّم لها معلومات عن أسعارها. لا يحتوي ملف قائمة الفنادق نفسه على معلومات الأسعار.

إنّ العنصر الجذر في قائمة الفنادق هو العنصر <listings> الذي يحتوي على عناصر <listing> التي تصف فنادقك.

يمكنك إنشاء قائمة فنادق كجزء من عملية التنفيذ الأولية، ثم إضافة الفنادق أو إزالتها منها كجزء من الصيانة المنتظمة.

تأكد من توافق ملفاتك مع إرشادات البنية. على سبيل المثال، استخدِم ترميز UTF-8 وحدِّد مخطّط الترميز هذا من خلال تضمين السمة encoding في علامة XML.

بعد إنشاء قائمة فنادق، يمكنك تحميلها يدويًا إلى Google باستخدام Hotel Center أو استضافتها على خادمك.

البحث عن مشاكل البيانات وإصلاحها

للعثور على مشاكل البيانات في قائمة الفنادق وإصلاحها، يُرجى الاطّلاع على المقالات التالية:

متطلبات بطاقة بيانات المتجر

للتأهُّل لعرض إعلانات الفنادق على Google، يجب أن يستوفي أحد المواقع في قائمة الفنادق ما يلي:

  • غرف تتيح إقامة النزلاء بمقابل مادي
  • مكان على أرض الواقع وموقع جغرافي ثابت ومفتوح للجمهور
  • جدران وسباكة ثابتة
  • عدم تجاوز الحد الأدنى المطلوب للإقامة 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, 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

الموقع الجغرافي الكامل للفندق.

يستخدم هذا العنصر سمة واحدة، 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, Boston, MA, 02472</address>

يُرجى العلم أنّ صناديق البريد أو العناوين البريدية الأخرى فقط لا تُعتبر عناوين جغرافية كاملة.
<country> Required string البلد الذي تقع فيه بطاقة البيانات هذه. يجب أن تكون القيمة رمز بلد مكوّنًا من حرفَين. على سبيل المثال، رمز مصر هو "EG" والإمارات "AE". مثلاً: 
<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, 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 type="description"> Optional Object

صفحة الويب المرتبطة بالبيانات من مقدّم الخدمة تتوفر به العناصر الفرعية التالية:

  • <link>: رابط إلى الوصف أدرِج "http://" أو
    "https://" في هذا العنصر (اختياري).
  • <title>: عنوان الوصف (اختياري)
  • <author>: مؤلف الوصف (اختياري).
  • <body>: نص الوصف (مطلوب)
  • <date>: تاريخ الوصف (اختياري)

    • ملاحظة: يجب أن تظهر هذه العناصر بالترتيب أعلاه.
<review type="[editorial|user]"> Optional <review>

يحتوي على مراجعة مستخدم أو مراجعة تحريرية لبطاقة البيانات. يمكن أن تتضمن بياناتك أي عدد من المراجعات، من أي نوع.

ليس عليك تضمين جميع المراجعات الخاصة بالسمة في العنصر <listing>، فهذا العنصر مخصّص لك لتضمين مراجعات محدّدة توضّح ميزات بطاقة البيانات هذه أو جودتها.
<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>
      <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 تمثّل هذه السمة نوع المراجعة. اضبط القيمة على إحدى القيم التالية:
  • editorial: مراجعة من موقع إلكتروني أو هيئة مراجعة أخرى.
  • user: مراجعة أضافها أحد المستخدمين النهائيين

العناصر الفرعية

يتضمن العنصر <review> العناصر الثانوية التالية:

العنصر الثانوي مطلوب؟ النوع الوصف
<link> Optional string تمثّل هذه السمة رابطًا يؤدي إلى المراجعة. أدرِج "http://" أو "https://" في هذا العنصر.
<title> Optional string (المراجعات التحريرية فقط) عنوان المراجعة.
<author> Optional string مؤلف المراجعة، على سبيل المثال، "سوزان فون تراب". ويمكن أن يكون هذا أيضًا اسم موقع إلكتروني أو جهة نشر تظهر فيها المراجعة إذا كانت غير معتمدة.
<rating> Optional string يمثّل رقم النقطة العائمة من 0 إلى 10 (شاملاً) نتيجة المراجعة. على سبيل المثال، "8.9".
<body> Optional string تمثّل هذه السمة نص المراجعة. يجب ألا يحتوي هذا العنصر على HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (مراجعات المستخدمين فقط) تاريخ المراجعة الذي تحدّده باستخدام السمات التالية لهذا العنصر:
  • day: اليوم من الشهر، على سبيل المثال، "7".
  • month: الشهر، حيث 1 = كانون الثاني (يناير) ... 12 = كانون الأول (ديسمبر).
  • year: السنة المكوّنة من أربعة أرقام، على سبيل المثال "2023"

على سبيل المثال، تتم كتابة تاريخ 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 للإيجارات المخصّصة للاستئجار.

قيم العنصر النائب attribute_name

يعرض الجدول التالي القيم الصالحة لـ attribute_name في العنصر <client_attr name="attribute_name">.

قيم attribute_name الوصف قيم المحتوى الصالحة
alternate_hotel_id معرّف بديل لموقعك. ومن المفيد استخدام أرقام تعريف منفصلة إذا كنت قد تحتاج إلى معرّف موقع واحد لمعلومات خلاصتك ومعرّف موقع آخر لمحرك الحجز. أي قيمة سلسلة
custom_[0-4] أي سمة مخصّصة لنوع السلسلة. لا يتم عرض هذه الإعلانات للمستخدمين. أي قيمة سلسلة
hotel_brand العلامة التجارية التي ينتمي إليها الفندق. على سبيل المثال، "ماريوت" أو "هيلتون". لا يظهر هذا الاسم للمستخدمين، ولكن يمكن استخدامه لتجميع الفنادق. أي قيمة سلسلة
lodging تمثيل مشفّر لجميع الحقول المتوفرة في نموذج Lodging. سلسلة Base64 مرمّزة للنموذج الأوّلي المشفّر Lodging
num_reviews عدد مراجعات بطاقة البيانات. أي عدد صحيح غير سالب.
rating رقم النقطة العائمة يمثّل التقييم المجمّع للخاصية. وتتراوح هذه الأرقام عادةً بين 0-5 أو 0-10 أو من 0 إلى 100، ولكن يمكنك استخدام أي نطاق يمثّل نظام التقييم الخاص بك.

قيم العنصر النائب attribute_name لأماكن الاستئجار

يُرجى الرجوع إلى السمات الخاصة بأماكن الاستئجار ومثال XML.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>
            + <image>

يتم استخدام الصور لإظهار الموقع الإلكتروني في معرّف البيانات. يجب أن تتبع جميع الصور المستخدمة هذه الإرشادات:

  • نسبة العرض إلى الارتفاع المقترَحة للصور هي 4:3.
  • يجب أن يتمكن زاحف Googlebot Image من الوصول إلى عنوان 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، لا تتخطى الرموز الخاصة.

  • يمكنك استخدام رموز الإلغاء لقيم البيانات غير المضمّنة في أقسام CDATA، بما في ذلك عناوين URL. ويمكنك استخدام رمز الكيان أو رمز الحرف لتمثيل هذه الرموز الخاصة. يسرد الجدول التالي رموز الأحرف والكيانات الشائعة التي يمكنك استخدامها:

    حرف الكيان رمز الشخصية
    علامة العطف (&) &amp; &#38;
    علامة الاقتباس المفردة (') &apos; &#39;
    علامة الاقتباس المزدوجة (") &quot; &#34؛
    علامة "أكبر من" (>) &gt; &#62;
    علامة "أقل من" (<) &lt; &#60;

  • احذف عناصر XML التي لا تحتوي على بيانات. على سبيل المثال، إذا لم يكن لديك خط العرض وخط الطول للفندق، يجب عدم تضمين عنصرَي <latitude/> و<longitude/> فارغَين.

  • لا تستخدِم HTML في عناصر XML تحت أي ظرف من الظروف (حتى إذا تم تجاوزها).

  • للتحقق من صحة الخلاصة قبل تحميلها، يمكنك استخدام خلاصة XSD المحلية http://www.gstatic.com/localfeed/local_feed.xsd.

  • لاستخدام التعليقات في خلاصتك، عليك لف التعليق في علامتَي <!-- و-->، على النحو الموضّح في المثال التالي:

    <!-- This is a comment -->

  • تأكَّد من إغلاق العنصر <date> في صفحة المستخدِم <review>. مثلاً:

    <date day="2" month="12" year="2017"/>