比赛

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

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

  • Contest
    • CandidateContest
    • PartyContest
    • BallotMeasureContest

比赛

Contest 是一个抽象元素，根据比赛类型可使用以下三种类型的抽象元素：

  • CandidateContest：当 Contest 包含一个或多个办公室候选人时，请使用此类型。
  • PartyContest：如果 Contest 在选票上有党派名单选项，请使用此类型。
  • BallotMeasureContest：如果 Contest 涉及一项或多项公投议案，请使用此类型。

报告选举结果后，您可以更新 Feed 以显示不同阶段的结果，例如投票后投票结果或估算结果。Google 会就选举阶段和结果类型提供指南。Google 可以要求提供一个或多个阶段。这些阶段类型值在选举之夜期间可能会发生变化。将初始 Feed 值设置为起始阶段。如需了解详情，请参阅元素部分中的 ExternalIdentifiers。

属性

下表介绍了 Contest 的属性：

属性 是否必需？ 类型 说明
objectId 必需 ID 其他元素用于引用此元素的唯一内部标识符。

元素

下表介绍了 Contest 的元素：

元素 多样性 类型 说明
Abbreviation 0 或 1 string 比赛的简称。
BallotSelection 0 个或更多 BallotSelection

将选票上的选定项目与竞赛关联起来。Contest 中的候选人或方的顺序必须与 BallotSelection 中的顺序相同。

如果每项内容都有 BallotSelection.SequenceOrder，则将其作为所选项的默认顺序。
BallotSubTitle 0 或 1 InternationalizedText 比赛的副标题，必须与其在选民选票上的显示方式保持一致。
BallotTitle 0 或 1 InternationalizedText 比赛的标题，必须与其在选民选票上显示的名称一致。
BallotTitle 0 或 1 InternationalizedText 比赛的标题，必须与其在选民选票上显示的名称一致。
ComposingContestIds 0 个或更多 IDREFS

用于定义汇总比赛。例如，美国总统大选有一场国家级比赛，需要为每次州级选举编写比赛 ID。

ComposingContest 的范围必须小于其父级竞赛，并且必须与其在同一轮选举中举行。
ContestDateStatus 0 或 1 DateStatus

此元素表示为选举安排更新。默认值为 confirmed。在大多数情况下，ContestDateStatus 值最好与包含它的 Election 的 ElectionDateStatus 一致。
ElectoralDistrictId 1 IDREF

GpUnit 元素的唯一标识符。将比赛与表示比赛地理范围（例如选区）的报告单元相关联。

例如，对于特定比赛，ElectoralDistrictId 可能会引用为比赛关联的选区定义的 ReportingUnit。 Office 还包含具有相同用途的可选引用。例如，对于全国性的竞赛，您可以重复使用为国家/地区定义的同一 GpUnit。
ExternalIdentifiers 1 ExternalIdentifiers 将 ID 与比赛关联。必须提供稳定的标识符。如需提供 Feed 报告的选举结果所处的阶段，请将 OtherType 设置为 ContestStage 中的值。
HasRotation 0 或 1 boolean 用于指明比赛中的选定项目是否已轮播。如果此元素不存在，则默认值为 false。
Name 1 string 结果报告中列出的竞赛名称，不一定与选票中显示的名称相同。
SequenceOrder 0 或 1 integer

Contest 元素的默认顺序（用于显示结果）。竞赛按照以下规则展示：

  • 如果两场比赛的值相同，它们的显示顺序可能不确定。
  • 所有具有 SequenceOrder 的竞赛均按该顺序呈现，后跟所有不带 SequenceOrder 值的竞赛，顺序不确定。

SequenceOrder 用于对显示的结果进行排序。例如，100 可能表示地区性竞赛，200 可能表示本地竞赛，依此类推。 SequenceOrder 不适合用作选票上的比赛顺序；每张选票上的比赛顺序可以保留，但可以使用 BallotStyle 实体将选票样式与相应的地缘政治单位相关联。
SubsequentContestId 0 或 1 IDREF

用于指向同一相关组中稍后的比赛。例如，在美国选举中，它通常从初选指向相关的大选。也可能从大选改为二轮决选。

SubsequentContest 的作用域通常与其之前比赛的作用域相同。
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 选举竞赛统计的投票后日期。只有在计数日与投票的最后一天（例如印度人民院选举）不同时，才应添加此字段。常见的情况是，在投票的最后一天（即选举的 EndDate）进行计数。

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 枚举的比赛类型，例如初选或常规。仅当 Contest 的类型与 Election 的类型不同时，才应设置 Contest 的类型。

示例

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。如果 Feed 中不存在 NumberElected，则使用默认值 1。
VotesAllowed 0 或 1 integer 此次比赛中每位选民允许的最大投票数或发帖数。如果 Feed 中不存在 VotesAllowed，则使用默认值 1。
OfficeIds 1 IDREFS 一个或多个 Office 元素的唯一标识符。 将办公室说明与竞赛关联。
Type 0 个或更多 ElectionType 枚举的比赛类型，例如初选或常规。仅当 Contest 的类型与 Election 的类型不同时，才应设置 Contest 的类型。

示例

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

选票的官方标题，例如 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 中。此外，请添加带有注解的 URI fulltext 的 InfoUri。 否则，请只添加带有 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 枚举的公投议案类型。请选择最能准确描述其管辖区内公投议案的值。

示例

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",
      }
    ]