Kantor

Gunakan Office untuk menentukan kantor dan informasi yang terkait dengan kontesnya. Kantor diidentifikasi berdasarkan daerah pemilihan dan peran kantornya.

Elemen Office berlaku untuk semua jenis feed, tetapi tidak perlu ditentukan untuk referendum.


Pilih salah satu jenis feed berikut untuk mempelajari lebih lanjut cara menggunakan Office dengan jenis feed tersebut.


Atribut

Tabel berikut menjelaskan atribut untuk Office:

Atribut Wajib? Jenis Deskripsi
objectId Wajib ID ID internal unik yang digunakan oleh elemen lain untuk mereferensikan elemen ini.

Elemen

Tabel berikut menjelaskan elemen untuk Office:

Elemen Keanekaragaman Jenis Deskripsi
ContactInformation 0 atau lebih ContactInformation Mengaitkan berbagai informasi kontak dengan kantor. Jika elemen ini disertakan, tentukan hanya informasi yang terkait dengan kantor itu sendiri, bukan kandidat atau pemegang jabatan saat ini.
ElectoralDistrictId 1 IDREF

Berikan objectId dari GpUnit yang mewakili daerah pemilihan. Misalnya, berikan negara bagian, seperti "Alaska", untuk Senator AS, atau distrik, seperti "Distrik kongres ke-14 New York", untuk Perwakilan AS.

Untuk data pra-pemilu hasil pemilu, berikan satu entity Office untuk office-role yang sama. Tetapkan ElectoralDistrict ke entity tingkat tinggi yang mewakili tingkat geografis teratas pemilu.

Contoh: Pemilu legislatif Taiwan

  • Meskipun kandidat terpilih di distrik yang berbeda, tetapkan semua dari mereka ke satu nilai Office, "Anggota Yuan Legislatif." Gunakan tingkat tinggi ElectoralDistrict dari ru-country-tw.
ExternalIdentifiers 1 ExternalIdentifiers

Mengaitkan ID dengan kantor. ID stabil diperlukan. ID stabil untuk kantor harus unik di seluruh masa jabatan kantor. Misalnya, setiap masa jabatan berikut memerlukan ID stabil kantor yang berbeda:

  • Masa kepresidenan Grover Cleveland dari tahun 1885 hingga 1889
  • Masa kepresidenan Grover Cleveland dari tahun 1893 hingga 1897
  • Masa kepresidenan Franklin Roosevelt dari tahun 1933 hingga 1945

Elemen ExternalIdentifiers dari Office memungkinkan Anda memberikan informasi tambahan dengan nilai tertentu untuk OtherType. Untuk mengetahui detail selengkapnya, lihat Jenis tambahan untuk ExternalIdentifiers.

FilingDeadline 0 atau 1 PartialDate Tanggal terakhir kandidat harus mengajukan permohonan untuk kontes jabatan.
GovernmentBodyIds 0 atau 1 IDREFS Berikan objectId dari GovernmentBody yang menjadi bagian dari kantor ini. Misalnya, Senat Amerika Serikat untuk Senator AS
Name 1 InternationalizedText Memberikan nama lengkap dari judul umum kantor ini. Nama ini harus menyertakan yurisdiksi kantor, tetapi tidak menyertakan informasi apa pun yang terkait dengan daerah pemilihan.

Contoh:

  • Anggota Parlemen Singapura
  • Perdana Menteri India
  • Presiden Indonesia
  • Senator Amerika Serikat
JurisdictionId 0 atau 1 IDREF

Berikan objectId dari GpUnit yang menentukan wilayah hukum kantor.

Level 0 atau 1 OfficeLevel

Jenis enumerasi tingkat kantor. Lihat referensi untuk mengetahui daftar lengkap opsi.

Role 0 atau lebih OfficeRole Jenis enumerasi Peran kantor, seperti cabinet member atau president. Lihat referensi untuk mengetahui semua opsi yang memungkinkan.
SelectionMethod 0 atau lebih OfficeSelectionMethod Informasi tentang cara pemegang jabatan dipilih atau ditempatkan di kantor.
Term 0 atau 1 Term Memberikan informasi terkait masa jabatan kantor.

Jenis tambahan untuk ExternalIdentifiers

Di elemen ExternalIdentifiers dari Office, berikan data tambahan dengan a Type other, beserta nilai untuk OtherType dan Value. Tabel berikut menunjukkan kemungkinan nilai untuk elemen ini:

OtherType Contoh nilai Deskripsi
jurisdiction-id gpu1

objectId dari GpUnit yang menentukan yurisdiksi kantor.

legislative-session 116th United States Congress
office-level Country Harus berupa nilai dari OfficeLevel. Jika tidak ada yang berlaku, hubungi kontak Google Anda.
office-role upper house

Harus berupa nilai dari OfficeRole. Jika tidak ada yang berlaku, hubungi kontak Google Anda.

office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Gunakan ini untuk membedakan kantor dengan beberapa kursi atau posisi, dan untuk kantor yang tidak memiliki batas waktu dan kantor yang tidak memiliki batas waktu.

Contoh

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>