Feed

Uma entidade Feed representa um único stream ativo ou futuro de arquivos de dados CDF ao longo do tempo que correspondem a um país específico e a um tipo de feed CDF. Para mais detalhes, consulte Tipos de feed. Um FeedDeliveryReport pode conter várias entidades Feed para um determinado país e tipo de feed, desde que os escopos não se sobreponham, seja por escopo geográfico período ou nível de cargo. Confira alguns exemplos de combinações válidas:

  • Um único FeedDeliveryReport pode conter um Feed de titulares de cargos dos EUA e um Feed pré-eleitoral dos EUA (conteúdo atemporal).
  • Um único FeedDeliveryReport pode conter um Feed pré-eleitoral dos EUA (2022) e um Feed pré-eleitoral dos EUA (2024).
  • Um único FeedDeliveryReport pode conter um Feed pré-eleitoral dos EUA (somente nível federal) e um Feed pré-eleitoral dos EUA (somente nível estadual).
  • Um único FeedDeliveryReport pode conter um Feed de titulares de cargos dos EUA e um Feed pré-eleitoral do Japão (somente nível nacional) apenas se ambos os países estiverem no escopo.

Um Feed tem uma duração limitada, porque há uma data de término esperada (como 60 dias após uma eleição), ou é "perene", o que significa que não há uma data de término esperada e ele é atualizado continuamente.

Aguarde 60 dias após a FeedInactiveDate de um feed antes de removê-lo do feed de metadados.

Elementos

Elemento Multiplicidade Tipo Descrição
FeedId 1 string Um identificador exclusivo e estável para a vida útil do feed. Não pode ser reutilizado em outros feeds.
FeedName 1 string Uma breve descrição do feed, como "Titulares de cargos dos EUA 2023".
FeedType 1 FeedType Indica o tipo de feed CDF.
FeedLongevity 1 FeedLongevity Indica a vida útil do feed.
SourceDirPath 0 ou 1 FeedSourcePathUri URI do caminho de origem totalmente qualificado do arquivo XML do feed.

As seguintes soluções de hospedagem de arquivos são compatíveis:

  • s3
  • ftp e sftp
  • http e https

Ele precisa estar acessível pela mesma solução de hospedagem de arquivos que o feed de metadados, mas pode estar vazio antes que os dados estejam prontos.
SqsQueueName 0 ou 1 string O nome do recurso da Amazon (ARN) totalmente qualificado da fila do SQS para feeds com notificações push ativadas (por exemplo, arn:aws:sqs:region:account-id:queue-name). Para mais detalhes, consulte o Guia do desenvolvedor do SQS. Se isso não for definido, as atualizações do feed serão extraídas.
CountryCode 0 ou 1 string O código de país no formato ISO 3166-1 alfa-2 que esse feed abrange. Obrigatório se FeedType não for election-dates ou voter-information.
FeedInactiveDate 0 ou 1 date Uma data no formato ISO-8601 que indica quando o feed não será mais atualizado e não deverá mais ser ingerido.
  • Para feeds evergreen, isso provavelmente não será definido, a menos que o feed esteja sendo descontinuado.
  • Para limited feeds, isso precisa ser definido como duas semanas após a data de término do último ElectionEvent no feed ou duas semanas após a última atualização pós-eleitoral esperada. Observe que, se um ElectionEvent for cancelado sem atualizações esperadas, a FeedInactiveDate poderá preceder a EndDate do ElectionEvent.
  • Para feeds yearly, como os limited feeds, isso precisa ser definido como pelo menos duas semanas após a data de término do último ElectionEvent, mas também não pode ser antes de duas semanas após o final do ano para o qual o feed é. Por exemplo, para um feed de 2024, o FeedInactiveDate precisa ser definido como 2025-01-14 no caso comum em que todas as eleições terminaram em ou antes de 2024-12-31. Ela pode ser definida ainda mais tarde se as eleições forem adiadas, se houver segundo turno em 2025 ou se os eventos eleitorais continuarem em 2025.
IsTest 0 ou 1 boolean Indica se o feed é um feed de teste para simulações. É considerado false se não for especificado.
ElectionEventCollection 0 ou 1 ElectionEvent Contém informações sobre as eleições cobertas por esse feed. Isso só é é respeitado para os tipos de feed PRE_ELECTION ou ELECTION_RESULTS.
OfficeholderSubFeed 0 ou 1 OfficeholderSubFeed Contém informações sobre os titulares de cargos cobertos por esse feed. Isso só é respeitado para o tipo de feed OFFICEHOLDER.