फ़ीड

Feed इकाई, किसी देश और सीडीएफ़ फ़ीड टाइप से जुड़ी, सीडीएफ़ डेटा फ़ाइलों की एक ऐसी स्ट्रीम को दिखाती है जो समय के साथ ऐक्टिव या आने वाली है. ज़्यादा जानकारी के लिए, फ़ीड के टाइप देखें. किसी देश और फ़ीड टाइप के लिए, एक FeedDeliveryReport में कई Feed इकाइयां हो सकती हैं. हालांकि, ऐसा तब ही किया जा सकता है, जब उनके स्कोप ओवरलैप न हों. स्कोप, भौगोलिक क्षेत्र, समयसीमा या ऑफ़िस लेवल के हिसाब से तय किया जाता है. मान्य कॉम्बिनेशन के उदाहरण यहां दिए गए हैं:

  • एक FeedDeliveryReport में, अमेरिका के मौजूदा अधिकारियों Feed और अमेरिका के चुनाव से पहले दिखाए जाने वाले Feed (हमेशा उपलब्ध रहने वाले) दोनों तरह के विज्ञापन शामिल हो सकते हैं.
  • एक FeedDeliveryReport में, अमेरिका के चुनाव से पहले का Feed (2022) और अमेरिका के चुनाव से पहले का Feed (2024) शामिल हो सकता है.
  • एक FeedDeliveryReport में, अमेरिका में चुनाव से पहले का Feed (सिर्फ़ 2022 के फ़ेडरल-लेवल के चुनाव) और अमेरिका में चुनाव से पहले का Feed (सिर्फ़ 2022 के राज्य-लेवल के चुनाव) शामिल हो सकता है.
  • एक FeedDeliveryReport में, अमेरिका के किसी पद पर मौजूद व्यक्ति Feed और जापान में चुनाव से पहले का Feed (सिर्फ़ 2022 के राष्ट्रीय स्तर के चुनाव के लिए) शामिल हो सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब दोनों देश दायरे में हों.

Feed की अवधि सीमित होती है, क्योंकि इसके खत्म होने की तारीख तय होती है. जैसे, चुनाव के 60 दिन बाद या यह "हमेशा के लिए" होता है. इसका मतलब है कि इसके खत्म होने की कोई तारीख तय नहीं होती और इसे लगातार रीफ़्रेश किया जाता है.

मेटाडेटा फ़ीड से किसी फ़ीड को हटाने से पहले, उसके FeedInactiveDate के 60 दिन पूरे होने तक इंतज़ार करें.

एलिमेंट

नाम टैग टाइप नोट गुणनफल
फ़ीड ID FeedId String फ़ीड के पूरे जीवनकाल के लिए यूनीक और स्टेबल आइडेंटिफ़ायर. इसका इस्तेमाल सभी फ़ीड में नहीं किया जा सकता. 1
फ़ीड का नाम FeedName String फ़ीड के बारे में कम शब्दों में जानकारी दें. जैसे, "अमेरिका के सरकारी अधिकारी 2023". 1
फ़ीड प्रकार FeedType FeedType इससे पता चलता है कि यह किस तरह का CDF फ़ीड है. 1
फ़ीड के डेटा को अपडेट करने की फ़्रीक्वेंसी FeedLongevity FeedLongevity इससे फ़ीड के इस्तेमाल की अवधि के बारे में पता चलता है. 1
फ़ीड की जगह SourceDirPath String फ़ीड की एक्सएमएल फ़ाइल का पूरा यूआरआई (सिर्फ़ ftp और http काम करते हैं). इसे उसी फ़ाइल होस्टिंग सलूशन से ऐक्सेस किया जाना चाहिए जिससे मेटाडेटा फ़ीड को ऐक्सेस किया जाता है. हालांकि, डेटा तैयार होने से पहले यह खाली हो सकता है. 0 या 1
देश का कोड CountryCode String ISO 3166-1 alpha-2 फ़ॉर्मैट में देश का कोड, जिसके लिए यह फ़ीड उपलब्ध है. अगर FeedType की वैल्यू election-dates या voter-information नहीं है, तो इसका इस्तेमाल करना ज़रूरी है. 0 या 1
फ़ीड बंद होने की तारीख FeedInactiveDate xs:date ISO-8601 फ़ॉर्मैट में तारीख और समय. इससे पता चलता है कि फ़ीड को कब अपडेट नहीं किया जाएगा और कब इसे शामिल नहीं किया जाएगा.
  • evergreen फ़ीड के लिए, इसे सेट नहीं किया जाना चाहिए. हालांकि, अगर फ़ीड को बंद किया जा रहा है, तो इसे सेट किया जा सकता है.
  • limited फ़ीड के लिए, इसे दो हफ़्ते पर सेट किया जाना चाहिए. यह अवधि, फ़ीड में मौजूद पिछले ElectionEvent की खत्म होने की तारीख के दो हफ़्ते बाद या चुनाव के बाद के आखिरी अपडेट के दो हफ़्ते बाद होनी चाहिए. ध्यान दें कि अगर ElectionEvent को रद्द कर दिया जाता है और कोई अपडेट नहीं मिलता है, तो ElectionEvent के लिए FeedInactiveDate, EndDate से पहले आ सकता है.
  • yearly फ़ीड के लिए, इसे limited फ़ीड की तरह ही सेट किया जाना चाहिए. इसे आखिरी ElectionEvent के खत्म होने की तारीख के कम से कम दो हफ़्ते बाद सेट किया जाना चाहिए. हालांकि, यह उस साल के खत्म होने के दो हफ़्ते पहले भी सेट नहीं किया जाना चाहिए जिस साल के लिए फ़ीड है. उदाहरण के लिए, अगर फ़ीड 2024 के लिए है, तो FeedInactiveDate को 2025-01-14 पर सेट किया जाना चाहिए. ऐसा तब होता है, जब सभी चुनाव 2024-12-31 को या उससे पहले खत्म हो गए हों. अगर चुनाव स्थगित कर दिए जाते हैं, 2025 में रनऑफ़ होते हैं या चुनाव से जुड़े इवेंट 2025 में भी जारी रहते हैं, तो इसे बाद में भी सेट किया जा सकता है.
0 या 1
चुनाव से जुड़े इवेंट का कलेक्शन ElectionEventCollection ElectionEvent इस फ़ीड में, उन चुनावों के बारे में जानकारी होती है जिनके नतीजे दिखाए जाते हैं. इसकी वैल्यू सिर्फ़ PRE_ELECTION या ELECTION_RESULTS टाइप के फ़ीड के लिए मान्य होती है. 0 या 1
अधिकारी का सब-फ़ीड OfficeholderSubFeed OfficeholderSubFeed इस फ़ीड में, उन पदाधिकारियों के बारे में जानकारी होती है जिनके बारे में बताया गया है. इस वैल्यू का इस्तेमाल सिर्फ़ OFFICEHOLDER फ़ीड टाइप के लिए किया जाता है. 0 या 1