在辦公室工作

使用 Office 定義辦公室和與競選活動相關的資訊。辦公室的識別依據是選區和辦公室角色。

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

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

屬性

下表說明 Office 的屬性：

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

元素

下表說明 Office 的元素：

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

提供 GpUnit 的 objectId，指定外交辦事處的接受國。
DiplomatSendingStateId 0 或 1 IDREF

提供 objectId 的 GpUnit ，指定外交機構的傳送狀態。
ElectoralDistrictId 1 IDREF

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

如果是選前資料 動態饋給，請為同一個 office-role 提供單一 Office 實體。將 ElectoralDistrict 設為代表選舉最高地理層級的高層級實體。

例子：臺灣立法委員選舉

  • 即使候選人是在不同選區當選，也請將所有候選人的 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

提供 GpUnit 的 objectId，指定辦公室的管轄範圍。
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="off-9999a">
      <ElectoralDistrictId>ru-0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-9999a</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <IsPartisan>true</IsPartisan>
      <JurisdictionId>ru-0002</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Role>president</Role>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>