Kantor

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

Elemen Office berlaku untuk semua jenis feed, tetapi tidak perlu ditentukan untuk referendum. Namun, definisi kantor ditafsirkan secara berbeda berdasarkan jenis feed. Dalam konteks pemilu, Office mewakili judul jabatan yang dicari, seperti "Anggota Dewan Perwakilan Rakyat". Dalam konteks pemegang jabatan, ini adalah kursi khusus untuk satu orang.

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

Jika seseorang memiliki lebih dari satu posisi yang sedang berlangsung secara bersamaan, pastikan untuk memberikan informasi tentang beberapa posisi tersebut. Misalnya, jika seseorang adalah Kanselir Jerman dan Anggota Bundestag, dia harus ditentukan di kedua jabatan tersebut.

Jika seseorang ditunjuk sebagai pemegang jabatan untuk distrik baru atau posisi baru, tautkan orang ini ke kantor baru. Pastikan untuk tidak menggunakan kembali kantor yang sudah tidak digunakan lagi.

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, hanya tentukan informasi yang terkait dengan jabatan itu sendiri, bukan kandidat atau pemegang jabatan saat ini.
ElectoralDistrictId 0 atau 1 IDREF

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

Untuk feed pemegang jabatan, kami mengharapkan satu Office per kursi dan ElectoralDistrictId ditetapkan ke distrik yang memilih orang tersebut untuk menjabat.

Contoh: Pemilu legislatif Taiwan

  • Berikan Office yang berbeda kepada setiap anggota Legislative Yuan, berdasarkan distrik mereka.

Contoh lainnya: Feed pejabat senat Amerika Serikat

  • Berikan 100 objek Office untuk Senat AS.
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 kantor stabil 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.
GovernmentBodyIds 0 atau 1 IDREFS Berikan objectId GovernmentBody yang menjadi bagian dari kantor ini. Misalnya, United States Senate untuk Senator AS
Name 1 InternationalizedText Memberikan nama lengkap judul umum kantor ini. Informasi ini harus menyertakan wilayah hukum kantor, tetapi mengecualikan informasi apa pun yang terkait dengan distrik pemilihan.

Contoh:

  • Anggota Parlemen Singapura
  • Perdana Menteri India
  • Presiden Indonesia
  • Senator Amerika Serikat
OfficeHolderPersonIds 1 IDREFS

Berikan objectId dari Person yang memegang jabatan ini.
SeatStatus 0 atau 1 SeatStatus Jenis SeatStatus pemegang jabatan yang dihitung, seperti active atau on-leave. Nilai defaultnya adalah active jika tidak ada SeatStatus yang ditentukan.
SelectionMethod 0 atau 1 OfficeSelectionMethod Informasi tentang cara pemegang jabatan dipilih atau ditempatkan dalam jabatan.
Term 1 Term Memberikan informasi terkait masa berlaku kantor.

Jenis tambahan untuk ExternalIdentifiers

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

OtherType Contoh nilai Deskripsi
jurisdiction-id gpu1

Wajib

objectId dari GpUnit yang menentukan wilayah hukum kantor.
government-body United States Senate Lihat GovernmentBody.
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

Wajib

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 umum dan yang belum berakhir masa berlakunya.

Contoh

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"
        }
      }
    ]