Кормить

Сущность 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 1 string Уникальный и стабильный идентификатор на протяжении всего срока службы корма. Не может быть использован повторно для разных кормов.
FeedName 1 string Краткое описание для ленты, например, "Должностные лица США 2023".
FeedType 1 FeedType Указывает, к какому типу корма CDF относится данный продукт.
FeedLongevity 1 FeedLongevity Указывает срок службы корма.
SourceDirPath 0 или 1 FeedSourcePathUri Полный URI пути к XML-файлу фида.

Поддерживаются следующие решения для размещения файлов:

  • s3
  • ftp и sftp
  • http и https

Доступ к этому разделу должен осуществляться через то же решение для размещения файлов, что и к потоку метаданных, но он может быть пустым до того, как данные будут готовы.

CountryCode 0 или 1 string Код страны ISO 3166-1 alpha-2, к которой относится данный канал. Обязательно, если FeedType не имеет значения election-dates или voter-information .
FeedInactiveDate 0 или 1 date Дата в формате ISO-8601, указывающая, когда обновление фида прекращается и прием данных прекращается.
  • Для evergreen кормов этот параметр, скорее всего, вообще не следует устанавливать, если только данный корм не устаревает.
  • Для лент limited сообщений это значение следует установить на две недели после даты окончания последнего ElectionEvent в ленте или на две недели после ожидаемого последнего обновления после выборов. Обратите внимание, что если ElectionEvent , отменено без ожидаемых обновлений, то FeedInactiveDate может предшествовать EndDate для ElectionEvent .
  • Для yearly лент, как и для лент с limited записей, этот параметр следует установить как минимум на две недели позже даты окончания последнего ElectionEvent , но также не раньше, чем через две недели после окончания года, для которого предназначена лента. Например, для ленты за 2024 год параметр FeedInactiveDate следует установить на 2025-01-14 в типичном случае, когда все выборы закончились не позднее 2024-12-31 . Его можно установить даже позже, если выборы будут отложены, если в 2025 году состоятся вторые туры выборов или если события, связанные с выборами, продолжатся в 2025 году.
ElectionEventCollection 0 или 1 ElectionEvent Содержит информацию о выборах, освещаемых в этом канале. Это правило действует только для типов каналов PRE_ELECTION или ELECTION_RESULTS .
OfficeholderSubFeed 0 или 1 OfficeholderSubFeed Содержит информацию о должностных лицах, охватываемых данной лентой новостей. Это относится только к типу ленты новостей OFFICEHOLDER .