Feed

Eine Feed-Entität stellt einen einzelnen aktiven oder bevorstehenden Stream von CDF-Datendateien im Zeitverlauf dar, die einem bestimmten Land und einem bestimmten CDF-Feedtyp entsprechen. Weitere Informationen finden Sie unter Feedtypen. Ein FeedDeliveryReport kann mehrere Feed Entitäten für ein bestimmtes Land und Feedtyp enthalten, sofern sich ihre Bereiche nicht überschneiden, weder nach geografischem Bereich, Zeitraum noch nach Amtsebene. Beispiele für gültige Kombinationen:

  • Ein einzelner FeedDeliveryReport kann sowohl einen Feed für US-Amtsinhaber als auch einen Feed für US-Vorwahlen (immer aktuell) enthalten.
  • Ein einzelnes FeedDeliveryReport kann einen Feed für US-Vorwahlen (2022) und einen Feed für US-Vorwahlen (2024) enthalten.
  • Ein einzelnes FeedDeliveryReport kann einen Feed für US-Vorwahlen (2022, nur auf Bundesebene) und einen Feed für US-Vorwahlen (2022, nur auf bundesstaatlicher Ebene) enthalten.
  • Ein einzelnes FeedDeliveryReport kann einen Feed für US-Amtsinhaber und einen Feed für JP-Vorwahlen (2022, nur auf nationaler Ebene) enthalten, aber nur, wenn beide Länder im Bereich liegen.

Ein Feed hat entweder eine begrenzte Dauer, da ein erwartetes Enddatum vorhanden ist (z. B. 60 Tage nach einer Wahl), oder er ist „immer aktuell“, d. h., es gibt kein erwartetes Enddatum und er wird kontinuierlich aktualisiert.

Warten Sie 60 Tage nach dem FeedInactiveDate eines Feeds, bevor Sie ihn aus dem Metadaten-Feed entfernen.

Elemente

Element Multiplizität Typ Beschreibung
FeedId 1 string Eine eindeutige und stabile ID für die Lebensdauer des Feeds. Kann nicht für mehrere Feeds verwendet werden.
FeedName 1 string Eine kurze Beschreibung des Feeds, z. B. „US-Amtsinhaber 2023“.
FeedType 1 FeedType Gibt an, um welchen Typ von CDF-Feed es sich handelt.
FeedLongevity 1 FeedLongevity Gibt die Lebensdauer des Feeds an.
SourceDirPath 0 oder 1 FeedSourcePathUri Voll qualifizierte Quellpfad-URI der XML-Datei des Feeds.

Die folgenden Lösungen für das Dateihosting werden unterstützt:

  • s3
  • ftp und sftp
  • http und https

Dieser Pfad muss über dieselbe Lösung für das Dateihosting wie den Metadaten-Feed zugänglich sein, kann aber leer sein, bevor die Daten bereit sind.
SqsQueueName 0 oder 1 string Der vollqualifizierte Amazon Resource Name (ARN) der SQS-Warteschlange für Feeds, für die Push-Benachrichtigungen aktiviert sind (z. B. arn:aws:sqs:region:account-id:queue-name). Weitere Informationen finden Sie unter dem SQS-Entwicklerleitfaden. Wenn dieser Wert nicht festgelegt ist, werden die Feedaktualisierungen stattdessen abgerufen.
CountryCode 0 oder 1 string Der Ländercode gemäß ISO 3166-1 alpha-2, auf den sich dieser Feed bezieht. Erforderlich, wenn FeedType nicht election-dates oder voter-information ist.
FeedInactiveDate 0 oder 1 date Ein Datum im ISO 8601-Format, das angibt, wann der Feed nicht mehr aktualisiert und nicht mehr aufgenommen werden sollte.
  • Bei evergreen Feeds sollte dieser Wert in den meisten Fällen nicht festgelegt werden, es sei denn, der Feed wird eingestellt.
  • Bei limited Feeds sollte dieser Wert auf zwei Wochen nach dem Enddatum des letzten ElectionEvent im Feed oder zwei Wochen nach der erwarteten letzten Aktualisierung nach der Wahl festgelegt werden. Wenn ein ElectionEvent ohne erwartete Aktualisierungen abgesagt wird, kann das FeedInactiveDate vor dem EndDate für das ElectionEvent liegen.
  • Bei yearly-Feeds sollte dieser Wert wie bei limited Feeds mindestens zwei Wochen nach dem Enddatum des letzten ElectionEvent liegen, aber auch nicht früher als zwei Wochen nach dem Ende des Jahres, für das der Feed gilt. Bei einem Feed für 2024 sollte FeedInactiveDate beispielsweise auf 2025-01-14 festgelegt werden, wenn alle Wahlen am oder vor dem 2024-12-31 beendet wurden. Der Wert kann noch später festgelegt werden, wenn Wahlen verschoben werden, wenn 2025 Stichwahlen stattfinden oder wenn Wahlereignisse auf andere Weise bis ins Jahr 2025 andauern.
IsTest 0 oder 1 boolean Gibt an, ob der Feed ein Test-Feed für Simulationen ist. Wenn nicht angegeben, wird false angenommen.
ElectionEventCollection 0 oder 1 ElectionEvent Enthält Informationen zu den Wahlen, die in diesem Feed behandelt werden. Dieser Wert wird nur für die Feedtypen PRE_ELECTION oder ELECTION_RESULTS berücksichtigt.
OfficeholderSubFeed 0 oder 1 OfficeholderSubFeed Enthält Informationen zu den Amtsinhabern, die in diesem Feed behandelt werden. Dieser Wert wird nur für den Feedtyp OFFICEHOLDER berücksichtigt.