Usa Contest
para describir una contienda y vincularla a los candidatos y partidos asociados.
En este documento, se analizan Contest
y sus entidades secundarias:
Contest
CandidateContest
PartyContest
BallotMeasureContest
RetentionContest
Tipos
Contest
es un elemento abstracto con tres tipos que se usan según el tipo de concurso:
CandidateContest
: Usa este tipo cuando unContest
incluye uno o más candidatos para un cargo.PartyContest
: Usa este tipo cuando unContest
tiene una selección de lista de partidos en la boleta.BallotMeasureContest
: Usa este tipo cuando unContest
involucre una o más medidas electorales.RetentionContest
: Usa este tipo cuando unContest
implica un referéndum para decidir si un funcionario electo debe permanecer en el cargo o ser destituido.
A medida que se informen los resultados de una elección, puedes actualizar tu feed para mostrar las diferentes etapas de los resultados, como las encuestas a boca de urna o las estimaciones. Google proporciona orientación sobre las etapas electorales 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 electoral. Establece el valor inicial del feed en la etapa con la que se comenzará. Para obtener más detalles, consulta ExternalIdentifiers
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. |
Elementos
En la siguiente tabla, se describen los elementos de Contest
:
Elemento | Multiplicidad | Tipo | Descripción |
---|---|---|---|
Abbreviation |
0 o 1 | string |
Nombre corto del concurso. |
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 |
Es el título del concurso. El texto del título debe corresponderse con la guía de sintaxis. En el caso de los concursos sobre medidas electorales, el título debe coincidir con la redacción de la boleta electoral. |
ComposingContestIds |
0 o más | IDREFS |
Se usa para definir un concurso acumulativo. Por ejemplo, en las elecciones generales presidenciales de EE.UU., hay una contienda a nivel nacional con IDs de contienda compuestos para cada una de las elecciones a nivel estatal. Un |
ContestDateStatus |
0 o 1 |
DateStatus
|
Este elemento indica las actualizaciones de programación para una elección. El valor predeterminado es |
ElectoralDistrictId |
1 | IDREF |
Identificador único de un elemento Por ejemplo, para un concurso específico, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Asocia un ID al concurso. Se requiere un identificador estable. Para proporcionar la etapa de los resultados electorales que informa tu feed, establece OtherType con un valor de ContestStage . |
HasRotation |
0 o 1 | boolean |
Indica si las selecciones del concurso se rotan. Si este elemento no está presente, el valor predeterminado es false . |
Name |
1 | string |
Debe coincidir con el BallotTitle en inglés y corresponderse con la sintaxis del título. |
SequenceOrder |
0 o 1 | integer |
Es el orden predeterminado de los elementos
|
SubsequentContestId |
0 o 1 | IDREF |
Se usa para apuntar a un concurso posterior en el mismo conjunto relacionado. Por ejemplo, en las elecciones de EE.UU., suele apuntar de una primaria a su elección general relacionada. También puede apuntar de una elección general a una segunda vuelta. Por lo general, un |
SubUnitsReported |
0 o 1 | integer |
Es la cantidad de subunidades, como los 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 el concurso. Esto incluye la cantidad total de votos emitidos que contienen la contienda y la cantidad total de abstenciones, votos en exceso, votos insuficientes o votos escritos. Los recuentos de resumen se pueden asociar con el concurso en su totalidad o con otras unidades de informes de nivel inferior a través del uso de varias ocurrencias de SummaryCounts . |
TotalSubUnits |
0 o 1 | integer |
Es la cantidad total de subunidades, como las circunscripciones electorales, que tienen esta contienda en la boleta. |
VoteVariation |
0 o 1 | VoteVariation |
Es el tipo de variación de votos asociada al concurso, como n-of-m . |
OtherVoteVariation |
0 o 1 | string |
Se usa para proporcionar un valor personalizado cuando VoteVariation es other . |
StartDate |
0 o 1 | PartialDate |
Es la fecha de inicio del concurso en el calendario. Usa la fecha en la que comienza la votación, como 2022-11-08. La fecha de inicio solo debe establecerse si la fecha de inicio y finalización del Contest difieren de la fecha de inicio y finalización del Election .
|
EndDate |
0 o 1 | PartialDate |
Es la fecha de finalización del calendario del concurso. Usa la fecha en la que finaliza la votación, por ejemplo, 2022-11-08. La fecha de finalización solo debe establecerse si la fecha de inicio y finalización del Contest difieren de la fecha de inicio y finalización del Election .
|
CountingDate |
0 o 1 | PartialDate |
Es la fecha posterior a la votación en la que se realiza el recuento de votos para la contienda electoral. Solo se debe incluir si el día de 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 las elecciones.
|
CandidateContest
Usa CandidateContest
para describir un concurso que implique la selección de uno o más candidatos.
Esta entidad puede hacer referencia de forma opcional a Office
o Party
por ID. No admitimos la representación de un boleto de candidatos en el mismo concurso; solo puedes hacer referencia a un Office
. Por ejemplo, para un boleto de presidente y vicepresidente, necesitarías dos concursos de 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 el concurso, que es el n de un concurso de n-of-m . Si NumberElected no está presente en el feed, se usa el valor predeterminado 1 . |
OfficeIds |
1 | IDREFS |
Es el identificador único de uno o más elementos Office .
Asocia una descripción de la oficina con el concurso. |
PrimaryPartyIds |
0 o más | IDREFS |
Identificador único para uno o más elementos Party , que indican que el Contest forma parte de una primaria partidista. PrimaryPartyId solo es significativo en una elección primaria. |
VotesAllowed |
1 | integer |
Es la cantidad máxima de votos o candidaturas escritas permitidas por votante en esta contienda. Si VotesAllowed no está presente en el feed, se usa el valor predeterminado 1 . |
Type |
0 o más | ElectionType |
Es el tipo enumerado de una elección, 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="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
Usa PartyContest
para un concurso en el que los votantes eligen un partido en la boleta.
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 el concurso, que es el n de un concurso de n-of-m . Si NumberElected no está presente en el feed, se usa el valor predeterminado 1 . |
VotesAllowed |
0 o 1 | integer |
Es la cantidad máxima de votos o candidaturas escritas permitidas por votante en esta contienda. Si VotesAllowed no está presente en el feed, se usa el valor predeterminado 1 . |
OfficeIds |
1 | IDREFS |
Es el identificador único de uno o más elementos Office .
Asocia una descripción de la oficina con el concurso. |
Type |
0 o más | ElectionType |
Es el tipo enumerado de una elección, 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="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
Usa BallotMeasureContest
para un concurso 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 referendos 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 |
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 |
Es una copia del texto completo de la medida electoral. Proporciona este elemento si hay texto adicional que no se incluye en la boleta electoral. 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 sería 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 enumeran en otros lugares:
|
SummaryText |
0 o 1 | InternationalizedText |
Es un resumen de la medida electoral. Consta de uno o dos párrafos cortos y el socio puede generarlo para resumir el texto completo de la boleta electoral, como en el siguiente ejemplo:
|
ProStatement |
0 o 1 | InternationalizedText |
Es una declaración que explica lo que significa un voto 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 No en esta medida electoral. 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 electoral. 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 necesarios para que se apruebe una moción. |
Ejemplos
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
Usa este tipo cuando un Contest
involucre un referéndum para decidir si un funcionario electo debe permanecer en el cargo o ser destituido.
Esto incluye casos como las elecciones judiciales de retención en algunos estados de EE.UU., en las que se decide si un juez debe continuar en el cargo por otro período. También se aplica a las elecciones de revocación, en las que se decide si un funcionario debe ser destituido 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 | ID del candidato que representa al funcionario que ocupa el cargo actualmente |
OfficeID |
0 o 1 | IDREF | ID del cargo que ocupa actualmente el funcionario |
Ejemplos
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>