Feed

Feed öğesi, belirli bir ülkeye ve CDF feed'i türüne karşılık gelen, zaman içindeki tek bir etkin veya yaklaşan CDF veri dosyaları akışını temsil eder. Daha fazla bilgi için Feed türleri başlıklı makaleyi inceleyin. Bir FeedDeliveryReport, kapsamları coğrafi kapsam, zaman aralığı veya ofis düzeyi açısından çakışmadığı sürece belirli bir ülke ve feed türü için birden fazla Feed öğesi içerebilir. Aşağıda geçerli kombinasyon örnekleri verilmiştir:

  • Tek bir FeedDeliveryReport hem ABD'deki görevlilerle ilgili Feed hem de ABD'deki seçim öncesi Feed (her zaman geçerli) içerebilir.
  • Tek bir FeedDeliveryReport, ABD'deki seçim öncesi Feed (2022) ve ABD'deki seçim öncesi Feed (2024) içerebilir.
  • Tek bir FeedDeliveryReport, ABD'de seçim öncesi Feed (yalnızca 2022 federal düzey) ve ABD'de seçim öncesi Feed (yalnızca 2022 eyalet düzeyi) içerebilir.
  • Tek bir FeedDeliveryReport, bir ABD'li resmi görevli Feed ve bir Japonya'da seçim öncesi Feed (yalnızca 2022 ulusal düzey) içerebilir ancak yalnızca her iki ülke de kapsam dahilindeyse.

Bir Feed, beklenen bir bitiş tarihi olduğu için (ör. seçimden 60 gün sonra) sınırlı bir süreye sahip olabilir veya "sürekli" olabilir. Bu durumda, beklenen bir bitiş tarihi yoktur ve sürekli olarak yenilenir.

Bir feed'in FeedInactiveDate tarihinden sonra 60 gün geçene kadar feed'i meta veri feed'inden kaldırmayın.

Öğeler

Öğe Çokluk Tür Açıklama
FeedId 1 string Feed'in kullanım ömrü boyunca benzersiz ve sabit bir tanımlayıcı. Feed'ler arasında yeniden kullanılamaz.
FeedName 1 string Feed'in kısa bir açıklaması (ör. "ABD'deki Kamu Görevlileri 2023").
FeedType 1 FeedType Bunun hangi tür CDF feed'i olduğunu gösterir.
FeedLongevity 1 FeedLongevity Feed'in kullanım ömrünü gösterir.
SourceDirPath 0 veya 1 FeedSourcePathUri Feed'in XML dosyasının tam nitelikli kaynak yolu URI'si.

Aşağıdaki dosya barındırma çözümleri desteklenir:

  • s3
  • ftp ve sftp
  • http ve https

Bu, meta veri feed'iyle aynı dosya barındırma çözümü üzerinden erişilebilir olmalıdır ancak veriler hazır olmadan önce boş olabilir.
SqsQueueName 0 veya 1 string Push bildirimlerinin etkinleştirildiği feed'ler için SQS kuyruğunun adı. Daha fazla bilgi için SQS Geliştirici Kılavuzu'na bakın. Bu ayar belirlenmezse feed güncellemeleri çekilir.
CountryCode 0 veya 1 string Bu feed'in kapsadığı ISO 3166-1 alfa-2 ülke kodu. FeedType, election-dates veya voter-information değilse zorunludur.
FeedInactiveDate 0 veya 1 date Feed'in artık güncellenmeyeceği ve alınmaması gerektiği tarihi belirten ISO-8601 biçiminde bir tarih.
  • evergreen feed'leri için, feed desteği sonlandırılmıyorsa bu özellik büyük olasılıkla hiç ayarlanmamalıdır.
  • limited özet akışları için bu süre, özet akışındaki son ElectionEvent'nin bitiş tarihinden iki hafta sonra veya seçim sonrası son güncellemenin beklendiği tarihten iki hafta sonra olarak ayarlanmalıdır. ElectionEvent, beklenen güncelleme olmadan iptal edilirse FeedInactiveDate, ElectionEvent için EndDate'den önce gelebilir.
  • yearly feed'leri için (limited feed'lerinde olduğu gibi) bu süre, son ElectionEvent'nin bitiş tarihinden en az iki hafta sonra olmalıdır. Ayrıca, feed'in ait olduğu yılın bitiminden iki hafta öncesine de ayarlanmamalıdır. Örneğin, 2024 feed'i için FeedInactiveDate, tüm seçimlerin 2024-12-31 tarihinde veya öncesinde sona erdiği genel durumda 2025-01-14 olarak ayarlanmalıdır. Seçimler ertelenirse, 2025'te ikinci tur seçimleri yapılırsa veya seçim etkinlikleri 2025'e kadar devam ederse bu tarih daha da ileriye alınabilir.
IsTest 0 veya 1 boolean Feed'in simülasyonlar için bir test feed'i olup olmadığı. Belirtilmemişse false olduğu varsayılır.
ElectionEventCollection 0 veya 1 ElectionEvent Bu feed'in kapsadığı seçimlerle ilgili bilgileri içerir. Bu yalnızca PRE_ELECTION veya ELECTION_RESULTS feed türleri için geçerlidir.
OfficeholderSubFeed 0 veya 1 OfficeholderSubFeed Bu feed'in kapsadığı görevliler hakkında bilgiler içerir. Bu yalnızca OFFICEHOLDER feed türü için geçerlidir.