Utilisez Contest pour décrire un scrutin et l'associer aux candidats et partis correspondants.
Ce document traite de Contest et de ses sous-entités :
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
Types
Contest est un élément abstrait avec trois types qui sont utilisés en fonction du type de concours :
CandidateContest: utilisez ce type lorsqu'unContestimplique un ou plusieurs candidats à un poste.PartyContest: utilisez ce type lorsqu'unContestpropose une sélection de listes de partis sur le bulletin de vote. Il peut également être utilisé comme un concours virtuel qui résume un ensemble plus vaste de concours plus petits.BallotMeasureContest: utilisez ce type lorsqu'unContestimplique une ou plusieurs mesures de scrutin.RetentionContest: utilisez ce type lorsqu'unContestimplique un référendum pour décider 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 les 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 attendus. Google peut demander une ou plusieurs étapes. Ces valeurs de type d'étape peuvent changer au cours de la nuit des élections. Définissez la valeur initiale du flux sur l'étape de départ. Pour en savoir plus, consultez CurrentResultsReportingStage et ResultsReportingStageCollection 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 référencer 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. |
AggregateBallotSelection |
0 ou 1 | SpecialBallotSelection |
Sélection de bulletins pour les agrégations de décomptes de votes, par exemple pour regrouper plusieurs candidats sous la catégorie "Autres". |
BallotSelection |
0 ou plus | BallotSelection |
Associe les sélections du 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 à la façon dont il apparaît sur les bulletins de vote. |
BallotTitle |
0 ou 1 | InternationalizedText |
Titre du concours. Le texte du titre doit respecter le guide de syntaxe. Pour les référendums, le titre doit correspondre au libellé du bulletin de vote. |
BlankBallotSelection |
0 ou 1 | SpecialBallotSelection |
Sélection de bulletins pour les bulletins blancs. |
ComposingContestIds |
0 ou plus | IDREFS |
Utilisé pour définir un concours de cumul. Par exemple, lors de l'élection présidentielle américaine, il existe un scrutin au niveau national, composé d'ID de scrutin pour chacune des élections au niveau des États. Un |
ContestDateStatus |
0 ou 1 |
DateStatus
|
Cet élément indique les modifications apportées au calendrier d'une élection. La valeur par défaut est |
ContestDateType |
0 ou 1 |
ElectionDateType
|
Cet élément indique la manière dont le concours est ajouté au calendrier.
En cas d'omission, la valeur par défaut est le |
CountingDate |
0 ou 1 | PartialDate |
Date postérieure au vote à laquelle le dépouillement a lieu pour le scrutin.
Cette propriété ne doit être incluse que si le jour du dépouillement est différent du dernier jour du vote, par exemple pour les élections de la Lok Sabha en Inde. En général, le dépouillement a lieu le même jour que le dernier jour du vote, c'est-à-dire le EndDate de l'élection.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
Étape actuelle de la communication des résultats du concours. |
EarliestPollsClose |
0 ou 1 | dateTime |
Lorsque les premiers bureaux de vote ferment. |
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. |
EndDate |
0 ou 1 | PartialDate |
Date de fin du concours. Utilisez la date de fin du sondage, 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 l'Contest diffèrent de celles de l'Election.
|
EstimatedExpectedVotePercentage |
0 ou 1 | float |
Souvent abrégé en EEVP, il s'agit du pourcentage estimé du nombre total de votes attendus qui ont été signalés pour ce scrutin, sous la forme d'un nombre compris entre 0 et 100. Par exemple, indiquez 24,2 % sous la forme |
FilingDeadline |
0 ou 1 | PartialDate |
Date limite à laquelle un candidat doit s'inscrire à l'élection. |
HasRotation |
0 ou 1 | boolean |
Indique si les sélections du concours sont alternées. Si cet élément n'est pas présent, la valeur par défaut est false. |
IsNotable |
0 ou 1 | boolean |
Indique si l'entité est considérée comme digne d'intérêt. false est utilisé si aucune valeur n'est spécifiée.
|
LatestPollsClose |
0 ou 1 | dateTime |
Lorsque les derniers bureaux de vote ferment. |
Name |
1 | string |
Il doit correspondre à BallotTitle en anglais et à la syntaxe du titre. |
NoneOfTheAboveBallotSelection |
0 ou 1 | SpecialBallotSelection |
Sélection d'un bulletin de vote pour l'option "Aucune des propositions ci-dessus" ou une option équivalente, telle que "Aucune", "Aucune de ces propositions" ou "Non engagé". |
NullBallotSelection |
0 ou 1 | SpecialBallotSelection |
Sélection de bulletins nuls ou blancs. Il s'agit de bulletins de vote qui ont été marqués de telle sorte que le vote ne peut pas être comptabilisé correctement. Les bulletins nuls sont, par exemple, des bulletins déchirés, salis, comportant trop ou pas assez de marques, ou marqués d'une manière qui permettrait d'identifier l'électeur. |
OutcomeDetermined |
0 ou 1 | boolean |
Si le résultat de l'élection a été déterminé.
|
Seat |
0 ou 1 | string |
Le siège spécifique pour lequel l'élection est organisée. |
SequenceOrder |
0 ou 1 | integer |
Ordre par défaut des éléments
|
StartDate |
0 ou 1 | PartialDate |
Date de début du concours. Utilisez la date de début de l'interrogation, 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 l'Contest diffèrent de celles de l'Election.
|
SubsequentContestId |
0 ou 1 | IDREF |
Permet de 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 élection primaire vers l'élection générale associée. Il peut également pointer d'une élection générale vers un second tour. Un |
SubUnitsReported |
0 ou 1 | integer |
Nombre de sous-unités ayant terminé de communiquer les votes pour ce scrutin. |
SummaryCounts |
0 ou plus | SummaryCounts |
Fournit un résumé des différents décomptes associés au concours. Cela inclut le nombre total de bulletins de vote exprimés contenant le scrutin, ainsi que le nombre total d'abstentions, de votes multiples, de votes blancs ou de votes par écrit. Les nombres récapitulatifs peuvent être associés au scrutin dans son ensemble ou à d'autres unités de reporting de niveau inférieur en utilisant plusieurs occurrences de SummaryCounts. |
TotalSeats |
0 ou 1 | integer |
Nombre total de sièges que la circonscription électorale de ce scrutin peut détenir pour la fonction. Cela équivaut aux sièges soumis à réélection + sièges reportés + sièges vacants. |
TotalSubUnits |
0 ou 1 | integer |
Nombre total de sous-unités qui ont ce scrutin sur le bulletin de vote. |
VoteVariation |
0 ou 1 | VoteVariation |
Type de variation de vote associé au scrutin, par exemple n-of-m. |
OtherVoteVariation |
0 ou 1 | string |
Permet de fournir une valeur personnalisée lorsque VoteVariation est défini sur other. |
ResultsEmbargoEnd |
0 ou 1 | dateTime |
Lorsqu'un embargo sur la publication des résultats des élections prend fin. |
ResultsExpected |
0 ou 1 | dateTime |
Date à laquelle les premiers résultats du dépouillement des votes devraient apparaître dans le flux. |
ResultsLastUpdated |
0 ou 1 | dateTime |
Date de la dernière mise à jour des résultats du concours. |
ResultsReportingStageCollection |
0 ou 1 | N/A |
Élément wrapper pour les définitions Pour un concours de composition (référencé par l'élément |
CandidateContest
Utilisez CandidateContest pour décrire un concours impliquant la sélection d'un ou de plusieurs candidats.
Cette entité peut éventuellement référencer Office ou Party par ID. Nous n'acceptons pas la représentation d'une liste de candidats pour un même scrutin. Vous ne pouvez référencer qu'un seul Office. Par exemple, pour un ticket Président et Vice-président, vous auriez besoin de deux concours Candidate. Chacun d'eux 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 lors du scrutin, qui correspond au n d'un scrutin 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 d'un ou de plusieurs éléments Office. Associe une description de bureau au concours. |
PrimaryPartyIds |
0 ou plus | IDREFS |
Identifiant unique d'un ou de plusieurs éléments Party, qui indiquent que l'élément Contest fait partie d'une primaire partisane. PrimaryPartyId n'est pertinent que lors d'une élection primaire. |
VotesAllowed |
1 | integer |
Nombre maximal de votes ou de candidats non déclarés autorisés par électeur dans ce scrutin. 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'un scrutin, par exemple primaire ou général. 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="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
Utilisez PartyContest pour un scrutin où les électeurs choisissent un parti sur le bulletin de vote.
Il peut également être utilisé dans un flux de résultats d'élection en tant que scrutin récapitulatif virtuel pour communiquer des données globales (par exemple, un scrutin de parti au niveau de l'État qui agrège les résultats des scrutins des circonscriptions).
É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 lors du scrutin, qui correspond au n d'un scrutin 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 candidats non déclarés autorisés par électeur dans ce scrutin. Si VotesAllowed n'est pas présent dans le flux, la valeur par défaut 1 est utilisée. |
OfficeIds |
1 | IDREFS |
Identifiant unique d'un ou de plusieurs éléments Office.
Associe une description de bureau au concours. |
Type |
0 ou plus | ElectionType |
Type énuméré d'un scrutin, par exemple primaire ou général. 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="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
Utilisez BallotMeasureContest pour un scrutin impliquant des mesures de vote.
Éléments
Le tableau suivant décrit les éléments de BallotMeasureContest :
| Élément | Multiplicité | Type | Description |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Titre officiel du scrutin, par exemple Certains référendums ont un seul titre collectif avec plusieurs questions numérotées. Dans ce cas, le titre peut inclure le numéro de la question pour distinguer 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 existe du texte supplémentaire qui ne figure pas sur le bulletin de vote lui-même. 30 000 caractères maximum. Si le texte complet de la mesure de vote fait moins de 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 |
Résumé de la mesure électorale. Il se compose d'un ou deux paragraphes courts 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 |
Déclaration expliquant ce que signifie un vote Oui pour cette mesure de 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 |
Déclaration expliquant ce que signifie un vote Non pour cette mesure de scrutin. 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'une mesure électorale. Sélectionnez la valeur qui décrit le mieux la mesure de vote dans sa juridiction. |
PassageThreshold |
0 ou 1 | string |
Part minimale de votes requise pour qu'une motion soit adoptée. |
Exemples
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
Utilisez ce type lorsqu'un Contest implique un référendum pour décider si un élu doit rester en fonction ou être démis de ses fonctions.
Cela inclut, par exemple, les élections de rétention judiciaire dans certains États américains, qui décident si un juge doit continuer pour un autre mandat. Cela s'applique également aux élections de révocation, qui déterminent si un titulaire de fonction 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 actuel du poste |
OfficeId |
0 ou 1 | IDREF | ID de la fonction actuellement occupée par le titulaire |
Exemples
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>