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

किताब: /product-review-feeds/_book.yaml

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

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

आप इस एक्सएमएल स्कीमा प्राइमर से, एक्सएमएल स्कीमा के बारे में ज़्यादा जान सकते हैं.

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

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

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

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

<feed> एलिमेंट में ये एलिमेंट, दिए गए क्रम में शामिल होते हैं.

एलिमेंट पुनरावृत्ति टाइप जानकारी
<version> ज़रूरी है (1) xs:string इससे पता चलता है कि प्रॉडक्ट की समीक्षा वाले फ़ीड स्कीमा का कौनसा वर्शन इस्तेमाल किया जा रहा है. इस समय सिर्फ़ <version>2.3</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 प्रॉडक्ट की समीक्षा का लेखक.
<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 समीक्षा का कॉन्टेंट.
<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> यह ज़रूरी है (जिन प्रॉडक्ट के बारे में पहले से जानकारी है, उससे जुड़ी सभी समीक्षाओं के लिए पूरी समीक्षा का मिलान करना ज़रूरी है)

अन्य सभी समीक्षाओं के लिए ज़रूरी नहीं है (इसका सुझाव दिया जाता है) (1)		 gtinsType इसमें किसी प्रॉडक्ट से जुड़े जीटीआईएन (ग्लोबल ट्रेड आइटम नंबर) होते हैं.
<mpns> अगर समीक्षा से जुड़े प्रॉडक्ट के लिए जीटीआईएन असाइन नहीं किया गया है, तो ज़रूरी है कि समीक्षा में मिलान करने के लिए, एमपीएन को शामिल किया जाए. इसे ब्रैंड के साथ सबमिट किया जाना चाहिए

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

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

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

<gtins>

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

एलिमेंट पुनरावृत्ति टाइप जानकारी
<gtin> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType प्रॉडक्ट का ग्लोबल ट्रेड आइटम नंबर.

<mpns>

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

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

<skus>

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

एलिमेंट पुनरावृत्ति टाइप जानकारी
<sku> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType प्रकाशक की इन्वेंट्री में प्रॉडक्ट की स्टॉक रखने की इकाई.

<brands>

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

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

<asins>

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

एलिमेंट पुनरावृत्ति टाइप जानकारी
<asin> ज़रूरी है (1-अनलिमिटेड) nonEmptyStringType प्रॉडक्ट का Amazon Standard Identity नंबर. हर ASIN में 10 वर्ण और अक्षर और अंक शामिल हैं.