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 ile ilgili özellikler 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 0 veya 1 IDREF

Seçim bölgesini temsil eden GpUnit'nın 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 belirtin.

Görevli feed'i için koltuk başına bir Office ve ElectoralDistrictId'nin, söz konusu kişiyi göreve seçen bölgeye ayarlanmış olmasını bekliyoruz.

Örnek: Tayvan'daki yasama seçimleri

  • Yasama Yuanı'nın her üyesine, bölgesine göre farklı bir Office verin.

Başka bir örnek: ABD senato görevlisi feed'i

  • ABD Senatosu için 100 Office nesnesi sağlayın.
ExternalIdentifiers 1 ExternalIdentifiers

Kimliği ofisle ilişkilendirir. Sabit 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 ayrı bir ofis kararlı 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.
GovernmentBodyIds 0 veya 1 IDREFS Bu ofisin bağlı olduğu GovernmentBody'ın objectId bilgisini girin. Ö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 Milletvekili
  • 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 düzeyinin 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.
OfficeHolderPersonIds 1 IDREFS

Bu görevi yürüten Person'ın objectId bilgisini sağlayın.
SeatStatus 0 veya 1 SeatStatus Görevlinin SeatStatus'unun numaralandırılmış türü (ör. active veya on-leave). SeatStatus belirtilmezse varsayılan değer active olur.
SelectionMethod 0 veya daha fazla OfficeSelectionMethod Görevlinin nasıl seçildiği veya göreve nasıl getirildiği hakkında bilgi.
Term 1 Term Ofis terimiyle ilgili bilgiler sağlar.

ExternalIdentifiers için ek türler

Office öğesinin ExternalIdentifiers öğesinde, other Type ile birlikte OtherType ve Value değerlerini içeren 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 objectId.
government-body United States Senate GovernmentBody sayfasına göz atın.
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="off0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <JurisdictionId>ru-gpu0</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <Role>upper house</Role>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>