Verwenden Sie Contest
, um einen Wettbewerb zu beschreiben und den Wettbewerb mit den zugehörigen Kandidaten und Parteien zu verknüpfen.
In diesem Dokument werden Contest
und ihre Unterentitäten erörtert:
Contest
CandidateContest
PartyContest
BallotMeasureContest
Wettbewerb
Contest
ist ein abstraktes Element mit drei Typen, die je nach Art des Wettbewerbs verwendet werden:
CandidateContest
: Verwenden Sie diesen Typ, wenn zu einerContest
ein oder mehrere Kandidaten für ein Büro gehören.PartyContest
: Verwenden Sie diesen Typ, wenn für eineContest
eine Partei ausgewählt wurde.BallotMeasureContest
: Verwenden Sie diesen Typ, wennContest
eine oder mehrere Abstimmungen beinhaltet.
Sobald die Ergebnisse einer Wahl gemeldet werden, können Sie Ihren Feed so aktualisieren, dass unterschiedliche Phasen angezeigt werden, z. B. Wahlbefragungen oder Schätzungen. Google bietet Informationen dazu, welche Wahlphasen und Ergebnistypen erwartet werden. Google kann eine oder mehrere Phasen anfordern. Diese Phasentypwerte können sich während der Wahlnacht ändern. Legen Sie den anfänglichen Feedwert auf die Phase fest, mit der begonnen werden soll. Weitere Informationen finden Sie unter ExternalIdentifiers
im Abschnitt Elemente.
Attribute
In der folgenden Tabelle werden die Attribute für Contest
beschrieben:
Attribut | Erforderlich/Optional? | Typ | Beschreibung |
---|---|---|---|
objectId |
Erforderlich | ID |
Eindeutige interne Kennung, die von anderen Elementen verwendet wird, um auf dieses Element zu verweisen. |
Elemente
In der folgenden Tabelle werden die Elemente für Contest
beschrieben:
Element | Multiplizität | Typ | Beschreibung |
---|---|---|---|
Abbreviation |
„0“ oder „1“ | string |
Kurzname für den Wettbewerb. |
BallotSelection |
0 oder mehr | BallotSelection |
Die Auswahl auf dem Stimmzettel wird mit dem Wettbewerb verknüpft. Die Reihenfolge der Kandidaten oder Parteien in Wenn |
BallotSubTitle |
„0“ oder „1“ | InternationalizedText |
Untertitel des Wettbewerbs, der mit der Anzeige in den Stimmen der Wähler übereinstimmen muss. |
BallotTitle |
„0“ oder „1“ | InternationalizedText |
Titel des Wettbewerbs, der mit der Angabe in der Stimmabgabe der Wähler übereinstimmen muss. |
BallotTitle |
„0“ oder „1“ | InternationalizedText |
Titel des Wettbewerbs, der mit der Angabe in der Stimmabgabe der Wähler übereinstimmen muss. |
ComposingContestIds |
0 oder mehr | IDREFS |
Wird verwendet, um einen Netzwerk-Wettbewerb zu definieren. Bei den US-Präsidentschaftswahlen gibt es beispielsweise einen nationalen Wettbewerb, bei dem die Wettbewerbs-IDs für jede Wahl auf bundesstaatlicher Ebene zusammenstellen. Ein |
ContestDateStatus |
„0“ oder „1“ |
DateStatus
|
Mit diesem Element werden Aktualisierungen zu einer Wahl geplant. Der Standardwert ist |
ElectoralDistrictId |
1 | IDREF |
Eindeutige Kennung für ein Beispielsweise kann |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Verknüpft eine ID mit dem Wettbewerb. Eine stabile Kennung ist erforderlich. Wenn du den Stand der in deinem Feed gemeldeten Wahlergebnisse angeben möchtest, lege für OtherType einen Wert von ContestStage fest. |
HasRotation |
„0“ oder „1“ | boolean |
Gibt an, ob die Auswahlen im Wettbewerb rotieren. Wenn dieses Element nicht vorhanden ist, wird der Standardwert false verwendet. |
Name |
1 | string |
Der Name des Wettbewerbs, wie er im Ergebnisbericht aufgeführt ist, muss nicht unbedingt mit dem Stimmzettel übereinstimmen. |
SequenceOrder |
„0“ oder „1“ | integer |
Die Standardsortierung von
Mit |
SubsequentContestId |
„0“ oder „1“ | IDREF |
Wird verwendet, um auf einen späteren Wettbewerb in derselben verwandten Reihe zu verweisen. Bei Wahlen in den USA verweist er beispielsweise in der Regel von einer Vorwahl auf die zugehörige Parlamentswahl. Er kann sich auch von einer Parlamentswahl auf eine Stichwahl verweisen. Ein |
SubUnitsReported |
„0“ oder „1“ | integer |
Die Anzahl der Untereinheiten, z. B. Wahlkreise, die für diesen Wettbewerb Stimmen abgegeben haben. |
SummaryCounts |
0 oder mehr | SummaryCounts |
Liefert eine Zusammenfassung der verschiedenen Zählwerte im Zusammenhang mit dem Wettbewerb. Dazu gehören die Gesamtzahl der Stimmzettel für den Wettbewerb sowie die Gesamtzahl der Stimmen, Überstimmen, Unterstimmen oder Beiträge. Die zusammengefasste Anzahlen kann dem Wettbewerb als Ganzes oder anderen untergeordneten Berichtseinheiten zugeordnet werden, wenn SummaryCounts mehrmals verwendet wird. |
TotalSubUnits |
„0“ oder „1“ | integer |
Die Gesamtzahl der Untereinheiten, z. B. Wahlbezirke, für die dieser Wahlgang zur Abstimmung geführt hat. |
VoteVariation |
„0“ oder „1“ | VoteVariation |
Die Art der Stimmenvariation, die mit dem Wettbewerb verknüpft ist, z. B. n-of-m . |
OtherVoteVariation |
„0“ oder „1“ | string |
Wird verwendet, um einen benutzerdefinierten Wert bereitzustellen, wenn VoteVariation other ist. |
StartDate |
„0“ oder „1“ | PartialDate |
Kalenderstartdatum des Wettbewerbs Verwenden Sie das Datum des Umfragebeginns, z. B. 2022-11-08. Das Startdatum sollte nur festgelegt werden, wenn das Start- und Enddatum des Contest vom Start- und Enddatum des Election abweichen.
|
EndDate |
„0“ oder „1“ | PartialDate |
Das Kalenderenddatum des Wettbewerbs. Verwenden Sie das Datum für das Ende der Umfrage, z. B. 2022-11-08. Das Enddatum sollte nur festgelegt werden, wenn das Start- und Enddatum des Contest vom Start- und Enddatum des Election abweichen.
|
CountingDate |
„0“ oder „1“ | PartialDate |
Das Datum der Abstimmung nach der Abstimmung, an dem die Auszählung für den Wahlwettbewerb erfolgt. Dieser Wert sollte nur angegeben werden, wenn sich der Zähltag vom letzten Wahltag unterscheidet, z. B. bei der India Lok Sabha-Wahl. Üblicherweise wird die Auszählung am selben Tag wie die letzte Stimmabgabe durchgeführt, also am EndDate der Wahl.
|
CandidateContest
Verwenden Sie CandidateContest
, um einen Wettbewerb zu beschreiben, bei dem ein oder mehrere Kandidaten ausgewählt werden.
Diese Entität kann optional anhand der ID auf Office
oder Party
verweisen. Die Darstellung eines Tickets für Kandidaten in demselben Wettbewerb wird nicht unterstützt. Es kann immer nur ein Office
-Element referenziert werden. Für ein „Präsident“- und „Vice President“-Ticket benötigen Sie beispielsweise zwei Candidate
-Wettbewerbe. Jede davon würde sich auf ein
anderes Büro beziehen.
Elemente
In der folgenden Tabelle werden die Elemente für CandidateContest
beschrieben:
Element | Multiplizität | Typ | Beschreibung |
---|---|---|---|
NumberElected |
„0“ oder „1“ | integer |
Die Anzahl der Kandidaten, die für den Wettbewerb gewählt wurden. Dies entspricht den n eines n-of-m -Wettbewerbs. Wenn NumberElected nicht im Feed vorhanden ist, wird der Standardwert 1 verwendet. |
OfficeIds |
1 | IDREFS |
Eindeutige Kennung für ein oder mehrere Office -Elemente.
Verknüpft eine Office-Beschreibung mit dem Wettbewerb. |
PrimaryPartyIds |
0 oder mehr | IDREFS |
Eindeutige Kennung für ein oder mehrere Party -Elemente, die anzeigen, dass die Contest Teil einer partisanen Primärinstanz ist. PrimaryPartyId ist nur bei einer Vorwahl von Bedeutung. |
VotesAllowed |
1 | integer |
Die maximale Anzahl der Stimmen oder Beiträge, die pro Teilnehmer bei diesem Wettbewerb zulässig sind. Wenn VotesAllowed nicht im Feed vorhanden ist, wird der Standardwert 1 verwendet. |
Type |
0 oder mehr | ElectionType |
Der Aufzählungstyp eines Wettbewerbs, z. B. „Primär“ oder „Allgemein“. Der Typ von Contest sollte nur festgelegt werden, wenn er vom Typ des Election abweicht. |
Beispiele
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">President of Kenya</Text> <Text language="es">Presidente de Kenya</Text> <Text language="fr">Président du Kenya</Text> <Text language="id">Presiden Kenya</Text> </BallotTitle> <CountStatus>...</CountStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <Name>President of Kenya</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>
JavaScript Object Notation
"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": "President and Vice-President of Kenya", "language": "en" }, { "value": "Presidente y Vice-Presidente de Kenya", "language": "es" }, { "value": "Président et vice-président du Kenya", "language": "fr" }, { "value": "Presiden dan Wakil Presiden Kenya", "language": "id" }, { "value": "राष्ट्रपति और केन्या के उपराष्ट्रपति", "language": "hi" }, { "value": "Rais na Makamu wa Rais of Kenya", "language": "sw" } ] }, "CountStatus": "...", "ElectoralDistrictId": "...", "Name": "President of Kenya", "SubUnitsReported": 48, "SummaryCounts": "...", "TotalSubUnits": 48, "VoteVariation": "1-of-m", "NumberElected": 1, "VotesAllowed": 1, "Type": "general" } ]
PartyContest
Verwenden Sie PartyContest
für einen Wettbewerb, bei dem die Wähler eine Partei auf dem Stimmzettel wählen.
Elemente
In der folgenden Tabelle werden die Elemente für PartyContest
beschrieben:
Element | Multiplizität | Typ | Beschreibung |
---|---|---|---|
NumberElected |
„0“ oder „1“ | integer |
Die Anzahl der Kandidaten, die für den Wettbewerb gewählt wurden. Dies entspricht den n eines n-of-m -Wettbewerbs. Wenn NumberElected nicht im Feed vorhanden ist, wird der Standardwert 1 verwendet. |
VotesAllowed |
„0“ oder „1“ | integer |
Die maximale Anzahl der Stimmen oder Beiträge, die pro Teilnehmer bei diesem Wettbewerb zulässig sind. Wenn VotesAllowed nicht im Feed vorhanden ist, wird der Standardwert 1 verwendet. |
OfficeIds |
1 | IDREFS |
Eindeutige Kennung für ein oder mehrere Office -Elemente.
Verknüpft eine Office-Beschreibung mit dem Wettbewerb. |
Type |
0 oder mehr | ElectionType |
Der Aufzählungstyp eines Wettbewerbs, z. B. „Primär“ oder „Allgemein“. Der Typ von Contest sollte nur festgelegt werden, wenn er vom Typ des Election abweicht. |
Beispiele
XML
<Contest xsi:type="PartyContest" objectId="pc20001"> <BallotSelection objectId="ps10132" xsi:type="PartySelection"> <PartyIds>par10132 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>
JavaScript Object Notation
"Contest": [ { "@type": "PartyContest", "objectId": "pc20001", "BallotSelection": [ { "@type": "PartySelection", "objectId": "ps10132", "PartyIds": [ "par10132", "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
Verwenden Sie BallotMeasureContest
für einen Wettbewerb, der Abstimmungen umfasst.
Elemente
In der folgenden Tabelle werden die Elemente für BallotMeasureContest
beschrieben:
Element | Multiplizität | Typ | Beschreibung |
---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Der offizielle Titel des Stimmzettels, z. B. Einige Referenden haben einen gemeinsamen Titel mit mehreren nummerierten Fragen. In diesen Fällen kann der Titel die Fragenummer enthalten, damit zwischen den |
BallotSubTitle |
„0“ oder „1“ | InternationalizedText |
Der Untertitel des Stimmzettels, falls vorhanden. |
BallotText |
1 | InternationalizedText |
Der Text, der auf dem Stimmzettel selbst erscheint. Beispiel: 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“ oder „1“ | InternationalizedText |
Eine Kopie des vollständigen Abstimmungstextes. Geben Sie dieses Element an, wenn der Stimmzettel keinen zusätzlichen Text enthält. Begrenzt auf 30.000 Zeichen. Wenn der vollständige Abstimmungstext kürzer als 30.000 Zeichen ist und keine Formatierung enthält,die in einer Feeddatei ungültig wäre, füge diese in |
InfoUri |
„0“ oder „1“ | AnnotatedUri |
Ein annotierter URI, der anstelle der an anderer Stelle aufgeführten Annotationen die folgenden Annotationen akzeptiert:
|
SummaryText |
„0“ oder „1“ | InternationalizedText |
Eine Zusammenfassung der Abstimmungen. Besteht aus ein bis zwei kurzen Absätzen und kann vom Partner generiert werden, um den vollständigen Text des Stimmzettels zusammenzufassen, wie im folgenden Beispiel:
|
ProStatement |
„0“ oder „1“ | InternationalizedText |
Eine Erklärung, die erklärt, was ein Ja-Stimmen zu diesem Abstimmungsergebnis bedeutet. Es ist kein Argument zugunsten des Messwerts. Zum Beispiel:
A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
„0“ oder „1“ | InternationalizedText |
Eine Erklärung, die erläutert, was ein Nein-Stimmen zu dieser Abstimmung bedeutet. Es ist kein Argument gegen den Messwert. Beispiel: 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“ oder „1“ | BallotMeasureType |
Ein Aufzählungstyp einer Abstimmung. Wählen Sie den Wert aus, der die Abstimmung in seiner Gerichtsbarkeit am besten beschreibt. |
Beispiele
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> <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>
JavaScript Object Notation
"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" } ], "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", } ]