在辦公室工作

使用 Office 定義辦公室，以及與該辦公室選舉相關的資訊。辦公室的識別依據是選區和辦公室角色。

Office 元素適用於所有動態饋給類型，但不需要為公民投票指定。

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

屬性

下表說明 Office 的屬性：

屬性 是否必要？ 類型 說明
objectId 必填 ID 其他元素用來參照這個元素的專屬內部 ID。

元素

下表說明 Office 的元素：

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

提供選區的 objectIdGpUnit。舉例來說，如果是美國參議員，請提供州別，例如「阿拉斯加」；如果是美國眾議員，請提供選區，例如「紐約州第 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 提供這個辦公室的通用職稱全名。必須包含辦公室的管轄範圍，但不含任何與選區相關的資訊。

範例：

  • 新加坡國會議員
  • 印度總理
  • 印尼總統
  • 美國參議員
JurisdictionId 0 或 1 IDREF

提供 objectId，GpUnit 指定辦公室管轄範圍。
Level 0 或 1 OfficeLevel

辦公室層級的列舉型別。如需選項的完整清單，請參閱參考資料。
Role 0 個以上 OfficeRole 辦公室角色的列舉型別，例如 cabinet member 或 president。如要瞭解所有可能選項，請參閱參考資料。
OfficeHolderPersonIds 1 IDREFS

提供擔任此職務的Person objectId。
SeatStatus 0 或 1 SeatStatus 辦公室人員的 SeatStatus 列舉型別，例如 active 或 on-leave。如未指定 SeatStatus，預設值為 active。
SelectionMethod 0 個以上 OfficeSelectionMethod 官員的選任或任命方式。
Term 1 Term 提供辦公室任期相關資訊。

ExternalIdentifiers 的其他類型

在 Office 的 ExternalIdentifiers 元素中，提供 Type 為 other 的額外資料，以及 OtherType 和 Value 的值。下表列出這些元素的可能值：

OtherType 範例值 說明
jurisdiction-id gpu1

GpUnit 的 objectId，指定辦公室的管轄範圍。
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">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <JurisdictionId>ru-gpu0</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <Role>upper house</Role>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>