フィード

Feed エンティティは、特定の国と CDF フィードタイプに対応する、CDF データファイルの単一のアクティブまたは今後のストリームを表します。詳しくは、フィードの種類をご覧ください。FeedDeliveryReport には、地理的範囲、期間、オフィスレベルのいずれかで範囲が重複しない限り、特定の国とフィードタイプに対して複数の Feed エンティティを含めることができます。有効な組み合わせの例を次に示します。

  • 1 つの FeedDeliveryReport に、米国の公職者の Feed と米国の選挙前の Feed(エバーグリーン)の両方を含めることができます。
  • 1 つの FeedDeliveryReport に、米国大統領選挙前の Feed(2022 年)と米国大統領選挙前の Feed(2024 年)を含めることができます。
  • 1 つの FeedDeliveryReport に、米国選挙前の Feed(2022 年連邦レベルのみ)と米国選挙前の Feed(2022 年州レベルのみ)を含めることができます。
  • 1 つの FeedDeliveryReport に、米国の公職者 Feed と日本の選挙前 Feed(2022 年の国政レベルのみ)を含めることができますが、両方の国が対象範囲内にある場合に限ります。

Feed には、予想される終了日(選挙後 60 日など)があるため期間が限定されているものと、終了日がなく継続的に更新される「エバーグリーン」のものがあります。

フィードの FeedInactiveDate から 60 日間経過するまで待ってから、メタデータ フィードから削除します。

要素

要素 重複 タイプ 説明
FeedId 1 string フィードの有効期間にわたって一意で固定の識別子。フィード間で再利用できません。
FeedName 1 string フィードの簡単な説明(「US Officeholders 2023」など)。
FeedType 1 FeedType これがどのタイプの CDF フィードであるかを示します。
FeedLongevity 1 FeedLongevity フィードの有効期間を示します。
SourceDirPath 0 または 1 FeedSourcePathUri フィードの XML ファイルの完全修飾ソースパス URI。

次のファイル ホスティング ソリューションがサポートされています。

  • s3
  • ftpsftp
  • httphttps

これはメタデータ フィードと同じファイル ホスティング ソリューションからアクセスできる必要がありますが、データが準備できるまでは空にすることができます。

CountryCode 0 または 1 string このフィードが対象とする ISO 3166-1 alpha-2 の国コード。FeedTypeelection-dates または voter-information ではない場合は必須です。
FeedInactiveDate 0 または 1 date フィードの更新が停止され、取り込みが不要になる日付を ISO-8601 形式で指定します。
  • evergreen フィードの場合、フィードが非推奨にならない限り、この属性は設定しないことがほとんどです。
  • limited フィードの場合、フィード内の最後の ElectionEvent の終了日から 2 週間後、または最後の選挙後の更新が予定されている日から 2 週間後に設定する必要があります。ElectionEvent がキャンセルされ、更新が予定されていない場合、FeedInactiveDateElectionEventEndDate より先に実行されることがあります。
  • yearly フィードの場合、limited フィードと同様に、最後の ElectionEvent の終了日から 2 週間以上後に設定する必要があります。ただし、フィードの対象となる年の終了日から 2 週間以上後である必要もあります。たとえば、2024 年のフィードの場合、すべての選挙が 2024-12-31 以前に終了している一般的なケースでは、FeedInactiveDate2025-01-14 に設定する必要があります。選挙が延期された場合、2025 年に決選投票が行われた場合、または選挙関連のイベントが 2025 年まで継続された場合、さらに遅れて設定されることもあります。
ElectionEventCollection 0 または 1 ElectionEvent このフィードで取り上げられている選挙に関する情報が含まれます。これは、フィードタイプ PRE_ELECTION または ELECTION_RESULTS の場合にのみ適用されます。
OfficeholderSubFeed 0 または 1 OfficeholderSubFeed このフィードで対象となる公職者に関する情報が含まれます。これは、フィードタイプ OFFICEHOLDER でのみ有効です。