एक्सएमएल स्कीमा रेफ़रंस

Google के साथ शेयर किए गए प्रॉडक्ट की समीक्षा वाले फ़ीड के लिए एक्सएमएल स्कीमा, आपके एक्सएमएल फ़ीड के स्वीकार किए गए स्ट्रक्चर के बारे में बताता है. एक्सएमएल स्कीमा, .xsd फ़ाइल एक्सटेंशन का इस्तेमाल करते हैं. डीटीडी फ़ाइलों की तरह, एक्सएमएल स्कीमा भी उन एलिमेंट और एट्रिब्यूट के बारे में बताता है जो किसी एक्सएमएल दस्तावेज़ में दिख सकते हैं.

एक्सएमएल स्कीमा के बारे में ज़्यादा जानने के लिए, इस एक्सएमएल स्कीमा प्राइमर को पढ़ें.

प्रॉडक्ट की समीक्षा वाले फ़ीड के लिए एक्सएमएल स्कीमा को यहां पब्लिश किया गया है: http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

इस स्कीमा से तय किए गए फ़ीड स्ट्रक्चर के बारे में जानकारी यहां दी गई है. इस जानकारी में, xs: प्रीफ़िक्स वाले टाइप के नाम, पहले से मौजूद एक्सएमएल स्कीमा टाइप के बारे में बताते हैं. ये टाइप, एक्सएमएल नेमस्पेस http://www.w3.org/2001/XMLSchema में होते हैं.

हमारा सिस्टम हमेशा पूरे फ़ीड की उम्मीद करता है. पहले सबमिट की गई ऐसी सभी समीक्षाएं मिटा दी जाएंगी जिन्हें अगले पूरे फ़ीड में शामिल नहीं किया गया है. इसलिए, फ़ीड सबमिट करते समय अपनी सभी समीक्षाएं सबमिट करें.

टॉप लेवल <feed> एलिमेंट

<feed> एलिमेंट में ये एलिमेंट, सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<version> ज़रूरी है (1) xs:string इससे पता चलता है कि प्रॉडक्ट की समीक्षा वाले फ़ीड स्कीमा के किस वर्शन का इस्तेमाल किया जा रहा है. फ़िलहाल, सिर्फ़ <version>2.4</version> का इस्तेमाल किया जा सकता है.
<aggregator> ज़रूरी नहीं (1) aggregatorType कोई पब्लिशर, समीक्षाओं को मैनेज करने और फ़ीड उपलब्ध कराने के लिए, समीक्षा एग्रीगेटर का इस्तेमाल कर सकता है. इस एलिमेंट से, एग्रीगेटर के इस्तेमाल के बारे में पता चलता है. साथ ही, इसमें एग्रीगेटर के बारे में जानकारी भी होती है.
<publisher> ज़रूरी है (1) publisherType पब्लिशर के बारे में जानकारी. यह खुदरा दुकानदार, मैन्युफ़ैक्चरर, समीक्षा करने वाली सेवा देने वाली कंपनी या ऐसी कोई इकाई हो सकती है जो प्रॉडक्ट की समीक्षाएं पब्लिश करती है.
<reviews> ज़रूरी नहीं (1) xs:sequence इसमें प्रॉडक्ट की समीक्षाएं शामिल हैं.

<feed>, फ़ीड में इस्तेमाल किए गए एलिमेंट पर यूनीक होने से जुड़ी पाबंदियों के बारे में बताता है.

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

<aggregator>

समीक्षाओं को मैनेज करने और फ़ीड उपलब्ध कराने के लिए, पब्लिशर किसी समीक्षा एग्रीगेटर का इस्तेमाल कर सकता है. यह एलिमेंट, एग्रीगेटर के इस्तेमाल के बारे में बताता है. साथ ही, इसमें एग्रीगेटर के बारे में जानकारी भी होती है. <aggregator> एलिमेंट में ये एलिमेंट, सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<name> ज़रूरी है (1) nonEmptyStringType प्रॉडक्ट की समीक्षाओं को इकट्ठा करने वाले एग्रीगेटर का नाम.

<publisher>

पब्लिशर की जानकारी. यह खुदरा दुकानदार, मैन्युफ़ैक्चरर, समीक्षा करने वाली सेवा देने वाली कंपनी या प्रॉडक्ट की समीक्षाएं पब्लिश करने वाली कोई इकाई हो सकती है. <publisher> एलिमेंट में, ये एलिमेंट ऊपर दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<name> ज़रूरी है (1) nonEmptyStringType प्रॉडक्ट की समीक्षाओं के पब्लिशर का नाम.
<favicon> ज़रूरी नहीं (1) httpUrlType पब्लिशर की कंपनी के फ़ैविकॉन का लिंक. इमेज का डाइमेंशन, फ़ैविकॉन के साइज़ के हिसाब से होना चाहिए: 16x16 पिक्सल. इमेज का फ़ॉर्मैट GIF, JPG या PNG होना चाहिए.

<reviews>

इसमें प्रॉडक्ट की समीक्षाएं शामिल होती हैं. <reviews> एलिमेंट में ये एलिमेंट, सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<review> ज़रूरी है (1-अनलिमिटेड) reviewType प्रॉडक्ट की किसी एक यूनीक समीक्षा के लिए. अगर कोई समीक्षा पब्लिशर की इन्वेंट्री में मौजूद एक से ज़्यादा प्रॉडक्ट के बारे में है, तो समीक्षा को एक बार बताएं और <products> एलिमेंट में कई <product> एलिमेंट शामिल करें.

<review>

प्रॉडक्ट की किसी एक यूनीक समीक्षा के लिए. अगर कोई समीक्षा पब्लिशर की इन्वेंट्री में मौजूद एक से ज़्यादा प्रॉडक्ट पर लागू होती है, तो समीक्षा को एक बार बताएं और <products> एलिमेंट में कई <product> एलिमेंट शामिल करें.<review> एलिमेंट में, ये एलिमेंट सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<review_id> ज़रूरी है (1) nonEmptyStringType पब्लिशर के सिस्टम में, प्रॉडक्ट की समीक्षा के लिए एक यूनीक आइडेंटिफ़ायर होता है. यह हमेशा के लिए मौजूद होता है.
<reviewer> ज़रूरी है (1) reviewerType प्रॉडक्ट की समीक्षा करने वाले व्यक्ति का नाम.
<is_verified_purchase> ज़रूरी नहीं (1) xs:boolean इससे पता चलता है कि समीक्षा करने वाले व्यक्ति ने प्रॉडक्ट खरीदा है या नहीं.
<is_incentivized_review> ज़रूरी नहीं (1) xs:boolean इससे पता चलता है कि समीक्षक को प्रॉडक्ट की समीक्षा करने के लिए, कोई इंसेंटिव दिया गया था या नहीं.
<review_timestamp> ज़रूरी है (1) xs:dateTime

टाइमस्टैंप से पता चलता है कि समीक्षा कब लिखी गई थी.

उदाहरण:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> ज़रूरी नहीं (1) nonEmptyStringType समीक्षा का टाइटल.
<content> ज़रूरी है (1) nonEmptyStringType समीक्षा का कॉन्टेंट.
<review_language> ज़रूरी नहीं (1) xs:string समीक्षा की भाषा (BCP 47).
<review_country> ज़रूरी नहीं (1) xs:string समीक्षक के देश का कोड (ISO 3166-1).
<pros> ज़रूरी नहीं (1) xs:sequence इसमें समीक्षक की राय के आधार पर, प्रॉडक्ट के फ़ायदे शामिल होते हैं. "pro:" जैसे बॉयलरप्लेट टेक्स्ट को हटाएं. ऐसा तब ही करें, जब इसे समीक्षक ने लिखा हो.
<cons> ज़रूरी नहीं (1) xs:sequence इसमें समीक्षक की राय के आधार पर, ऐप्लिकेशन के खराब पहलुओं के बारे में बताया गया है. "con:" जैसे बोयलरप्लेट टेक्स्ट को हटाएं. ऐसा तब तक करें, जब तक इसे समीक्षक ने न लिखा हो.
<reviewer_images> ज़रूरी नहीं (1) xs:sequence इसमें समीक्षक की ओर से उपलब्ध कराए गए प्रॉडक्ट की इमेज के लिंक शामिल होते हैं.
<review_url> ज़रूरी है (1) reviewUrlType समीक्षा के लैंडिंग पेज का यूआरएल.
<ratings> ज़रूरी है (1) xs:sequence इसमें समीक्षा से जुड़ी रेटिंग शामिल होती हैं.
<products> ज़रूरी है (1) xs:sequence इसमें समीक्षा से जुड़े प्रॉडक्ट शामिल होते हैं.
<is_spam> ज़रूरी नहीं (1) xs:boolean इससे पता चलता है कि पब्लिशर के सिस्टम में समीक्षा को स्पैम के तौर पर मार्क किया गया है या नहीं.
<collection_method> ज़रूरी नहीं (1) collectionMethodType

समीक्षा इकट्ठा करने का तरीका. वैल्यू, इनमें से कोई एक होनी चाहिए:

unsolicited
जब उपयोगकर्ता ने समीक्षा सबमिट की थी, तब वह किसी अनुरोध का जवाब नहीं दे रहा था.
post_fulfillment
उपयोगकर्ता ने ऑर्डर मिलने के बाद, किसी अनुरोध के जवाब में समीक्षा सबमिट की है.
<transaction_id> ज़रूरी नहीं (1) nonEmptyStringType पब्लिशर के सिस्टम में, समीक्षा से जुड़े लेन-देन के लिए एक स्थायी और यूनीक आइडेंटिफ़ायर. इस आईडी का इस्तेमाल यह बताने के लिए किया जा सकता है कि एक ही ट्रांज़ैक्शन से कई समीक्षाएं जुड़ी हैं.

<reviewer>

प्रॉडक्ट की समीक्षा करने वाले व्यक्ति का नाम. <reviewer> एलिमेंट में ये एलिमेंट, सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<name> ज़रूरी है (1) reviewerNameType

समीक्षा लिखने वाले व्यक्ति का नाम.

उदाहरण:

<name>Jane</name>
<reviewer_id> ज़रूरी नहीं (1) nonEmptyStringType

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

उदाहरण:

<reviewer_id>14295</reviewer_id>

<name>

समीक्षा लिखने वाले व्यक्ति का नाम. <name> एलिमेंट, nonEmptyStringType एलिमेंट का एक्सटेंशन है. इसमें समीक्षक का नाम या उपनाम शामिल होता है. <name> एलिमेंट में ये एट्रिब्यूट होते हैं.

एट्रिब्यूट दोहराव टाइप ब्यौरा
is_anonymous वैकल्पिक xs:boolean

इससे पता चलता है कि समीक्षक की पहचान छिपी हुई है या नहीं.

उदाहरण:

<name is_anonymous="true">Anonymous</name>

<pros>

इसमें समीक्षक की राय के आधार पर, प्रॉडक्ट के फ़ायदे शामिल होते हैं. <pros> एलिमेंट में, सूची में दिए गए क्रम में ये एलिमेंट शामिल होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<pro> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType

समीक्षक की राय के आधार पर, किसी व्यक्ति को प्रोफ़ेशनल के तौर पर दिखाया गया हो. फ़ायदों को उसी क्रम में सूची में शामिल किया जाना चाहिए जिस क्रम में वे दिखाए जाते हैं. "pro:" जैसे बॉयलरप्लेट टेक्स्ट को हटाएं. ऐसा तब तक करें, जब तक कि उसे समीक्षक ने न लिखा हो.

उदाहरण:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

इसमें समीक्षक की राय के आधार पर, ऐप्लिकेशन के खराब पहलुओं के बारे में बताया गया है. <cons> एलिमेंट में, सूची में दिए गए क्रम में ये एलिमेंट शामिल होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<con> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType

समीक्षक की राय के आधार पर, किसी खास समस्या की जानकारी. नुकसानों को उसी क्रम में सूची में शामिल किया जाना चाहिए जिस क्रम में वे दिखाए जाते हैं. "con:" जैसे बॉयलरप्लेट टेक्स्ट को हटाएं. ऐसा तब तक करें, जब तक कि उसे समीक्षक ने न लिखा हो.

उदाहरण:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

समीक्षा के लैंडिंग पेज का यूआरएल. <review_url> एलिमेंट, httpUrlType का एक्सटेंशन है. इसमें समीक्षा के लैंडिंग पेज का लिंक शामिल होता है. <review_url> एलिमेंट में ये एट्रिब्यूट होते हैं.

एट्रिब्यूट दोहराव टाइप ब्यौरा
type ज़रूरी है xs:string

टाइप इनमें से कोई एक होना चाहिए:

singleton
समीक्षा वाले पेज पर सिर्फ़ यह एक समीक्षा मौजूद है.
group
समीक्षा वाले पेज पर, समीक्षाओं का एक ग्रुप होता है. इसमें यह समीक्षा भी शामिल होती है.

उदाहरण:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

इसमें समीक्षक की ओर से उपलब्ध कराए गए प्रॉडक्ट की इमेज शामिल होती हैं. <reviewer_images> टैग में कई <reviewer_image> एलिमेंट हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<reviewer_image> ज़रूरी है (1-अनलिमिटेड) reviewImageType

समीक्षा करने वाले व्यक्ति ने जिस प्रॉडक्ट की समीक्षा की है उसकी इमेज.

<reviewer_image>

समीक्षा की एक इमेज.

एलिमेंट दोहराव टाइप ब्यौरा
<url> ज़रूरी है (1) httpUrlType

समीक्षा करने वाले व्यक्ति की ओर से, समीक्षा किए गए प्रॉडक्ट की इमेज का यूआरएल. यूआरएल के आखिर में इमेज फ़ाइल एक्सटेंशन होना ज़रूरी नहीं है.

उदाहरण:

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

इसमें समीक्षा से जुड़ी रेटिंग शामिल होती हैं. <ratings> एलिमेंट में, सूची में दिए गए क्रम में ये एलिमेंट शामिल होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<overall> ज़रूरी है (1) ratingType समीक्षक ने प्रॉडक्ट को जो कुल रेटिंग दी है.

<overall>

समीक्षक ने प्रॉडक्ट को जो कुल रेटिंग दी है. <overall> एलिमेंट, xs:decimal simpleType को एक्सटेंंड करता है और समीक्षक की दी गई रेटिंग को कैप्चर करता है. वैल्यू, min और max एट्रिब्यूट की तय की गई सीमा के अंदर होनी चाहिए. <overall> एलिमेंट में ये एट्रिब्यूट होते हैं.

एट्रिब्यूट दोहराव टाइप ब्यौरा
min ज़रूरी है xs:integer रेटिंग के लिए कम से कम संख्या. यह सबसे खराब रेटिंग होनी चाहिए. यह वैल्यू, रेटिंग न होने की वैल्यू नहीं होनी चाहिए.
max ज़रूरी है xs:integer रेटिंग की ज़्यादा से ज़्यादा संख्या. max एट्रिब्यूट की वैल्यू, min एट्रिब्यूट की वैल्यू से ज़्यादा होनी चाहिए.

<products>

इसमें समीक्षा से जुड़े प्रॉडक्ट शामिल होते हैं. <products> एलिमेंट में, सूची में दिए गए क्रम में ये एलिमेंट शामिल होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<product> ज़रूरी है (1-अनलिमिटेड) productType समीक्षा से जुड़ा प्रॉडक्ट.

<product>

समीक्षा से जुड़ा प्रॉडक्ट. <product> एलिमेंट में ये एलिमेंट, सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<product_ids> ज़रूरी नहीं (1) productIdsType किसी प्रॉडक्ट से जुड़े आइडेंटिफ़ायर.
<product_name> ज़रूरी नहीं (1) nonEmptyStringType प्रॉडक्ट का ब्यौरा देने वाला नाम.
<product_url> ज़रूरी है (1) httpUrlType प्रॉडक्ट का यूआरएल. अगर समीक्षा यूआरएल और प्रॉडक्ट यूआरएल एक जैसे हैं, तो इस यूआरएल की वैल्यू, <review_url> एलिमेंट की वैल्यू जैसी हो सकती है.

<product_ids>

किसी प्रॉडक्ट से जुड़े आइडेंटिफ़ायर. <product_ids> एलिमेंट में, सूची में दिए गए क्रम में ये एलिमेंट होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<gtins> ज़रूरी है (जिन प्रॉडक्ट का GTIN पता है उनसे जुड़ी सभी समीक्षाओं के लिए)

अन्य सभी समीक्षाओं के लिए ज़रूरी नहीं है (1)		 gtinsType इसमें किसी प्रॉडक्ट से जुड़े GTIN (ग्लोबल ट्रेड आइटम नंबर) शामिल होते हैं. GTIN के सब-टाइप (जैसे, UPC, EAN, ISBN, JAN) इस्तेमाल किए जा सकते हैं.
<mpns> ज़रूरी है (जिन प्रॉडक्ट का एमपीएन है उनसे जुड़ी सभी समीक्षाओं के लिए)

अन्य सभी समीक्षाओं के लिए ज़रूरी नहीं है (1)		 mpnsType इसमें किसी प्रॉडक्ट से जुड़े एमपीएन (मैन्युफ़ैक्चरर पार्ट नंबर) शामिल होते हैं.
<skus> ज़रूरी है (ऐसे प्रॉडक्ट की सभी समीक्षाओं के लिए जिनका एसकेयू पहले से पता है)

अन्य सभी समीक्षाओं के लिए ज़रूरी नहीं है (1)		 skusType इसमें किसी प्रॉडक्ट से जुड़े एसकेयू (स्टॉक कीपिंग यूनिट) शामिल होते हैं. आम तौर पर, यह प्रॉडक्ट फ़ीड में मौजूद प्रॉडक्ट ऑफ़र आईडी से मेल खाता है.
<brands> ज़रूरी है (किसी ब्रैंड के प्रॉडक्ट से जुड़ी सभी समीक्षाओं के लिए)

अन्य सभी समीक्षाओं के लिए ज़रूरी नहीं है (1)		 brandsType इसमें किसी प्रॉडक्ट से जुड़े ब्रैंड के नाम शामिल होते हैं.
<asins> ज़रूरी नहीं (1) asinsType इसमें किसी प्रॉडक्ट से जुड़े ASIN (Amazon स्टैंडर्ड आइडेंटिफ़िकेशन नंबर) शामिल होते हैं.

<gtins>

इसमें किसी प्रॉडक्ट से जुड़े GTIN (ग्लोबल ट्रेड आइटम नंबर) शामिल होते हैं. <gtins> एलिमेंट में ये एलिमेंट, सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<gtin> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType प्रॉडक्ट का ग्लोबल ट्रेड आइटम नंबर. GTIN के सब-टाइप (जैसे, UPC, EAN, ISBN, JAN) इस्तेमाल किए जा सकते हैं.

<mpns>

इसमें किसी प्रॉडक्ट से जुड़े एमपीएन (मैन्युफ़ैक्चरर पार्ट नंबर) शामिल होते हैं. <mpns> एलिमेंट में ये एलिमेंट, सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<mpn> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType प्रॉडक्ट के मैन्युफ़ैक्चरर का पार्ट नंबर.

<skus>

इसमें किसी प्रॉडक्ट से जुड़े एसकेयू (स्टॉक कीपिंग यूनिट) शामिल होते हैं. <skus> एलिमेंट में, ये एलिमेंट सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<sku> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType पब्लिशर की इन्वेंट्री में मौजूद प्रॉडक्ट की स्टॉक कीपिंग यूनिट.

<brands>

इसमें किसी प्रॉडक्ट से जुड़े ब्रैंड के नाम शामिल होते हैं. <brands> एलिमेंट में, सूची में दिए गए क्रम में ये एलिमेंट होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<brand> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType प्रॉडक्ट का ब्रैंड नाम.

<asins>

इसमें किसी प्रॉडक्ट से जुड़े ASIN (Amazon स्टैंडर्ड आइडेंटिफ़िकेशन नंबर) शामिल होते हैं. <asins> एलिमेंट में ये एलिमेंट, सूची में दिए गए क्रम में होते हैं.

एलिमेंट दोहराव टाइप ब्यौरा
<asin> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType प्रॉडक्ट का Amazon स्टैंडर्ड आइडेंटिफ़िकेशन नंबर. हर ASIN में 10 वर्ण होते हैं. इसमें अक्षर और अंक होते हैं.