比賽

使用 Contest 描述競選活動，並將競選活動連結至相關候選人和政黨。

本文將討論 Contest 及其子實體：

  • Contest
    • CandidateContest
    • PartyContest
    • BallotMeasureContest
    • RetentionContest

類型

Contest 是抽象元素，有三種類型，會根據競賽類型使用：

  • CandidateContest：如果 Contest 涉及一或多位公職候選人，請使用這個類型。
  • PartyContest：如果 Contest 的選票上有政黨名單選項，請使用這個類型。這也可以做為虛擬競賽，總結多項小型競賽。
  • BallotMeasureContest：如果 Contest 涉及一或多項投票提案，請使用這個類型。
  • RetentionContest：如果Contest涉及公投，決定民選官員應留任或免職，請使用這種類型。

選舉結果公布後，您可以更新動態饋給，顯示不同階段的結果，例如出口民調或預估結果。Google 會提供指引，說明我們預期的選舉階段和結果類型。Google 可能會要求提供一或多個階段。這些階段類型值在選舉之夜可能有所變動。將初始動態饋給值設為要開始的階段。詳情請參閱「元素」一節中的 CurrentResultsReportingStage 和 ResultsReportingStageCollection。

屬性

下表說明 Contest 的屬性：

屬性 是否必要？ 類型 說明
objectId 必填 ID 其他元素用來參照這個元素的專屬內部 ID。

元素

下表說明 Contest 的元素：

元素 多重性 類型 說明
Abbreviation 0 或 1 string 競賽簡稱。
AggregateBallotSelection 0 或 1 SpecialBallotSelection 計票匯總的選票選項，例如將多位候選人匯總為「其他」。
BallotSelection 0 以上 BallotSelection

將選票上的選項與競選活動建立關聯。Contest 中候選人或政黨的順序必須與 BallotSelection 中的順序相同。

如果每個項目都有 BallotSelection.SequenceOrder，系統會將其做為選項的預設順序。
BallotSubTitle 0 或 1 InternationalizedText 競選活動的副標題，必須與選民選票上的顯示方式相符。
BallotTitle 0 或 1 InternationalizedText 競賽名稱。標題文字應符合語法指南。 如果是投票議案競選，標題應與選票上的用詞一致。
BlankBallotSelection 0 或 1 SpecialBallotSelection 空白選票的選票選項。
ComposingContestIds 0 以上 IDREFS

用於定義匯總競賽。舉例來說，在美國總統大選中，全國選舉會包含各州選舉的選舉 ID。

ComposingContest 的範圍必須小於其上層競選活動，且必須在同一輪選舉中進行。
ContestDateStatus 0 或 1 DateStatus

這個元素代表選舉時間表的更新。預設值為 confirmed。在大多數情況下，ContestDateStatus 值最好與包含該值的 Election 的 ElectionDateStatus 相符。
ContestDateType 0 或 1 ElectionDateType

這個元素代表競賽加入日曆的方式。 如省略，預設值為封閉 Election 的 ElectionDateType。如果競賽有截止日期 (當天或之前)，但尚未設定日期，則值為 bounded。在大多數情況下，ContestDateType 值最好與包含該值的 Election 的 ElectionDateType 相符。
CountingDate 0 或 1 PartialDate 選舉計票的投票後日期。 只有在計票日與投票最後一天不同時，才應加入這個屬性，例如印度人民院選舉。一般情況下，計票作業會在投票最後一天進行，也就是選舉的EndDate。
CurrentResultsReportingStage 1 ResultsReportingStageType 競賽結果回報的目前階段。
EarliestPollsClose 0 或 1 dateTime 首批投票所關閉時。
ElectoralDistrictId 1 IDREF

GpUnit 元素的專屬 ID。將競選活動與代表競選活動地理範圍的報表單位建立關聯，例如選區。

舉例來說，對於特定競賽，ElectoralDistrictId 可能會參照為與競賽相關聯的學區定義的 ReportingUnit。Office 也包含一個用途相同的選用參考資料。舉例來說，如果是全國性競賽，您可以重複使用為該國家/地區定義的 GpUnit。
ExternalIdentifiers 1 ExternalIdentifiers 將 ID 與競賽建立關聯。必須提供穩定的 ID。
EndDate 0 或 1 PartialDate 競賽的結束日期。請使用投票結束日期，例如 2022-11-08。只有在Contest的開始和結束日期與Election的開始和結束日期不同時，才應設定結束日期。
EstimatedExpectedVotePercentage 0 或 1 float

通常簡稱為 EEVP，這是指這場選舉已回報的預期總票數預估百分比，介於 0 到 100 之間。

舉例來說，24.2% 應回報為 24.2，而非 0.242。
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 無效或廢票的選票選項。這類選票的標記方式會導致系統無法正確計票。 無效選票的例子包括破損、髒汙、標記過多或過少，或標記方式可識別選民身分的選票。
OutcomeDetermined 0 或 1 boolean

選舉結果是否已確定。

  • 如果競賽包含多個子競賽，則表示所有子競賽的結果都已確定。
  • 如果是候選人競選，這表示所有勝選或進入決選的候選人都已宣布 (無論是否為預測結果)，或競選已取消。
  • 如果是政黨選舉，這代表所有席次都已公布並標示為勝選席次，或剩餘席次的選舉已取消。
Seat 0 或 1 string 競選的特定席位。
SequenceOrder 0 或 1 integer

Contest 元素的預設排序，用於顯示結果。系統會根據下列規則顯示競賽：

  • 如果兩場競賽的值相同，系統可能會以未定義的順序顯示。
  • 所有含有 SequenceOrder 的競選活動都會依該順序顯示，接著是所有不含 SequenceOrder 值的競選活動，順序不限。

SequenceOrder 用於排序顯示的結果。 舉例來說，100 可代表區域競賽，200 可代表當地競賽，以此類推。SequenceOrder 不適合做為選票上的競選順序；不過，您可以使用 BallotStyle 實體，將選票樣式與對應的地緣政治單位建立關聯，藉此保留每張選票上的競選順序。
StartDate 0 或 1 PartialDate 競賽的開始日期。請使用投票開始日期，例如 2022-11-08。只有在Contest的開始和結束日期與Election的開始和結束日期不同時，才應設定開始日期。
SubsequentContestId 0 或 1 IDREF

用於指向同一組相關競賽中的後續競賽。以美國選舉為例，這個屬性通常會從初選指向相關的大選。也可以從普選指向決選。

SubsequentContest 的範圍通常與前一場競賽相同。
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 定義的包裝函式元素。詳情請參閱「集合實體」。

如果是組合競賽 (由上層競賽的 ComposingContestIds 參照)，您可以將選用的 boolean 子元素 InheritFromComposedContest 設為 true，以便沿用組合競賽的回報階段。如果 InheritFromComposedContest 為 true，請勿在集合中加入任何 ResultsReportingStage 元素。競賽必須列在另一項競賽的 ComposingContestIds 中。否則，必須提供 ResultsReportingStage，且集合應至少包含兩個 ResultsReportingStage 元素：一個將 StageType 設為 no-results，另一個則將 StageType 設為 preliminary 或 official。

CandidateContest

使用 CandidateContest 描述涉及選出一或多位候選人的競選活動。

這個實體可選擇依 ID 參照 Office 或 Party。我們不支援在同一場競選活動中呈現候選人名單；您只能參照一個 Office。舉例來說，如果是正副總統選舉，您需要兩個 Candidate 競選活動。每個網址都會參照不同的辦公室。

元素

下表說明 CandidateContest 的元素：

元素 多重性 類型 說明
NumberElected 0 或 1 integer 在競選中當選的候選人人數，也就是 n-of-m 競選的 n。如果動態饋給中沒有 NumberElected，系統會使用預設值 1。
OfficeIds 1 IDREFS 一或多個 Office 元素的專屬 ID。將職位說明與競選活動建立關聯。
PrimaryPartyIds 0 以上 IDREFS 一或多個 Party 元素的專屬 ID，表示 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 元素的專屬 ID。 將辦公室說明與競賽建立關聯。
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

選票的正式名稱，例如 Nevada Renewable Energy Standards Initiative。請確認 BallotTitle 不重複。

部分公投案會使用單一集體標題，並列出多個編號問題。在這種情況下，標題可以包含問題編號，以區分針對每個問題建立的 BallotMeasureContest 實體。
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 個字元，且不含任何在動態饋給檔案中無效的格式，請將其加入 FullText。此外，請加入 InfoUri，並加上 fulltext 的註解 URI。否則，請只加入含有 fulltext 註解的 URI。
InfoUri 0 或 1 AnnotatedUri

接受下列註解 (而非其他地方列出的註解) 的註解 URI：

  • wikipedia：關於公投提案的維基百科頁面
  • ballotpedia：Ballotpedia 網站上關於投票提案的頁面。例如：https://ballotpedia.org/Nevada_Renewable_Energy_Standards_Initiative_(2020)
  • official-website：投票提案的官方網站
  • fulltext：如果文字內容比選票上的多 (例如提案法案副本)，則這是完整額外文字的 URI。以下是範例： https://www.nvsos.gov/sos/home/showdocument?id=5330
  • logo-uri：標誌圖片
SummaryText 0 或 1 InternationalizedText

投票議案摘要。由一到兩個簡短段落組成，可由合作夥伴產生，用於總結選票全文，例如：

Requires utilities to acquire 50 percent of their electricity from renewable resources by 2030

Official Summary:

EXPLANATION—This ballot measure proposes to amend Article 4 of the Nevada Constitution to require all providers of electric utility services that sell electricity to retail customers for consumption in Nevada to meet a Renewable Portfolio Standard (RPS) that would go into effect beginning in calendar year 2022 and increase gradually until the RPS reaches 50 percent in calendar year 2030. According to the Public Utilities Commission of Nevada, an RPS establishes the percentage of electricity sold by an electric utility to retail customers that must come from renewable sources.
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>