在辦公室工作

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

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

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

屬性

下表說明 Office 的屬性：

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

元素

下表說明 Office 的元素：

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

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

針對選舉前資料 動態饋給，請為相同的 office-role 提供單一 Office 實體。將 ElectoralDistrict 設為代表選舉頂層地理層級的高層實體。

範例：臺灣立法委員選舉

  • 即使候選人來自不同選區，也請將所有候選人設為單一 Office 值：「立法院委員」。使用 ru-country-tw 的高階 ElectoralDistrict。
ExternalIdentifiers 1 ExternalIdentifiers

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

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

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

範例：

  • 新加坡國會議員
  • 印度總理
  • 印尼總統
  • 美國參議員
SelectionMethod 0 或 1 OfficeSelectionMethod 關於官員選舉或就任方式的資訊。
Term 0 或 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="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"
        }
      },
    ]