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

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

होटल की सूची का रूट एलिमेंट, <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, 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

होटल की जगह की पूरी जानकारी.

इस एलिमेंट में एक एट्रिब्यूट 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, 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

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

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, 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 type="description"> Optional Object

सेवा देने वाली कंपनी की लिस्टिंग से जुड़ा वेबपेज. इसमें ये चाइल्ड एलिमेंट शामिल हैं:

  • <link>: जानकारी का लिंक. इस एलिमेंट में "http://" या
    "https://" शामिल करें (ज़रूरी नहीं).
  • <title>: ब्यौरे का टाइटल (ज़रूरी नहीं).
  • <author>: जानकारी का लेखक (ज़रूरी नहीं).
  • <body>: ब्यौरे का मुख्य हिस्सा (ज़रूरी है).
  • <date>: ब्यौरे की तारीख (ज़रूरी नहीं).

    • ध्यान दें: ये एलिमेंट ऊपर दिए गए क्रम में दिखने चाहिए.
<review type="[editorial|user]"> Optional <review>

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

आपको अपने <listing> एलिमेंट में किसी प्रॉपर्टी की सभी समीक्षाएं शामिल करने की ज़रूरत नहीं है. इस एलिमेंट का मकसद, चुनी गई उन समीक्षाओं को शामिल करना है जो इस लिस्टिंग की सुविधाएं या क्वालिटी के बारे में बताती हैं.
<attributes> Optional Object

इसमें 0 या इससे ज़्यादा <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> एलिमेंट, 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 समीक्षा किस तरह की है. इनमें से किसी एक वैल्यू पर सेट करें:
  • editorial: वेबसाइट या समीक्षा करने वाली दूसरी संस्था की ओर से की गई समीक्षा.
  • user: किसी असली उपयोगकर्ता की समीक्षा.

चाइल्ड एलीमेंट

<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 (सिर्फ़ उपयोगकर्ता की समीक्षा) समीक्षा की वह तारीख जिसकी जानकारी, आपने इस एलिमेंट के इन एट्रिब्यूट के साथ दी है:
  • 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> का महीना और साल मौजूद न हो. दिन डालना ज़रूरी नहीं है.

ध्यान दें कि अगर समीक्षा के 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 शामिल है, तो पुष्टि करें कि उसमें यहां दिए गए दो विकल्पों में से कोई एक शामिल है:

    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> ज़रूरी नहीं कॉन्टेंट के लेखक का नाम. यह वैल्यू या तो उपयोगकर्ता नाम हो सकती है या "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 सेक्शन में नहीं हैं. इन विशेष वर्णों को दिखाने के लिए, इकाई कोड या वर्ण कोड का इस्तेमाल किया जा सकता है. इस टेबल में, इस्तेमाल किए जा सकने वाले सामान्य इकाई और वर्ण कोड की जानकारी दी गई है:

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

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

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

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

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

    <!-- This is a comment -->

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

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