होटल की सूची एक्सएमएल रेफ़रंस

होटल की सूची, एक या इससे ज़्यादा एक्सएमएल फ़ाइलें होती हैं. इनमें उन सभी होटलों की सूची होती है जिनके किराये की जानकारी आपको दी जाती है. होटल की सूची वाली फ़ाइल में, किराये की जानकारी शामिल नहीं होती.

होटल की सूची का रूट एलिमेंट, <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
  • 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> एलिमेंट, होटल सूची फ़ीड एक्सएमएल की हैरारकी में इस जगह पर दिखता है:

+ <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 वह देश जहां यह लिस्टिंग मौजूद है. वैल्यू, दो अक्षरों वाले देश का कोड होनी चाहिए. उदाहरण के लिए, अमेरिका का "US" है और कनाडा का "CA" है. उदाहरण के लिए: 
<country>US</country>
<latitude> Required* float वह अक्षांश जो सूची में उस जगह के बारे में बताता है. उदाहरण के लिए: 
<latitude>37.423738</latitude>

यह वैल्यू, Google Maps API जैसे GeoCoding टूल की मदद से जनरेट की जा सकती है.
<longitude> Required* float वह देशांतर जो सूची में उस जगह के बारे में बताता है. उदाहरण के लिए: 
<longitude>-122.090101</longitude>

यह वैल्यू, Google Maps API जैसे GeoCoding टूल की मदद से जनरेट की जा सकती है.
<location_precision> Optional integer प्रॉपर्टी का अक्षांश और देशांतर अस्पष्ट होने पर, प्रॉपर्टी की जगह की सटीक जानकारी मीटर में. शून्य (0) का मतलब है कि कोई अस्पष्ट जानकारी नहीं है और यह वही जगह है. ध्यान दें: यह एलिमेंट, छुट्टियों में किराये पर उपलब्ध जगहों पर ही लागू होता है.
<phone> Required* string

होटल के एक या उससे ज़्यादा फ़ोन नंबर. अगर लिस्टिंग में कारोबार की शाखा है, तो कृपया उस जगह के लिए खास फ़ोन नंबर दें (न कि केंद्रीय मुख्यालय का फ़ोन नंबर).

type एट्रिब्यूट इनमें से कोई एक हो सकता है:

  • fax: फ़ैक्स टेलीफ़ोन नंबर.
  • main: मुख्य टेलीफ़ोन नंबर.
  • mobile: मोबाइल टेलीफ़ोन नंबर.
  • 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> एलिमेंट, होटल सूची फ़ीड एक्सएमएल की हैरारकी में इस जगह पर दिखता है:

+ <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> एलिमेंट, होटल सूची फ़ीड एक्सएमएल की हैरारकी में इस जगह पर दिखता है:

+ <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 समीक्षा का लेखक; उदाहरण के लिए, "Susan von Trapp". यह उस वेबसाइट या पब्लिकेशन का नाम भी हो सकता है जिसमें बिना क्रेडिट वाली समीक्षा दिखती है.
<rating> Optional string 0 से 10 तक का फ़्लोटिंग पॉइंट नंबर, जो समीक्षा के स्कोर को दिखाता है. उदाहरण के लिए, "8.9".
<body> Optional string समीक्षा का टेक्स्ट. इस एलिमेंट में एचटीएमएल नहीं होना चाहिए.
<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 का इस्तेमाल करके बताया जा सकता है.

Attribution_name प्लेसहोल्डर के लिए वैल्यू

यहां दी गई टेबल में <client_attr name="attribute_name"> एलिमेंट में, attribute_name की मान्य वैल्यू दी गई हैं.

attribute_name के लिए मान कंपनी का ब्यौरा कॉन्टेंट की मान्य वैल्यू
alternate_hotel_id आपकी प्रॉपर्टी के लिए एक वैकल्पिक पहचानकर्ता. अगर आपको अपने फ़ीड की जानकारी के लिए एक प्रॉपर्टी आइडेंटिफ़ायर और बुकिंग इंजन के लिए दूसरे प्रॉपर्टी आइडेंटिफ़ायर की ज़रूरत पड़ सकती है, तो अलग-अलग आईडी इस्तेमाल करना फ़ायदेमंद होता है. स्ट्रिंग की कोई भी वैल्यू
custom_[0-4] कोई भी स्ट्रिंग टाइप कस्टम एट्रिब्यूट. यह जानकारी लोगों को नहीं दिखाई जाती. स्ट्रिंग की कोई भी वैल्यू
hotel_brand यह किस ब्रैंड का होटल है. उदाहरण के लिए, "Marriott" या "Hilton". यह नाम उपयोगकर्ताओं को नहीं दिखाया जाता. हालांकि, इसका इस्तेमाल होटल का ग्रुप बनाने के लिए किया जा सकता है. स्ट्रिंग की कोई भी वैल्यू
lodging Lodging प्रोटोकॉल में मौजूद सभी फ़ील्ड को कोड में बदलकर दिखाया गया है. कोड में बदले गए Lodging प्रोटो की Base64 कोड में बदली गई स्ट्रिंग
num_reviews लिस्टिंग की समीक्षाओं की संख्या. कोई भी नॉन-नेगेटिव पूर्णांक.
rating प्रॉपर्टी की एग्रीगेट रेटिंग दिखाने वाला फ़्लोटिंग पॉइंट नंबर. यह संख्या आम तौर पर 0-5, 0-10 या 0-100 के बीच होती है, लेकिन आपके पास अपने रेटिंग सिस्टम को दिखाने वाली किसी भी रेंज का इस्तेमाल करने का विकल्प होता है.

छुट्टियों में किराये पर उपलब्ध जगहों के एट्रिब्यूट_name प्लेसहोल्डर की वैल्यू

छुट्टियों में किराये पर उपलब्ध जगहों से जुड़े एट्रिब्यूट और एक्सएमएल के उदाहरण देखें.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>
            + <image>

लिस्टिंग आईडी में प्रॉपर्टी को दिखाने के लिए, इमेज का इस्तेमाल किया जाता है. इस्तेमाल की गई सभी इमेज के लिए इन दिशा-निर्देशों का पालन करना ज़रूरी है:

  • इमेज के लिए, आसपेक्ट रेशियो (चौड़ाई-ऊंचाई का अनुपात) 4:3 होना चाहिए.
  • इमेज का यूआरएल ऐसा होना चाहिए जिसे Googlebot इमेज क्रॉलर ऐक्सेस कर सके.

  • अगर आपकी साइट में रूट लेवल पर robots.txt है, तो पुष्टि करें कि इसमें नीचे दिए गए दो विकल्पों में से कोई एक शामिल हो:

    1. Googlebot क्रॉलर को आपकी साइट का कॉन्टेंट, इमेज को क्रॉल करने की अनुमति देता है.

      • User-agent: Googlebot
      • Allow: /

    2. 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> ज़रूरी नहीं कॉन्टेंट के लेखक का नाम. यह वैल्यू या तो उपयोगकर्ता का नाम हो सकती है या "नाम उपनाम" फ़ॉर्मैट में पूरा नाम हो सकता है.
<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 के Xएसडी स्कीमा की मदद से, अपनी होटल सूची की एक्सएमएल फ़ाइलों की पुष्टि करें.

  • UTF-8 एन्कोडिंग का इस्तेमाल करें. अपने एक्सएमएल टैग में encoding एट्रिब्यूट को शामिल करके, कोड में बदलने के इस स्कीमा के बारे में बताएं. इसका तरीका नीचे दिए गए उदाहरणों में दिखाया गया है.

  • अपने फ़ीड में CDATA सेक्शन की मदद से, डेटा वैल्यू तय की जा सकती है. अगर CDATA सेक्शन का इस्तेमाल किया जाता है, तो खास वर्णों को एस्केप न करें.

  • ऐसी डेटा वैल्यू के लिए एस्केप कोड इस्तेमाल करें जो CDATA सेक्शन में नहीं हैं. इनमें यूआरएल भी शामिल हैं. इन खास वर्णों को दिखाने के लिए, इकाई कोड या वर्ण कोड का इस्तेमाल किया जा सकता है. इस टेबल में वे सामान्य इकाई और वर्ण कोड दिए गए हैं जिनका इस्तेमाल किया जा सकता है:

    वर्ण इकाई वर्ण कोड
    एंपरसैंड (&) &amp; &#38;
    सिंगल कोट (') &apos; &#39;
    डबल कोट (") &quot; &#34;
    इससे ज़्यादा (>) &gt; &#62;
    इससे कम (<) &lt; &#60;

  • बिना डेटा वाले एक्सएमएल एलिमेंट हटाएं. उदाहरण के लिए, अगर होटल में अक्षांश और देशांतर की जानकारी उपलब्ध नहीं है, तो आपको <latitude/> और <longitude/> वाले खाली एलिमेंट शामिल नहीं करने चाहिए.

  • किसी भी स्थिति में अपने एक्सएमएल एलिमेंट में एचटीएमएल का इस्तेमाल न करें, भले ही उसे एस्केप किया गया हो.

  • फ़ीड अपलोड करने से पहले उसकी पुष्टि करने के लिए, स्थानीय फ़ीड का Xएसडी इस्तेमाल करें. http://www.gstatic.com/localfeed/local_feed.xsd.

  • अपने फ़ीड में टिप्पणियों का इस्तेमाल करने के लिए, टिप्पणी को <!-- और --> टैग में रैप करें, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:

    <!-- This is a comment -->

  • पक्का करें कि आपने उपयोगकर्ता <review> में <date> एलिमेंट को बंद किया हो. उदाहरण के लिए:

    <date day="2" month="12" year="2017"/>