Ofis

Bir ofisi ve yarışmasıyla ilişkili bilgileri tanımlamak için Office öğesini kullanın. Bir ofis, seçim bölgesi ve ofis rolüyle tanımlanır.

Office öğesi tüm feed türleri için geçerlidir ancak referandumlar için belirtilmesi gerekmez.

Office'ı 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.

Özellikler

Aşağıdaki tabloda Office öğesinin özellikleri açıklanmaktadır:

Ö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 Office öğeleri açıklanmaktadır:

Öğe Çokluk Tür Açıklama
ContactInformation 0 veya daha fazla ContactInformation Çeşitli iletişim bilgilerini ofisle ilişkilendirir. Bu öğe dahil edilirse yalnızca ofisle ilgili bilgileri belirtin. Aday veya mevcut görevliyle ilgili bilgileri belirtmeyin.
ElectoralDistrictId 1 IDREF

Seçim bölgesini temsil eden GpUnit objectId'ını girin. Örneğin, ABD Senatörü için "Alaska" gibi bir eyalet veya ABD Temsilcisi için "New York'un 14. seçim bölgesi" gibi bir bölge girin.

Seçim öncesi veriler feed'i için aynı office-role için tek bir Office öğesi sağlayın. ElectoralDistrict öğesini, seçimin en üst coğrafi düzeyini temsil eden üst düzey öğe olarak ayarlayın.

Örnek: Tayvan'daki yasama seçimleri

  • Adaylar farklı bölgelerden seçilmiş olsa bile hepsini tek bir Office değerine, "Yasama Yuanı Üyesi" olarak ayarlayın. Yüksek düzeyde ElectoralDistrict ru-country-tw kullanın.
ExternalIdentifiers 1 ExternalIdentifiers

Kimliği ofisle ilişkilendirir. Bir kararlı tanımlayıcı gerekir. Ofisler için sabit tanımlayıcılar, ofis görev süreleri boyunca benzersiz olmalıdır. Örneğin, aşağıdaki görev sürelerinin her biri için farklı bir ofis sabit tanımlayıcısı gerekir:

  • Grover Cleveland'ın 1885-1889 yılları arasındaki başkanlığı
  • Grover Cleveland'ın 1893-1897 yılları arasındaki başkanlığı
  • Franklin Roosevelt'in 1933-1945 yılları arasındaki başkanlığı

Office öğesinin ExternalIdentifiers öğesi, OtherType için belirli değerlerle ek bilgiler sağlamanıza olanak tanır. Daha fazla bilgi için ExternalIdentifiers için ek türler başlıklı makaleyi inceleyin.
FilingDeadline 0 veya 1 PartialDate Bir adayın, ofis için yarışmaya başvurması gereken tarih.
GovernmentBodyIds 0 veya 1 IDREFS Bu ofisin parçası olduğu GovernmentBody'ın objectId'ını belirtin. Örneğin, ABD Senatörü için ABD Senatosu
Name 1 InternationalizedText Bu ofisin genel unvanının tam adını sağlar. Bu, ofisin yargı alanını içermeli ancak seçim bölgesiyle ilgili bilgileri hariç tutmalıdır.

Örnekler:

  • Singapur Parlamentosu Üyesi
  • Hindistan Başbakanı
  • Endonezya Devlet Başkanı
  • ABD Senatörü
JurisdictionId 0 veya 1 IDREF

Ofisin yetki alanını belirten GpUnit'nin objectId bilgisini girin.
Level 0 veya 1 OfficeLevel

Ofisin seviyesinin numaralandırılmış türü. Seçeneklerin tam listesi için referansa bakın.
Role 0 veya daha fazla OfficeRole Ofisin rolünün numaralandırılmış türü (ör. cabinet member veya president). Tüm olası seçenekler için referans bölümüne bakın.
SelectionMethod 0 veya daha fazla OfficeSelectionMethod Görevlinin nasıl seçildiği veya göreve nasıl getirildiği hakkında bilgi.
Term 0 veya 1 Term Ofis terimiyle ilgili bilgiler sağlar.

ExternalIdentifiers için ek türler

Office öğesinin ExternalIdentifiers öğesinde, OtherType ve Value değerleriyle birlikte Type değeri other olan ek veriler sağlayın. Aşağıdaki tabloda bu öğeler için olası değerler gösterilmektedir:

OtherType Örnek değerler Açıklama
jurisdiction-id gpu1

Ofisin yargı alanını belirten GpUnit'nın objectId.
legislative-session 116th United States Congress
office-level Country OfficeLevel değerlerinden biri olmalıdır. Bu nedenlerin hiçbiri geçerli değilse Google temsilcinizle iletişime geçin.
office-role upper house

OfficeRole değerlerinden biri olmalıdır. Bu nedenlerin hiçbiri geçerli değilse Google temsilcinizle iletişime geçin.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Bunu, birden fazla koltuk veya pozisyonu olan ofisleri ve genel olarak süresi dolmamış ofisleri ayırt etmek için kullanın.

Örnekler

XML

    <Office objectId="off9999a">
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off9999a</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <IsPartisan>true</IsPartisan>
      <JurisdictionId>ru0002</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Role>president</Role>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>