Utilisez Contest
pour décrire un scrutin et l'associer aux candidats et partis concernés.
Ce document traite de Contest
et de ses sous-entités :
Contest
CandidateContest
PartyContest
BallotMeasureContest
RetentionContest
Types
Contest
est un élément abstrait avec trois types qui sont utilisés en fonction du type de concours :
CandidateContest
: à utiliser lorsqu'unContest
implique un ou plusieurs candidats à un poste.PartyContest
: utilisez ce type lorsqu'unContest
comporte une sélection de liste de partis sur le bulletin de vote.BallotMeasureContest
: utilisez ce type lorsqu'unContest
implique une ou plusieurs mesures électorales.RetentionContest
: utilisez ce type lorsqu'unContest
implique un référendum visant à déterminer si un élu doit rester en fonction ou être démis de ses fonctions.
À mesure que les résultats d'une élection sont publiés, vous pouvez mettre à jour votre flux pour afficher différentes étapes des résultats, comme les sondages à la sortie des urnes ou les estimations. Google fournit des conseils sur les étapes des élections et les types de résultats que nous attendons. Google peut vous demander de fournir des informations sur une ou plusieurs étapes. Ces valeurs de type d'étape peuvent changer le soir des élections. Définissez la valeur initiale du flux sur l'étape par laquelle commencer. Pour en savoir plus, consultez ExternalIdentifiers
dans la section Éléments.
Attributs
Le tableau suivant décrit les attributs de Contest
:
Attribut | Obligatoire ? | Type | Description |
---|---|---|---|
objectId |
Obligatoire | ID |
Identifiant interne unique utilisé par d'autres éléments pour faire référence à cet élément. |
Éléments
Le tableau suivant décrit les éléments de Contest
:
Élément | Multiplicité | Type | Description |
---|---|---|---|
Abbreviation |
0 ou 1 | string |
Nom court du concours. |
BallotSelection |
0 ou plus | BallotSelection |
Associe les sélections sur le bulletin de vote au scrutin. L'ordre des candidats ou des partis dans Si |
BallotSubTitle |
0 ou 1 | InternationalizedText |
Sous-titre du scrutin, qui doit correspondre à celui qui figure sur les bulletins de vote. |
BallotTitle |
0 ou 1 | InternationalizedText |
Titre du concours. Le texte du titre doit correspondre au guide de syntaxe. Pour les concours sur les référendums, le titre doit correspondre à la formulation du bulletin de vote. |
ComposingContestIds |
0 ou plus | IDREFS |
Permet de définir un concours cumulatif. Par exemple, lors des élections présidentielles générales aux États-Unis, il existe un scrutin au niveau national avec des ID de scrutin composés pour chacune des élections au niveau des États. Un |
ContestDateStatus |
0 ou 1 |
DateStatus
|
Cet élément indique les modifications de programmation pour une élection. La valeur par défaut est |
ElectoralDistrictId |
1 | IDREF |
Identifiant unique d'un élément
Par exemple, pour un concours spécifique, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Associe un ID au concours. Un identifiant stable est requis. Pour indiquer l'état des résultats des élections signalé par votre flux, définissez OtherType sur une valeur de ContestStage . |
HasRotation |
0 ou 1 | boolean |
Indique si les sélections du concours sont permutées. Si cet élément n'est pas présent, la valeur par défaut est false . |
Name |
1 | string |
Il doit correspondre à BallotTitle en anglais et respecter la syntaxe des titres. |
SequenceOrder |
0 ou 1 | integer |
Ordre par défaut des éléments
|
SubsequentContestId |
0 ou 1 | IDREF |
Utilisé pour pointer vers un concours ultérieur dans le même ensemble associé. Par exemple, lors des élections américaines, il pointe généralement d'une primaire vers l'élection générale associée. Elle peut également pointer d'une élection générale vers un second tour. Un |
SubUnitsReported |
0 ou 1 | integer |
Nombre de sous-unités, telles que les circonscriptions, qui ont terminé de déclarer les votes pour ce scrutin. |
SummaryCounts |
0 ou plus | SummaryCounts |
Fournit un récapitulatif des différents nombres associés au concours. Cela inclut le nombre total de bulletins de vote déposés contenant le concours, ainsi que le nombre total d'abstentions, de votes multiples, de votes incomplets ou de votes par écrit. Les nombres récapitulatifs peuvent être associés au concours dans son ensemble ou à d'autres unités de reporting de niveau inférieur en utilisant plusieurs occurrences de SummaryCounts . |
TotalSubUnits |
0 ou 1 | integer |
Nombre total de sous-unités, telles que les circonscriptions, pour lesquelles ce scrutin figure sur le bulletin de vote. |
VoteVariation |
0 ou 1 | VoteVariation |
Type de variation de vote associée au concours, par exemple n-of-m . |
OtherVoteVariation |
0 ou 1 | string |
Permet de fournir une valeur personnalisée lorsque VoteVariation est défini sur other . |
StartDate |
0 ou 1 | PartialDate |
Date de début du concours dans le calendrier. Utilisez la date à laquelle le scrutin commence, par exemple "2022-11-08". La date de début ne doit être définie que si les dates de début et de fin de la Contest diffèrent de celles de la Election .
|
EndDate |
0 ou 1 | PartialDate |
Date de fin du concours dans le calendrier. Utilisez la date de fin du scrutin, par exemple "2022-11-08". La date de fin ne doit être définie que si les dates de début et de fin de la Contest diffèrent de celles de la Election .
|
CountingDate |
0 ou 1 | PartialDate |
Date après le vote à laquelle le dépouillement a lieu pour le scrutin. Cette information ne doit être incluse que si le jour du dépouillement est différent du dernier jour du scrutin (par exemple, pour les élections Lok Sabha en Inde). Le cas le plus courant est que le dépouillement a lieu le même jour que le dernier jour du scrutin, c'est-à-dire le EndDate des élections.
|
CandidateContest
Utilisez CandidateContest
pour décrire un concours impliquant la sélection d'un ou plusieurs candidats.
Cette entité peut éventuellement référencer Office
ou Party
par ID. Nous n'acceptons pas la représentation d'un ticket de candidats dans un même concours. Vous ne pouvez faire référence qu'à un seul Office
. Par exemple, pour un ticket Président et Vice-président, vous aurez besoin de deux compétitions Candidate
. Chacune d'elles ferait référence à un bureau différent.
Éléments
Le tableau suivant décrit les éléments de CandidateContest
:
Élément | Multiplicité | Type | Description |
---|---|---|---|
NumberElected |
0 ou 1 | integer |
Nombre de candidats élus au cours du concours, qui correspond au n d'un concours n-of-m . Si NumberElected n'est pas présent dans le flux, la valeur par défaut 1 est utilisée. |
OfficeIds |
1 | IDREFS |
Identifiant unique pour un ou plusieurs éléments Office .
Associe une description du bureau au concours. |
PrimaryPartyIds |
0 ou plus | IDREFS |
Identifiant unique pour un ou plusieurs éléments Party , qui indiquent que Contest fait partie d'une primaire partisane. PrimaryPartyId n'a de sens que lors d'une élection primaire. |
VotesAllowed |
1 | integer |
Nombre maximal de votes ou de votes par écrit autorisés par électeur pour ce concours. Si VotesAllowed n'est pas présent dans le flux, la valeur par défaut 1 est utilisée. |
Type |
0 ou plus | ElectionType |
Type énuméré d'une élection, par exemple primaire ou générale. Le type de Contest ne doit être défini que s'il diffère du type de Election . |
Exemples
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
Utilisez PartyContest
pour un scrutin où les électeurs choisissent un parti sur le bulletin de vote.
Éléments
Le tableau suivant décrit les éléments de PartyContest
:
Élément | Multiplicité | Type | Description |
---|---|---|---|
NumberElected |
0 ou 1 | integer |
Nombre de candidats élus au cours du concours, qui correspond au n d'un concours n-of-m . Si NumberElected n'est pas présent dans le flux, la valeur par défaut 1 est utilisée. |
VotesAllowed |
0 ou 1 | integer |
Nombre maximal de votes ou de votes par écrit autorisés par électeur pour ce concours. Si VotesAllowed n'est pas présent dans le flux, la valeur par défaut 1 est utilisée. |
OfficeIds |
1 | IDREFS |
Identifiant unique pour un ou plusieurs éléments Office .
Associe une description du bureau au concours. |
Type |
0 ou plus | ElectionType |
Type énuméré d'une élection, par exemple primaire ou générale. Le type de Contest ne doit être défini que s'il diffère du type de Election . |
Exemples
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
Utilisez BallotMeasureContest
pour un scrutin impliquant des mesures soumises au vote.
Éléments
Le tableau suivant décrit les éléments de BallotMeasureContest
:
Élément | Multiplicité | Type | Description |
---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Titre officiel du bulletin de vote, par exemple Certains référendums ont un titre collectif unique avec plusieurs questions numérotées. Dans ce cas, le titre peut inclure le numéro de la question pour faire la distinction entre les entités |
BallotSubTitle |
0 ou 1 | InternationalizedText |
Sous-titre du bulletin de vote, le cas échéant. |
BallotText |
1 | InternationalizedText |
Texte qui apparaît sur le bulletin de vote lui-même. Par exemple : 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 |
Une copie du texte intégral de la mesure électorale. Fournissez cet élément s'il y a du texte supplémentaire qui ne figure pas sur le bulletin de vote lui-même. 30 000 caractères maximum. Si le texte intégral de la mesure électorale est inférieur à 30 000 caractères et ne comporte aucune mise en forme non valide dans un fichier de flux, incluez-le dans |
InfoUri |
0 ou 1 | AnnotatedUri |
URI annoté qui accepte les annotations suivantes, plutôt que celles listées ailleurs :
|
SummaryText |
0 ou 1 | InternationalizedText |
Un résumé du référendum. Il se compose d'un ou deux courts paragraphes et peut être généré par le partenaire pour résumer le texte complet du bulletin de vote, comme dans l'exemple suivant :
|
ProStatement |
0 ou 1 | InternationalizedText |
Énoncé expliquant ce que signifie un vote Oui pour cette mesure du scrutin. Il ne s'agit pas d'un argument en faveur de la mesure. Exemple : 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 |
Énoncé expliquant ce que signifie un vote Non pour ce référendum. Il ne s'agit pas d'un argument contre la mesure. Par exemple : 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 |
Type énuméré d'un projet de loi. Sélectionnez la valeur qui décrit le mieux la mesure électorale dans sa juridiction. |
PassageThreshold |
0 ou 1 | string |
Part minimale des votes requise pour qu'une motion soit adoptée. |
Exemples
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
Utilisez ce type lorsqu'un Contest
implique un référendum visant à déterminer si un élu doit rester en fonction ou être démis de ses fonctions.
Cela inclut les cas tels que les élections judiciaires dans certains États américains, qui déterminent si un juge doit continuer à exercer ses fonctions pour un autre mandat. Cela s'applique également aux élections de révocation qui décident si un titulaire de charge doit être démis de ses fonctions avant la fin de son mandat.
Éléments
Tous les éléments de BallotMeasureContest
s'appliquent également à RetentionContest
.
Élément | Multiplicité | Type | Description |
---|---|---|---|
CandidateID |
1 | IDREF | ID du candidat représentant le titulaire du poste actuellement en fonction |
OfficeID |
0 ou 1 | IDREF | ID de la fonction actuellement occupée par le titulaire |
Exemples
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>