Feed

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

  • Ein einzelnes FeedDeliveryReport kann sowohl ein Feed für US-Amtsträger als auch ein Feed für die Vorwahl in den USA (immergrün) enthalten.
  • Ein einzelnes FeedDeliveryReport kann eine Feed für die Vorwahlen in den USA (2022) und eine Feed für die Vorwahlen in den USA (2024) enthalten.
  • Ein einzelnes FeedDeliveryReport kann eine Feed für die Vorwahl in den USA (nur auf Bundesebene, 2022) und eine Feed für die Vorwahl in den USA (nur auf Bundesstaatsebene, 2022) enthalten.
  • Ein einzelnes FeedDeliveryReport kann einen US-Amtsinhaber Feed und einen japanischen Kandidaten vor der Wahl Feed (nur auf nationaler Ebene 2022) enthalten, aber nur, wenn beide Länder im Geltungsbereich liegen.

Eine Feed hat entweder eine begrenzte Laufzeit, weil es ein erwartetes Enddatum gibt (z. B. 60 Tage nach einer Wahl), oder sie ist „immergrün“, d. h., es gibt kein erwartetes Enddatum und sie wird fortlaufend aktualisiert.

Warten Sie 60 Tage nach dem FeedInactiveDate eines Feeds, bevor Sie ihn aus dem Metadatenfeed entfernen.

Elemente

Element Multiplizität Typ Beschreibung
FeedId 1 string Eine eindeutige und stabile Kennung für die Lebensdauer des Feeds. Nicht in mehreren Feeds verwendbar.
FeedName 1 string Eine kurze Beschreibung des Feeds, z. B. „US Officeholders 2023“ (US-Amtsträger 2023).
FeedType 1 FeedType Gibt an, um welche Art von CDF-Feed es sich handelt.
FeedLongevity 1 FeedLongevity Gibt die Lebensdauer des Feeds an.
SourceDirPath 0 oder 1 FeedSourcePathUri Vollständig qualifizierter Quellpfad-URI der XML-Datei des Feeds.

Die folgenden Dateihosting-Lösungen werden unterstützt:

  • s3
  • ftp und sftp
  • http und https

Diese muss über dieselbe Dateihostinglösung wie der Metadatenfeed zugänglich sein, kann aber leer sein, bevor die Daten bereit sind.
SqsQueueName 0 oder 1 string Der Name der SQS-Warteschlange für Feeds, für die Push-Benachrichtigungen aktiviert sind. Weitere Informationen finden Sie im SQS-Entwicklerleitfaden. Wenn diese Option nicht festgelegt ist, werden die Feedupdates stattdessen abgerufen.
CountryCode 0 oder 1 string Der ISO 3166-1 Alpha-2-Ländercode, der in diesem Feed enthalten ist. 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 wird 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 auf zwei Wochen nach dem erwarteten Datum des letzten Updates nach der Wahl festgelegt werden. Wenn ein ElectionEvent ohne erwartete Updates storniert wird, kann das FeedInactiveDate dem EndDate für das ElectionEvent vorangehen.
  • Bei yearly-Feeds sollte dieses Feld 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 bestimmt ist. 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. Das Datum kann sich auch noch weiter nach hinten verschieben, wenn Wahlen verschoben werden, wenn 2025 Stichwahlen stattfinden oder wenn Wahlereignisse anderweitig bis ins Jahr 2025 andauern.
IsTest 0 oder 1 boolean Gibt an, ob der Feed ein Testfeed für Simulationen ist. Wenn keine Angabe erfolgt, wird false angenommen.
ElectionEventCollection 0 oder 1 ElectionEvent Enthält Informationen zu Wahlen, die in diesem Feed behandelt werden. Dies wird nur für die Feedtypen PRE_ELECTION oder ELECTION_RESULTS berücksichtigt.
OfficeholderSubFeed 0 oder 1 OfficeholderSubFeed Enthält Informationen zu den Amtsträgern, die in diesem Feed enthalten sind. Dies wird nur für den Feedtyp OFFICEHOLDER berücksichtigt.