動態消息

注意： 這個實體僅用於中繼資料動態饋給。不適用於

選舉前、選舉或現任官員動態消息。

Feed 實體代表一段時間內，與特定國家/地區和 CDF 饋給類型對應的單一有效或即將推出的 CDF 資料檔案串流。詳情請參閱「動態饋給類型」。只要範圍不重疊 (不論是地理範圍、時間範圍或辦公室層級)，一個 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	動態消息生命週期的專屬固定 ID。 無法在不同動態饋給中重複使用。
FeedName	1	string	動態消息的簡短說明，例如「2023 年美國官員」。
FeedType	1	FeedType	指出這是哪種 CDF 動態饋給。
FeedLongevity	1	FeedLongevity	指出動態饋給的生命週期。
SourceDirPath	0 或 1	FeedSourcePathUri	動態饋給 XML 檔案的完整來源路徑 URI。 系統支援下列檔案代管解決方案： s3 ftp和sftp http和https 這項檔案必須透過與中繼資料動態饋給相同的檔案代管解決方案存取，但資料準備就緒前可以為空白。 注意：只有在來源路徑 URI 可正常運作且適合用於正式版時，才應新增 SourceDirPath。
SqsQueueName	0 或 1	string	已啟用推送通知的動態饋給的 SQS 佇列完整 Amazon 資源名稱 (ARN)，例如 arn:aws:sqs:region:account-id:queue-name。詳情請參閱 SQS 開發人員指南。 注意：這項設定只能用於 SourceDirPath 位於 s3 的動態消息。 如未設定，系統會改為提取動態消息更新。
CountryCode	0 或 1	string	這項動態饋給涵蓋的 ISO 3166-1 alpha-2 國家/地區代碼。如果 FeedType 不是 election-dates 或 voter-information，則為必要欄位。
FeedInactiveDate	0 或 1	date	採用 ISO-8601 格式的日期，表示動態饋給停止更新的時間，之後就不應再擷取動態饋給。 如果是 evergreen 動態消息，除非動態消息即將淘汰，否則最有可能完全不會設定這個值。 如果是 limited 資訊動態，請將這個值設為資訊動態中最後一個 ElectionEvent 的結束日期後兩週，或是預期最後一次更新選舉後資訊的兩週後。請注意，如果取消 ElectionEvent 且沒有預期更新，則 FeedInactiveDate 可能會先於 ElectionEvent 的 EndDate 發生。 如果是 yearly 動態消息，與 limited 動態消息一樣，這個日期應設在最後一個 ElectionEvent 的結束日期至少兩週後，但也不應早於動態消息所屬年度結束後的兩週。舉例來說，如果是 2024 年動態消息，在所有選舉都已於 2024-12-31 當天或之前結束的常見情況下，FeedInactiveDate 應設為 2025-01-14。如果選舉延期、2025 年舉行決選，或選舉活動持續到 2025 年，設定期限可能會更晚。 注意：請在FeedInactiveDate後等待 60 天，再從中繼資料動態消息移除動態消息。
IsTest	0 或 1	boolean	動態饋給是否為模擬測試動態饋給。如未指定，則假設為 false。
ElectionEventCollection	0 或 1	ElectionEvent	內含這項動態消息涵蓋的選舉相關資訊。這項設定只會套用至 PRE_ELECTION 或 ELECTION_RESULTS 動態饋給類型。
OfficeholderSubFeed	0 或 1	OfficeholderSubFeed	內含這項動態饋給涵蓋的官員資訊。 這項設定只適用於 OFFICEHOLDER 動態饋給類型。

注意： 每個 Feed 實體在 ElectionEventCollection 欄位和 OfficeholderSubFeed 欄位中，都必須至少有一個項目。