Кормить

Сущность Feed представляет собой отдельный активный или ожидаемый поток файлов данных CDF за определенный период времени, соответствующий конкретной стране и типу потока данных CDF. Более подробную информацию см. в разделе «Типы потоков данных» . Объект FeedDeliveryReport может содержать несколько сущностей Feed для данной страны и типа потока данных, при условии, что их области действия не перекрываются ни по географическому охвату, ни по временным рамкам, ни по уровню офиса. Ниже приведены примеры допустимых комбинаций:

  • Один FeedDeliveryReport может содержать как Feed о должностных лицах США, так и предвыборную Feed США (актуальную на постоянной основе).
  • Один FeedDeliveryReport может содержать Feed о предвыборных выборах в США (2022 г.) и Feed о предвыборных выборах в США (2024 г.).
  • Один FeedDeliveryReport может содержать Feed о выборах в США (только на федеральном уровне в 2022 году) и Feed о выборах в США (только на уровне штатов в 2022 году).
  • Один FeedDeliveryReport может содержать Feed выборах должностного лица США и предвыборную Feed мирового судьи (только на национальном уровне в 2022 году), но только если обе страны входят в сферу охвата.

Feed либо имеет ограниченный срок действия, поскольку существует ожидаемая дата окончания (например, через 60 дней после выборов), либо является «вечнозеленой», то есть у нее нет ожидаемой даты окончания, и она постоянно обновляется.

Подождите 60 дней после даты, когда фид FeedInactiveDate , прежде чем удалять его из метаданных фида.

Элементы

Имя Ярлык Тип Примечания Множественность
Идентификатор ленты FeedId string Уникальный и стабильный идентификатор на протяжении всего срока службы корма. Не может быть использован повторно для разных кормов. 1
Название корма FeedName string Краткое описание для ленты, например, "Должностные лица США 2023". 1
Тип корма FeedType FeedType Указывает, к какому типу корма CDF относится данный продукт. 1
Продолжительность жизни корма FeedLongevity FeedLongevity Указывает срок службы корма. 1
Место кормления SourceDirPath string Полный URI XML-файла фида (поддерживаются только ftp и http ). Должен быть доступен через то же решение для размещения файлов, что и фид метаданных (но может быть пустым до того, как данные будут готовы). 0 или 1
Код страны CountryCode string Код страны ISO 3166-1 alpha-2, к которой относится данный канал. Обязательно, если FeedType не имеет значения election-dates или voter-information . 0 или 1
Дата прекращения использования корма FeedInactiveDate date Дата в формате ISO-8601, указывающая, когда обновление фида прекращается и прием данных прекращается.
  • Для evergreen кормов этот параметр, скорее всего, вообще не следует устанавливать, если только данный корм не устаревает.
  • Для лент limited сообщений это значение следует установить на две недели после даты окончания последнего ElectionEvent в ленте или на две недели после ожидаемого последнего обновления после выборов. Обратите внимание, что если ElectionEvent , отменено без ожидаемых обновлений, то FeedInactiveDate может предшествовать EndDate для ElectionEvent .
  • Для yearly лент, как и для лент с limited записей, этот параметр следует установить как минимум на две недели позже даты окончания последнего ElectionEvent , но также не раньше, чем через две недели после окончания года, для которого предназначена лента. Например, для ленты за 2024 год параметр FeedInactiveDate следует установить на 2025-01-14 в типичном случае, когда все выборы закончились не позднее 2024-12-31 . Его можно установить даже позже, если выборы будут отложены, если в 2025 году состоятся вторые туры выборов или если события, связанные с выборами, продолжатся в 2025 году.
 0 или 1
Сбор данных о событиях выборов ElectionEventCollection ElectionEvent Содержит информацию о выборах, освещаемых в этом канале. Это правило действует только для типов каналов PRE_ELECTION или ELECTION_RESULTS . 0 или 1
Подканал новостей для должностных лиц OfficeholderSubFeed OfficeholderSubFeed Содержит информацию о должностных лицах, охватываемых данной лентой новостей. Это относится только к типу ленты новостей OFFICEHOLDER . 0 или 1