书房

使用 Office 定义办事处及其相关竞选信息。职位由选区和职位角色标识。

Office 元素适用于所有 Feed 类型，但无需为全民公投指定。

选择以下任一 Feed 类型，详细了解如何将 Office 与该类型的 Feed 搭配使用。

属性

下表介绍了 Office 的属性：

属性 是否必需？ 类型 说明
objectId 必需 ID 供其他元素引用此元素的唯一内部标识符。

元素

下表介绍了 Office 的元素：

元素 多样性 类型 说明
ContactInformation 0 个或更多 ContactInformation 将各种联系信息与办事处相关联。如果包含此元素，请仅指定与职位本身相关的信息，而不是与候选人或现任官员相关的信息。
ElectoralDistrictId 0 或 1 IDREF

提供表示选区的 GpUnit 的 objectId。例如，对于美国参议员，请提供州，如“阿拉斯加”；对于美国众议员，请提供选区，如“纽约第 14 国会选区”。

对于在职官员 Feed，我们预计每个席位有一个 Office，并且 ElectoralDistrictId 设置为将该人员选入办公室的选区。

示例：台湾立法机构选举

  • 根据每位立法委员的选区，为其分配不同的 Office。

另一个示例：美国参议院官员 Feed

  • 为美国参议院提供 100 个 Office 对象。
ExternalIdentifiers 1 ExternalIdentifiers

将 ID 与办事处相关联。必须提供稳定标识符。办公室的稳定标识符在整个办公室任期内必须是唯一的。例如，以下每个任期都需要一个不同的办公室稳定标识符：

  • 格罗弗·克利夫兰的总统任期（1885 年至 1889 年）
  • 格罗弗·克利夫兰的总统任期（1893 年至 1897 年）
  • 富兰克林·罗斯福的总统任期（1933 年至 1945 年）

通过 Office 的 ExternalIdentifiers 元素，您可以提供具有特定 OtherType 值的其他信息。如需了解详情，请参阅 ExternalIdentifiers 的其他类型。
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。如需了解所有可能的选项，请参阅参考文档。
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，用于指定办事处的管辖范围。
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>