在辦公室工作

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

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

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

屬性

下表說明 Office 的屬性：

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

元素

下表說明 Office 的元素：

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

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

針對選舉前資料 動態消息，請為同一提供單一 Office 實體。office-role將 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

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

辦公室層級的列舉型別。如需選項的完整清單，請參閱參考資料。
Role 0 個以上 OfficeRole 辦公室角色的列舉型別，例如 cabinet member 或 president。如要瞭解所有可能選項，請參閱參考資料。
SelectionMethod 0 個以上 OfficeSelectionMethod 官員的選拔或任命方式。
Term 0 或 1 Term 提供與任期相關的資訊。

ExternalIdentifiers 的其他類型

在 Office 的 ExternalIdentifiers 元素中，提供 Type 為 other 的 other，以及 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>
      </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>