Biuro

Użyj elementu Office, aby zdefiniować urząd i informacje powiązane z jego konkursem. Urząd jest identyfikowany na podstawie okręgu wyborczego i pełnionej funkcji.

Element Office ma zastosowanie do wszystkich typów plików danych, ale nie musi być określony w przypadku referendów.

Wybierz jeden z tych typów plików danych, aby dowiedzieć się więcej o tym, jak używać Office z danym typem pliku danych.

Atrybuty

W tabeli poniżej opisano atrybuty Office:

Atrybut Wymagany? Typ Opis
objectId Wymagane ID Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu.

Elementy

W tabeli poniżej opisano elementy Office:

Element Mnogość Typ Opis
ContactInformation 0 lub więcej ContactInformation Łączy różne informacje kontaktowe z biurem. Jeśli ten element jest uwzględniony, podaj tylko informacje związane z samym biurem, a nie z kandydatem lub obecnym urzędnikiem.
ElectoralDistrictId 1 IDREF

Podaj objectId GpUnit, który reprezentuje okręg wyborczy. Na przykład w przypadku senatora USA podaj stan, np. „Alaska”, a w przypadku przedstawiciela USA podaj okręg, np. „14 okręg wyborczy Nowego Jorku”.

W przypadku pliku danychprzed wyborami podaj pojedynczy element Office dla tego samego office-role. Ustaw ElectoralDistrict na element najwyższego poziomu, który reprezentuje najwyższy poziom geograficzny wyborów.

Przykład: wybory do tajwańskiego parlamentu

  • Nawet jeśli kandydaci zostali wybrani w różnych okręgach, ustaw dla nich wszystkich jedną wartość Office: „Członek Yuanu Ustawodawczego”. Użyj ElectoralDistrict ru-country-tw.
ExternalIdentifiers 1 ExternalIdentifiers

Łączy identyfikator z biurem. Wymagany jest stabilny identyfikator. Stabilne identyfikatory biur muszą być unikalne w ramach okresów zajmowania biura. Na przykład każdy z tych okresów musi mieć odrębny stabilny identyfikator biura:

  • Prezydentura Grovera Clevelanda w latach 1885–1889
  • Prezydentura Grovera Clevelanda w latach 1893–1897
  • prezydentura Franklina Roosevelta w latach 1933–1945,

Element ExternalIdentifiers w Office umożliwia podanie dodatkowych informacji z określonymi wartościami dla OtherType. Więcej informacji znajdziesz w sekcji Dodatkowe typy dla ExternalIdentifiers.
FilingDeadline 0 lub 1 PartialDate Data, do której kandydat musi zgłosić się do wyborów na dany urząd. Atrybut
GovernmentBodyIds 0 lub 1 IDREFS Podaj objectId GovernmentBody, którego częścią jest to stanowisko. Na przykład Senat Stanów Zjednoczonych w przypadku senatora USA.
Name 1 InternationalizedText Zawiera pełną nazwę ogólną tego urzędu. Musi ona zawierać jurysdykcję urzędu, ale nie może zawierać żadnych informacji związanych z okręgiem wyborczym.

Przykłady:

  • Członek parlamentu Singapuru
  • Premier Indii
  • Prezydent Indonezji
  • Senator Stanów Zjednoczonych
JurisdictionId 0 lub 1 IDREF

Podaj objectId GpUnit, który określa jurysdykcję urzędu.
Level 0 lub 1 OfficeLevel

Typ wyliczeniowy poziomu biura. Pełną listę opcji znajdziesz w dokumentacji.
Role 0 lub więcej OfficeRole Wyliczony typ roli biura, np. cabinet member lub president. Wszystkie możliwe opcje znajdziesz w dokumentacji.
SelectionMethod 0 lub więcej OfficeSelectionMethod Informacje o tym, jak dana osoba została wybrana lub powołana na stanowisko.
Term 0 lub 1 Term Zawiera informacje dotyczące kadencji.

Dodatkowe typy identyfikatorów zewnętrznych

W elemencie ExternalIdentifiers elementu Office podaj dodatkowe dane z atrybutem Type o wartości other oraz wartościami atrybutów OtherType i Value. W tabeli poniżej znajdziesz możliwe wartości tych elementów:

OtherType Przykładowe wartości Opis
jurisdiction-id gpu1

objectId GpUnit, który określa jurysdykcję urzędu.
legislative-session 116th United States Congress
office-level Country Musi to być wartość z OfficeLevel. Jeśli żadna z nich nie pasuje, skontaktuj się z osobą kontaktową w Google.
office-role upper house

Musi to być wartość z zakresu OfficeRole. Jeśli żadna z tych wartości nie pasuje, skontaktuj się z osobą kontaktową w Google.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Użyj tego, aby odróżnić biura z wieloma stanowiskami lub pozycjami, a także biura z nieograniczoną liczbą stanowisk i biura, w których kadencja jeszcze się nie skończyła.

Przykłady

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>