होटल की सूची एक या उससे ज़्यादा एक्सएमएल फ़ाइलें होती हैं. इनमें उन सभी होटलों की सूची होती है जिनके लिए आप किराये की जानकारी देते हैं. होटल की सूची में कीमत की जानकारी नहीं होती.
होटल की सूची का रूट एलिमेंट, <listings>
एलिमेंट होता है. इसमें
<listing>
एलिमेंट होते हैं, जो आपकी प्रॉपर्टी के बारे में जानकारी देते हैं.
शुरुआती कार्रवाई के तहत होटल की सूची बनाई जाती है और फिर नियमित रखरखाव के तहत उसमें होटल जोड़े या हटाए जाते हैं.
पक्का करें कि आपकी फ़ाइलें सिंटैक्स से जुड़े दिशा-निर्देशों के मुताबिक हों.
उदाहरण के लिए, UTF-8 एन्कोडिंग का इस्तेमाल करें और अपने एक्सएमएल टैग में encoding
एट्रिब्यूट को शामिल करके, इस एन्कोडिंग स्कीमा के बारे में बताएं.
होटल की सूची बनाने के बाद, Hotel Center का इस्तेमाल करके उसे मैन्युअल तरीके से Google पर अपलोड करें या उसे अपने सर्वर पर होस्ट करें.
डेटा से जुड़ी समस्याओं का पता लगाना और उन्हें ठीक करना
होटल की सूची में डेटा से जुड़ी समस्याएं ढूंढने और उन्हें ठीक करने के लिए, ये लेख पढ़ें:
लिस्टिंग से जुड़ी ज़रूरी शर्तें
Google Hotel Ads का इस्तेमाल करने के लिए, आपके होटल की सूची में मौजूद किसी प्रॉपर्टी में ये चीज़ें होनी चाहिए:
- ऐसे कमरे हों जिनमें पैसे चुकाने वाले मेहमान ठहर सकें
- लोगों के ठहरने के लिए ऐसी तय जगह हो जो आम जनता के लिए खुली हो
- लकड़ी की दीवार और प्लम्बिंग
- होटल में ठहरने की कम से कम सीमा सात दिनों से ज़्यादा न हो
ज़रूरी शर्तें पूरी न करने वाली प्रॉपर्टी के उदाहरणों में क्रूज़ और
अपार्टमेंट शामिल हैं, क्योंकि वे आम तौर पर Listing requirements
की शर्तें पूरी नहीं करतीं.
स्थिर दीवारों, प्लंबिंग, और जलवायु को कंट्रोल करने वाले सिस्टम (इसमें लकड़ी का स्टोव या प्रोपेन हीटर भी शामिल हैं) वाले कैंपिंग केबिन और कैंपिंग की अन्य जगहें इसका इस्तेमाल कर सकती हैं. इस तरह की ठहरने की बाहर की जगहों की जानकारी नहीं दी जा सकती:
- कैंप लगाने की जगहें, जहां मेहमान टेंट में ठहर सकते हैं
- आरवी पार्क, जहां मेहमान अपना आरवी लेकर आते हैं
<listings>
<listings>
, होटल की सूची का रूट एलिमेंट है और इसमें
<language>
एलिमेंट और कम से कम एक <listing>
शामिल है.
<listings>
एलिमेंट, होटल की सूची की हैरारकी में
नीचे दी गई जगह पर दिखता है:
+ <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 होती है.
इसका इस्तेमाल, ज़्यादातर आधुनिक जीपीएस डिवाइसों में किया जाता है. टोक्यो डाटम, सिर्फ़ जापान में मौजूद पतों
पर लागू होता है.
इस एलिमेंट के लिए सही वैल्यू हैं:
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>
एलिमेंट, Hotel सूची फ़ीड के एक्सएमएल की हैरारकी में नीचे दी गई जगह पर दिखता है:
+ <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 | वह देश जहां यह लिस्टिंग मौजूद है. यह वैल्यू,
दो अक्षरों वाले देश का कोड होनी चाहिए.
उदाहरण के लिए, अमेरिका का "US" है और कनाडा का "CA" है. उदाहरण के लिए:
<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 | होटल के लिए एक या उससे ज़्यादा संपर्क नंबर. अगर लिस्टिंग कारोबार की शाखा है, तो कृपया शाखा की जगह के लिए खास फ़ोन नंबर दें (मुख्य मुख्यालय का फ़ोन नंबर नहीं).
उदाहरण के लिए: <!-- 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>
एलिमेंट, Hotel सूची फ़ीड के एक्सएमएल की हैरारकी में नीचे दी गई जगह पर दिखता है:
+ <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>
एलिमेंट, Hotel सूची फ़ीड के एक्सएमएल की हैरारकी में नीचे दी गई जगह पर दिखता है:
+ <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 | समीक्षा का टेक्स्ट. इस एलिमेंट में एचटीएमएल नहीं होना चाहिए. |
<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> का महीना और साल मौजूद न हो. दिन डालना ज़रूरी नहीं है. |
ध्यान दें कि अगर समीक्षा के type
का मान editorial
है, तो <title>
, <review>
का मान्य चाइल्ड एलिमेंट है. साथ ही, <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 प्लेसहोल्डर के लिए वैल्यू
इस टेबल में, <client_attr name="attribute_name"> एलिमेंट में, attribute_name के लिए मान्य वैल्यू दी गई हैं.
attribute_name के लिए मान |
ब्यौरा | कॉन्टेंट की मान्य वैल्यू |
---|---|---|
alternate_hotel_id | आपकी प्रॉपर्टी के लिए एक वैकल्पिक पहचानकर्ता. अगर आपको अपने फ़ीड की जानकारी के लिए एक प्रॉपर्टी आइडेंटिफ़ायर और बुकिंग इंजन के लिए दूसरे प्रॉपर्टी आइडेंटिफ़ायर की ज़रूरत है, तो अलग-अलग आईडी होना फ़ायदेमंद होता है. | स्ट्रिंग की कोई भी वैल्यू |
custom_[0-4] | स्ट्रिंग टाइप कस्टम एट्रिब्यूट. ये लोगों को नहीं दिखाए जाते. | स्ट्रिंग की कोई भी वैल्यू |
hotel_brand | यह किस ब्रैंड का होटल है. उदाहरण के लिए, "मैरियट" या "हिल्टन". यह लोगों को नहीं दिखाया जाता. हालांकि, इसका इस्तेमाल होटल के ग्रुप बनाने के लिए किया जा सकता है. | स्ट्रिंग की कोई भी वैल्यू |
lodging | Lodging
प्रोटो में मौजूद सभी फ़ील्ड को कोड में दिखाया गया है. |
कोड में बदला गया
Lodging प्रोटो की Base64 कोड में बदली गई स्ट्रिंग |
num_reviews | लिस्टिंग की समीक्षाओं की संख्या. | कोई भी नॉन-नेगेटिव पूर्णांक. |
rating | कुल प्रॉपर्टी रेटिंग को दिखाने वाला फ़्लोटिंग पॉइंट नंबर. | आम तौर पर, यह संख्या 0-5, 0-10 या 0-100 तक की होती है. हालांकि, अपने रेटिंग सिस्टम को दिखाने वाली किसी भी रेंज का इस्तेमाल किया जा सकता है. |
छुट्टियों में किराये पर उपलब्ध जगहों के लिए attribute_name प्लेसहोल्डर के मान
छुट्टियों में किराये पर उपलब्ध जगहों से जुड़े एट्रिब्यूट और एक्सएमएल के उदाहरण देखें.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
इमेज का इस्तेमाल, लिस्टिंग आईडी में प्रॉपर्टी को दिखाने के लिए किया जाता है. इस्तेमाल की गई सभी इमेज इन दिशा-निर्देशों के मुताबिक होनी चाहिए:
- हमारा सुझाव है कि इमेज के लिए, 4:3 का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) रखें.
- इमेज का यूआरएल ऐसा होना चाहिए जिसे Googlebot इमेज क्रॉलर से ऐक्सेस कर सके.
अगर आपकी साइट में रूट लेवल पर robots.txt शामिल है, तो पुष्टि करें कि उसमें यहां दिए गए दो विकल्पों में से कोई एक शामिल है:
इससे Googlebot क्रॉलर को आपकी साइट के कॉन्टेंट और इमेज को क्रॉल करने की अनुमति मिलती है.
- User-agent: Googlebot
- Allow: /
इससे Googlebot इमेज क्रॉलर को आपकी साइट पर मौजूद इमेज क्रॉल करने की अनुमति मिलती है.
- User-agent: Googlebot-Image
- Allow: /
इमेज या वेबसाइटों के स्क्रीनशॉट इस्तेमाल करने की अनुमति नहीं है. इमेज मूल और असली इमेज या फ़ोटो होनी चाहिए.
विशेषताएं
- अगर इमेज विज्ञापन है, तो
"ad"
- अगर इमेज रेस्टोरेंट का मेन्यू है, तो
"menu"
- अगर इमेज कारोबार की फ़ोटो है, तो
"photo"
एट्रिब्यूट का नाम | ज़रूरी है? | फ़ॉर्मैट | ब्यौरा |
---|---|---|---|
type | Required | Text | इमेज इनमें से कोई एक होनी चाहिए: |
url | Required | Text | फ़ुल साइज़ की इमेज का यूआरएल. किसी पेज पर कौनसी इमेज इस्तेमाल करनी है, यह बताने के लिए यूआरएल एट्रिब्यूट का इस्तेमाल करें. |
width | Required | A non-negative integer | इमेज की चौड़ाई पिक्सल में होनी चाहिए (हमारा सुझाव है कि इमेज की चौड़ाई 720 पिक्सल से ज़्यादा होनी चाहिए) |
height | Required | A non-negative integer | इमेज की ऊंचाई पिक्सल में (720 पिक्सल से ज़्यादा का सुझाव दिया जाता है) |
चाइल्ड एलीमेंट
चाइल्ड एलिमेंट | ज़रूरी है? | ब्यौरा |
---|---|---|
<link> | अनुरोध किया गया, लेकिन स्थानीय फ़ोटो लिस्टिंग के लिए ज़रूरी है. | इस टैग में, आपकी साइट के उस पेज का मान्य और अप-टू-डेट यूआरएल होता है जिस पर सही इमेज मौजूद है. इसमें इमेज का यूआरएल नहीं होता.
उदाहरण:<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>
सिंटैक्स से जुड़े दिशा-निर्देश
एक्सएमएल पर आधारित होटल की सूची बनाते समय, इन दिशा-निर्देशों का पालन करें:
Google के XSD स्कीमा की मदद से, अपनी होटल सूची की एक्सएमएल फ़ाइलों की पुष्टि करें.
कोड में बदलने के UTF-8 तरीके का इस्तेमाल करें. जैसा कि नीचे दिए गए उदाहरणों में दिखाया गया है, अपने एक्सएमएल टैग में
encoding
एट्रिब्यूट शामिल करके, इस एन्कोडिंग स्कीमा के बारे में बताएं.CDATA
सेक्शन की मदद से, अपने फ़ीड में डेटा की वैल्यू तय की जा सकती हैं. अगरCDATA
सेक्शन का इस्तेमाल किया जाता है, तो विशेष वर्णों को एस्केप न करें.ऐसे डेटा वैल्यू के लिए एस्केप कोड इस्तेमाल करें जो यूआरएल के साथ-साथ
CDATA
सेक्शन में नहीं हैं. इन विशेष वर्णों को दिखाने के लिए, इकाई कोड या वर्ण कोड का इस्तेमाल किया जा सकता है. इस टेबल में, इस्तेमाल किए जा सकने वाले सामान्य इकाई और वर्ण कोड की जानकारी दी गई है:वर्ण इकाई वर्ण कोड एंपरसैंड (&) & & सिंगल कोट (') ' ' डबल कोट (") " " इससे ज़्यादा (>) > > इससे छोटा (<) < < उन एक्सएमएल एलिमेंट को छोड़ दें जिनमें डेटा नहीं है. उदाहरण के लिए, अगर आपके पास होटल का अक्षांश और देशांतर नहीं हैं, तो आपको खाली
<latitude/>
और<longitude/>
एलिमेंट शामिल नहीं करने चाहिए.अपने एक्सएमएल एलिमेंट में एचटीएमएल का इस्तेमाल किसी भी स्थिति में न करें, भले ही उसे एस्केप किया गया हो.
अपलोड करने से पहले अपने फ़ीड की पुष्टि करने के लिए, लोकल फ़ीड एक्सएसडी http://www.gstatic.com/localfeed/local_feed.xsd का इस्तेमाल किया जा सकता है.
अपने फ़ीड में टिप्पणियों का इस्तेमाल करने के लिए, टिप्पणी को
<!--
और-->
टैग में रैप करें, जैसा कि नीचे दिखाया गया है:<!-- This is a comment -->
पक्का करें कि आपने उपयोगकर्ता
<review>
में<date>
एलिमेंट बंद किया हो. उदाहरण के लिए:<date day="2" month="12" year="2017"/>