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

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

होटल की सूची का रूट एलिमेंट, <listings> एलिमेंट होता है. इसमें <listing> एलिमेंट शामिल होते हैं, जो आपकी प्रॉपर्टी के बारे में जानकारी देते हैं.

शुरुआत में लागू करने के दौरान, होटल की सूची बनाई जाती है. इसके बाद, नियमित रखरखाव के दौरान इसमें होटल जोड़े या हटाए जाते हैं.

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

होटल की सूची बनाने के बाद, उसे Google पर मैन्युअल तरीके से अपलोड किया जा सकता है. इसके लिए, https://support.google.com/hotelprices/ पर जाएं या उसे अपने सर्वर पर होस्ट करें.

डेटा से जुड़ी समस्याओं का पता लगाना और उन्हें ठीक करना

होटल की सूची में मौजूद डेटा से जुड़ी समस्याओं का पता लगाने और उन्हें ठीक करने के लिए, ये लेख पढ़ें:

• अपनी होटल इन्वेंट्री कैसे सेट अप करें
• प्रॉपर्टी मैचिंग से जुड़ी समस्याओं को हल करना

लिस्टिंग से जुड़ी ज़रूरी शर्तें

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> एलिमेंट में ये एट्रिब्यूट होते हैं:

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

<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 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>

<?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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

<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>

<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>

<country>US</country>

<latitude>37.423738</latitude>

<longitude>-122.090101</longitude>

<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

* या तो फ़ोन नंबर या अक्षांश/देशांतर ज़रूरी है. हमारा सुझाव है कि आप दोनों को तय करें.

उदाहरण

<?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>

<?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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

<client_attr name="attribute_name">attribute_value<client_attr>

उदाहरण

यहां होटल की सूची का एक हिस्सा दिखाया गया है. इसमें <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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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>
            + <attributes>

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

<website>https://hotel.example.com</website>

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

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

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

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

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            <!-- <review> is allowed in Vacation Rentals only -->
            + <review>
            + <attributes>
            + <image>

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

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

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

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

     • User-agent: Googlebot
     • Allow: /

  2. इस डायरेक्टिव से, Googlebot Image क्रॉलर को आपकी साइट पर मौजूद इमेज क्रॉल करने की अनुमति मिलती है.

     • उपयोगकर्ता-एजेंट: Googlebot-छवि
     • Allow: /

• इमेज या वेबसाइटों के स्क्रीनशॉट इस्तेमाल करने की अनुमति नहीं है. इमेज ओरिजनल होनी चाहिए. साथ ही, वे असल इमेज या फ़ोटोग्राफ़ होनी चाहिए.

विशेषताएं

• "ad" अगर इमेज कोई विज्ञापन है
• "menu" अगर इमेज, रेस्टोरेंट के मेन्यू की है
• "photo" अगर इमेज, कारोबार की फ़ोटो है

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

<link><http://www.example.com/magic_pizza/></link>

<title>"Luxury Apartment"</title>

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

  वर्ण	इकाई	वर्ण कोड
  ऐंपरसैंड (&)	&	&
  सिंगल कोट (')	'	'
  डबल कोट (")	"	"
  इससे ज़्यादा (>)	>	>
  Less Than (<)	&lt;	&#60;

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

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

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

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

  <!-- This is a comment -->