Aday

Bir yarışmadaki aday hakkında bilgi vermek için Candidate kullanın. Bir Candidate, CandidateSelection öğesi tarafından referans verilebilir.

Candidate özelliğini ilgili feed türüyle nasıl kullanacağınız hakkında daha fazla bilgi edinmek için aşağıdaki feed türlerinden birini seçin.

Bazı seçimler birden fazla küçük yarışmadan oluşur veya bir dizi sonraki yarışmayı içerir. Bu tür ilgili yarışmalarda, bir Person yalnızca bir Candidate tarafından referans alınmalıdır. Aşağıdaki örneği inceleyelim:

  • Polonya'daki bir seçimin 1. turunda, 1. Aday, 1. Kişi'ye atıfta bulunuyor.
  • Ancak 2. turda 1. Kişi, 2. Aday tarafından referans olarak gösteriliyor.

Bu durumda, 1. Aday ve 2. Aday yinelenen girişlerdir. Her iki yarışmanın da aynı Candidate'ya referans vermesi gerekir. Genellikle bir adayı birden fazla alakasız yarışmaya dahil etmeyin.

Özellikler

Aşağıdaki tabloda Candidate öğesinin özellikleri gösterilmektedir:

Özellik Zorunlu mu? Tür Açıklama
objectId Zorunlu ID Diğer öğelerin bu öğeye referans vermek için kullandığı benzersiz dahili tanımlayıcı.

Öğeler

Aşağıdaki tabloda Candidate öğeleri gösterilmektedir:

Öğe Çokluk Tür Açıklama
BallotName 1 InternationalizedText Adayın oy pusulasında listelenen adını sağlar.
CampaignSlogan 0 veya 1 InternationalizedText

Bir adaya veya kampanyasına kampanya sloganının ne olduğunu sorduğunuzda aldığınız slogan. 2020 ABD başkanlık seçimindeki şu örneklere göz atın:

  • Joe Biden'ın sloganı: "En iyi günlerimizi henüz yaşamadık."
  • Donald Trump'ın sloganı: "Make America Great Again" (Amerika'yı Yeniden Harika Yapalım).
ContactInformation 0 veya daha fazla ContactInformation Kampanya merkezinin adresini, telefon numaralarını vb. aday bilgileriyle ilişkilendirin.
ExternalIdentifiers 1 ExternalIdentifiers Adayla bir kimlik ilişkilendirir. Bir kararlı tanımlayıcı gerekir.
FileDate 0 veya 1 PartialDate Adayın yarışmaya resmi olarak başvurduğu tarih.
IsIncumbent 0 veya 1 boolean true değeri, adayın yarışmayla ilişkili görevin mevcut sahibi olduğunu gösterir. Bu öğe yoksa varsayılan değer false olur.
IsNotable 0 veya 1 boolean Varlığın kayda değer olup olmadığı. Belirtilmezse false olduğu varsayılır.
IsTopTicket 0 veya 1 boolean Adayın, birden fazla adayın yer aldığı bir pusulanın en üstünde olup olmadığını gösterir. Bu öğeyi yalnızca bir CandidateSelection nesnesinde birden fazla Candidate olduğunda ekleyin. Bu öğe yoksa varsayılan değer false olur.
PartyId 1 veya daha fazla IDREF Bir Party öğesinin benzersiz tanımlayıcısı. Adayı siyasi partisiyle ilişkilendirmek için kullanılır.
PersonId 1 IDREF Bir Person öğesinin benzersiz tanımlayıcısı. Aday hakkında daha ayrıntılı bilgileri ilişkilendirmek için kullanılır.
PostElectionStatus 0 veya 1 CandidatePostElectionStatus Adayın son durumu (ör. winner veya withdrawn).
PreElectionStatus 0 veya 1 CandidatePreElectionStatus Adayın kayıt durumu (ör. filed veya qualified).

ExternalIdentifiers için ek türler

Candidate öğesinin ExternalIdentifiers öğesinde, other Type ile ek veriler sağlayın. Ayrıca OtherType ve Value değerlerini de ekleyin. Aşağıdaki tabloda bu öğeler için olası değerler gösterilmektedir:

OtherType Örnek değerler Açıklama
electoral-commission H2NY22097

İsteğe bağlı

Seçim komisyonu kimliği.

Örnekler

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>
      <PartyId>par-0002</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","par-0002"]
            "PersonId": "per-001-kenyatta",
            "PostElectionStatus": "projected-winner",
            "PreElectionStatus": "qualified"
          }
      ]