Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

コンテスト

Contest を使用してコンテストを説明し、コンテストを関連する候補者と政党にリンクします。

このドキュメントでは、Contest とそのサブエンティティについて説明します。

Contest
- CandidateContest
- PartyContest
- BallotMeasureContest
- RetentionContest

型

Contest は抽象要素で、コンテストのタイプに応じて 3 つのタイプが使用されます。

CandidateContest: Contest に 1 人以上の候補者が含まれる場合は、このタイプを使用します。
PartyContest: Contest の投票用紙に政党リストの選択肢がある場合に使用します。これは、より大きな一連の小さなコンテストの概要である仮想コンテストとしても使用できます。
BallotMeasureContest: Contest に 1 つ以上の投票案が含まれている場合は、このタイプを使用します。
RetentionContest: 選出された公職者が職務を継続するか、解任されるかを決定する国民投票が Contest に含まれる場合に使用します。

選挙結果が報告されたら、フィードを更新して、出口調査や推定値など、結果のさまざまな段階を表示できます。Google は、どの選挙段階と結果の種類を想定しているかについてのガイダンスを提供します。Google は 1 つまたは複数のステージをリクエストできます。これらのステージタイプの値は、選挙当日に変更される可能性があります。初期フィード値を開始するステージに設定します。詳しくは、要素セクションの 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` と一致させるのが最適です。
`CountingDate`	0 または 1	`PartialDate`	選挙の集計が行われる投票後の日付。これは、投票の最終日とカウント日が異なる場合（インドの Lok Sabha 選挙など）にのみ含める必要があります。一般的なケースでは、投票の最終日、つまり選挙の `EndDate` と同日に集計が行われます。注: この属性を設定する場合、日付は `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` の開始日と終了日と異なる場合にのみ設定する必要があります。注: この属性を設定する場合は、`StartDate` も設定する必要があります。すべての `EndDate` に対応する `StartDate` が必要です。
`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`	結果を表示するための `Contest` 要素のデフォルトの順序。コンテストは次のルールに従って表示されます。 2 つのコンテストの値が同じ場合、順序は未定義になる可能性があります。 `SequenceOrder` のあるすべてのコンテストがその順序で表示され、その後に `SequenceOrder` 値のないすべてのコンテストが順序なしで表示されます。 `SequenceOrder` は、表示される結果を並べ替えるために使用されます。たとえば、`100` は地域コンテスト、`200` はローカルコンテストなどを示すことができます。`SequenceOrder` は、投票用紙の候補者順序として使用するのに適していません。ただし、`BallotStyle` エンティティを使用して、投票用紙のスタイルを対応する地政学的単位に関連付けることで、各投票用紙の候補者順序を保持できます。
`StartDate`	0 または 1	`PartialDate`	コンテストの開始日。ポーリングが開始される日付（2022-11-08 など）を使用します。開始日は、`Contest` の開始日と終了日が `Election` の開始日と終了日と異なる場合にのみ設定する必要があります。注: この属性を設定する場合は、`EndDate` も設定する必要があります。すべての `StartDate` に対応する `EndDate` が必要です。
`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` 定義のラッパー要素。詳しくは、コレクションエンティティをご覧ください。

CandidateContest

CandidateContest は、1 人以上の候補者の選択を伴うコンテストを説明するために使用します。

このエンティティは、必要に応じて ID で Office または Party を参照できます。候補者のチケットを同じコンテストに登録することはできません。参照できる Office は 1 つだけです。たとえば、大統領と副大統領のチケットの場合、2 つの Candidate コンテストが必要になります。それぞれが異なるオフィスを参照します。

要素

次の表に、CandidateContest の要素を示します。

要素	重複	タイプ	説明
`NumberElected`	0 または 1	`integer`	コンテストで選出される候補者の数。これは `n-of-m` コンテストの n です。フィードに `NumberElected` が存在しない場合は、デフォルト値の `1` が使用されます。
`OfficeIds`	1	`IDREFS`	1 つ以上の `Office` 要素の固有識別子。オフィスの説明をコンテストに関連付けます。
`PrimaryPartyIds`	0 以上	`IDREFS`	1 つ以上の `Party` 要素の固有識別子。`Contest` が党派の予備選挙の一部であることを示します。`PrimaryPartyId` は予備選挙でのみ意味があります。
`VotesAllowed`	1	`integer`	このコンテストで 1 人の投票者が投票または記入できる最大数。フィードに `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`	このコンテストで 1 人の投票者が投票または記入できる最大数。フィードに `VotesAllowed` がない場合は、デフォルト値の `1` が使用されます。
`OfficeIds`	1	`IDREFS`	1 つ以上の `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`	投票用紙の正式なタイトル（`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` に含めます。また、`fulltext` のアノテーション付き URI を含む `InfoUri` も含めます。それ以外の場合は、`fulltext` アノテーションを含む URI のみを含めます。
`InfoUri`	0 または 1	`AnnotatedUri`	他の場所でリストされているアノテーションではなく、次のアノテーションを受け入れるアノテーション付き URI: `wikipedia`: 投票案に関する 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`	投票対象法案の概要。1 ～ 2 つの短い段落で構成され、パートナーが生成して投票用紙の全文を要約できます。例: `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>