قائمة الفنادق هي ملف واحد أو أكثر من ملفات 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 ، لا تضمِّن العنصر <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 | تمثّل هذه السمة الموقع الجغرافي الكامل للفندق. يأخذ هذا العنصر سمة واحدة، على الأقل، عليك تقديم عنوان الشارع والمدينة والولاية أو المنطقة
والرمز البريدي للفندق. استخدِم عناصر
مثلاً: <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 | رقم واحد أو أكثر للاتصال بالفندق. إذا كانت البيانات عبارة عن فرع لنشاط تجاري، يُرجى تقديم رقم الهاتف الخاص بموقع الفرع الجغرافي (وليس رقم هاتف المقر الرئيسي المركزي). يمكن أن تكون السمة
مثلاً: <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> ويجب إدخال النوع |
<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 |
Optional | Object | صفحة الويب المرتبطة ببطاقة البيانات من مقدّم الخدمة. تتوفر به العناصر الفرعية التالية:
ملاحظة: يجب أن تظهر هذه العناصر بالترتيب أعلاه. |
<review |
Optional | <review> |
تحتوي على مراجعة أجراها مستخدم أو مراجعة تحريرية لبطاقة البيانات. ويمكن أن تشتمل بياناتك على أي عدد من المراجعات فيها، سواء كان نوعها أم لا. ليس عليك تضمين جميع المراجعات الخاصة بالموقع الإلكتروني في العنصر
|
<attributes> | Optional | Object | لا تحتوي على عناصر <client_attr name="attribute_name">attribute_value<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 | تمثّل هذه السمة نوع المراجعة. اضبط القيمة على إحدى القيم التالية:
|
العناصر الفرعية
يحتوي العنصر <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 | (مراجعات المستخدمين فقط) تاريخ المراجعة الذي تحدّده باستخدام
السمات التالية لهذا العنصر:
على سبيل المثال، تتم كتابة 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 في مستوى الجذر، تأكَّد من أنّه يحتوي على أحد الخيارَين الواردَين أدناه:
تسمح لزاحف Googlebot بالزحف إلى محتوى موقعك الإلكتروني والصور المضمّنة.
- User-agent: Googlebot
- Allow: /
تسمح لزاحف 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. ويمكنك استخدام رمز الكيان أو رمز الأحرف لتمثيل هذه الرموز الخاصة. يسرد الجدول التالي رموز الكيانات والرموز الشائعة التي يمكنك استخدامها:حرف الكيان رمز الحرف علامة العطف (&) & & علامة اقتباس مفردة (') ' ' علامة اقتباس مزدوجة (") " " أكبر من (>) > > أصغر من (<) < < احذف عناصر 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"/>