书房

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

Office 元素适用于所有 Feed 类型，但无需为公投指定。不过，办公室的定义因 Feed 类型而异。在竞选背景下，Office 表示所竞选的职位的名称，例如“众议员”。在公职人员上下文中，它是指单个人员的特定席位。

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

属性

下表介绍了 Office 的属性：

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

元素

下表介绍了 Office 的元素：

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

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

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

示例：台湾立法机构选举

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

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

  • 1885 年至 1889 年 Grover Cleveland 的总统任期
  • 1893 年至 1897 年，格罗弗·克利夫兰担任美国总统
  • 富兰克林·罗斯福 1933 年至 1945 年的总统任期

借助 Office 的 ExternalIdentifiers 元素，您可以为 OtherType 提供具有特定值的其他信息。如需了解详情，请参阅 ExternalIdentifiers 的其他类型。
FilingDeadline 0 或 1 PartialDate 候选人必须在该日期之前提交竞选该职位的申请。
GovernmentBodyIds 0 或 1 IDREFS 提供此办公室所属的 GovernmentBody 的 objectId。例如，United States Senate 表示美国参议员
Name 1 InternationalizedText 提供此办公室通用职位的全名。此信息必须包含相应办公室的管辖区，但不得包含与选区相关的任何信息。

示例：

  • 新加坡国会议员
  • 印度总理
  • 印度尼西亚总统
  • 美国参议员
SelectionMethod 0 或 1 OfficeSelectionMethod 有关官员的选举或任命方式的信息。
Term 0 或 1 Term 提供与办公室任期相关的信息。

ExternalIdentifier 的其他类型

在 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="off9999a">
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off9999a</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru0002</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>president</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FilingDeadline>2013-01-01</FilingDeadline>
      <IsPartisan>true</IsPartisan>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off9999a",
        "ElectoralDistrictId": "ru0002",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off9999a"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru0002"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "president"
            }
          ]
        }
        "FilingDeadline": "2013-01-01"
        "IsPartisan": true,
        "Name": {
          "Text": [
            {
              "value": "President",
              "language": "en"
            }
          ]
        },
        "Term": {
          "Type": "full-term"
        }
      },
    ]