Feed

Un'entità Feed rappresenta un singolo flusso attivo o imminente di file di dati CDF nel tempo che corrispondono a un paese specifico e a un tipo di feed CDF. Per maggiori dettagli, vedi Tipi di feed. Un FeedDeliveryReport può contenere più entità Feed per un determinato paese e tipo di feed, purché i loro ambiti non si sovrappongano per ambito geografico, periodo di tempo o livello di ufficio. Di seguito sono riportati alcuni esempi di combinazioni valide:

  • Un singolo FeedDeliveryReport può contenere sia un Feed di un funzionario statunitense sia un Feed pre-elettorale statunitense (sempreverde).
  • Un singolo FeedDeliveryReport può contenere un Feed pre-elettorale statunitense (2022) e un Feed pre-elettorale statunitense (2024).
  • Un singolo FeedDeliveryReport può contenere un Feed pre-elettorale statunitense (solo a livello federale 2022) e un Feed pre-elettorale statunitense (solo a livello statale 2022).
  • Un singolo FeedDeliveryReport può contenere un funzionario statunitense Feed e un annuncio pre-elettorale giapponese Feed (solo a livello nazionale del 2022), ma solo se entrambi i paesi rientrano nell'ambito.

Un Feed ha una durata limitata, perché è prevista una data di fine (ad esempio 60 giorni dopo un'elezione), oppure è "evergreen", il che significa che non è prevista una data di fine ed è continuamente aggiornato.

Attendi 60 giorni dopo il FeedInactiveDate di un feed prima di rimuoverlo dal feed di metadati.

Elementi

Nome Tag Tipo Note Molteplicità
ID feed FeedId string Un identificatore univoco e stabile per la durata del feed. Non riutilizzabile in più feed. 1
Nome feed FeedName string Una breve descrizione del feed, ad esempio "Funzionari pubblici degli Stati Uniti 2023". 1
Tipo di feed FeedType FeedType Indica il tipo di feed CDF. 1
Durata del feed FeedLongevity FeedLongevity Indica la durata del feed. 1
Posizione del feed SourceDirPath string URI completo del file XML del feed (sono supportati solo ftp e http). Deve essere accessibile tramite la stessa soluzione di hosting di file del feed di metadati (ma può essere vuoto prima che i dati siano pronti). 0 o 1
Codice paese CountryCode string Il codice paese ISO 3166-1 alpha-2 coperto da questo feed. Obbligatorio se FeedType non è election-dates o voter-information. 0 o 1
Data di inattività del feed FeedInactiveDate date Una data nel formato ISO-8601 che indica quando il feed non verrà più aggiornato e non deve più essere importato.
  • Per i feed evergreen, è molto probabile che non debba essere impostato a meno che il feed non venga ritirato.
  • Per i feed limited, questo valore deve essere impostato su due settimane dopo la data di fine dell'ultimo ElectionEvent nel feed o due settimane dopo l'ultimo aggiornamento post-elettorale previsto. Tieni presente che se un ElectionEvent viene annullato senza aggiornamenti previsti, il FeedInactiveDate può precedere il EndDate per il ElectionEvent.
  • Per i feed yearly, come per i feed limited, questa data deve essere impostata almeno due settimane dopo la data di fine dell'ultimo ElectionEvent, ma non deve essere precedente di due settimane alla fine dell'anno a cui si riferisce il feed. Ad esempio, per un feed del 2024, FeedInactiveDate deve essere impostato su 2025-01-14 nel caso comune in cui tutte le elezioni si sono concluse entro il giorno 2024-12-31. Potrebbe essere impostata anche in un secondo momento se le elezioni vengono rinviate, se si verificano ballottaggi nel 2025 o se gli eventi elettorali continuano nel 2025.
0 o 1
Raccolta di eventi elettorali ElectionEventCollection ElectionEvent Contiene informazioni sulle elezioni coperte da questo feed. Questa proprietà viene rispettata solo per i tipi di feed PRE_ELECTION o ELECTION_RESULTS. 0 o 1
Feed secondario del pubblico ufficiale OfficeholderSubFeed OfficeholderSubFeed Contiene informazioni sulle cariche coperte da questo feed. Questo valore viene rispettato solo per il tipo di feed OFFICEHOLDER. 0 o 1