応募者

Candidate を使用して、コンテストの候補者に関する情報を記述します。Candidate は、CandidateSelection エンティティから参照できます。

以下のフィードタイプを選択して、Candidate をそのタイプのフィードで使用する方法をご確認ください。

選挙の中には、複数の小規模な選挙で構成されるものや、一連の選挙が継続的に行われる選挙もあります。このような関連コンテストでは、Person は 1 つの Candidate でのみ参照する必要があります。たとえば次のようになります。

  • ポーランドの選挙のラウンド 1 で、候補者 1 が人物 1 を参照します。
  • しかし、ラウンド 2 では受験者 2 から人物 1 が言及されます。

この例では、候補 1 と候補 2 は重複しています。両方のコンテストが同じ Candidate を参照する必要があります。一般に、関係のない複数のコンテストに候補者を参加させないでください。

属性

次の表に、Candidate の属性を示します。

属性 必須かどうか 種類 説明
objectId 必須 ID 他の要素がこの要素を参照するために使用する一意の内部識別子。

要素

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

要素 重複 種類 説明
BallotName 1 InternationalizedText 投票用紙に記載されている候補者の名前を指定します。
CampaignSlogan 0 または 1 InternationalizedText

候補者やその選挙キャンペーンのスローガンについて質問したときに表示されるスローガン。2020 年米国大統領選挙の例をご覧ください。

  • ジョー・バイデンのスローガン: 「Our Best Days Still Lie Ahead」
  • ドナルド・トランプのスローガンは、「Make America Great Again」です。
ContactInformation 0 以上 ContactInformation キャンペーン本部の住所や電話番号などを候補者情報に関連付けます。
ExternalIdentifiers 1 ExternalIdentifiers ID を受験者に関連付けます。安定した識別子が必要です。
FileDate 0 または 1 PartialDate 候補者が公式にコンテストに応募した日付。
IsIncumbent 0 または 1 boolean 値が true の場合、その候補者が、コンテストに関連するオフィスの現在の所有者です。この要素が存在しない場合、デフォルト値は false です。
IsTopTicket 0 または 1 boolean 受験者が、複数の候補を含むチケットの一番上にあるかどうかを示します。この要素は、CandidateSelection オブジェクトに複数の Candidate がある場合にのみ指定します。 この要素が存在しない場合のデフォルト値は false です。
PartyId 1 IDREF Party 要素の一意の識別子。候補者を政党に関連付けるために使用されます。
PersonId 1 IDREF Person 要素の一意の識別子。受験者に関する詳細情報を関連付けるために使用されます。
PostElectionStatus 0 または 1 CandidatePostElectionStatus winner や withdrawn などの候補の最終ステータス。
PreElectionStatus 0 または 1 CandidatePreElectionStatus 受験者の登録ステータス（filed や qualified など）。

ExternalIdentifiers の追加の型

Candidate の ExternalIdentifiers 要素で、other の Type と OtherType および Value の値を使用して追加データを指定します。次の表に、これらの要素に指定できる値を示します。

OtherType 値の例 説明
electoral-commission H2NY22097

任意

選挙手数料 ID。

例

XML

    <Candidate objectId="can-1001-kenyatta">
      <BallotName>
        <Text language="en">Uhuru Kenyatta</Text>
        <Text language="sw">Uhuru Kenyatta</Text>
      </BallotName>
      <ExternalIdentifiers>
         <ExternalIdentifier>
            <Type>other</Type>
            <OtherType>stable</OtherType>
            <Value>can-per-100</Value>
          </ExternalIdentifier>
          <ExternalIdentifier>
            <Type>other</Type>
            <OtherType>electoral-commission</OtherType>
            <Value>H2NY22097</Value>
          </ExternalIdentifier>
        </ExternalIdentifiers>
      <IsIncumbent>1</IsIncumbent>
      <IsTopTicket>1</IsTopTicket>
      <PartyId>par-jubilee</PartyId>
      <PersonId>per-001-kenyatta</PersonId>
      <PostElectionStatus>projected-winner</PostElectionStatus>
      <PreElectionStatus>qualified</PreElectionStatus>
    </Candidate>

JSON

      "Candidate": [
          {
            "objectId": "can-1001-kenyatta",
            "BallotName": {
              "Text": [
                {
                  "value": "Uhuru Kenyatta",
                  "language": "en"
                },
                {
                  "value": "Uhuru Kenyatta",
                  "language": "sw"
                }
              ]
            },
            "ExternalIdentifiers": {
              "ExternalIdentifier" : [
                {
                  "Type": "other",
                  "OtherType": "stable",
                  "Value": "can-per-100"
                },
                {
                  "Type": "other",
                  "OtherType": "electoral-commission",
                  "Value": "H2NY22097"
                },
              ]
            }
            "IsIncumbent": 1,
            "IsTopTicket": 1,
            "PartyId": "par-jubilee",
            "PersonId": "per-001-kenyatta",
            "PostElectionStatus": "projected-winner",
            "PreElectionStatus": "qualified"
          }
      ]