Use Contest
para descrever uma disputa e vincular os candidatos e partidos associados.
Este documento aborda Contest
e as subentidades dele:
Contest
CandidateContest
PartyContest
BallotMeasureContest
RetentionContest
Tipos
Contest
é um elemento abstrato com três tipos que são usados com base no tipo de concurso:
CandidateContest
: use esse tipo quando umaContest
envolver um ou mais candidatos a um cargo.PartyContest
: use esse tipo quando umContest
tiver uma seleção de lista de partidos na cédula.BallotMeasureContest
: use esse tipo quando umaContest
envolver uma ou mais propostas de lei.RetentionContest
: use esse tipo quando umaContest
envolver um referendo para decidir se um funcionário eleito deve permanecer no cargo ou ser removido dele.
À medida que 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 da eleição e tipos de resultados esperamos. O Google pode pedir uma ou várias etapas. Esses valores de tipo de etapa podem mudar durante a noite da eleição. Defina o valor inicial do feed para o estágio com que você quer começar. Para mais detalhes, consulte ExternalIdentifiers
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 abreviado do concurso. |
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 à forma como aparece nas cédulas dos eleitores. |
BallotTitle |
0 ou 1 | InternationalizedText |
Título do concurso. O texto do título precisa corresponder ao guia de sintaxe. Para concursos de referendos, o título precisa corresponder ao texto da cédula. |
ComposingContestIds |
0 ou mais | IDREFS |
Usado para definir uma disputa de rollup. Por exemplo, nas eleições gerais presidenciais dos EUA, há uma disputa nacional com IDs de disputa que compõem 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 é |
ElectoralDistrictId |
1 | IDREF |
Identificador exclusivo de um elemento
Por exemplo, em um concurso específico, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Associa um ID ao concurso. Um identificador estável é obrigatório. Para fornecer o estágio dos resultados da eleição informado pelo seu feed, defina OtherType com um valor de ContestStage . |
HasRotation |
0 ou 1 | boolean |
Indica se as seleções no concurso são rotacionadas. Se esse elemento não estiver presente, o valor padrão será false . |
Name |
1 | string |
Ele precisa corresponder ao BallotTitle em inglês e à sintaxe do título. |
SequenceOrder |
0 ou 1 | integer |
A ordenação padrão dos elementos
|
SubsequentContestId |
0 ou 1 | IDREF |
Usado para apontar para uma competição posterior no mesmo conjunto relacionado. Por exemplo, nas eleições dos EUA, ele geralmente aponta de uma eleição primária para a eleição geral relacionada. Ele também pode apontar de uma eleição geral para um segundo turno. Um |
SubUnitsReported |
0 ou 1 | integer |
O número de subunidades, como distritos eleitorais, que concluíram a votação para esta disputa. |
SummaryCounts |
0 ou mais | SummaryCounts |
Fornece um resumo de várias contagens associadas ao
concurso. Isso inclui o número total de cédulas preenchidas 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 ao concurso como um todo ou a outras unidades de relatórios de nível inferior usando várias ocorrências de SummaryCounts . |
TotalSubUnits |
0 ou 1 | integer |
O número total de subunidades, como distritos eleitorais, 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 . |
StartDate |
0 ou 1 | PartialDate |
A data de início do concurso no calendário. Use a data em que a votação 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 .
|
EndDate |
0 ou 1 | PartialDate |
A data de término do concurso no calendário. Use a data em que a pesquisa 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 .
|
CountingDate |
0 ou 1 | PartialDate |
A data após a votação em que a contagem acontece para a disputa eleitoral. Isso só deve ser incluído se o dia da contagem for diferente do último dia de votação, como nas eleições da Lok Sabha na Índia. O caso comum é que a contagem acontece no mesmo dia do último dia de votação, ou seja, o EndDate da eleição.
|
CandidateContest
Use CandidateContest
para descrever um concurso que envolve a seleção de um ou mais candidatos.
Essa entidade pode referenciar Office
ou Party
por ID. Não é possível representar uma chapa de candidatos na mesma disputa. Você só pode referenciar 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 no concurso, que é o n de um concurso 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 escritório ao concurso. |
PrimaryPartyIds |
0 ou mais | IDREFS |
Identificador exclusivo de um ou mais elementos
Party
que indicam que o Contest faz parte de uma
prévia partidária. PrimaryPartyId só é significativo em uma eleição primária. |
VotesAllowed |
1 | integer |
O número máximo de votos ou votos por escrito 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
do Contest só deve ser definido se for diferente do tipo do
Election . |
Exemplos
XML
<Contest xsi:type="CandidateContest" objectId="cc1-001"> <Abbreviation>KENYAPRES</Abbreviation> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenyatta">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-odinga">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-mudavadi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenneth">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-dida">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-karua">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kiyiapi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-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>off9999a</OfficeIds> <VotesAllowed>1</VotesAllowed> <Type>general</Type> </Contest>
JSON
"Contest": [ { "@type": "CandidateContest", "objectId": "cc1-001", "Abbreviation": "KENYAPRES", "BallotSelection": [ { "@type": "CandidateSelection", "objectId": "cs1-001-kenyatta", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-odinga", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-mudavadi", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-kenneth", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-dida", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-karua", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-kiyiapi", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-muite", ... } ], "BallotTitle": { "Text": [ { "value": "2022 Kenya Presidential election", "language": "en" }, { "value": "2022 Elecciones presidenciales de Kenia", "language": "es" }, { "value": "2022 Élection présidentielle au Kenya", "language": "fr" }, ] }, "CountStatus": "...", "ElectoralDistrictId": "...", "Name": "2022 Kenya Presidential election", "SubUnitsReported": 48, "SummaryCounts": "...", "TotalSubUnits": 48, "VoteVariation": "1-of-m", "NumberElected": 1, "VotesAllowed": 1, "Type": "general" } ]
PartyContest
Use PartyContest
para uma disputa em que os eleitores escolhem um partido na cédula.
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 no concurso, que é o n de um concurso 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 votos por escrito 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 escritório ao concurso. |
Type |
0 ou mais | ElectionType |
O tipo enumerado de uma disputa, como primária ou geral. O tipo
do Contest só deve ser definido se for diferente do tipo do
Election . |
Exemplos
XML
<Contest xsi:type="PartyContest" objectId="pc20001"> <BallotSelection objectId="ps101321" xsi:type="PartySelection"> <PartyIds>par10132</PartyIds> </BallotSelection> <BallotSelection objectId="ps101322" xsi:type="PartySelection"> <PartyIds>par10133</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>off9999a</OfficeIds> <Type>general</Type> <VotesAllowed>1</VotesAllowed> </Contest>
JSON
"Contest": [ { "@type": "PartyContest", "objectId": "pc20001", "BallotSelection": [ { "@type": "PartySelection", "objectId": "ps101321", "PartyIds": [ "par10132" ] } ], "BallotSelection": [ { "@type": "PartySelection", "objectId": "ps101322", "PartyIds": [ "par10133" ] } ], "BallotTitle": { "Text": [ { "value": "Ballot title example", "language": "en" } ] }, "ContestDateStatus": "confirmed", "CountingDate": "2022-08-11", "ElectoralDistrictId": "...", "EndDate": "2022-08-09", "ExternalIdentifiers": [ ... ], "Name": "Contest name example", "StartDate": "2022-08-09", "VoteVariation": "1-of-m", "OfficeIds": "off9999a", "Type": "general", "VotesAllowed": 1 } ]
BallotMeasureContest
Use BallotMeasureContest
para uma disputa que envolva 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 cédula, 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 entre as entidades |
BallotSubTitle |
0 ou 1 | InternationalizedText |
O subtítulo da cédula, se houver. |
BallotText |
1 | InternationalizedText |
O texto que aparece na 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 proposição. Forneça esse elemento se houver texto adicional não incluído na cédula. Limitado a 30.000 caracteres. Se o texto completo da proposição for menor que 30.000 caracteres e não incluir 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 das anotações listadas em outro lugar:
|
SummaryText |
0 ou 1 | InternationalizedText |
Um resumo da cédula. 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 nesse referendo. Isso 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 uma proposição. Selecione o valor que melhor descreve a medida eleitoral na jurisdição dela. |
PassageThreshold |
0 ou 1 | string |
A porcentagem mínima de votos necessária para que uma moção seja aprovada. |
Exemplos
XML
<Contest objectId="bmc0" xsi:type="BallotMeasureContest"> <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0_yes</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms01" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0_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>bmc0</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>
JSON
"Contest": [ { "@type": "BallotMeasureContest", "objectId": "bmc0", "BallotSelection": [ { "@type": "BallotMeasureSelection", "objectId": "bms00", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0_yes" } ] } } "Text": [ { "value": "Yes", "language": "en" }, ] ], "BallotSelection": [ { "@type": "BallotMeasureSelection", "objectId": "bms01", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0_no" } ] } } "Text": [ { "value": "No", "language": "en" }, ] ], "BallotSubTitle": { "Text": [ { "value": "Farm Animal Confinement Initiative", "language": "en" } ] }, "BallotTitle": { "Text": [ { "value": "California Proposition 12, Farm Animal Confinement Initiative (2018)", "language": "en" } ] }, "ElectoralDistrictId": "ru_ca_1" "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0" } ] }, "Name": "California Proposition 12, Farm Animal Confinement Initiative (2018)", "BallotText": [ "Text": [ { "value": "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.", "language": "en" } ] ], "ConStatement": [ "Text": [ { "value": "No means the measure will not be enacted", "language": "en" } ] ], "InfoUri": [ { "value": "https://example-government.gov/ballot-measures/California_Proposition_12_2018", "annotation": "fulltext" } ], "InfoUri": [ { "value": "https://en.wikipedia.org/wiki/2018_California_Proposition_12", "annotation": "wikipedia" } ], "PassageThreshold": [ "Text": [ { "value": "50.01%", "language": "en" } ] ], "ProStatement": [ "Text": [ { "value": "Yes means the measure will be enacted", "language": "en" } ] ], "SummaryText": [ "Text": [ { "value": "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.", "language": "en" } ] ], "Type": "ballot-measure", } ]
RetentionContest
Use esse tipo quando um Contest
envolver um referendo para decidir se um funcionário eleito deve permanecer ou ser removido do cargo.
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 recall, que decidem se um ocupante de cargo 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 ocupante do cargo no momento. |
OfficeID |
0 ou 1 | IDREF | O ID do cargo que o ocupante exerce atualmente. |
Exemplos
XML
<Contest objectId="rc40001" xsi:type="RetentionContest"> <!-- Retention contest selections are actually BallotMeasureSelection objects, and should use the 'bms' objectId prefix.--> <BallotSelection objectId="bms40001a" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc_bms40001a</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms40001at"> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms40001b" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc_bms40001at</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms40001bt"> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotTitle> <Text language="en">Retention of Supreme Court Justice</Text> </BallotTitle> <ElectoralDistrictId>ru0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>vageneral-cont-2013-va16-country-us</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name>Judicial Retention, Supreme Court</Name> <CandidateId>can12345</CandidateId> <OfficeId>off20006</OfficeId> </Contest>