Biuro

Użyj właściwości 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 Powiązywanie różnych informacji kontaktowych z biurem. Jeśli ten element jest uwzględniony, podaj tylko informacje związane z samym stanowiskiem, a nie z kandydatem lub osobą zajmującą to stanowisko.
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 w Nowym Jorku”.

W przypadku pliku danych zdanymi przedwyborczymi podaj pojedynczy element Office dla tego samego office-role. Ustaw wartość ElectoralDistrict na element wysokiego 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 wysokiego poziomu ElectoralDistrict o wartości ru-country-tw.
ExternalIdentifiers 1 ExternalIdentifiers

Przypisuje identyfikator do biura. Wymagany jest stabilny identyfikator. Stałe identyfikatory urzędów muszą być niepowtarzalne w przypadku wszystkich okresów sprawowania urzędu. Na przykład każdy z tych okresów musi mieć odrębny identyfikator stabilny urzędu:

  • 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, do którego należy to biuro. 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

Wyliczeniowy typ 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 związane z kadencją urzędu.

Dodatkowe typy dla ExternalIdentifiers

W elemencie ExternalIdentifiers elementu Office podaj dodatkowe dane z elementem Type o wartości other oraz wartościami elementó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.
government-body United States Senate Zobacz GovernmentBody.
legislative-session 116th United States Congress
office-level Country Musi to być wartość z zakresu OfficeLevel. Jeśli żaden z nich nie pasuje do Twojej sytuacji, skontaktuj się z osobą kontaktową w Google.
office-role upper house

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

Użyj tej opcji, aby odróżnić biura z wieloma miejscami lub stanowiskami oraz biura, które nie są ograniczone do konkretnego okręgu i nie wygasły.

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>