Feed

Feed 实体表示一段时间内与特定国家/地区和 CDF Feed 类型对应的单个有效或即将到来的 CDF 数据文件流。如需了解详情,请参阅Feed 类型。 一个 FeedDeliveryReport 可以包含多个针对特定国家/地区和 Feed 类型的 Feed 实体,前提是它们的范围(地理范围、时间范围或办事处级别)不重叠。以下是有效组合的示例:

  • 单个 FeedDeliveryReport 可以同时包含美国公职人员 Feed 和美国选举前 Feed(常青)。
  • 单个 FeedDeliveryReport 可以包含美国 2022 年大选前 Feed 和美国 2024 年大选前 Feed
  • 一个 FeedDeliveryReport 可以包含美国选举前 Feed(仅限 2022 年联邦级)和美国选举前 Feed(仅限 2022 年州级)。
  • 单个 FeedDeliveryReport 可以包含美国公职人员 Feed 和日本竞选前 Feed(仅限 2022 年国家级),但前提是这两个国家/地区都在范围内。

Feed 的有效期有限,因为有预期结束日期(例如选举后 60 天),或者它是“常青”的,这意味着没有预期结束日期,并且会不断刷新。

在从元数据 Feed 中移除 Feed 之前,请等待 FeedInactiveDate 后的 60 天。

元素

名称 标记 类型 备注 多样性
Feed ID FeedId String Feed 的唯一稳定标识符,在 Feed 的整个生命周期内保持不变。 无法在多个 Feed 中重复使用。 1
Feed 名称 FeedName String 动态的简短说明,例如“美国公职人员 2023 年”。 1
Feed 类型 FeedType FeedType 指明相应 CDF Feed 的类型。 1
Feed 的持久性 FeedLongevity FeedLongevity 表示 Feed 的有效期。 1
Feed 位置 SourceDirPath String Feed 的 XML 文件的完全限定 URI(仅支持 ftphttp)。必须通过与元数据 Feed 相同的文件托管解决方案进行访问(但在数据准备就绪之前可以为空)。 0 或 1
国家/地区代码 CountryCode String 相应 Feed 所涵盖的 ISO 3166-1 alpha-2 国家/地区代码。如果 FeedType 不是 election-datesvoter-information,则必须提供此值。 0 或 1
Feed 无效日期 FeedInactiveDate xs:date 采用 ISO-8601 格式的日期时间,用于指明 Feed 将不再更新的时间,以及不再应提取的时间。
  • 对于 evergreen Feed,除非 Feed 即将弃用,否则很可能根本不应设置此属性。
  • 对于 limited Feed,此值应设置为 Feed 中最后一个 ElectionEvent 的结束日期之后两周,或预期最后一次选举后更新之后两周。 请注意,如果取消 ElectionEvent 时没有预期更新,则 FeedInactiveDate 可以先于 ElectionEventEndDate
  • 对于 yearly Feed,与 limited Feed 一样,此值应设置为至少比最后一个 ElectionEvent 的结束日期晚两周,但也不应早于相应 Feed 所针对年份的结束日期后两周。例如,对于 2024 年的 Feed,如果所有选举都已在 2024-12-31 或之前结束,则 FeedInactiveDate 应设置为 2025-01-14。如果选举推迟、2025 年举行决胜选举,或者选举活动以其他方式持续到 2025 年,则截止日期可能会更晚。
0 或 1
选举活动集锦 ElectionEventCollection ElectionEvent 包含有关相应 Feed 所涵盖的选举的信息。此属性仅适用于 PRE_ELECTIONELECTION_RESULTS 类型的 Feed。 0 或 1
“任职者”子 Feed OfficeholderSubFeed OfficeholderSubFeed 包含相应 Feed 中涵盖的公职人员的相关信息。 此属性仅适用于 Feed 类型 OFFICEHOLDER 0 或 1