フィード

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
  • ftp、sftp
  • http、https

これは メタデータ フィードと同じファイル ホスティング ソリューションからアクセスできる必要がありますが、データの準備が整うまでは空にできます。
SqsQueueName 0 または 1 string プッシュ通知が有効になっているフィードの SQS キューの完全修飾 Amazon Resource Name（ARN）（例: arn:aws:sqs:region:account-id:queue-name）。詳しくは、SQS デベロッパー ガイドをご覧ください。 設定しない場合、フィードの更新はプルされます。
CountryCode 0 または 1 string このフィードが対象とする ISO 3166-1 alpha-2 の国コード。`FeedType` が `election-dates` または `voter-information` でない場合は必須です。
FeedInactiveDate 0 または 1 date フィードが更新されなくなり、取り込みを停止する日付（ISO-8601 形式）。
  • evergreen フィードの場合、フィードが非推奨にならない限り、設定しないことをおすすめします。
  • limited フィードの場合、フィード内の最後の ElectionEvent の終了日から 2 週間後、または選挙後の最後の更新が予定されている日から 2 週間後に設定する必要があります。ElectionEvent がキャンセルされ、更新が予定されていない場合、FeedInactiveDate は ElectionEvent の EndDate より前に設定できます。
  • yearly フィードの場合、limited フィードと同様に、最後の ElectionEvent の終了日から 2 週間後以降に設定する必要があります。また、フィードの対象となる年の終了日から 2 週間後以降に設定する必要があります。 たとえば、2024 年のフィードの場合、FeedInactiveDate を 2025-01-14 に設定する必要があります。これは、 すべての選挙が 2024-12-31 以前に終了している一般的なケースです。選挙が延期された場合、2025 年に決選投票が行われる場合、または選挙イベントが 2025 年まで続く場合は、さらに遅く設定できます。
IsTest 0 または 1 boolean フィードがシミュレーション用のテストフィードかどうか。指定しない場合は false とみなされます。
ElectionEventCollection 0 または 1 ElectionEvent このフィードが対象とする選挙に関する情報が含まれます。これは、フィードタイプ PRE_ELECTION または ELECTION_RESULTS の場合にのみ有効です。
OfficeholderSubFeed 0 または 1 OfficeholderSubFeed このフィードが対象とする現職者に関する情報が含まれます。 これは、フィードタイプ OFFICEHOLDER の場合にのみ有効です。