Biuro

Użyj elementu Office, aby zdefiniować biuro i informacje powiązane z konkursem. Urząd jest identyfikowany przez okręg wyborczy i stanowisko.

Element Office dotyczy wszystkich typów plików danych, ale nie musi być określony w przypadku referendów. Definicja biura jest jednak interpretowana inaczej w zależności od typu pliku danych. W kontekście wyborczym Office oznacza tytuł urzędu, o który ubiega się kandydat, np. „Członek Izby Reprezentantów”. W kontekście urzędu jest to konkretne miejsce dla jednej osoby.

Aby dowiedzieć się więcej o używaniu Office w przypadku tego typu pliku danych, wybierz jeden z tych typów plików danych.

Jeśli dana osoba pełni jednocześnie więcej niż jedną funkcję, podaj informacje o tych stanowiskach. Jeśli na przykład dana osoba jest kanclerz Niemiec i posłem do Bundestagu, musi być zdefiniowana w obu tych funkcjach.

Gdy dana osoba zostanie wyznaczona na stanowisko w nowej dzielnicy lub na nowe stanowisko, powiążesz ją z nowym urzędem. Nie używaj ponownie przestarzałego biura.

Atrybuty

W tabeli poniżej opisano atrybuty Office:

Atrybut Wymagany? Typ Opis
objectId Wymagane ID Unikalny wewnętrzny identyfikator 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ązanie 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 obecnym urzędnikiem.
ElectoralDistrictId 0 lub 1 IDREF

Podaj objectId GpUnit, który reprezentuje okręg wyborczy. Podaj na przykład stan, np. „Alaska”, w przypadku senatora Stanów Zjednoczonych, lub okręg wyborczy, np. „14. okręg wyborczy w Nowym Jorku”, w przypadku członka Izby Reprezentantów Stanów Zjednoczonych.

W przypadku kanału urzędnika oczekujemy jednego Office na mandat oraz ElectoralDistrictId ustawionego na okręg, w którym dana osoba została wybrana na stanowisko.

Przykład: wybory do parlamentu Tajwanu

  • Przydziel każdemu członkowi Legislative Yuan inny Office na podstawie jego okręgu.

Inny przykład: dane o posłach do Senatu Stanów Zjednoczonych

  • Podaj 100 obiektów Office dla Senatu Stanów Zjednoczonych.
ExternalIdentifiers 1 ExternalIdentifiers

Przypisuje identyfikator do biura. Wymagane jest podanie stabilnego identyfikatora. Stabilne identyfikatory urzędów muszą być unikalne w przypadku wszystkich urzędów. Na przykład każda z poniższych kadencji wymaga osobnego stabilnego identyfikatora biura:

  • prezydentura Grovera Clevelanda w latach 1885–1889;
  • Grover Cleveland był prezydentem USA w latach 1893–1897.
  • prezydentura Franklina Roosevelta w latach 1933–1945;

Element ExternalIdentifiers w elementach Office umożliwia podanie dodatkowych informacji z określonymi wartościami dla elementu OtherType. Więcej informacji znajdziesz w sekcji Dodatkowe typy w przypadku ExternalIdentifiers.
GovernmentBodyIds 0 lub 1 IDREFS Podaj objectId firmy GovernmentBody, do której należy to biuro. Na przykład „United States Senate” (Senat Stanów Zjednoczonych) w przypadku senatora Stanów Zjednoczonych.
Name 1 InternationalizedText Pełna nazwa urzędu. Musi ona zawierać informacje o jurysdykcji 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
OfficeHolderPersonIds 1 IDREFS

Podaj objectId osoby, która pełni tę funkcję w Person.
SeatStatus 0 lub 1 SeatStatus Wyliczony typ wartości właściwości urzędu, takiej jak active lub on-leave. Jeśli nie określono właściwości SeatStatus, wartość domyślna to active.
SelectionMethod 0 lub 1 OfficeSelectionMethod Informacje o tym, jak wybrano lub powołano daną osobę na stanowisko.
Term 1 Term Zawiera informacje dotyczące kadencji urzędu.

Dodatkowe typy identyfikatorów zewnętrznych

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

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

Wymagany

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 żadna z nich nie pasuje do Twojej sytuacji, skontaktuj się z osobą kontaktową w Google.
office-role upper house

Wymagany

Musi to być wartość z zakresu OfficeRole. Jeśli żadna 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 tego, aby odróżnić biura z wieloma miejscami lub stanowiskami oraz biura ogólne i niewygasłe.

Przykłady

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