书房

使用 Office 定义办公室及其相关竞选信息。办公室由其选区和办公室角色标识。

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

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

属性

下表介绍了 Office 的属性：

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

元素

下表介绍了 Office 的元素：

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

提供代表选区的 GpUnit 的 objectId。例如，为美国参议员提供州（如 “阿拉斯加”），或为美国众议员提供选区（如“纽约第 14 国会选区”）。

对于 Office 元素，

对于官员 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

提供担任此办公室的 objectId。Person
SeatStatus 0 个或 1 个 SeatStatus 官员的 SeatStatus 的枚举类型，例如 active 或 on-leave。如果未指定 SeatStatus，则默认值为 active。 对于 Office ，
SelectionMethod 0 个或多个 OfficeSelectionMethod 有关如何选择官员或将其安排到 办公室的信息。
Term 1 个 Term 提供与办公室任期相关的信息。

ExternalIdentifiers 的其他类型

在 ExternalIdentifiers 元素中，提供 Type 为 other 的其他数据，以及 OtherType 和 Value 的值。Office下表显示了这些元素的可能值：

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="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>