फ़ीड

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

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

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

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

एलिमेंट

एलिमेंट गुणनफल टाइप ब्यौरा
FeedId 1 string फ़ीड के पूरे जीवनकाल के लिए यूनीक और स्टेबल आइडेंटिफ़ायर. इसका इस्तेमाल सभी फ़ीड में नहीं किया जा सकता.
FeedName 1 string फ़ीड के बारे में कम शब्दों वाली जानकारी, जैसे कि "अमेरिका के सरकारी अधिकारी 2023".
FeedType 1 FeedType इससे पता चलता है कि यह किस तरह का CDF फ़ीड है.
FeedLongevity 1 FeedLongevity इससे फ़ीड के इस्तेमाल की अवधि के बारे में पता चलता है.
SourceDirPath 0 या 1 FeedSourcePathUri फ़ीड की एक्सएमएल फ़ाइल का पूरा सोर्स पाथ यूआरआई.

फ़ाइल होस्ट करने के लिए, इन समाधानों का इस्तेमाल किया जा सकता है:

  • s3
  • ftp और sftp
  • http और https

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