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.

Ö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 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.

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

Örnek: Tayvan'daki yasama seçimleri

  • Adaylar farklı seçim bölgelerinden seçilmiş olsa bile hepsini tek bir Office değerine ("Yasama Yuan Üyesi") ayarlayın. ru-country-tw için yüksek düzey bir ElectoralDistrict kullanı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.
FilingDeadline 0 veya 1 PartialDate Adayın, makam için yarışmaya başvurması gereken tarih.
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ü
SelectionMethod 0 veya 1 OfficeSelectionMethod Görevli kişinin nasıl seçildiği veya göreve getirildiği hakkında bilgi.
Term 0 veya 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="off9999a">
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off9999a</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru0002</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>president</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FilingDeadline>2013-01-01</FilingDeadline>
      <IsPartisan>true</IsPartisan>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off9999a",
        "ElectoralDistrictId": "ru0002",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off9999a"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru0002"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "president"
            }
          ]
        }
        "FilingDeadline": "2013-01-01"
        "IsPartisan": true,
        "Name": {
          "Text": [
            {
              "value": "President",
              "language": "en"
            }
          ]
        },
        "Term": {
          "Type": "full-term"
        }
      },
    ]