Contest
を使用して選挙を説明し、選挙を関連する候補者と政党にリンクします。
このドキュメントでは、Contest
とそのサブエンティティについて説明します。
Contest
CandidateContest
PartyContest
BallotMeasureContest
RetentionContest
型
Contest
は抽象要素で、コンテストのタイプに基づいて使用される 3 つのタイプがあります。
CandidateContest
:Contest
に 1 人以上の候補者が含まれる場合は、このタイプを使用します。PartyContest
:Contest
が投票用紙に政党リストの選択肢がある場合に使用します。BallotMeasureContest
:Contest
に 1 つ以上の投票項目が含まれている場合は、このタイプを使用します。RetentionContest
: 選出された公職者がその職に留まるか、その職から解任されるかを決定する国民投票がContest
に含まれる場合に使用します。
選挙結果が報告されたら、フィードを更新して、出口調査や推定値など、結果のさまざまな段階を表示できます。Google は、どの選挙段階と結果の種類を想定しているかについてのガイダンスを提供します。Google は 1 つまたは複数のステージをリクエストできます。これらのステージタイプの値は、選挙当日に変更される可能性があります。開始するステージに初期フィード値を設定します。詳しくは、要素セクションの ExternalIdentifiers
をご覧ください。
属性
次の表に、Contest
の属性を示します。
属性 | 必須かどうか | 型 | 説明 |
---|---|---|---|
objectId |
必須 | ID |
他の要素がこの要素を参照するために使用する一意の内部識別子。 |
要素
次の表に、Contest
の要素を示します。
要素 | 重複 | タイプ | 説明 |
---|---|---|---|
Abbreviation |
0 または 1 | string |
コンテストの略称。 |
BallotSelection |
0 以上 | BallotSelection |
投票用紙の選択肢をコンテストに関連付けます。 すべてのアイテムに |
BallotSubTitle |
0 または 1 | InternationalizedText |
選挙の副題。投票用紙に表示されるものと一致している必要があります。 |
BallotTitle |
0 または 1 | InternationalizedText |
コンテストのタイトル。タイトル テキストは、構文ガイドに対応している必要があります。投票法案のコンテストの場合、タイトルは投票用紙の文言と一致している必要があります。 |
ComposingContestIds |
0 以上 | IDREFS |
ロールアップ コンテストの定義に使用されます。たとえば、米国大統領の総選挙では、州レベルの選挙ごとに構成されたコンテスト ID を持つ全国レベルのコンテストがあります。
|
ContestDateStatus |
0 または 1 |
DateStatus
|
この要素は、選挙のスケジュール更新を示します。デフォルト値は |
ElectoralDistrictId |
1 | IDREF |
たとえば、特定のコンテストの場合、 |
ExternalIdentifiers |
1 | ExternalIdentifiers |
ID をコンテストに関連付けます。安定した識別子が必要です。フィードで報告される選挙結果の段階を指定するには、ContestStage の値を使用して OtherType を設定します。 |
HasRotation |
0 または 1 | boolean |
コンテストの選択肢がローテーションされるかどうかを示します。この要素がない場合、デフォルト値は false です。 |
Name |
1 | string |
これは、英語の BallotTitle と一致し、タイトルの構文に対応している必要があります。 |
SequenceOrder |
0 または 1 | integer |
結果を表示するための
|
SubsequentContestId |
0 または 1 | IDREF |
同じ関連セット内の後続のコンテストを指すために使用されます。たとえば、米国の選挙では、通常、予備選挙から関連する総選挙にリンクします。また、一般選挙から決選投票を指すこともあります。 通常、 |
SubUnitsReported |
0 または 1 | integer |
このコンテストの投票結果の報告を完了した選挙区などのサブユニットの数。 |
SummaryCounts |
0 以上 | SummaryCounts |
コンテストに関連付けられたその他のカウントの概要を提供します。これには、コンテストを含む投票用紙の総数と、棄権、超過投票、過少投票、手書きの総数が含まれます。概要のカウントは、SummaryCounts の複数の出現を使用して、コンテスト全体または他の下位レベルのレポート単位に関連付けることができます。 |
TotalSubUnits |
0 または 1 | integer |
この候補者が投票用紙に記載されている選挙区などのサブユニットの合計数。 |
VoteVariation |
0 または 1 | VoteVariation |
コンテストに関連付けられている投票バリエーションのタイプ(n-of-m など)。 |
OtherVoteVariation |
0 または 1 | string |
VoteVariation が other の場合にカスタム値を提供するために使用されます。 |
StartDate |
0 または 1 | PartialDate |
コンテストの開始日。ポーリングの開始日(2022-11-08 など)を使用します。開始日は、Contest の開始日と終了日が Election の開始日と終了日と異なる場合にのみ設定する必要があります。 |
EndDate |
0 または 1 | PartialDate |
コンテストのカレンダー上の終了日。投票の終了日(2022-11-08 など)を使用します。終了日は、Contest の開始日と終了日が Election の開始日と終了日と異なる場合にのみ設定する必要があります。 |
CountingDate |
0 または 1 | PartialDate |
選挙の集計が行われる投票日後の日付。これは、投票の最終日とカウント日が異なる場合(インドの Lok Sabha 選挙など)にのみ含める必要があります。通常、集計は投票最終日(選挙の EndDate )と同日に行われます。 |
CandidateContest
CandidateContest
は、1 人以上の候補者の選択を伴うコンテストを説明するために使用します。
このエンティティは、必要に応じて ID で Office
または Party
を参照できます。同じコンテストに候補者のチケットを登録することはできません。参照できる Office
は 1 つだけです。たとえば、大統領と副大統領のチケットの場合、2 つの Candidate
コンテストが必要になります。それぞれが異なるオフィスを参照します。
要素
次の表に、CandidateContest
の要素を示します。
要素 | 重複 | タイプ | 説明 |
---|---|---|---|
NumberElected |
0 または 1 | integer |
コンテストで選出される候補者の数。n-of-m コンテストの n です。フィードに NumberElected が含まれていない場合は、デフォルト値の 1 が使用されます。 |
OfficeIds |
1 | IDREFS |
1 つ以上の Office 要素の一意の識別子。オフィスの説明をコンテストに関連付けます。 |
PrimaryPartyIds |
0 以上 | IDREFS |
1 つ以上の Party 要素の一意の識別子。Contest が党派の予備選挙の一部であることを示します。PrimaryPartyId は予備選挙でのみ意味があります。 |
VotesAllowed |
1 | integer |
このコンテストで 1 人の投票者が投票または記入できる最大数。フィードに VotesAllowed が存在しない場合は、デフォルト値の 1 が使用されます。 |
Type |
0 以上 | ElectionType |
予備選挙や本選挙など、選挙の列挙型。Contest のタイプは、Election のタイプと異なる場合にのみ設定する必要があります。 |
例
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
投票者が投票用紙で政党を選択するコンテストには PartyContest
を使用します。
要素
次の表に、PartyContest
の要素を示します。
要素 | 重複 | タイプ | 説明 |
---|---|---|---|
NumberElected |
0 または 1 | integer |
コンテストで選出される候補者の数。n-of-m コンテストの n です。フィードに NumberElected が含まれていない場合は、デフォルト値の 1 が使用されます。 |
VotesAllowed |
0 または 1 | integer |
このコンテストで 1 人の投票者が投票または記入できる最大数。フィードに VotesAllowed が含まれていない場合は、デフォルト値の 1 が使用されます。 |
OfficeIds |
1 | IDREFS |
1 つ以上の Office 要素の一意の識別子。オフィスの説明をコンテストに関連付けます。 |
Type |
0 以上 | ElectionType |
予備選挙や本選挙など、選挙の列挙型。Contest のタイプは、Election のタイプと異なる場合にのみ設定する必要があります。 |
例
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
投票案を含むコンテストには BallotMeasureContest
を使用します。
要素
次の表に、BallotMeasureContest
の要素を示します。
要素 | 重複 | タイプ | 説明 |
---|---|---|---|
BallotTitle |
1 | InternationalizedText |
投票の正式なタイトル( 一部の国民投票では、複数の番号付きの質問を含む単一の包括的なタイトルが使用されています。このような場合、タイトルに質問番号を含めて、各質問に対して作成された |
BallotSubTitle |
0 または 1 | InternationalizedText |
投票のサブタイトル(ある場合)。 |
BallotText |
1 | InternationalizedText |
投票用紙に表示されるテキスト。例: 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 または 1 | InternationalizedText |
投票案の全文のコピー。投票用紙自体に含まれていない追加のテキストがある場合は、この要素を指定します。30,000 文字まで。 投票案の全文が 30,000 文字未満で、フィード ファイルで無効になる書式設定が含まれていない場合は、 |
InfoUri |
0 または 1 | AnnotatedUri |
他の場所に記載されているアノテーションではなく、次のアノテーションを受け入れるアノテーション付き URI:
|
SummaryText |
0 または 1 | InternationalizedText |
投票法案の概要。1 ~ 2 つの短い段落で構成され、パートナーが投票用紙の全文を要約するために生成できます。例:
|
ProStatement |
0 または 1 | InternationalizedText |
この投票用紙の投票項目で「はい」と投票した場合の意味を説明する文言。これは、この対策を支持する論拠にはなりません。例: A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
0 または 1 | InternationalizedText |
この投票法案に反対票を投じることの意味を説明する文言。これは、この対策に反対するものではありません。例: 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 または 1 | BallotMeasureType |
投票法案の列挙型。管轄区域の住民投票を最もよく表す値を選択します。 |
PassageThreshold |
0 または 1 | string |
動議が可決されるために必要な最低限の投票割合。 |
例
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
このタイプは、Contest
に、選出された公職者が職に留まるか、職から解任されるかを決定する国民投票が含まれる場合に使用します。
これには、米国の州で裁判官の任期延長を決定する裁判官の任期延長選挙などが含まれます。また、任期が終了する前に公職者の解職を決定するリコール選挙にも適用されます。
要素
BallotMeasureContest
のすべての要素は RetentionContest
にも適用されます。
要素 | 重複 | タイプ | 説明 |
---|---|---|---|
CandidateID |
1 | IDREF | 現在その役職に就いている公職者を代表する候補者の ID |
OfficeID |
0 または 1 | IDREF | 公職者が現在保持している公職の ID |
例
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>