在辦公室工作

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

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

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

屬性

下表說明 Office 的屬性：

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

元素

下表說明 Office 的元素：

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

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

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

範例：臺灣立法委員選舉

  • 即使候選人當選的選區不同，仍應將所有候選人設為單一 Office 值「立法委員」。使用高層級的 ElectoralDistrict ru-country-tw。
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 提供這個辦公室的通用職稱全名。必須包含辦公室的管轄範圍，但不含任何與選區相關的資訊。

範例：

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

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

辦公室層級的列舉型別。如需選項的完整清單，請參閱參考資料。
Role 0 個以上 OfficeRole 辦公室角色的列舉型別，例如 cabinet member 或 president。如要瞭解所有可能選項，請參閱參考資料。
SelectionMethod 0 個以上 OfficeSelectionMethod 官員的選任或任命方式。
Term 0 或 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="off9999a">
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off9999a</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <IsPartisan>true</IsPartisan>
      <JurisdictionId>ru0002</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Role>president</Role>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>