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

يمكن إنشاء هذه القيمة باستخدام أدوات ترميز المواقع الجغرافية، مثل Google Maps API.
<longitude> Required* float خط الطول الذي يمثّل الموقع الجغرافي للفندق ضمن البيانات. على سبيل المثال: 
<longitude>-122.090101</longitude>

يمكن إنشاء هذه القيمة باستخدام أدوات ترميز المواقع الجغرافية، مثل 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

يحتوي على 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 proto. سلسلة مشفّرة بترميز Base64 لملف Lodging proto المشفّر
num_reviews عدد المراجعات التي تلقّاها الفندق أي عدد صحيح غير سالب
rating عدد عشري يمثّل التقييم الإجمالي للمكان يتراوح هذا الرقم عادةً بين 0 و5 أو 0 و10 أو 0 و100، ولكن يمكنك استخدام أي نطاق يمثّل نظام التقييم الخاص بك. على سبيل المثال، يجب أن يكون تقييم الفندق 3 أو 4 ليكون مقياس_التقييم 5.

ملاحظة: تكون قيمة مقياس_التقييم التلقائية من 0 إلى 10 إذا لم يتم تحديدها.

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

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

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <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> غير مطلوب اسم مؤلف المحتوى يمكن أن تكون القيمة اسم مستخدم أو اسمًا كاملاً بالتنسيق "Firstname Lastname".
<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"/>