फ़ीड

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

इसे उसी फ़ाइल होस्टिंग समाधान के ज़रिए ऐक्सेस किया जाना चाहिए जिसका इस्तेमाल मेटाडेटा फ़ीड के लिए किया जाता है. हालांकि, डेटा तैयार होने से पहले यह खाली हो सकता है.
SqsQueueName 0 या 1 string पुश नोटिफ़िकेशन की सुविधा चालू करने वाले फ़ीड के लिए, SQS कतार का नाम. ज़्यादा जानकारी के लिए, SQS डेवलपर गाइड देखें. अगर यह सेट नहीं है, तो फ़ीड अपडेट किए जाएंगे.
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 में भी जारी रहते हैं, तो इसे बाद में भी सेट किया जा सकता है.
IsTest 0 या 1 boolean इससे पता चलता है कि फ़ीड, सिम के लिए टेस्ट फ़ीड है या नहीं. अगर इस एट्रिब्यूट की वैल्यू नहीं दी जाती है, तो false मान लिया जाता है.
ElectionEventCollection 0 या 1 ElectionEvent इस फ़ीड में, उन चुनावों के बारे में जानकारी होती है जिनके नतीजे इस फ़ीड में शामिल किए गए हैं. इसकी वैल्यू सिर्फ़ PRE_ELECTION या ELECTION_RESULTS टाइप के फ़ीड के लिए मान्य होती है.
OfficeholderSubFeed 0 या 1 OfficeholderSubFeed इस फ़ीड में, उन पदाधिकारियों के बारे में जानकारी होती है जिनके बारे में बताया गया है. इस वैल्यू का इस्तेमाल सिर्फ़ OFFICEHOLDER फ़ीड टाइप के लिए किया जाता है.