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.

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 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 przypadkudanych przedwyborowych plików danych podaj jeden element Office dla tego samego office-role. Ustaw element ElectoralDistrict na element wysokiego poziomu, który reprezentuje najwyższy poziom geograficzny wyborów.

Przykład: wybory do parlamentu Tajwanu

  • Nawet jeśli kandydaci zostali wybrani w różnych okręgach, ustaw dla wszystkich z nich tę samą wartość Office, czyli „Członek Yuanu Legislacyjnego”. Użyj ogólnego ElectoralDistricto wartości ru-country-tw.
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.
FilingDeadline 0 lub 1 PartialDate Data, do której kandydat musi złożyć wniosek o konkurs na stanowisko.
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
SelectionMethod 0 lub 1 OfficeSelectionMethod Informacje o tym, jak wybrano lub powołano daną osobę na stanowisko.
Term 0 lub 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="off9999a">
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off9999a</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru0002</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>president</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FilingDeadline>2013-01-01</FilingDeadline>
      <IsPartisan>true</IsPartisan>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off9999a",
        "ElectoralDistrictId": "ru0002",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off9999a"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru0002"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "president"
            }
          ]
        }
        "FilingDeadline": "2013-01-01"
        "IsPartisan": true,
        "Name": {
          "Text": [
            {
              "value": "President",
              "language": "en"
            }
          ]
        },
        "Term": {
          "Type": "full-term"
        }
      },
    ]