Feed

Entitas Feed merepresentasikan satu aliran aktif atau mendatang dari file data CDF dari waktu ke waktu yang sesuai dengan negara dan jenis feed CDF tertentu. Untuk mengetahui detail selengkapnya, lihat Jenis feed. FeedDeliveryReport dapat berisi beberapa entitas Feed untuk negara dan jenis feed tertentu, asalkan cakupannya tidak tumpang-tindih, baik berdasarkan cakupan geografis, jangka waktu, atau tingkat kantor. Berikut adalah contoh kombinasi yang valid:

  • Satu FeedDeliveryReport dapat berisi Feed pejabat terpilih Amerika Serikat dan Feed pra-pemilu Amerika Serikat (selalu aktif).
  • Satu FeedDeliveryReport dapat berisi Feed pra-pemilu AS (2022) dan Feed pra-pemilu AS (2024).
  • Satu FeedDeliveryReport dapat berisi Feedpra-pemilu Amerika Serikat (Khusus Tingkat Federal 2022) dan berisi Feedpra-pemilu Amerika Serikat (Khusus Tingkat Negara Bagian 2022).
  • Satu FeedDeliveryReport dapat berisi pemegang jabatan di Amerika Serikat Feed dan Feed pra-pemilu Jepang (Khusus Tingkat Nasional 2022), tetapi hanya jika kedua negara tersebut tercakup.

Feed memiliki durasi terbatas, karena ada perkiraan tanggal akhir (seperti 60 hari setelah pemilu), atau "selalu baru", yang berarti tidak ada perkiraan tanggal akhir dan terus diperbarui.

Tunggu hingga 60 hari setelah FeedInactiveDate feed sebelum menghapusnya dari feed metadata.

Elemen

Elemen Keanekaragaman Jenis Deskripsi
FeedId 1 string ID yang unik dan stabil untuk masa aktif feed. Tidak dapat digunakan kembali di seluruh feed.
FeedName 1 string Deskripsi singkat untuk feed, seperti "Pejabat AS 2023".
FeedType 1 FeedType Menunjukkan jenis feed CDF ini.
FeedLongevity 1 FeedLongevity Menunjukkan masa aktif feed.
SourceDirPath 0 atau 1 FeedSourcePathUri URI jalur sumber yang sepenuhnya memenuhi syarat dari file XML feed.

Solusi hosting file berikut didukung:

  • s3
  • ftp dan sftp
  • http dan https

File ini harus dapat diakses melalui solusi hosting file yang sama dengan feed metadata, tetapi dapat kosong sebelum data siap.
CountryCode 0 atau 1 string Kode negara ISO 3166-1 alpha-2 yang dicakup oleh feed ini. Wajib jika FeedType bukan election-dates atau voter-information.
FeedInactiveDate 0 atau 1 date Tanggal dalam format ISO-8601 yang menunjukkan kapan feed tidak akan lagi diperbarui dan tidak boleh lagi di-crawl.
  • Untuk feed evergreen, kolom ini kemungkinan besar tidak boleh ditetapkan sama sekali kecuali jika feed tersebut tidak digunakan lagi.
  • Untuk feed limited, ini harus ditetapkan ke dua minggu setelah tanggal berakhirnya ElectionEvent terakhir dalam feed atau dua minggu setelah pembaruan pasca-pemilu terakhir diperkirakan. Perhatikan bahwa jika ElectionEvent dibatalkan tanpa pembaruan yang diharapkan, maka FeedInactiveDate dapat mendahului EndDate untuk ElectionEvent.
  • Untuk feed yearly, seperti feed limited, tanggal ini harus ditetapkan setidaknya dua minggu setelah tanggal akhir ElectionEvent terakhir, tetapi juga tidak boleh lebih awal dari dua minggu setelah akhir tahun feed tersebut. Misalnya, untuk feed 2024, FeedInactiveDate harus disetel ke 2025-01-14 dalam kasus umum ketika semua pemilu telah berakhir pada atau sebelum 2024-12-31. Tanggal ini dapat ditetapkan lebih lanjut jika pemilu ditunda, jika putaran kedua terjadi pada tahun 2025, atau jika acara pemilu berlanjut hingga tahun 2025.
ElectionEventCollection 0 atau 1 ElectionEvent Berisi informasi tentang pemilu yang dicakup oleh feed ini. Atribut ini hanya diperhatikan untuk jenis feed PRE_ELECTION atau ELECTION_RESULTS.
OfficeholderSubFeed 0 atau 1 OfficeholderSubFeed Berisi informasi tentang pemegang jabatan yang tercakup dalam feed ini. Ini hanya diperhatikan untuk jenis feed OFFICEHOLDER.