कैरोसेल

आप अपने रिच परिणामों (जिसे पहले शानदार कार्ड कहा जाता था) को कैरोसेल नाम के सूची जैसे डिसप्ले में दिखाने लायक बनाने के लिए व्यवस्थित डेटा का इस्तेमाल कर सकते हैं. आम तौर पर कैरोसेल सिर्फ़ मोबाइल डिवाइस पर दिखाई देते हैं. ये सिर्फ़ कुछ सामग्री प्रकारों के लिए दिखाई देते हैं जैसा कि नीचे बताया गया है. अगर आप किसी ऐसे सामग्री प्रकार के लिए कैरोसेल मार्कअप का इस्तेमाल करते हैं जिसका इस्तेमाल फ़िलहाल कैरोसेल फ़ॉर्मैट में नहीं किया जा सकता है, तो यह कोई गड़बड़ी नहीं है; जानकारी अभी भी दिखाई जा सकती है, लेकिन यह किसी कैरोसेल में नहीं होगी.

कुछ मामलों में, 'Google सर्च' आपके रिच परिणाम को कैरोसेल में दिखा सकता है, भले ही पेज में सूची के लिए व्यवस्थित डेटा शामिल न हो: उदाहरण के लिए, कोई रेसिपी, कई अलग-अलग वेबसाइटों के नतीजों के रेसिपी कैरोसेल में दिखाई दे सकती है.

उदाहरण

यहां किसी एक वेबसाइट की चिकन रेसिपी की सूची एक कैरोसेल में दिखाई गई है:

रेसिपी रिच परिणाम का कैरोसेल

दिशा-निर्देश

सामान्य व्यवस्थित डेटा दिशा-निर्देशों के अलावा, सभी सूची मार्कअप पर आगे दिए गए दिशा-निर्देश लागू होते हैं:

  • सूची में दिए गए सभी आइटम एक ही तरह के होने चाहिए, जैसे: लेख या रेसिपी.
  • उपयोगकर्ता को दिखाई देने वाला लेख, पेज पर मौजूद व्यवस्थित डेटा में दी गई जानकारी से मिलता-जुलता होना चाहिए.
  • सूची फ़ॉर्मैट में दिखाए गए आइटम position प्रॉपर्टी के ज़रिए तय किए जाने वाले क्रम में दिखाए जाएंगे.
  • सूची फ़ॉर्मैट का इस्तेमाल फ़िलहाल इन सामग्री प्रकारों के लिए किया जा सकता है. इस सूची में नई चीज़ें जुड़ी रही हैं, इसलिए जैसे ही दूसरे सामग्री प्रकारों को इस्तेमाल करने की सुविधा उपलब्ध होती है, वैसे ही आप उनके लिए सूची बना सकते हैं: रेसिपी, फ़िल्म, कोर्स, लेख, रेसिपी.

आपके व्यवस्थित डेटा के लिए सूची फ़ॉर्मैट इस्तेमाल करने के दो तरीके हैं:

  • सारांश पेज + पूरी जानकारी वाले कई पेज
  • एक ही पेज पर पूरी जानकारी वाली एक सूची

सारांश पेज + पूरी जानकारी वाले कई पेज

सारांश पेज में सूची में दिए गए हर आइटम के बारे में थोड़ी जानकारी होती है. सारांश पर मौजूद आइटम की हर जानकारी एक अलग पूरी जानकारी वाले पेज पर ले जाती है जिसमें किसी एक आइटम के बारे में पूरी जानकारी होती है.

सारांश पेज पूरी जानकारी वाला पेज
ItemList के बारे में जानकारी देता है, जहां हर ListItem की सिर्फ़ तीन प्रॉपर्टी होती हैं: @type ("ListItem" पर सेट), position (सूची में आइटम की जगह) और url (उस आइटम के बारे में पूरी जानकारी के साथ पेज का यूआरएल). उस सूची प्रकार के लिए सही एक व्यवस्थित डेटा ऐलिमेंट की जानकारी देता है.
best_pie_recipes.html के लिए स्यूडोकोड:

ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      url: http://example.com/cherry_pie_recipe.html
    },
    {
      @type: ListItem
      position:2
      url: http://example.com/appple_pie_recipe.html,
    },
    ... more recipes ...
  ]
cherry_pie_recipe.html के लिए स्यूडोकोड:

@type: Recipe
name: George's Cherry Pie
author: George Smith
.... more properties ...

कोड का नमूना:

कोड का नमूना:

एक ही पेज पर पूरी जानकारी वाली सूची

'एक ही पेज पर पूरी जानकारी वाली एक सूची' में हर आइटम के पूरे लेख सहित सूची की पूरी जानकारी होती है: उदाहरण के लिए, एक ही पेज पर मौजूद, अलग-अलग तरह के मफ़िन के लिए रेसिपी की एक गैलरी.

एक पेज
ItemList के बारे में जानकारी देता है, जहां हर ऐलिमेंट एक ListItem है जिसमें item प्रॉपर्टी में उस schema.org ऐलिमेंट प्रकार (उदाहरण के लिए, फ़िल्म या कोर्स) के लिए व्यवस्थित डेटा डाला गया है. पेज में उपयोगकर्ता को दिखाई देने वाला लेख और हर ListItem ऐलिमेंट से मेल खाने वाला एंकर होना चाहिए.

best_pie_recipes.html के लिए स्यूडोकोड:


ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      item: {
        @type: recipe
        url: http://example.com/big_list_of_recipes#recipe_1
        name: George's Cherry Pie
        author: George Smith
        ... all other required Recipe type properties ...}
    },
    {
      @type: ListItem
      position: 2
      item: {
        @type: recipe
        url: http://example.com/big_list_of_recipes#recipe_2
        name: Martha's Apple Pie
        author: Martha Smith
        ... all other required Recipe type properties ...}
    },
    ... more recipes ...
  ]

 

कोड का नमूना:

व्यवस्थित डेटा प्रकार की परिभाषाएं

कोई सूची बनाने के लिए,आपको एक ItemList तय करना होगा जिसमें कम से कम दो ListItems हों.

ItemList

ItemList एक कंटेनर आइटम है जिसमें सूची के सभी ऐलिमेंट होते हैं. सारांश पेज पर इस्तेमाल किया जाने पर सूची में मौजूद सभी यूआरएल, एक ही डोमेन के अलग-अलग पेजों पर लेकर जाने वाले होने चाहिए. 'एक ही पेज पर पूरी जानकारी वाली एक सूची' पर इस्तेमाल किए जाने पर सभी यूआरएल, उस पेज पर लेकर जाने वाले होने चाहिए जिस पर सूची का व्यवस्थित डेटा है.

ItemList की पूरी परिभाषा schema.org पर उपलब्ध है.

प्रॉपर्टी
@type

ज़रूरी

"ItemList" होना चाहिए.

itemListElement

ListItem, ज़रूरी है

आइटम की सूची. सभी आइटम एक ही प्रकार के होने चाहिए. जानकारी के लिए नीचे ListItem देखें.

ListItem

ListItem में सूची में किसी खास आइटम के बारे में जानकारी होती है.

  • अगर यह सारांश पेज है, तो ListItem में सिर्फ़ type , position और url प्रॉपर्टी शामिल होनी चाहिए.
  • अगर यह एक ही पेज पर पूरी जानकारी वाली सूची, तो ListItem में उस डेटा प्रकार के लिए सभी अतिरिक्त schema.org प्रॉपर्टी शामिल होनी चाहिए जिनके बारे में इसमें जानकारी दी गई है (उदाहरण के लिए, Recipe या Course जैसी चीज़ें).

ListItem की पूरी परिभाषा schema.org पर उपलब्ध है.

सरल सारांश सूची में आइटम के उदाहरण (JSON-LD):

{
  "@type":"ListItem",
  "position":1,
  "url":"http://example.com/desserts/apple-pie"
}

एक पेज में पूरी जानकारी वाली सूची में आइटम के उदाहरण (JSON-LD):

{
  "@type": "ListItem",
  "position": 1,
  "item": {
    "@type": "Recipe",
    "url": "http://example.com/desserts/pies/#apple-pie",
    "name": "Apple Pie",
    "image": "https://example.com/300px-Apple_pie.jpg",
     "aggregateRating": {
       "@type": "AggregateRating",
       "ratingValue": "6",
       "reviewCount": "32"
     },
     "recipeYield": "8 servings",
     "recipeIngredient": [
       "Pastry crust for bottom and top",
       "1/2 cup unsalted butter",
       "3 tablespoons all-purpose flour",
       "1/4 cup water",
       "1/4 cup white sugar",
       "1/2 cup brown sugar",
       "10 cups peeled, chopped green apples"
     ],
  }
}
प्रॉपर्टी
@type

ज़रूरी

"ListItem" होना चाहिए

position

Integer, ज़रूरी

कैरोसेल में आइटम की जगह. यह 1-आधारित संख्या होती है.

url

URL, सारांश पेजों के लिए ज़रूरी है; 'एक पेज में पूरी जानकारी वाली सूची' के लिए शामिल न करें

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

item

Thing, 'एक ही पेज में पूरी जानकारी वाली सूचियों' के लिए ज़रूरी है, सारांश पेजों के लिए शामिल न करें

सिर्फ़ 'एक ही पेज में पूरी जानकारी वाली सूचियों' के लिए इस्तेमाल किया जाता है. इस ऑब्जेक्ट में आगे दिए मान डालें. इसके साथ-साथ खास व्यवस्थित डेटा प्रकार के सभी सदस्यों के बारे में जानकारी दी गई है:

  • @type - जिस ऑब्जेक्ट की जानकारी दी जा रही उसका schema.org प्रकार नाम. उदाहरण: "रेसिपी"
  • url - पूरी तरह इस्तेमाल होने लायक यूआरएल + पेज पर मौजूद इस आइटम के लिए पेज एंकर. यूआरएल मौजूदा पेज का होना चाहिए. साथ ही आपको उपयोगकर्ता को दिखाई देने लायक लेख के पास अपने पेज में HTML एंकर (<a> टैग या name या id मान) शामिल करना होगा. उदाहरण: "https://example.org/recipes/pies#apple_pie"
  • name - आइटम का स्ट्रिंग का नाम, रेंडर की गई गैलेरी में दिखाया गया. HTML फ़ॉर्मैट को अनदेखा किया जाता है.
  • इस डेटा प्रकार के लिए ज़रूरी कोई भी दूसरी प्रॉपर्टी, जैसा कि schema.org में बताया गया है और आपकी सामग्री के प्रकार (उदाहरण के लिए लेख या किताब) के लिए इन दस्तावेज़ों में दिए गए नियम. उदाहरण के तौर पर, सूची में दी गई किताब के लिए, आप bookFormat और isbn प्रॉपर्टी डालेंगे; रेसिपी के लिए, आप prepTime और image प्रॉपर्टी डालेंगे.

निम्न के बारे में फ़ीडबैक भेजें...