在辦公室工作

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

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

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

屬性

下表說明 Office 的屬性：

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

元素

下表說明 Office 的元素：

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

請提供objectId選區GpUnit，舉例來說，如果是美國參議員，請提供州別，例如「阿拉斯加州」；如果是美國眾議員，請提供選區，例如「紐約州第 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 的 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="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>