Feed

注意： 此实体仅用于元数据 Feed。它不适用于选举前、选举或在职官员 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 的 FeedInactiveDate 之后，请等待 60 天，然后再从元数据 Feed 中移除该 Feed。

元素

元素	多样性	类型	说明
FeedId	1	string	Feed 的唯一稳定标识符。 无法在多个 Feed 中重复使用。
FeedName	1	string	Feed 的简短说明，例如“美国公职人员 2023 年”。
FeedType	1	FeedType	指明相应 CDF Feed 的类型。
FeedLongevity	1	FeedLongevity	表示 Feed 的有效期。
SourceDirPath	0 或 1	FeedSourcePathUri	Feed 的 XML 文件的完全限定源路径 URI。 我们支持以下文件托管解决方案： s3 ftp和sftp http和https 此文件必须可通过与元数据 Feed 相同的文件托管解决方案进行访问，但在数据准备就绪之前可以为空。 注意：只有在源路径 URI 可正常运行且适合用于生产环境时，才应添加 SourceDirPath。
CountryCode	0 或 1	string	相应 Feed 所涵盖的 ISO 3166-1 alpha-2 国家/地区代码。如果 FeedType 不是 election-dates 或 voter-information，则必须提供此值。
FeedInactiveDate	0 或 1	date	采用 ISO-8601 格式的日期，用于指明 Feed 将不再更新且不应再被提取的时间。 对于 evergreen Feed，除非 Feed 即将弃用，否则很可能根本不应设置此属性。 对于 limited Feed，此值应设置为 Feed 中最后一个 ElectionEvent 的结束日期后两周，或预期最后一次选举后更新后两周。 请注意，如果取消 ElectionEvent 时没有预期更新，则 FeedInactiveDate 可能会先于 ElectionEvent 的 EndDate。 对于 yearly Feed，与 limited Feed 一样，此日期应设置为至少比最后一个 ElectionEvent 的结束日期晚两周，但也不应早于相应 Feed 所针对年份的年末两周。例如，对于 2024 年的 Feed，如果所有选举都在 2024-12-31 或之前结束，则 FeedInactiveDate 应设置为 2025-01-14。如果选举推迟、2025 年举行决胜选举，或者选举活动以其他方式持续到 2025 年，则截止日期可能会更晚。 注意：请在 FeedInactiveDate 之后等待 60 天，然后再从元数据 Feed 中移除 Feed。
ElectionEventCollection	0 或 1	ElectionEvent	包含有关相应 Feed 所涵盖的选举的信息。此属性仅适用于 PRE_ELECTION 或 ELECTION_RESULTS 类型的 Feed。
OfficeholderSubFeed	0 或 1	OfficeholderSubFeed	包含此 Feed 中涵盖的公职人员的相关信息。 此属性仅适用于 Feed 类型 OFFICEHOLDER。

注意： 每个 Feed 实体都需要在 ElectionEventCollection 字段和 OfficeholderSubFeed 字段中至少包含一个条目。