फ़ीड

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 date ISO-8601 फ़ॉर्मैट में दी गई वह तारीख जिसके बाद फ़ीड अपडेट नहीं किया जाएगा और न ही उसे शामिल किया जाएगा.
  • evergreen फ़ीड के लिए, इसे सेट नहीं किया जाना चाहिए. हालांकि, अगर फ़ीड को बंद किया जा रहा है, तो इसे सेट किया जा सकता है.
  • limited फ़ीड के लिए, इसे पिछले ElectionEvent की समाप्ति तारीख के दो हफ़्ते बाद सेट किया जाना चाहिए. इसके अलावा, इसे चुनाव के बाद के आखिरी अपडेट के दो हफ़्ते बाद भी सेट किया जा सकता है. ध्यान दें कि अगर ElectionEvent को रद्द कर दिया जाता है और कोई अपडेट नहीं मिलता है, तो ElectionEvent के लिए EndDate से पहले FeedInactiveDate का इस्तेमाल किया जा सकता है.
  • yearly फ़ीड के लिए, limited फ़ीड की तरह ही, इसे पिछले ElectionEvent के खत्म होने की तारीख के कम से कम दो हफ़्ते बाद सेट किया जाना चाहिए. हालांकि, यह उस साल के खत्म होने के दो हफ़्ते से पहले नहीं होना चाहिए जिस साल के लिए फ़ीड है. उदाहरण के लिए, अगर 2024 के फ़ीड में सभी चुनाव 2024-12-31 को या उससे पहले खत्म हो गए हैं, तो सामान्य तौर पर FeedInactiveDate को 2025-01-14 पर सेट किया जाना चाहिए. अगर चुनाव स्थगित कर दिए जाते हैं, 2025 में रनऑफ़ होते हैं या चुनाव से जुड़े इवेंट 2025 में भी जारी रहते हैं, तो इसे बाद में भी सेट किया जा सकता है.
0 या 1
चुनाव से जुड़े इवेंट का कलेक्शन ElectionEventCollection ElectionEvent इस फ़ीड में, उन चुनावों के बारे में जानकारी होती है जिनके बारे में यह फ़ीड जानकारी देता है. इसकी वैल्यू सिर्फ़ PRE_ELECTION या ELECTION_RESULTS फ़ीड टाइप के लिए मान्य होती है. 0 या 1
अधिकारी का सब-फ़ीड OfficeholderSubFeed OfficeholderSubFeed इस फ़ीड में, उन पदाधिकारियों के बारे में जानकारी होती है जिनके बारे में बताया गया है. इस एट्रिब्यूट की वैल्यू सिर्फ़ OFFICEHOLDER फ़ीड टाइप के लिए मान्य होती है. 0 या 1