在辦公室工作

使用 Office 定義辦公室和與該辦公室相關的競賽資訊。職位可透過選區和職位角色識別。

Office 元素適用於所有動態饋給類型，但不必針對公投指定。不過，辦公室的定義會根據動態饋給類型而有所不同。在選舉脈絡中，Office 代表候選人競選的公職頭銜，例如「眾議院議員」。在公職人員的情況下，指的是某人特定的職位。

請選取下列任一動態饋給類型，進一步瞭解如何搭配該類型動態饋給使用 Office。

如果某人同時擔任多個職位，請務必提供這些職位的相關資訊。舉例來說，如果某人同時是德國總理和聯邦議會議員，則需要在兩個職位中定義。

當某人被指定為新選區或新職位的候選人時，請將該人連結至新職位。請勿重複使用過時的辦公室。

屬性

下表說明 Office 的屬性：

屬性 必填與否 類型 說明
objectId 必填 ID 其他元素用來參照此元素的專屬內部 ID。

元素

下表說明 Office 的元素：

元素 多重性 類型 說明
ContactInformation 0 個以上 ContactInformation 將各種聯絡資訊與辦公室建立關聯。如果包含這個元素，請只指定與職位本身相關的資訊，而非候選人或現任官員。
ElectoralDistrictId 0 或 1 IDREF

提供代表選區的 GpUnit 的 objectId。舉例來說，如果是美國參議員，請提供州名，例如「阿拉斯加州」；如果是美國眾議員，請提供選區，例如「紐約州第 14 選區」。

對於公職人員動態饋給，我們預期每個席次會有一個 Office，而 ElectoralDistrictId 則設為選出該人擔任公職的選區。

範例：臺灣立法委員選舉

  • 根據立法委員的選區，為每位立法委員提供不同的 Office。

其他範例：美國參議院議員動態饋給

  • 提供 100 個 Office 物件，用於美國參議院。
ExternalIdentifiers 1 ExternalIdentifiers

將 ID 與辦公室建立關聯。必須提供穩定 ID。辦公室的穩定 ID 在任職期間內不得重複。舉例來說，下列各個任期都需要一個獨特的辦公室穩定 ID：

  • 格羅佛·克里夫蘭於 1885 年至 1889 年擔任總統
  • 格羅弗·克里夫蘭在 1893 年至 1897 年擔任總統
  • 富蘭克林羅斯福總統 1933 年至 1945 年的任期

Office 的 ExternalIdentifiers 元素可讓您提供額外資訊，並為 OtherType 提供特定值。詳情請參閱「ExternalIdentifiers 的其他類型」。
GovernmentBodyIds 0 或 1 IDREFS 請提供這個辦公室所屬的 GovernmentBody 的 objectId。例如美國參議院代表美國參議員
Name 1 InternationalizedText 提供這個辦公室的通用職稱全名。這項資訊必須包含辦公室的管轄區，但不包含任何與選區相關的資訊。

範例：

  • 新加坡國會議員
  • 印度總理
  • 印尼總統
  • 美國參議員
OfficeHolderPersonIds 1 IDREFS

請提供這個辦公室的 Person 的 objectId。
SeatStatus 0 或 1 SeatStatus 辦公室持有人的 SeatStatus 的列舉型別，例如 active 或 on-leave。如果未指定 SeatStatus，則預設值為 active。
SelectionMethod 0 或 1 OfficeSelectionMethod 關於官員選舉或就任方式的資訊。
Term 1 Term 提供辦公室任期相關資訊。

ExternalIdentifiers 的其他類型

在 Office 的 ExternalIdentifiers 元素中，提供 other 的 Type 和 OtherType 和 Value 的值，以便提供其他資料。下表列出這些元素的可用值：

OtherType 範例值 說明
jurisdiction-id gpu1

必要

指定辦公室管轄區的 GpUnit 的 objectId。
government-body United States Senate 請參閱 GovernmentBody。
legislative-session 116th United States Congress
office-level Country 必須是 OfficeLevel 中的值。如果上述原因皆不適用，請與 Google 聯絡窗口聯絡。
office-role upper house

必要

必須是 OfficeRole 中的值。如果上述原因皆不適用，請與 Google 聯絡窗口聯絡。
office-seat Position 1、Seat 2、unexpired、special、Seat 2 special

用於區分有多個席次或職位的辦公室，以及全國性和未過期的辦公室。

範例

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