फ़ीड

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 इससे पता चलता है कि यह किस तरह का सीडीएफ़ फ़ीड है.
FeedLongevity 1 FeedLongevity इससे फ़ीड की अवधि का पता चलता है.
SourceDirPath 0 या 1 FeedSourcePathUri फ़ीड की एक्सएमएल फ़ाइल का पूरी तरह क्वालिफ़ाइड सोर्स पाथ यूआरआई.

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

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

इसे उसी फ़ाइल होस्टिंग समाधान के ज़रिए ऐक्सेस किया जाना चाहिए जिसका इस्तेमाल मेटाडेटा फ़ीड के लिए किया जाता है. हालांकि, डेटा तैयार होने से पहले यह खाली हो सकता है.
SqsQueueName 0 या 1 string पुश नोटिफ़िकेशन की सुविधा चालू किए गए फ़ीड के लिए, SQS क्यू का पूरी तरह क्वालिफ़ाइड Amazon रिसोर्स नेम (एआरएन). उदाहरण के लिए, arn:aws:sqs:region:account-id:queue-name. ज़्यादा जानकारी के लिए, SQS डेवलपर गाइड देखें. अगर इसे सेट नहीं किया जाता है, तो फ़ीड अपडेट किए जाएंगे.
CountryCode 0 या 1 string ISO 3166-1 alpha-2 फ़ॉर्मैट में देश का वह कोड जिसके लिए यह फ़ीड उपलब्ध है. अगर FeedType की वैल्यू election-dates या voter-information नहीं है, तो इसका इस्तेमाल करना ज़रूरी है.
FeedInactiveDate 0 या 1 date आईएसओ-8601 फ़ॉर्मैट में वह तारीख डालें जिसके बाद फ़ीड अपडेट नहीं किया जाएगा और उसे शामिल नहीं किया जाना चाहिए.
  • evergreen फ़ीड के लिए, इस फ़ील्ड को सेट नहीं किया जाना चाहिए. हालांकि, अगर फ़ीड को बंद किया जा रहा है, तो इसे सेट किया जा सकता है.
  • limited फ़ीड के लिए, इसे दो हफ़्ते पर सेट किया जाना चाहिए. यह समयसीमा, फ़ीड में मौजूद पिछले ElectionEvent की खत्म होने की तारीख के दो हफ़्ते बाद या चुनाव के बाद के आखिरी अपडेट के दो हफ़्ते बाद होनी चाहिए. ध्यान दें कि अगर किसी ElectionEvent को रद्द कर दिया जाता है और उसके लिए कोई अपडेट नहीं मिलता है, तो ElectionEvent के लिए FeedInactiveDate, EndDate से पहले आ सकता है.
  • 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 फ़ीड टाइप के लिए किया जाता है.