Office

Usa Office para definir una oficina y la información asociada con su contienda. Una oficina se identifica por su distrito electoral y su rol.

El elemento Office se aplica a todos los tipos de feeds, pero no es necesario especificarlo para los referendos.

---

Selecciona uno de los siguientes tipos de feeds para obtener más información sobre cómo usar Office con ese tipo de feed.

Feeds de datos previos a las elecciones Feeds de resultados de las elecciones Feeds de funcionarios

---

Atributos

En la siguiente tabla, se describen los atributos de Office:

Atributo	¿Es obligatorio?	Tipo	Descripción
objectId	Obligatorio	ID	Es un identificador interno único que usan otros elementos para hacer referencia a este.

Elementos

En la siguiente tabla, se describen los elementos de Office:

Elemento	Multiplicidad	Tipo	Descripción
ContactInformation	0 o más	ContactInformation	Asocia varios datos de contacto con la oficina. Si se incluye este elemento, solo se debe especificar la información relacionada con la oficina en sí, no con el candidato ni el funcionario actual.
ElectoralDistrictId	0 o 1	IDREF	Proporciona el objectId de la GpUnit que representa el distrito electoral. Por ejemplo, proporciona un estado, como "Alaska", para un senador de EE.UU., o un distrito, como "14º distrito congresional de Nueva York", para un representante de EE.UU. ElectoralDistrictId quedó obsoleto para los elementos Office. En su lugar, usa el atributo en OfficeHolderTenure. Para los feeds históricos en los que se incluye, en el caso de los funcionarios designados, el valor debe ser igual a jurisdiction-id. Para el feed de funcionarios, esperamos un Office por puesto y el ElectoralDistrictId establecido en el distrito que eligió a esa persona para el cargo. Ejemplo: Las elecciones legislativas de Taiwán Proporciona a cada miembro del Yuan Legislativo un Office, según su distrito. Otro ejemplo: Feed de funcionarios del Senado de EE.UU. Proporciona 100 objetos Office para el Senado de EE.UU.
ExternalIdentifiers	1	ExternalIdentifiers	Asocia un ID con la oficina. Se requiere un identificador estable. Los identificadores estables de las oficinas deben ser únicos en todos los períodos de mandato. Por ejemplo, cada uno de los siguientes períodos de mandato necesita un identificador estable de oficina distinto: La presidencia de Grover Cleveland de 1885 a 1889 La presidencia de Grover Cleveland de 1893 a 1897 La presidencia de Franklin Roosevelt de 1933 a 1945 El elemento ExternalIdentifiers de Office te permite proporcionar información adicional con valores particulares para OtherType. Para obtener más detalles, consulta Tipos adicionales para ExternalIdentifiers.
GovernmentBodyIds	0 o 1	IDREFS	Proporciona el objectId del GovernmentBody del que forma parte esta oficina. Por ejemplo, el Senado de los Estados Unidos para un senador de EE.UU.
Name	1	InternationalizedText	Proporciona el nombre completo del título genérico de esta oficina. Debe incluir la jurisdicción de la oficina, pero excluir cualquier información relacionada con el distrito electoral. Ejemplos: Miembro del Parlamento de Singapur Primer ministro de la India Presidente de Indonesia Senador de los Estados Unidos
JurisdictionId	0 o 1	IDREF	Proporciona el objectId de la GpUnit que especifica la jurisdicción de la oficina.
Level	0 o 1	OfficeLevel	Es el tipo enumerado del nivel de la oficina. Consulta la referencia para obtener una lista completa de las opciones.
Role	0 o más	OfficeRole	Es el tipo enumerado del rol de la oficina, como cabinet member o president. Consulta la referencia para ver todas las opciones posibles.
OfficeHolderPersonIds	1	IDREFS	Proporciona el objectId de la Person que ocupa este cargo. OfficeHolderPersonIds quedó obsoleto. En su lugar, usa el elemento OfficeHolderTenure.
SeatStatus	0 o 1	SeatStatus	Es el tipo enumerado del SeatStatus del funcionario, como active o on-leave. El valor predeterminado es active si no se especifica ningún SeatStatus. SeatStatus para Office quedó obsoleto. En su lugar, proporciona esta información con el OfficeHolderTenure elemento.
SelectionMethod	0 o más	OfficeSelectionMethod	Información sobre cómo se selecciona o se designa al funcionario.
Term	1	Term	Proporciona información relacionada con el período de mandato. El elemento Term para Office quedó obsoleto. En su lugar, proporciona esta información con el OfficeHolderTenure elemento.

Tipos adicionales para ExternalIdentifiers

En el ExternalIdentifiers elemento de Office, proporciona datos adicionales con un Type de other, junto con valores para OtherType y Value. En la siguiente tabla, se muestran los valores posibles para estos elementos:

OtherType	Valores de ejemplo	Descripción
jurisdiction-id	gpu1	El objectId de la GpUnit que especifica la jurisdicción de la oficina. El ID externo jurisdiction-id quedó obsoleto. En su lugar, usa el atributo JurisdictionId.
legislative-session	116th United States Congress
office-level	Country	Debe ser un valor de OfficeLevel. Si no se aplica ninguno, comunícate con tu contacto de Google. El ID externo office-level quedó obsoleto. En su lugar, usa el atributo OfficeLevel.
office-role	upper house	Debe ser un valor de OfficeRole. Si no se aplica ninguno, comunícate con tu contacto de Google. El ID externo office-role quedó obsoleto. En su lugar, usa el atributo OfficeRole.
office-seat	Position 1, Seat 2, unexpired, special, Seat 2 special	Usa este parámetro para diferenciar las oficinas con varios puestos o cargos, y para las oficinas generales y no vencidas. El ID externo office-seat quedó obsoleto. Nota: Si el ElectoralDistrict es único para la elección, no especifiques office-seat. Agrega office-seat para cualquier puesto de oficina en el mismo organismo que se elija del mismo ElectoralDistrict. Para las elecciones especiales, como las elecciones parciales, office-seat debe ser diferente de lo que sería para las elecciones generales. Si no hay puesto, establece special. Si ya hay un puesto, agrega special al final de office-seat, como Seat 2 special.

Ejemplos

XML

    <Office objectId="off0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <JurisdictionId>ru-gpu0</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <Role>upper house</Role>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>