比赛

使用 Contest 描述竞选，并将竞选与关联的候选人和政党相关联。

本文档讨论了 Contest 及其子实体：

  • Contest
    • CandidateContest
    • PartyContest
    • BallotMeasureContest
    • RetentionContest

类型

Contest 是一个抽象元素，有三种类型，根据竞赛类型使用：

  • CandidateContest：当 Contest 涉及一个或多个公职候选人时，请使用此类型。
  • PartyContest：当 Contest 在选票上有政党 名单选项时，请使用此类型。这也可以用作虚拟竞赛，作为更大规模的小型竞赛的总结。
  • BallotMeasureContest：当 Contest 涉及一项或多项投票措施时，请使用此类型。
  • RetentionContest：如果Contest涉及通过公投来决定当选官员应留任还是免职，请使用此类型。

在报告选举结果时，您可以更新 Feed 以显示结果的不同阶段，例如出口民调或估算结果。Google 会提供有关我们预计会涵盖哪些选举阶段和结果类型的指导。Google 可能会要求提供一个或多个阶段。这些阶段类型值可能会在大选之夜发生变化。将初始 Feed 值设置为要开始的阶段。如需了解详情，请参阅元素部分中的 CurrentResultsReportingStage 和 ResultsReportingStageCollection。

属性

下表介绍了 Contest 的属性：

属性 是否必需？ 类型 说明
objectId 必填 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 元素的唯一标识符。将竞选与代表竞选地理范围（例如选区）的报告单位相关联。

例如，对于特定竞选，ElectoralDistrictId 可能会引用为与该竞选关联的选区定义的 ReportingUnit。 Office 还包含一个可选引用，其用途相同。例如，对于全国性比赛，您可以重复使用为该国家/地区定义的同一 GpUnit。
ExternalIdentifiers 1 ExternalIdentifiers 将 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 预计在 Feed 中显示首个计票结果的时间。
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。如果 Feed 中没有 NumberElected，则使用默认值 1。
OfficeIds 1 IDREFS 一个或多个 Office 元素的唯一标识符。将办公室说明与竞赛相关联。
PrimaryPartyIds 0 个或更多 IDREFS 一个或多个 Party 元素的唯一标识符，表示 Contest 是党派初选的一部分。PrimaryPartyId 仅在初选中才有意义。
VotesAllowed 1 integer 此竞选中每位选民可投出的选票或手写选票数量上限。如果 Feed 中没有 VotesAllowed，则使用默认值 1。
Type 0 个或更多 ElectionType 竞选的枚举类型，例如初选或普选。仅当 的类型与 Election 的类型不同时，才应设置 Contest 的 类型。

示例

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。 这也可以在选举结果 Feed 中用作虚拟摘要竞选，以传达汇总数据（例如，汇总选区竞选结果的州级政党竞选）。

元素

下表介绍了 PartyContest 的元素：

元素 多样性 类型 说明
NumberElected 0 或 1 integer 在竞选中当选的候选人数量，即 n-of-m 竞选中的 n。如果 Feed 中没有 NumberElected，则使用默认值 1。
VotesAllowed 0 或 1 integer 此竞选中每位选民可投出的选票或手写选票数量上限。如果 Feed 中没有 VotesAllowed，则使用默认值 1。
OfficeIds 1 IDREFS 一个或多个 Office 元素的唯一标识符。 将职位说明与竞选相关联。
Type 0 个或更多 ElectionType 竞选的枚举类型，例如初选或普选。仅当 的类型与 Election 的类型不同时，才应设置 Contest 的 类型。

示例

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 个字符，并且不包含在 Feed 文件中无效的任何格式，请将其包含在 FullText 中。此外，还应添加 InfoUri，并附上带注解的 URI fulltext。 否则，请仅添加带有 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>