书房

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

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

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

属性

下表介绍了 Office 的属性：

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

元素

下表介绍了 Office 的元素：

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

提供 objectId 的 GpUnit ，用于指定外交办公室的接收国。
DiplomatSendingStateId 0 或 1 IDREF

提供 objectId GpUnit ，用于指定外交办公室的派遣国。
ElectoralDistrictId 1 IDREF

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

对于 选举前数据 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

提供 objectId GpUnit ，用于指定办公室的管辖范围。
Level 0 或 1 OfficeLevel

办公室级别的枚举类型。如需查看完整选项列表，请参阅 参考文档。
Role 0 个或多个 OfficeRole 办公室角色的枚举类型，例如 cabinet member 或 president。如需查看所有 可能的选项，请参阅 参考文档。
SelectionMethod 0 个或多个 OfficeSelectionMethod 有关如何选择官员或将其安排到 办公室的信息。
Term 0 或 1 Term 提供与办公室任期相关的信息。

ExternalIdentifiers 的其他类型

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

OtherType 示例值 说明
jurisdiction-id gpu1

objectId 的 GpUnit，用于指定办公室的管辖范围。
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="off-9999a">
      <ElectoralDistrictId>ru-0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-9999a</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <IsPartisan>true</IsPartisan>
      <JurisdictionId>ru-0002</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Role>president</Role>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>