书房

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

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

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

属性

下表介绍了 Office 的属性：

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

元素

下表介绍了 Office 的元素：

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

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

对于 Office 元素，

对于 选举前数据 Feed，请为同一 office-role 提供单个 Office 实体。将 ElectoralDistrict 设置为代表选举最高地理级别的 顶级实体。

示例： 台湾立法选举

  • 即使候选人在不同的选区当选，也要将所有 候选人设置为单个 Office 值“立法委员”。使用顶级 ElectoralDistrict 的 ru-country-tw。
ExternalIdentifiers 1 ExternalIdentifiers

将 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 的其他类型

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