Usa Contest para describir una contienda y vincularla a los candidatos y partidos asociados.
En este documento, se analiza Contest y sus subentidades:
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
Tipos
Contest es un elemento abstracto con tres tipos que se usan según el tipo de concurso:
CandidateContest: Usa este tipo cuando unContestinvolucre a uno o más candidatos para un cargo.PartyContest: Usa este tipo cuando unContesttenga una selección de lista de partidos en la boleta. Esto también se puede usar como un concurso virtual que es un resumen de un conjunto más grande de concursos más pequeños.BallotMeasureContest: Usa este tipo cuando unaContestinvolucre una o más medidas de votación.RetentionContest: Usa este tipo cuando unaContestimplique un referéndum para decidir si un funcionario electo debe permanecer en el cargo o ser destituido.
A medida que se informan los resultados de una elección, puedes actualizar tu feed para mostrar
diferentes etapas de los resultados, como las encuestas a boca de urna o las estimaciones. Google
proporciona orientación sobre las etapas de las elecciones y los tipos de resultados que esperamos. Google
puede solicitar una o varias etapas. Estos valores de tipo de etapa pueden cambiar durante
la noche de las elecciones. Establece el valor inicial del feed en la etapa con la que deseas comenzar. Para obtener más detalles, consulta CurrentResultsReportingStage y ResultsReportingStageCollection en la sección Elementos.
Atributos
En la siguiente tabla, se describen los atributos de Contest:
| Atributo | ¿Es obligatorio? | Tipo | Descripción |
|---|---|---|---|
objectId |
Obligatorio | ID |
Es el identificador interno único que usan otros elementos para hacer referencia a este elemento. |
Elementos
En la siguiente tabla, se describen los elementos de Contest:
| Elemento | Multiplicidad | Tipo | Descripción |
|---|---|---|---|
Abbreviation |
0 o 1 | string |
Es el nombre corto del concurso. |
AggregateBallotSelection |
0 o 1 | SpecialBallotSelection |
Selección de boletas para agregaciones de recuento de votos, como agregar varios candidatos en "Otros". |
BallotSelection |
0 o más | BallotSelection |
Asocia las selecciones de la boleta con la contienda. El orden
de los candidatos o partidos en Si |
BallotSubTitle |
0 o 1 | InternationalizedText |
Es el subtítulo de la contienda, que debe coincidir con el que aparece en las boletas de los votantes. |
BallotTitle |
0 o 1 | InternationalizedText |
Título del concurso. El texto del título debe corresponder a la guía de sintaxis. En el caso de las contiendas de medidas sometidas a votación, el título debe coincidir con la redacción de la boleta. |
BlankBallotSelection |
0 o 1 | SpecialBallotSelection |
Selección de boleta para boletas en blanco. |
ComposingContestIds |
0 o más | IDREFS |
Se usa para definir un concurso de resumen. Por ejemplo, en las elecciones generales presidenciales de EE.UU., hay una contienda a nivel nacional con IDs de contienda que la componen para cada una de las elecciones a nivel estatal. Un |
ContestDateStatus |
0 o 1 |
DateStatus
|
Este elemento indica las actualizaciones de programación de una elección. El valor predeterminado es |
ContestDateType |
0 o 1 |
ElectionDateType
|
Este elemento indica la forma en que se agrega el concurso al calendario.
Si se omite, el valor predeterminado es el |
CountingDate |
0 o 1 | PartialDate |
Es la fecha posterior a la votación en la que se realiza el recuento de la contienda electoral.
Esto solo se debe incluir si el día del recuento es diferente del
último día de votación, por ejemplo, en las elecciones de Lok Sabha de la India. Lo habitual
es que el recuento se realice el mismo día que el último día de votación,
es decir, el EndDate de la elección.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
Es la etapa actual de los informes de resultados del concurso. |
EarliestPollsClose |
0 o 1 | dateTime |
Cuando se cierren las primeras urnas |
ElectoralDistrictId |
1 | IDREF |
Es el identificador único de un elemento Por ejemplo, para una contienda específica, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Asocia un ID con el concurso. Se requiere un identificador estable. |
EndDate |
0 o 1 | PartialDate |
La fecha de finalización del concurso en el calendario. Usa la fecha en la que finaliza la votación, como 2022-11-08. La fecha de finalización solo se debe establecer si la fecha de inicio
y finalización del Contest difieren de la fecha de inicio y finalización
del Election.
|
EstimatedExpectedVotePercentage |
0 o 1 | float |
A menudo se abrevia como EEVP y es el porcentaje estimado del total de votos esperados que se informó para esta contienda, como un número entre 0 y 100. Por ejemplo, informa 24.2% como |
FilingDeadline |
0 o 1 | PartialDate |
Es la fecha límite en la que un candidato debe presentar su postulación para la contienda. |
HasRotation |
0 o 1 | boolean |
Indica si las selecciones de la contienda se rotan. Si este elemento no está presente, el valor predeterminado es false. |
IsNotable |
0 o 1 | boolean |
Indica si la entidad se considera destacada. Se supone que es false
si no se especifica.
|
LatestPollsClose |
0 o 1 | dateTime |
Cuando se cierren las últimas urnas |
Name |
1 | string |
Este debe coincidir con el BallotTitle en inglés y corresponder
a la sintaxis del título. |
NoneOfTheAboveBallotSelection |
0 o 1 | SpecialBallotSelection |
Selección de la opción en una boleta electoral para votar por "Ninguna de las anteriores" o alguna selección equivalente, como "Ninguna", "Ninguna de estas" o "No comprometido". |
NullBallotSelection |
0 o 1 | SpecialBallotSelection |
Selección de boletas nulas o dañadas. Estas son boletas que se marcaron de tal manera que el voto no se puede contar correctamente. Algunos ejemplos de boletas nulas son las que se rompieron, se ensuciaron, se marcaron de más o de menos, o se marcaron de una manera que permitiría identificar al votante. |
OutcomeDetermined |
0 o 1 | boolean |
Si se determinó el resultado de las elecciones
|
Seat |
0 o 1 | string |
El cargo específico para el que se realiza la contienda |
SequenceOrder |
0 o 1 | integer |
Es el orden predeterminado de los elementos
|
StartDate |
0 o 1 | PartialDate |
Es la fecha de inicio del concurso en el calendario. Usa la fecha en que comienza la votación, como 2022-11-08. La fecha de inicio solo se debe establecer si la
fecha de inicio y finalización del Contest difieren de la fecha de inicio y
finalización del Election.
|
SubsequentContestId |
0 o 1 | IDREF |
Se usa para indicar una contienda posterior en el mismo conjunto relacionado. En las elecciones de EE.UU., por ejemplo, suele apuntar de una elección primaria a su elección general relacionada. También puede apuntar de una elección general a una elección de segunda vuelta. Por lo general, un |
SubUnitsReported |
0 o 1 | integer |
Es la cantidad de subdivisiones, como distritos electorales, que completaron el informe de votos para esta contienda. |
SummaryCounts |
0 o más | SummaryCounts |
Proporciona un resumen de los recuentos varios asociados con la
contienda. Esto incluye la cantidad total de boletas emitidas que contienen la
contienda y la cantidad total de abstenciones, votos nulos, votos en blanco o
votos por escrito. Los recuentos de resumen se pueden asociar con la contienda en su
totalidad o con otras unidades de informes de nivel inferior mediante el uso de varias
instancias de SummaryCounts. |
TotalSeats |
0 o 1 | integer |
Es la cantidad total de escaños que el distrito electoral de esta contienda puede ocupar para el cargo. Esto equivale a las bancas que se eligen, las bancas que se mantienen y las bancas vacantes. |
TotalSubUnits |
0 o 1 | integer |
Es la cantidad total de subdivisiones, como distritos electorales, que tienen esta contienda en la boleta. |
VoteVariation |
0 o 1 | VoteVariation |
Es el tipo de variación de voto que se asocia con la contienda, como
n-of-m. |
OtherVoteVariation |
0 o 1 | string |
Se usa para proporcionar un valor personalizado cuando VoteVariation es
other. |
ResultsEmbargoEnd |
0 o 1 | dateTime |
Cuando finaliza el embargo de la publicación de los resultados de las elecciones |
ResultsExpected |
0 o 1 | dateTime |
Cuándo se espera que aparezcan los primeros resultados del recuento de votos en el feed. |
ResultsLastUpdated |
0 o 1 | dateTime |
Cuándo se actualizaron por última vez los resultados de la contienda. |
ResultsReportingStageCollection |
0 o 1 | N/A | Es el elemento wrapper para las definiciones de ResultsReportingStage. Para obtener más detalles, consulta
Entidades de colección.
|
CandidateContest
Usa CandidateContest para describir una contienda que implique la selección de uno
o más candidatos.
De manera opcional, esta entidad puede hacer referencia a Office
o Party por ID. No admitimos la representación de una lista de candidatos en la misma contienda; solo puedes hacer referencia a un Office. Por ejemplo, para una fórmula de presidente y vicepresidente, necesitarías dos contiendas Candidate. Cada uno
haría referencia a una oficina diferente.
Elementos
En la siguiente tabla, se describen los elementos de CandidateContest:
| Elemento | Multiplicidad | Tipo | Descripción |
|---|---|---|---|
NumberElected |
0 o 1 | integer |
Es la cantidad de candidatos que se eligen en la contienda, que es el valor de
n de una contienda n-of-m. Si
NumberElected no está presente en el feed, se usa un valor predeterminado de
1. |
OfficeIds |
1 | IDREFS |
Es el identificador único de uno o más elementos Office. Asocia una descripción de la oficina con la contienda. |
PrimaryPartyIds |
0 o más | IDREFS |
Es el identificador único de uno o más elementos Party, que indican que el elemento Contest forma parte de una elección primaria partidaria. PrimaryPartyId solo es significativo en una
elección primaria. |
VotesAllowed |
1 | integer |
Es la cantidad máxima de votos o candidatos no registrados permitidos por votante en esta
contienda. Si VotesAllowed no está presente en el feed, se usa un valor predeterminado de 1. |
Type |
0 o más | ElectionType |
Es el tipo enumerado de una contienda, como primaria o general. El tipo
de Contest solo se debe establecer si difiere del tipo de
Election. |
Ejemplos
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
Usa PartyContest para una contienda en la que los votantes eligen un partido en la boleta.
Esto también se puede usar en un feed de resultados electorales como una contienda de resumen virtual
para comunicar datos agregados (p.ej., una contienda de partidos a nivel estatal que
agrega los resultados de las contiendas de las circunscripciones electorales).
Elementos
En la siguiente tabla, se describen los elementos de PartyContest:
| Elemento | Multiplicidad | Tipo | Descripción |
|---|---|---|---|
NumberElected |
0 o 1 | integer |
Es la cantidad de candidatos que se eligen en la contienda, que es la
n de una contienda n-of-m. Si NumberElected
no está presente en el feed, se usa un valor predeterminado de
1. |
VotesAllowed |
0 o 1 | integer |
Es la cantidad máxima de votos o candidatos no registrados permitidos por votante en esta
contienda. Si VotesAllowed no está presente en el feed, se usa un valor predeterminado de 1. |
OfficeIds |
1 | IDREFS |
Es el identificador único de uno o más elementos Office.
Asocia una descripción de la oficina
con la contienda. |
Type |
0 o más | ElectionType |
Es el tipo enumerado de una contienda, como primaria o general. El tipo
de Contest solo se debe establecer si difiere del tipo de
Election. |
Ejemplos
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
Usa BallotMeasureContest para una contienda que involucre medidas electorales.
Elementos
En la siguiente tabla, se describen los elementos de BallotMeasureContest:
| Elemento | Multiplicidad | Tipo | Descripción |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Es el título oficial de la boleta, como Algunos referéndums tienen un solo título colectivo con varias
preguntas numeradas. En estos casos, el título puede incluir el número de pregunta
para distinguir entre las entidades |
BallotSubTitle |
0 o 1 | InternationalizedText |
Es el subtítulo de la boleta, si existe. |
BallotText |
1 | InternationalizedText |
Es el texto que aparece en la boleta. Por ejemplo: 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 o 1 | InternationalizedText |
Una copia del texto completo de la medida electoral Proporciona este elemento si hay texto adicional que no se incluye en la boleta. Tiene un límite de 30,000 caracteres. Si el texto completo de la medida electoral tiene menos de 30,000
caracteres y no incluye ningún formato que no sea válido en un archivo de feed, inclúyelo en |
InfoUri |
0 o 1 | AnnotatedUri |
Es un URI anotado que acepta las siguientes anotaciones, en lugar de las que se indican en otros lugares:
|
SummaryText |
0 o 1 | InternationalizedText |
Un resumen de la medida sometida a votación Consiste en uno o dos párrafos cortos que el socio puede generar para resumir el texto completo de la boleta, como en el siguiente ejemplo:
|
ProStatement |
0 o 1 | InternationalizedText |
Una declaración que explique lo que significa un voto por el Sí en esta medida electoral. No es un argumento a favor de la medida. Por ejemplo: A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
0 o 1 | InternationalizedText |
Es una declaración que explica lo que significa un voto por el No en esta consulta sometida a votación. No es un argumento en contra de la medida. Por ejemplo: 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 o 1 | BallotMeasureType |
Es un tipo enumerado de una medida sometida a votación. Selecciona el valor que mejor describa la medida electoral en su jurisdicción. |
PassageThreshold |
0 o 1 | string |
Es el porcentaje mínimo de votos que se requiere para que se apruebe una moción. |
Ejemplos
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
Usa este tipo cuando una Contest implique un referéndum para decidir si un funcionario electo
debe permanecer en el cargo o ser destituido.
Esto incluye casos como las contiendas de retención judicial en algunos estados de EE.UU., en las que se decide si un juez debe continuar durante otro mandato. También se aplica a las elecciones revocatorias, en las que se decide si se debe destituir a un funcionario antes de que finalice su mandato.
Elementos
Todos los elementos de BallotMeasureContest también se aplican
a RetentionContest.
| Elemento | Multiplicidad | Tipo | Descripción |
|---|---|---|---|
CandidateId |
1 | IDREF | Es el ID del candidato que representa al funcionario que ocupa el cargo actualmente. |
OfficeId |
0 o 1 | IDREF | Es el ID del cargo que ocupa actualmente el titular. |
Ejemplos
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>