フィード

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 日間経過するまで待ってから、メタデータ フィードから削除します。

要素

名前 タグ タイプ メモ 重複
フィード ID FeedId String フィードのライフタイムの一意で固定の識別子。フィード間で再利用できません。 1
フィード名 FeedName String フィードの簡単な説明(「US Officeholders 2023」など)。 1
フィードタイプ FeedType FeedType これがどのタイプの CDF フィードであるかを示します。 1
フィードの有効期間 FeedLongevity FeedLongevity フィードの有効期間を示します。 1
フィードの場所 SourceDirPath String フィードの XML ファイルの完全修飾 URI(ftphttp のみサポートされています)。メタデータ フィードと同じファイル ホスティング ソリューションからアクセスできる必要があります(ただし、データが準備できるまでは空にできます)。 0 または 1
国コード CountryCode String このフィードが対象とする ISO 3166-1 alpha-2 の国コード。FeedTypeelection-dates または voter-information ではない場合は必須です。 0 または 1
フィードの無効日 FeedInactiveDate xs:date フィードの更新が停止され、取り込みも停止される日時を示す ISO-8601 形式の日時。
  • evergreen フィードの場合、フィードが非推奨にならない限り、この属性は設定しないことがほとんどです。
  • limited フィードの場合、フィード内の最後の ElectionEvent の終了日から 2 週間後、または最後の選挙後の更新が予定されている日から 2 週間後に設定する必要があります。ElectionEvent がキャンセルされ、更新が予定されていない場合、FeedInactiveDateElectionEventEndDate より先に実行されることがあります。
  • yearly フィードの場合、limited フィードと同様に、最後の ElectionEvent の終了日の 2 週間後以降に設定する必要があります。また、フィードの対象となる年の終了日の 2 週間後以降に設定する必要があります。たとえば、2024 年のフィードの場合、すべての選挙が 2024-12-31 以前に終了している一般的なケースでは、FeedInactiveDate2025-01-14 に設定する必要があります。選挙が延期された場合、2025 年に決選投票が行われた場合、または選挙イベントが 2025 年まで継続された場合、さらに遅れて設定される可能性があります。
0 または 1
選挙イベントの収集 ElectionEventCollection ElectionEvent このフィードで取り上げられている選挙に関する情報が含まれます。これは、フィードタイプ PRE_ELECTION または ELECTION_RESULTS の場合にのみ適用されます。 0 または 1
公職者サブフィード OfficeholderSubFeed OfficeholderSubFeed このフィードで対象となる公職者に関する情報が含まれます。これは、フィードタイプ OFFICEHOLDER でのみ有効です。 0 または 1