Office

Use Office to define an office and information associated with its contest. An office is identified by its electoral district and its office role.

The Office element applies to all feed types but doesn't need to be specified for a referenda. However, the definition of an office is interpreted differently based on the feed type. In an election context, an Office represents the title of the office that's sought, such as "Member of the House of Representatives." In an officeholder context, it's a specific seat for a single person.

Select one of the following feed types to learn more about how to use Office with that type of feed.

Attributes

The following table describes the attributes for Office:

Attribute	Required?	Type	Description
`objectId`	Required	`ID`	Unique internal identifier that's used by other elements to reference this element.

Elements

The following table describes the elements for Office:

Element	Multiplicity	Type	Description
`ContactInformation`	0 or more	`ContactInformation`	Associates various contact information with the office. If this element is included, only specify information that's related to the office itself, not the candidate or current officeholder.
`ElectoralDistrictId`	1	`IDREF`	Provide the `objectId` of the `GpUnit` that represents the electoral district. For instance, give a state, like "Alaska," for a US Senator, or a district, like "New York's 14th congressional district," for a US Representative. For the pre-election data feed, provide a single `Office` entity for the same `office-role`. Set the `ElectoralDistrict` to the high-level entity that represents the top geographic level of the election. Example: The Taiwan legislative election Even if the candidates are elected in different districts, set all of them to a single `Office` value, "Member of the Legislative Yuan." Use a high-level `ElectoralDistrict` of `ru-country-tw`.
`ExternalIdentifiers`	1	`ExternalIdentifiers`	Associates an ID with the office. A stable identifier is required. Stable identifiers for offices must be unique across office tenures. For example, each of the following tenures need a distinct office stable identifier: Grover Cleveland's presidency from 1885 to 1889 Grover Cleveland's presidency from 1893 to 1897 Franklin Roosevelt's presidency from 1933 to 1945 The `ExternalIdentifiers` element of `Office` lets you provide additional information with particular values for `OtherType`. For more details, see Additional types for `ExternalIdentifiers`.
`FilingDeadline`	0 or 1	`PartialDate`	The date by which a candidate must file for the contest for the office.
`Name`	1	`InternationalizedText`	Provides the full name of the generic title of this office, but specific enough to include the jurisdiction of the office. Be sure to exclude any information that's related to the electoral district. The `Name` can appear on the ballot. Examples: Member of Parliament of Singapore Prime Minister of India President of Indonesia United States Senator
`SelectionMethod`	0 or 1	`OfficeSelectionMethod`	Information on how the officeholder is selected or placed into office.
`Term`	0 or 1	`Term`	Provides office term-related information.

Additional types for ExternalIdentifiers

In the ExternalIdentifiers element of Office, provide additional data with a Type of other, along with values for OtherType and Value. The following table shows possible values for these elements:

`OtherType`	Example values	Description
`jurisdiction-id`	`gpu1`	Required The `objectId` of the `GpUnit` that specifies the office's jurisdiction.
`government-body`	`United States Senate`	Any governmental, regulatory, or administrative agency, commission, department, court, or other similarly recognized organization or body of a government. Examples include senates, parliaments, ministries, and cabinets (among many others). Note: Offices with executive roles aren't part of any government body and shouldn't have this property set. Examples of executive office roles include: Heads of government or heads of state (such as presidents or prime ministers) Deputy heads of government/state (such as vice presidents or deputy PMs) State executives (such as governors) Deputy state executives (such as lieutenant governors) Mayors (among many others)
`legislative-session`	`116th United States Congress`
`office-level`	`Country`	Must be a value from `OfficeLevel`. If none apply, reach out to your Google contact.
`office-role`	`upper house`	Required Must be a value from `OfficeRole`. If none apply, reach out to your Google contact.
`office-seat`	`Position 1`, `Seat 2`, `unexpired`, `special`, `Seat 2 special`	Use this to differentiate offices with multiple seats or positions, and for at-large and unexpired offices. Note: If the `ElectoralDistrict` is unique to the election, don't specify `office-seat`. Add `office-seat` for any office positions in the same body that are elected from the same `ElectoralDistrict`. For special elections, such as by-elections, `office-seat` needs to be different than it would be for the general election. If there's no seat, set to `special`. If there is a seat already, add `special` to the end of `office-seat`, such as `Seat 2 special`.

Examples

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"
        }
      },
    ]