قائمة الفنادق هي ملف واحد أو أكثر بتنسيق 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, 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, 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, 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 | يحتوي على 0 أو أكثر من العناصر الثانوية من <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"/> قد لا يتم عرض المراجعات التي لم يتم ملء بياناتها عن الشهر والسنة على الأقل من أجل <servicedate>. اليوم غير مطلوب. |
يُرجى العِلم أنّ <title>
هي عنصر ثانوي صالح للسمة <review>
فقط إذا كانت قيمة type
في المراجعة هي editorial
، ولا تكون <date>
صالحة إلا إذا كانت قيمة type
هي user
.
مثال
يعرض المثال التالي قائمة فنادق جزئية مع بطاقة بيانات تتضمن رأيًا تحريريًا وتعليقات من المستخدمين:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<id>123456</id>
<name>My Apartment</name>
<address format="simple">
<component name="addr1">1 Sandstone Building</component>
<component name="city">Los Angeles</component>
<component name="postal_code">90210</component>
<component name="province">CA</component>
</address>
<country>US</country>
<latitude>40.730610</latitude>
<longitude>-73.935242</longitude>
<phone type="main">12345678</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>
<text type="description">
<link>https://examplelisting.com/listings/12345</link>
<title>3 bedrooms with ocean views</title>
<body>Stay in this newly renovated 3BR house with ocean views.</body>
<date month="7" day="23" year="2023"/>
</text>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<attributes>
يمكن استخدام علامة <attributes>
لوصف وسائل الراحة الخاصة بالموقع
وتصنيف تقييمات ومراجعات الموقع.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
العناصر الفرعية
العنصر الثانوي | مطلوب؟ | الوصف | |
---|---|---|---|
<website> | Optional | الموقع الإلكتروني الأساسي للفندق. وفي حال توفّره، يجب وضعه قبل عنصر <client_attr> الأول. مثال:
<website>https://hotel.example.com</website> |
|
<client_attr name="attribute_name"> | Optional | تمثّل هذه السمة سمة إضافية أو "سمة" إضافية للموقع يمكن تحديدها باستخدام السمة
attribute_name أو السمة
attribute_name للإيجارات المخصّصة للاستئجار.
|
قيم العنصر النائب attribute_name
يعرض الجدول التالي القيم الصالحة لـ attribute_name في العنصر <client_attr name="attribute_name">.
قيم attribute_name |
الوصف | قيم المحتوى الصالحة |
---|---|---|
alternate_hotel_id | معرّف بديل لموقعك. ومن المفيد استخدام أرقام تعريف منفصلة إذا كنت قد تحتاج إلى معرّف موقع واحد لمعلومات خلاصتك ومعرّف موقع آخر لمحرك الحجز. | أي قيمة سلسلة |
custom_[0-4] | أي سمة مخصّصة لنوع السلسلة. لا يتم عرض هذه الإعلانات للمستخدمين. | أي قيمة سلسلة |
hotel_brand | العلامة التجارية التي ينتمي إليها الفندق. على سبيل المثال، "ماريوت" أو "هيلتون". لا يظهر هذا الاسم للمستخدمين، ولكن يمكن استخدامه لتجميع الفنادق. | أي قيمة سلسلة |
lodging | تمثيل مشفّر لجميع الحقول المتوفرة في
نموذج Lodging . |
سلسلة Base64 مرمّزة للنموذج الأوّلي المشفّر
Lodging |
num_reviews | عدد مراجعات بطاقة البيانات. | أي عدد صحيح غير سالب. |
rating | رقم النقطة العائمة يمثّل التقييم المجمّع للخاصية. | وتتراوح هذه الأرقام عادةً بين 0-5 أو 0-10 أو من 0 إلى 100، ولكن يمكنك استخدام أي نطاق يمثّل نظام التقييم الخاص بك. |
قيم العنصر النائب attribute_name لأماكن الاستئجار
يُرجى الرجوع إلى السمات الخاصة بأماكن الاستئجار ومثال XML.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
يتم استخدام الصور لإظهار الموقع الإلكتروني في معرّف البيانات. يجب أن تتبع جميع الصور المستخدمة هذه الإرشادات:
- نسبة العرض إلى الارتفاع المقترَحة للصور هي 4:3.
- يجب أن يتمكن زاحف Googlebot Image من الوصول إلى عنوان URL للصورة.
إذا كان موقعك الإلكتروني يتضمّن ملف robots.txt على مستوى الجذر، تأكَّد من أنّه يتضمّن أحد الخيارَين التاليَين:
يسمح لزاحف Googlebot بالزحف إلى محتوى موقعك الإلكتروني، والصور المضمّنة.
- User-agent: Googlebot
- Allow: /
يسمح لزاحف Googlebot للصور بالزحف إلى الصور على موقعك.
- User-agent: Googlebot-Image
- Allow: /
لا يُسمح بلقطات شاشة للصور أو المواقع الإلكترونية. يجب أن تكون الصور أصلية وفعلية.
السمات
"ad"
إذا كانت الصورة إعلانًا"menu"
إذا كانت الصورة عبارة عن قائمة طعام لمطعم"photo"
إذا كانت الصورة صورة للنشاط التجاري
اسم السمة | مطلوب؟ | التنسيق | الوصف |
---|---|---|---|
type | Required | Text | يجب أن تكون الصورة من بين ما يلي: |
url | Required | Text | تمثّل هذه السمة عنوان URL للصورة بالحجم الكامل. استخدِم سمة عنوان URL لتحديد الصورة التي تريد استخدامها على تلك الصفحة. |
width | Required | A non-negative integer | عرض الصورة بالبكسل (يُنصح باستخدام قيمة أكبر من 720 بكسل) |
height | Required | A non-negative integer | ارتفاع الصورة بالبكسل (ننصح باستخدام أكبر من 720 بكسل) |
العناصر الفرعية
العنصر الثانوي | مطلوب؟ | الوصف |
---|---|---|
<link> | مطلوبة، ولكنها مطلوبة لبطاقات بيانات الصور المحلية. | تحتوي هذه العلامة على عنوان URL الصالح والحديث لصفحة على موقعك الإلكتروني
التي تظهر عليها الصورة ذات الصلة. لا تحتوي الصورة على عنوان URL للصورة نفسها.
مثال:<link><http://www.example.com/magic_pizza/></link> |
<title> | تاريخ الطلب | تتضمن هذه العلامة عنوان الصورة. مثال:
<title>"Luxury Apartment"</title> |
<author> | غير مطلوبة | تمثّل هذه السمة اسم مؤلّف المحتوى. ويمكن أن تكون القيمة إما اسم مستخدم أو اسمًا كاملاً بالتنسيق "الاسم الأول اسم العائلة". |
<date> | حقل مطلوب | تحدد هذه العلامة تاريخ إنشاء عنصر المحتوى. يجب إدخال السنة والشهر واليوم، كما في المثال التالي: <date month="6" day="7" year="2023"/> |
مثال
يعرض المثال التالي قائمة فنادق جزئية مع علامات الصور:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<content>
<review>
</review>
<attributes>
</attributes>
<image type="photo" url="https://image_url" width="400" height="300">
<link>https://image_url</link>
<title>Apartment at Sandstone</title>
<author>Jessica Landlord</author>
<date month="6" day="7" year="2023"/>
</image>
</content>
</listing>
...
</listings>
إرشادات بناء الجملة
يُرجى اتّباع الإرشادات التالية عند إنشاء قائمة فنادق مستندة إلى XML:
تحقّق من صحة ملفات XML لقائمة الفنادق باستخدام مخطط XSD من Google.
استخدِم ترميز UTF-8. حدِّد مخطّط الترميز هذا من خلال تضمين السمة
encoding
في علامة XML، كما هو موضّح في الأمثلة أدناه.يمكنك تحديد قيم البيانات في خلاصتك باستخدام أقسام
CDATA
. إذا كنت تستخدم أقسامCDATA
، لا تتخطى الرموز الخاصة.يمكنك استخدام رموز الإلغاء لقيم البيانات غير المضمّنة في أقسام
CDATA
، بما في ذلك عناوين URL. ويمكنك استخدام رمز الكيان أو رمز الحرف لتمثيل هذه الرموز الخاصة. يسرد الجدول التالي رموز الأحرف والكيانات الشائعة التي يمكنك استخدامها:حرف الكيان رمز الشخصية علامة العطف (&) & & علامة الاقتباس المفردة (') ' ' علامة الاقتباس المزدوجة (") " "؛ علامة "أكبر من" (>) > > علامة "أقل من" (<) < < احذف عناصر 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"/>