Use Contest para descrever uma disputa e vincular os candidatos e partidos associados.
Neste documento, discutimos Contest e as subentidades:
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
Tipos
Contest é um elemento abstrato com três tipos que são usados com base no tipo de contestação:
CandidateContest: use esse tipo quando umaContestenvolver um ou mais candidatos a um cargo.PartyContest: use esse tipo quando umContesttiver uma seleção de lista de partidos na cédula. Isso também pode ser usado como um concurso virtual, que é um resumo de um conjunto maior de concursos menores.BallotMeasureContest: use esse tipo quando umaContestenvolver uma ou mais medidas eleitorais.RetentionContest: use esse tipo quando umContestenvolver um referendo para decidir se um funcionário eleito deve permanecer no cargo ou ser removido dele.
Conforme os resultados de uma eleição são divulgados, você pode atualizar seu feed para mostrar
diferentes estágios dos resultados, como pesquisas de boca de urna ou estimativas. O Google
fornece orientações sobre quais etapas eleitorais e tipos de resultados esperamos. O Google
pode solicitar uma ou várias etapas. Esses valores de tipo de estágio podem mudar durante
a noite da eleição. Defina o valor inicial do feed como o estágio inicial. Para mais
detalhes, consulte CurrentResultsReportingStage e
ResultsReportingStageCollection na seção Elementos.
Atributos
A tabela a seguir descreve os atributos de Contest:
| Atributo | Obrigatório? | Tipo | Descrição |
|---|---|---|---|
objectId |
Obrigatório | ID |
Identificador interno exclusivo usado por outros elementos para fazer referência a este elemento. |
Elementos
A tabela a seguir descreve os elementos de Contest:
| Elemento | Multiplicidade | Tipo | Descrição |
|---|---|---|---|
Abbreviation |
0 ou 1 | string |
Nome curto do concurso. |
AggregateBallotSelection |
0 ou 1 | SpecialBallotSelection |
Seleção de cédulas para agregações de contagem de votos, como agregar vários candidatos em "Outros". |
BallotSelection |
0 ou mais | BallotSelection |
Associa as seleções na cédula à disputa. A ordem
dos candidatos ou partidos em Se |
BallotSubTitle |
0 ou 1 | InternationalizedText |
Subtítulo da disputa, que precisa corresponder ao que aparece nas cédulas dos eleitores. |
BallotTitle |
0 ou 1 | InternationalizedText |
Título do concurso. O texto do título precisa seguir o guia de sintaxe. Para disputas de referendos, o título precisa corresponder ao texto da cédula. |
BlankBallotSelection |
0 ou 1 | SpecialBallotSelection |
Seleção de cédulas para cédulas em branco. |
ComposingContestIds |
0 ou mais | IDREFS |
Usado para definir uma contestação de rollup. Por exemplo, na eleição presidencial geral dos EUA, há uma disputa nacional com IDs de disputa compostos para cada uma das eleições estaduais. Um |
ContestDateStatus |
0 ou 1 |
DateStatus
|
Esse elemento indica atualizações de programação para uma eleição. O
valor padrão é |
ContestDateType |
0 ou 1 |
ElectionDateType
|
Esse elemento indica como o concurso é adicionado ao calendário.
Se omitido, o valor padrão será o |
CountingDate |
0 ou 1 | PartialDate |
A data pós-votação em que ocorre a contagem para a disputa eleitoral.
Isso só deve ser incluído se o dia da contagem for diferente do
último dia de votação, como na eleição da Lok Sabha na Índia. O caso
comum é que a contagem aconteça no mesmo dia do último dia de votação,
ou seja, o EndDate da eleição.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
O estágio atual de divulgação dos resultados do concurso. |
EarliestPollsClose |
0 ou 1 | dateTime |
Quando as primeiras urnas forem fechadas. |
ElectoralDistrictId |
1 | IDREF |
Identificador exclusivo de um elemento
Por exemplo, para uma disputa específica, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Associa um ID ao concurso. É necessário um identificador estável. |
EndDate |
0 ou 1 | PartialDate |
A data de término do concurso. Use a data em que a votação
termina, como 2022-11-08. A data de término só deve ser definida se as datas de início
e término do Contest forem diferentes das datas de início e término
do Election.
|
EstimatedExpectedVotePercentage |
0 ou 1 | float |
Muitas vezes abreviado como EEVP, é a porcentagem estimada do total de votos esperados que foi relatada para essa disputa, como um número entre 0 e 100. Por exemplo, informe 24,2% como |
FilingDeadline |
0 ou 1 | PartialDate |
A data em que um candidato precisa se inscrever para a disputa. |
HasRotation |
0 ou 1 | boolean |
Indica se as seleções na disputa são alternadas. Se esse
elemento não estiver presente, o valor padrão será false. |
IsNotable |
0 ou 1 | boolean |
Se a entidade é considerada relevante. Será considerado false
se não for especificado.
|
LatestPollsClose |
0 ou 1 | dateTime |
Quando as últimas urnas forem fechadas. |
Name |
1 | string |
Ele precisa corresponder ao BallotTitle em inglês e à sintaxe do título. |
NoneOfTheAboveBallotSelection |
0 ou 1 | SpecialBallotSelection |
Seleção de cédula para a opção em uma cédula para votar em "Nenhuma das opções acima" ou alguma seleção equivalente, como "Nenhuma", "Nenhuma destas" ou "Não comprometido". |
NullBallotSelection |
0 ou 1 | SpecialBallotSelection |
Seleção de cédulas nulas ou estragadas. São cédulas que foram marcadas de forma que o voto não pode ser contado corretamente. Exemplos de cédulas nulas são aquelas que foram rasgadas, sujas, marcadas em excesso ou de forma insuficiente, ou marcadas de uma forma que identifique o eleitor. |
OutcomeDetermined |
0 ou 1 | boolean |
Se o resultado da eleição foi determinado.
|
Seat |
0 ou 1 | string |
O cargo específico da disputa. |
SequenceOrder |
0 ou 1 | integer |
A ordem padrão dos elementos
|
StartDate |
0 ou 1 | PartialDate |
A data de início do concurso. Use a data em que a pesquisa
começa, como 2022-11-08. A data de início só deve ser definida se as datas de início e término do Contest forem diferentes das datas de início e término do Election.
|
SubsequentContestId |
0 ou 1 | IDREF |
Usado para apontar para um concurso posterior no mesmo conjunto relacionado. Nas eleições dos EUA, por exemplo, geralmente aponta de uma eleição primária para a eleição geral relacionada. Também pode apontar de uma eleição geral para um segundo turno. Uma |
SubUnitsReported |
0 ou 1 | integer |
O número de subunidades que concluíram a contagem de votos para esta disputa. |
SummaryCounts |
0 ou mais | SummaryCounts |
Fornece um resumo de várias contagens associadas à
disputa. Isso inclui o número total de cédulas que contêm a
disputa e o número total de abstenções, votos em excesso, votos insuficientes ou
votos por escrito. As contagens de resumo podem ser associadas à disputa como um todo ou a outras unidades de relatório de nível inferior usando várias ocorrências de SummaryCounts. |
TotalSeats |
0 ou 1 | integer |
O número total de assentos que o distrito eleitoral para essa disputa pode ter para o cargo. Isso equivale a cadeiras disponíveis para eleição + cadeiras mantidas + cadeiras vagas. |
TotalSubUnits |
0 ou 1 | integer |
O número total de subunidades que têm essa disputa na cédula. |
VoteVariation |
0 ou 1 | VoteVariation |
O tipo de variação de voto associado à disputa, como
n-of-m. |
OtherVoteVariation |
0 ou 1 | string |
Usado para fornecer um valor personalizado quando VoteVariation é
other. |
ResultsEmbargoEnd |
0 ou 1 | dateTime |
Quando um embargo à publicação de resultados eleitorais termina. |
ResultsExpected |
0 ou 1 | dateTime |
Quando os primeiros resultados da contagem de votos devem aparecer no feed. |
ResultsLastUpdated |
0 ou 1 | dateTime |
Quando os resultados da disputa foram atualizados pela última vez. |
ResultsReportingStageCollection |
0 ou 1 | N/A |
Elemento wrapper para definições de Para um concurso de composição (referenciado pelo |
CandidateContest
Use CandidateContest para descrever uma disputa que envolve a seleção de um
ou mais candidatos.
Essa entidade pode referenciar Office
ou Party por ID. Não oferecemos suporte à
representação de uma chapa de candidatos na mesma disputa. Só é possível
fazer referência a um Office. Por exemplo, para
uma chapa de presidente e vice-presidente, você precisaria de duas
disputas Candidate. Cada um
faria referência a um escritório diferente.
Elementos
A tabela a seguir descreve os elementos de CandidateContest:
| Elemento | Multiplicidade | Tipo | Descrição |
|---|---|---|---|
NumberElected |
0 ou 1 | integer |
O número de candidatos eleitos na disputa, que é o
n de uma disputa n-of-m. Se
NumberElected não estiver presente no feed, um valor padrão de
1 será usado. |
OfficeIds |
1 | IDREFS |
Identificador exclusivo de um ou mais elementos
Office. Associa uma descrição de cargo à disputa. |
PrimaryPartyIds |
0 ou mais | IDREFS |
Identificador exclusivo de um ou mais elementos
Party,
que indicam que o Contest faz parte de uma
primária partidária. PrimaryPartyId só é significativo em uma
eleição primária. |
VotesAllowed |
1 | integer |
O número máximo de votos ou candidatos não listados permitidos por eleitor neste
concurso. Se VotesAllowed não estiver presente no feed, um
valor padrão de 1 será usado. |
Type |
0 ou mais | ElectionType |
O tipo enumerado de uma disputa, como primária ou geral. O tipo
de Contest só deve ser definido se for diferente do tipo
de Election. |
Exemplos
XML
<Contest xsi:type="CandidateContest" objectId="c-1-001"> <Abbreviation>KENYAPRES</Abbreviation> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kenyatta">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-odinga">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-mudavadi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kenneth">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-dida">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-karua">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kiyiapi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-muite">...</BallotSelection> <BallotTitle> <Text language="en">2022 Kenya Presidential election</Text> <Text language="es">2022 Elecciones presidenciales de Kenia</Text> <Text language="fr">2022 Élection présidentielle au Kenya</Text> </BallotTitle> <CountStatus>...</CountStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <Name>2022 Kenya Presidential election</Name> <StartDate>2022-08-09</StartDate> <SubUnitsReported>48</SubUnitsReported> <SummaryCounts>...</SummaryCounts> <TotalSubUnits>48</TotalSubUnits> <VoteVariation>1-of-m</VoteVariation> <NumberElected>1</NumberElected> <OfficeIds>off-9999a</OfficeIds> <VotesAllowed>1</VotesAllowed> <Type>general</Type> </Contest>
PartyContest
Use PartyContest para uma disputa em que os eleitores escolhem um partido na cédula.
Isso também pode ser usado em um feed de resultados de eleições como uma disputa de resumo virtual
para comunicar dados agregados (por exemplo, uma disputa de partido em nível estadual que
agrega resultados de disputas de eleitorado).
Elementos
A tabela a seguir descreve os elementos de PartyContest:
| Elemento | Multiplicidade | Tipo | Descrição |
|---|---|---|---|
NumberElected |
0 ou 1 | integer |
O número de candidatos eleitos na disputa, que é o
n de uma disputa n-of-m. Se NumberElected
não estiver presente no feed, um valor padrão de 1 será
usado. |
VotesAllowed |
0 ou 1 | integer |
O número máximo de votos ou candidatos não listados permitidos por eleitor neste
concurso. Se VotesAllowed não estiver presente no feed, um
valor padrão de 1 será usado. |
OfficeIds |
1 | IDREFS |
Identificador exclusivo de um ou mais elementos Office.
Associa uma descrição de cargo à disputa. |
Type |
0 ou mais | ElectionType |
O tipo enumerado de uma disputa, como primária ou geral. O tipo
de Contest só deve ser definido se for diferente do tipo
de Election. |
Exemplos
XML
<Contest xsi:type="PartyContest" objectId="c-20001"> <BallotSelection objectId="ps-101321" xsi:type="PartySelection"> <PartyIds>par-10132</PartyIds> </BallotSelection> <BallotSelection objectId="ps-101322" xsi:type="PartySelection"> <PartyIds>par-10133</PartyIds> </BallotSelection> <BallotTitle> <Text language="en">Ballot title example</Text> </BallotTitle> <ContestDateStatus>confirmed</ContestDateStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <ExternalIdentifiers>...</ExternalIdentifiers> <Name>Contest name example</Name> <StartDate>2022-08-09</StartDate> <VoteVariation>1-of-m</VoteVariation> <OfficeIds>off-9999a</OfficeIds> <Type>general</Type> <VotesAllowed>1</VotesAllowed> </Contest>
BallotMeasureContest
Use BallotMeasureContest para uma disputa que envolve medidas eleitorais.
Elementos
A tabela a seguir descreve os elementos de BallotMeasureContest:
| Elemento | Multiplicidade | Tipo | Descrição |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
O título oficial da votação, como Alguns referendos têm um único título coletivo com várias
perguntas numeradas. Nesses casos, o título pode incluir o número da pergunta para distinguir as entidades |
BallotSubTitle |
0 ou 1 | InternationalizedText |
O subtítulo da votação, se houver. |
BallotText |
1 | InternationalizedText |
O texto que aparece na própria cédula. Por exemplo: Shall
Article 4 of the Nevada Constitution be amended to require, beginning in
calendar year 2022, that all providers of electric utility services who
sell electricity... in Nevada comes from renewable energy
resources? |
FullText |
0 ou 1 | InternationalizedText |
Uma cópia do texto completo da medida eleitoral. Forneça esse elemento se houver texto adicional não incluído na própria cédula. Limitado a 30.000 caracteres. Se o texto completo da medida eleitoral tiver menos de 30.000
caracteres e não incluir nenhuma formatação inválida em um arquivo de feed, inclua-o em |
InfoUri |
0 ou 1 | AnnotatedUri |
Um URI anotado que aceita as seguintes anotações, em vez daquelas listadas em outros lugares:
|
SummaryText |
0 ou 1 | InternationalizedText |
Um resumo da medida levada a voto popular. Consiste em um ou dois parágrafos curtos e pode ser gerado pelo parceiro para resumir o texto completo da cédula, como no exemplo a seguir:
|
ProStatement |
0 ou 1 | InternationalizedText |
Uma declaração que explica o que significa um voto Sim nessa medida
de votação. Não é um argumento a favor da medida. Por
exemplo: A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
0 ou 1 | InternationalizedText |
Uma declaração que explica o que significa um voto Não nessa medida
eleitoral. Não é um argumento contra a medida. Por exemplo: A
"no" vote opposes this initiative, thus keeping the existing requirement
that electric utilities acquire 25 percent of their electricity from
renewable resources by 2025. |
Type |
0 ou 1 | BallotMeasureType |
Um tipo enumerado de medida levada a voto popular. Selecione o valor que melhor descreve a medida eleitoral na jurisdição dela. |
PassageThreshold |
0 ou 1 | string |
A parcela mínima de votos necessária para que uma moção seja aprovada. |
Exemplos
XML
<Contest objectId="c-0" xsi:type="BallotMeasureContest"> <BallotSelection objectId="bms-00" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-00-yes</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms-01" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-01-no</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotSubTitle> <Text language="en">Farm Animal Confinement Initiative</Text> </BallotSubTitle> <BallotTitle> <Text language="en"> California Proposition 12, Farm Animal Confinement Initiative (2018) </Text> </BallotTitle> <ElectoralDistrictId>ru-ca-1</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>c-0</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name> California Proposition 12, Farm Animal Confinement Initiative (2018) </Name> <BallotText> <Text language="en"> Establishes minimum requirements for confining certain farm animals. Prohibits sales of meat and egg products from animals confined in noncomplying manner. Fiscal Impact: Potential decrease in state income tax revenues from farm businesses, likely not more than several million dollars annually. State costs up to $10 million annually to enforce the measure. </Text> </BallotText> <ConStatement> <Text language="en">No means the measure will not be enacted </Text> </ConStatement> <InfoUri Annotation="fulltext"> https://example-government.gov/ballot-measures/California_Proposition_12_2018 </InfoUri> <InfoUri Annotation="wikipedia"> https://en.wikipedia.org/wiki/2018_California_Proposition_12 </InfoUri> <PassageThreshold> <Text language="en">50.01%</Text> </PassageThreshold> <ProStatement> <Text language="en">Yes means the measure will be enacted </Text> </ProStatement> <SummaryText> <Text language="en"> The proposition establishes new minimum requirements on farmers to provide more space for egg-laying hens, breeding pigs, and calves raised for veal. California businesses will be banned from selling eggs or uncooked pork or veal that came from animals housed in ways that did not meet these requirements. </Text> </SummaryText> <Type>ballot-measure</Type> </Contest>
RetentionContest
Use esse tipo quando uma Contest envolver um referendo para decidir se um funcionário eleito
deve permanecer no cargo ou ser removido dele.
Isso inclui casos como disputas de retenção judicial em alguns estados dos EUA, que decidem se um juiz deve continuar por mais um mandato. Isso também se aplica a eleições de revogação de mandato, que decidem se um funcionário público deve ser removido antes do término do mandato.
Elementos
Todos os elementos de BallotMeasureContest também se aplicam
a RetentionContest.
| Elemento | Multiplicidade | Tipo | Descrição |
|---|---|---|---|
CandidateId |
1 | IDREF | O ID do candidato que representa o titular atual do cargo |
OfficeId |
0 ou 1 | IDREF | O ID do cargo que o funcionário ocupa atualmente |
Exemplos
XML
<Contest objectId="c-40001" xsi:type="RetentionContest"> <!-- Retention contest selections are actually BallotMeasureSelection objects, and should use the 'bms-' objectId prefix.--> <BallotSelection objectId="bms-40001a" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-40001a</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms-40001at"> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms-40001b" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-40001b</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms-40001bt"> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotTitle> <Text language="en">Retention of Supreme Court Justice</Text> </BallotTitle> <ElectoralDistrictId>ru-0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>c-vageneral-2013-va16-country-us</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name>Judicial Retention, Supreme Court</Name> <CandidateId>can-12345</CandidateId> <OfficeId>off-20006</OfficeId> </Contest>