Contest를 사용하여 선거를 설명하고 선거를 관련 후보자 및 정당에 연결합니다.
이 문서에서는 Contest 및 하위 항목을 설명합니다.
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
유형
Contest는 콘테스트 유형에 따라 사용되는 세 가지 유형이 있는 추상 요소입니다.
CandidateContest:Contest에 하나 이상의 공직 후보자가 포함되는 경우 이 유형을 사용합니다.PartyContest:Contest에 투표용지에 정당 목록 선택이 있는 경우 이 유형을 사용합니다. 더 큰 소규모 콘테스트의 요약인 가상 콘테스트로 사용할 수도 있습니다.BallotMeasureContest:Contest에 하나 이상의 투표 안건이 포함된 경우 이 유형을 사용합니다.RetentionContest: 선출된 공무원이 직책을 유지해야 하는지 아니면 직책에서 해임되어야 하는지를 결정하는 국민투표가Contest에 포함되는 경우 이 유형을 사용합니다.
선거 결과가 발표되면 피드를 업데이트하여 출구 조사 또는 추정치와 같은 다양한 단계의 결과를 표시할 수 있습니다. Google에서는 예상되는 선거 단계와 결과 유형에 관한 안내를 제공합니다. Google에서 하나 이상의 단계를 요청할 수 있습니다. 이러한 단계 유형 값은 선거 당일에 변경될 수 있습니다. 시작할 스테이지로 초기 피드 값을 설정합니다. 자세한 내용은 요소 섹션의 CurrentResultsReportingStage 및 ResultsReportingStageCollection를 참고하세요.
속성
다음 표에서는 Contest의 속성을 설명합니다.
| 속성 | 필수 여부 | 유형 | 설명 |
|---|---|---|---|
objectId |
필수 | ID |
다른 요소가 이 요소를 참조하는 데 사용하는 고유 내부 식별자입니다. |
요소
다음 표에서는 Contest의 요소를 설명합니다.
| 요소 | 다중성 | 유형 | 설명 |
|---|---|---|---|
Abbreviation |
0 또는 1 | string |
콘테스트의 닉네임입니다. |
AggregateBallotSelection |
0 또는 1 | SpecialBallotSelection |
여러 후보자를 '기타'로 집계하는 등 투표수 집계를 위한 투표용지 선택 |
BallotSelection |
0 이상 | BallotSelection |
투표 용지의 선택 항목을 선거와 연결합니다.
|
BallotSubTitle |
0 또는 1 | InternationalizedText |
선거의 부제목으로, 유권자의 투표용지에 표시되는 내용과 일치해야 합니다. |
BallotTitle |
0 또는 1 | InternationalizedText |
콘테스트의 제목입니다. 제목 텍스트는 문법 가이드와 일치해야 합니다. 투표 안건 경선의 경우 제목이 투표 용지의 문구와 일치해야 합니다. |
BlankBallotSelection |
0 또는 1 | SpecialBallotSelection |
빈 투표용지의 투표용지 선택 |
ComposingContestIds |
0 이상 | IDREFS |
롤업 콘테스트를 정의하는 데 사용됩니다. 예를 들어 미국 대통령 일반 선거에는 각 주 수준 선거의 선거 ID로 구성된 전국 수준 선거가 있습니다.
|
ContestDateStatus |
0 또는 1 |
DateStatus
|
이 요소는 선거의 일정 업데이트를 나타냅니다. 기본값은 |
CountingDate |
0 또는 1 | PartialDate |
선거 경쟁의 집계가 이루어지는 투표 후 날짜입니다.
이는 집계일이 투표 마지막 날과 다른 경우에만 포함해야 합니다(예: 인도 Lok Sabha 선거). 일반적인 경우는 투표 마지막 날, 즉 선거일 EndDate에 집계가 이루어지는 것입니다.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
대회의 결과 보고의 현재 단계입니다. |
EarliestPollsClose |
0 또는 1 | dateTime |
첫 번째 설문조사가 종료되는 시점 대회를 구성하면 이 값이 없는 경우 상위 대회에서 상속됩니다. |
ElectoralDistrictId |
1 | IDREF |
예를 들어 특정 콘테스트의 경우 |
ExternalIdentifiers |
1 | ExternalIdentifiers |
ID를 콘테스트와 연결합니다. 안정적인 식별자가 필요합니다. |
EndDate |
0 또는 1 | PartialDate |
콘테스트의 캘린더 종료일입니다. 여론조사가 종료되는 날짜(예: 2022-11-08)를 사용합니다. Contest의 시작일과 종료일이 Election의 시작일과 종료일과 다른 경우에만 종료일을 설정해야 합니다.
|
FilingDeadline |
0 또는 1 | PartialDate |
후보자가 콘테스트에 신청해야 하는 날짜입니다. |
HasRotation |
0 또는 1 | boolean |
콘테스트의 선택사항이 로테이션되는지 여부를 나타냅니다. 이 요소가 없으면 기본값은 false입니다. |
IsNotable |
0 또는 1 | boolean |
엔티티가 주목할 만한 것으로 간주되는지 여부입니다. 지정되지 않은 경우 false로 간주됩니다.
|
LatestPollsClose |
0 또는 1 | dateTime |
마지막 설문조사가 종료되는 시점입니다. 대회를 구성하면 이 값이 없는 경우 상위 대회에서 상속됩니다. |
Name |
1 | string |
이는 영어의 BallotTitle와 일치해야 하며 제목 구문에 해당해야 합니다. |
NoneOfTheAboveBallotSelection |
0 또는 1 | SpecialBallotSelection |
'해당 사항 없음' 또는 '없음', '해당 사항 없음', '미정'과 같은 이에 상응하는 선택사항에 투표하기 위한 투표용지 옵션의 투표용지 선택입니다. |
NullBallotSelection |
0 또는 1 | SpecialBallotSelection |
무효표 또는 손상된 투표용지의 투표용지 선택입니다. 이러한 투표용지는 투표를 제대로 집계할 수 없는 방식으로 표시된 투표용지입니다. 무효 투표의 예로는 찢어졌거나, 더러워졌거나, 과도하게 표시되었거나, 부족하게 표시되었거나, 유권자를 식별할 수 있는 방식으로 표시된 투표가 있습니다. |
Seat |
0 또는 1 | string |
콘테스트가 진행되는 구체적인 자리입니다. |
SequenceOrder |
0 또는 1 | integer |
결과를 표시하기 위한
|
StartDate |
0 또는 1 | PartialDate |
콘테스트의 캘린더 시작일입니다. 여론조사가 시작되는 날짜(예: 2022-11-08)를 사용합니다. 시작일은 Contest의 시작일과 종료일이 Election의 시작일과 종료일과 다른 경우에만 설정해야 합니다.
|
SubsequentContestId |
0 또는 1 | IDREF |
동일한 관련 세트의 후속 콘테스트를 가리키는 데 사용됩니다. 예를 들어 미국 선거에서는 일반적으로 예비 선거에서 관련 본선으로 연결됩니다. 일반 선거에서 결선 투표로 이어질 수도 있습니다.
|
SubUnitsReported |
0 또는 1 | integer |
이 선거의 투표 보고를 완료한 선거구와 같은 하위 단위의 수입니다. |
SummaryCounts |
0 이상 | SummaryCounts |
콘테스트와 관련된 기타 수치의 요약을 제공합니다. 여기에는 선거를 포함하는 투표용지의 총수와 기권, 초과 투표, 미달 투표, 서면 투표의 총수가 포함됩니다. 요약 개수는 SummaryCounts가 여러 번 발생한 것을 사용하여 전체 콘테스트 또는 기타 하위 수준 보고 단위와 연결될 수 있습니다. |
TotalSeats |
0 또는 1 | integer |
이 선거의 선거구에서 직책을 위해 확보할 수 있는 총 의석수입니다. 이는 선거 의석 + 이월된 의석 + 공석과 동일합니다. |
TotalSubUnits |
0 또는 1 | integer |
선거구와 같이 투표용지에 이 선거가 있는 하위 단위의 총수입니다. |
VoteVariation |
0 또는 1 | VoteVariation |
선거와 연결된 투표 변형 유형입니다(예: n-of-m). |
OtherVoteVariation |
0 또는 1 | string |
VoteVariation이 other인 경우 맞춤 값을 제공하는 데 사용됩니다. |
ResultsEmbargoEnd |
0 또는 1 | dateTime |
선거 결과 게시 금지가 종료되는 시점입니다. 대회를 구성하면 이 값이 없는 경우 상위 대회에서 상속됩니다. |
ResultsExpected |
0 또는 1 | dateTime |
첫 번째 투표수 결과가 피드에 표시될 것으로 예상되는 시간입니다. 구성 경연대회는 이 값이 없는 경우 상위 경연대회에서 상속합니다. |
ResultsLastUpdated |
0 또는 1 | dateTime |
콘테스트 결과가 마지막으로 업데이트된 시간입니다. |
ResultsReportingStageCollection |
0 또는 1 | 해당 사항 없음 | ResultsReportingStage 정의의 래퍼 요소입니다. 자세한 내용은 수집 항목을 참고하세요. |
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="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
유권자가 투표용지에서 정당을 선택하는 선거에는 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="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
투표 안건이 포함된 선거에는 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="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
선출된 공무원이 직책을 유지해야 하는지 아니면 직책에서 해임되어야 하는지를 결정하는 국민투표가 Contest에 포함되는 경우 이 유형을 사용합니다.
여기에는 일부 미국 주에서 판사가 다음 임기를 계속해야 하는지 결정하는 사법부 유임 경쟁과 같은 사례가 포함됩니다. 또한 임기가 끝나기 전에 공직자를 해임할지 여부를 결정하는 소환 선거에도 적용됩니다.
요소
BallotMeasureContest의 모든 요소는 RetentionContest에도 적용됩니다.
| 요소 | 다중성 | 유형 | 설명 |
|---|---|---|---|
CandidateId |
1 | IDREF | 현재 직책을 맡고 있는 현직자를 나타내는 후보자의 ID입니다. |
OfficeId |
0 또는 1 | IDREF | 현직 공무원이 현재 보유하고 있는 직책의 ID입니다. |
예
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>