Ofis

Bir ofisi ve bu ofisin yarışmasıyla ilgili bilgileri tanımlamak için Office öğesini kullanın. Bir makam, seçim bölgesi ve makam rolü ile tanımlanır.

Office öğesi tüm feed türleri için geçerlidir ancak referandum için belirtilmesi gerekmez. Ancak ofis tanımı, feed türüne bağlı olarak farklı şekilde yorumlanır. Seçim bağlamında Office, aranan makamın unvanını temsil eder (ör. "Temsilciler Meclisi Üyesi"). Görevli bağlamında, tek bir kişi için belirli bir koltuktur.

Office'ü bu 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.

Bir kişi aynı anda birden fazla görevdeyse bu birden fazla ofis hakkında bilgi verdiğinizden emin olun. Örneğin, hem Almanya Başbakanı hem de Bundestag Üyesi olan bir kişinin her iki makamda da tanımlanması gerekir.

Bir kişi yeni bir seçim bölgesi veya yeni bir pozisyon için görevlendirildiğinde bu kişiyi yeni göreve bağlayın. Eski bir ofisi yeniden kullanmadığınızdan emin olun.

Özellikler

Aşağıdaki tabloda Office ile ilgili özellikler açıklanmaktadır:

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

Öğeler

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

Öğe Çokluk Tür Açıklama
ContactInformation 0 veya daha fazla ContactInformation Ofisle çeşitli iletişim bilgilerini ilişkilendirir. Bu öğe dahil edilirse aday veya görevde bulunan kişi ile ilgili değil, yalnızca görevle ilgili bilgileri belirtin.
ElectoralDistrictId 0 veya 1 IDREF

Seçim bölgesini temsil eden GpUnit için objectId değerini sağlayın. Ö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 seçim bölgesi girin.

Görevli feed'inde, koltuk başına bir Office ve ElectoralDistrictId değerinin, ilgili kişiyi göreve seçen seçim bölgesine ayarlanmasını bekliyoruz.

Örnek: Tayvan'daki yasama seçimleri

  • Yasama Yuan'ının her üyesine, bulunduğu seçim bölgesine göre farklı bir Office verin.

Başka bir örnek: ABD senatosu yetkilisi feed'i

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

Bir kimliği ofisle ilişkilendirir. Kararlı bir tanımlayıcı gereklidir. Ofislerin sabit tanımlayıcıları, ofis görev süreleri genelinde 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 bilgi 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 parçası olduğu GovernmentBody için objectId değerini sağlayın. Örneğin, ABD senatörü için United States Senate
Name 1 InternationalizedText Bu ofisin genel başlığının tam adını sağlar. Bu, ofisin yargı alanını içermeli ancak seçim bölgesiyle ilgili tüm bilgileri hariç tutmalıdır.

Örnekler:

  • Singapur Parlamentosu Üyesi
  • Hindistan Başbakanı
  • Endonezya Cumhurbaşkanı
  • ABD Senatörü
OfficeHolderPersonIds 1 IDREFS

Bu ofisi elinde tutan Person kuruluşunun objectId kimliğini belirtin.
SeatStatus 0 veya 1 SeatStatus Görevli için SeatStatus özelliğinin listelenen türü (ör. active veya on-leave). SeatStatus belirtilmezse varsayılan değer active olur.
SelectionMethod 0 veya 1 OfficeSelectionMethod Görevli kişinin nasıl seçildiği veya göreve getirildiği hakkında bilgi.
Term 1 Term Ofis terimleriyle ilgili bilgiler sağlar.

ExternalIdentifiers için ek türler

Office öğesinin ExternalIdentifiers alanında, OtherType ve Value değerlerinin yanı sıra 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
jurisdiction-id gpu1

Zorunlu

Ofisin yargı alanını belirten GpUnit'nin objectId
government-body United States Senate GovernmentBody adresine göz atın.
legislative-session 116th United States Congress
office-level Country OfficeLevel içinde bir değer olmalıdır. Bu durumlardan hiçbiri geçerli değilse Google temsilcinizle iletişime geçin.
office-role upper house

Zorunlu

OfficeRole içinde bir değer olmalıdır. Bu durumlardan 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 sandalye veya pozisyona sahip ofisleri, seçim bölgesi olmayan ve süresi dolmamış ofisleri ayırt etmek için bu özelliği kullanın.

Örnekler

XML

    <Office objectId="off0">
      <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>upper house</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru-gpu0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <OfficeHolderPersonIds>per0</OfficeHolderPersonIds>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off0",
        "ElectoralDistrictId": "ru-gpu0",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off0"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "upper house"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru-gpu0"
            }
          ]
        }
        "GovernmentBodyIds": ["gb-1]
        "Name": {
          "Text": [
            {
              "value": "United States Senator",
              "language": "en"
            }
          ]
        }
        "OfficeHolderPersonIds": "per0"
        "SelectionMethod": "directly-elected"
        "Term": {
          "StartDate": "2019-01-02"
        }
      }
    ]