動態消息

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

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

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 天，再從中繼資料動態饋給移除該動態饋給。

元素

名稱	標記	類型	附註	多重性
動態饋給ID	FeedId	String	動態消息生命週期的專屬固定 ID。 無法在不同動態饋給中重複使用。	1
動態饋給名稱	FeedName	String	動態消息的簡短說明，例如「美國官員 2023 年」。	1
動態饋給類型	FeedType	FeedType	指出這是哪種 CDF 動態饋給。	1
動態饋給生命週期	FeedLongevity	FeedLongevity	指出動態饋給的生命週期。	1
動態饋給位置	SourceDirPath	String	動態饋給 XML 檔案的完整 URI (僅支援 ftp 和 http)。必須透過與中繼資料動態饋給相同的檔案代管解決方案存取 (但資料準備就緒前可以為空)。 注意：只有在相關聯的網址可正常運作，且適合用於正式版時，才應加入 SourceDirPath。	0 或 1
國家/地區代碼	CountryCode	String	這項動態饋給涵蓋的 ISO 3166-1 alpha-2 國家/地區代碼。如果 FeedType 不是 election-dates 或 voter-information，則為必要欄位。	0 或 1
動態饋給停用日期	FeedInactiveDate	xs: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 天後，再從中繼資料動態饋給移除動態饋給。	0 或 1
選舉活動收集	ElectionEventCollection	ElectionEvent	內含這項動態消息涵蓋的選舉資訊。這項設定只適用於 PRE_ELECTION 或 ELECTION_RESULTS 動態饋給類型。	0 或 1
在職者子動態饋給	OfficeholderSubFeed	OfficeholderSubFeed	內含這項動態饋給涵蓋的官員資訊。 這項設定只適用於 OFFICEHOLDER 動態饋給類型。	0 或 1

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