مرجع ملف 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 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>
      <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 Unit 3, 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 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>
      <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

لا تحتوي على عناصر <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"/>

قد لا يتم عرض المراجعات التي لم يتم ملء بيانات الشهر والسنة فيها على الأقل. اليوم غير مطلوب.

يُرجى العِلم أنّ <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 Image بالزحف إلى الصور على موقعك الإلكتروني.

      • 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"/>