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

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

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

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

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

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

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

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

متطلبات البيانات

للتأهُّل لعرض إعلانات الفنادق على 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"/>

مراجعات بدون شهر وسنة <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
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"/>