Contest を使用してコンテストの説明を指定し、コンテストを関連する候補者や団体にリンクします。
このドキュメントでは、Contest とそのサブエンティティについて説明します。
ContestCandidateContestPartyContestBallotMeasureContest
コンテスト
Contest は、コンテストの種類に応じて 3 つの型を持つ抽象要素です。
CandidateContest:Contestにオフィスの 1 人以上の候補者が関係している場合は、このタイプを使用します。PartyContest:Contestが投票で政党リストを選択している場合は、このタイプを使用します。BallotMeasureContest:Contestに 1 つ以上の投票法案が含まれる場合に、このタイプを使用します。
選挙の結果が報告されたら、フィードを更新して、出口調査や推定選挙などのさまざまな段階の結果を表示できます。Google では、予想される選挙段階と選挙結果タイプに関するガイダンスを提供しています。Google は 1 つまたは複数のステージを要求できます。これらのステージタイプの値は、選挙日の夜中に変更される可能性があります。最初のフィード値を、最初に使用するステージに設定します。詳しくは、要素セクションの ExternalIdentifiers をご覧ください。
属性
次の表に、Contest の属性を示します。
| 属性 | 必須かどうか | タイプ | 説明 |
|---|---|---|---|
objectId |
必須 | ID |
他の要素がこの要素を参照するために使用する一意の内部 ID。 |
要素
次の表に、Contest の要素を示します。
| 要素 | 重複 | タイプ | 説明 |
|---|---|---|---|
Abbreviation |
0 または 1 | string |
コンテストの略称。 |
BallotSelection |
0 以上 | BallotSelection |
投票用紙の選出結果をコンテストに関連付けます。
|
BallotSubTitle |
0 または 1 | InternationalizedText |
コンテストのサブタイトル。投票者の投票用紙の表記と一致している必要があります。 |
BallotTitle |
0 または 1 | InternationalizedText |
コンテストのタイトル。投票者の投票用紙の表記と一致している必要があります。 |
BallotTitle |
0 または 1 | InternationalizedText |
コンテストのタイトル。投票者の投票用紙の表記と一致している必要があります。 |
ComposingContestIds |
0 以上 | IDREFS |
ロールアップ コンテストの定義に使用します。たとえば米国大統領総選挙では、州レベルの選挙ごとにコンテスト ID を作成する国レベルのコンテストがあります。
|
ContestDateStatus |
0 または 1 |
DateStatus
|
この要素は、選挙の更新のスケジュール設定を示します。デフォルト値は |
ElectoralDistrictId |
1 | IDREF |
たとえば、特定のコンテストについて、 |
ExternalIdentifiers |
1 | ExternalIdentifiers |
ID をコンテストに関連付けます。固定 ID が必要です。フィードで報告される選挙結果の段階を指定するには、OtherType に ContestStage の値を設定します。 |
HasRotation |
0 または 1 | boolean |
コンテストの出品物がローテーションされるかどうかを示します。この要素が存在しない場合、デフォルト値は false です。 |
Name |
1 | string |
結果レポートに記載されているコンテスト名。必ずしも投票用紙に記載されているわけではありません。 |
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 つのみです。たとえば、大統領と副大統領のチケットの場合、Candidate のコンテストが 2 回必要になります。それぞれ異なるオフィスを参照しています。
要素
次の表に、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">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>
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": "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
投票で投票所を選ぶコンテストでは、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="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>
JSON
"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
投票法案を含むコンテストの場合は BallotMeasureContest を使用します。
要素
次の表に、BallotMeasureContest の要素を示します。
| 要素 | 重複 | タイプ | 説明 |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
投票用紙の正式なタイトル（ 住民投票には、複数の番号付きの質問からなる 1 つの共通タイトルが付くものもあります。このような場合、各質問に対して作成された |
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 |
投票対象法案に対する「いいえ」の投票の意味を説明する声明。measure に対する議論ではない。例: 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 |
投票法案の列挙型。管轄区域の投票法案に最も近い値を選択してください。 |
例
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>
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"
}
],
"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",
}
]