Contest
를 사용하여 선거를 설명하고 선거를 관련 후보자 및 정당에 연결합니다.
이 문서에서는 Contest
및 하위 항목에 대해 설명합니다.
Contest
CandidateContest
PartyContest
BallotMeasureContest
RetentionContest
유형
Contest
는 콘테스트 유형에 따라 사용되는 세 가지 유형이 있는 추상 요소입니다.
CandidateContest
:Contest
에 하나 이상의 공직 후보자가 포함되는 경우 이 유형을 사용합니다.PartyContest
:Contest
에 투표용지에 정당 목록 선택이 있는 경우 이 유형을 사용합니다.BallotMeasureContest
:Contest
에 하나 이상의 투표 안건이 포함된 경우 이 유형을 사용합니다.RetentionContest
: 선출된 공무원이 직책을 유지해야 하는지 아니면 직책에서 해임되어야 하는지를 결정하는 국민투표가Contest
에 포함되는 경우 이 유형을 사용합니다.
선거 결과가 발표되면 출구 조사나 추정치와 같은 다양한 단계의 결과를 표시하도록 피드를 업데이트할 수 있습니다. Google에서는 예상되는 선거 단계와 결과 유형에 관한 안내를 제공합니다. Google에서 하나 이상의 단계를 요청할 수 있습니다. 이러한 단계 유형 값은 선거 당일에 변경될 수 있습니다. 시작할 단계를 초기 피드 값으로 설정합니다. 자세한 내용은 요소 섹션의 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
을 사용합니다.
이 항목은 ID로 Office
또는 Party
를 선택적으로 참조할 수 있습니다. 후보자의 티켓을 동일한 콘테스트에 표시하는 것은 지원되지 않습니다. 하나의 Office
만 참조할 수 있습니다. 예를 들어 대통령 및 부통령 후보의 경우 Candidate
콘테스트가 두 개 필요합니다. 각각 다른 사무실을 참조합니다.
요소
다음 표에서는 CandidateContest
의 요소를 설명합니다.
요소 | 다중성 | 유형 | 설명 |
---|---|---|---|
NumberElected |
0 또는 1 | integer |
경연에서 선출된 후보자 수입니다. n-of-m 경연의 n입니다. NumberElected 이 피드에 없으면 기본값 1 이 사용됩니다. |
OfficeIds |
1 | IDREFS |
하나 이상의 Office 요소의 고유 식별자입니다.
사무실 설명을 콘테스트와 연결합니다. |
PrimaryPartyIds |
0개 이상 | IDREFS |
하나 이상의 Party 요소의 고유 식별자로, Contest 이 당파 예비 선거의 일부임을 나타냅니다. PrimaryPartyId 은 예비 선거에서만 의미가 있습니다. |
VotesAllowed |
1 | integer |
이 선거에서 유권자당 허용되는 최대 투표수 또는 기표수입니다. 피드에 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 |
이 선거에서 유권자당 허용되는 최대 투표수 또는 기표수입니다. 피드에 VotesAllowed 이 없으면 기본값 1 이 사용됩니다. |
OfficeIds |
1 | IDREFS |
하나 이상의 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>