书房

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

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

选择以下一种 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 年 Grover Cleveland 的总统任期
  • 1893 年至 1897 年，格罗弗·克利夫兰担任美国总统
  • 富兰克林·罗斯福 1933 年至 1945 年的总统任期

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

示例：

  • 新加坡国会议员
  • 印度总理
  • 印度尼西亚总统
  • 美国参议员
OfficeHolderPersonIds 1 IDREFS

提供负责此职位的 Person 的 objectId。
SeatStatus 0 或 1 SeatStatus 职位持有者的 SeatStatus 的枚举类型，例如 active 或 on-leave。如果未指定 SeatStatus，则默认值为 active。
SelectionMethod 0 或 1 OfficeSelectionMethod 有关官员的选举或任命方式的信息。
Term 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="off0">
      <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>upper house</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru-gpu0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <OfficeHolderPersonIds>per0</OfficeHolderPersonIds>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off0",
        "ElectoralDistrictId": "ru-gpu0",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off0"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "upper house"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru-gpu0"
            }
          ]
        }
        "GovernmentBodyIds": ["gb-1]
        "Name": {
          "Text": [
            {
              "value": "United States Senator",
              "language": "en"
            }
          ]
        }
        "OfficeHolderPersonIds": "per0"
        "SelectionMethod": "directly-elected"
        "Term": {
          "StartDate": "2019-01-02"
        }
      }
    ]