Ofis

Bir ofisi ve yarışmasıyla ilgili bilgileri tanımlamak için Office 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 ö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 eklenirse yalnızca ofisle ilgili bilgileri belirtin. Aday veya mevcut görevliyle ilgili bilgileri belirtmeyin.
DiplomatReceivingStateId 0 veya 1 IDREF

Bir diplomatik ofisin alıcı durumunu belirten GpUnit objectId değerini girin.
DiplomatSendingStateId 0 veya 1 IDREF

Diplomatik ofisin gönderen devletini belirten GpUnit için objectId girin.
ElectoralDistrictId 0 veya 1 IDREF

Seçim bölgesini temsil eden GpUnit için objectId değerini girin. Örneğin, ABD'deki bir senatör için "Alaska" gibi bir eyalet veya ABD'deki bir temsilci için "New York'un 14. seçim bölgesi" gibi bir bölge belirtin.

Makam sahibi feed'i için her koltuk başına bir Office ve ElectoralDistrictId değerinin, o kişiyi makama seçen bölgeye ayarlanmasını bekleriz.

Örnek: Tayvan yasama meclisi seçimleri

  • Yasama Meclisi'nin 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. Bir kararlı tanımlayıcı gereklidir. Ofislerin 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 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ığı

ExternalIdentifiers öğesi, Office içinde 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, makamın yargı yetkisini içermeli ancak seçim bölgesiyle ilgili bilgileri içermemelidir.

Örnekler:

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

Ofisin yargı yetkisini belirten GpUnit öğesinin objectId değerini 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). Olası tüm seçenekler için referans bölümüne bakın.
OfficeHolderPersonIds 1 IDREFS

Bu ofisi barındıran Person'ın objectId bilgisini sağlayın.
SeatStatus 0 veya 1 SeatStatus Makam sahibinin SeatStatus değerinin 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 Görev süresiyle ilgili bilgi sağlar.

ExternalIdentifiers için ek türler

Office öğ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
jurisdiction-id gpu1

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

OfficeRole aralığında bir değer olmalıdır. Hiçbiri geçerli değilse Google temsilcinizle iletişime geçin.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Birden fazla koltuğu veya pozisyonu olan ofisleri ve genel olarak süresi dolmamış ofisleri ayırt etmek için bu özelliği kullanın.

Örnekler

XML

    <Office objectId="off-0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-0</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>