Aday

Yarışmadaki bir aday hakkındaki bilgileri açıklamak için Candidate kullanın. A Candidate, CandidateSelection varlığı tarafından referans alınabilir.

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.

inceleyin.

Bazı seçimler birden fazla küçük yarışmadan oluşur veya bir dizi sonraki yarışmayı içerir. Bu türdeki 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. Kişi, 1. Aday tarafından referans olarak gösteriliyor.
  • Ancak 2. turda 1. Kişi, 2. Aday tarafından referans olarak gösteriliyor.

Bu durumda, Aday 1 ve Aday 2 aynı yarışmanın iki kopyasıdır. Her iki yarışmada da aynı Candidate referans alınmalıdır. 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 Öznenin kayda değer olup olmadığı. Belirtilmemişse false olarak kabul edilir.
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 Party öğesinin benzersiz tanımlayıcısı. Adayı siyasi partisiyle ilişkilendirmek için kullanılır.
PartyLabel 0 veya 1 InternationalizedText Bir adayın oy pusulasındaki adının yanında partisi olarak görünebilen ancak oy pusulasında yer almaya uygun olmayan parti (buna izin verilen yerlerde).
PersonId 1 IDREF 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, OtherType ve Value değerleriyle birlikte other Type ile ek veriler sağlayın. 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.
tse-candidate-number 12345

İsteğe bağlı

Brezilya seçimlerinde, Yüksek Seçim Mahkemesi (Tribunal Superior Eleitoral – TSE) tarafından verilen aday numarası.

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