Office

Usa Office para definir una oficina y la información asociada a su concurso. 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 referéndums.


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


Atributos

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

Atributo ¿Es obligatorio? Tipo Descripción
objectId Obligatorio ID Es el 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 diversa información de contacto con la oficina. Si se incluye este elemento, solo se debe especificar información relacionada con el cargo en sí, no con el candidato ni el funcionario actual.
ElectoralDistrictId 0 o 1 IDREF

Proporciona el objectId del GpUnit que representa el distrito electoral. Por ejemplo, indica un estado, como "Alaska", para un senador de EE.UU., o un distrito, como "el distrito electoral 14 de Nueva York", para un representante de EE.UU.

En el feed de funcionarios públicos, esperamos un Office por banca y el ElectoralDistrictId establecido en el distrito que eligió a esa persona para el cargo.

Ejemplo: Elecciones legislativas de Taiwán

  • Asigna a cada miembro del Yuan Legislativo un Office diferente según su distrito.

Otro ejemplo: Feed de titulares de cargos 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 cargos necesita un identificador estable de oficina distinto:

  • 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, Senado de 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 no la 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 del 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 del Person que contiene esta oficina.

SeatStatus 0 o 1 SeatStatus Es el tipo enumerado de SeatStatus del titular del cargo, como active o on-leave. El valor predeterminado es active si no se especifica ningún SeatStatus.
SelectionMethod 0 o más OfficeSelectionMethod Información sobre cómo se selecciona o se coloca en el cargo al funcionario.
Term 1 Term Proporciona información relacionada con los períodos de oficina.

Tipos adicionales para ExternalIdentifiers

En el elemento ExternalIdentifiers 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 del objeto GpUnit que especifica la jurisdicción de la oficina.

government-body United States Senate Consulta GovernmentBody.
legislative-session 116th United States Congress
office-level Country Debe ser un valor de OfficeLevel. Si no se aplica ninguna, comunícate con tu contacto de Google.
office-role upper house

Debe ser un valor de OfficeRole. Si no se aplica ninguna, comunícate con tu contacto de Google.

office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Úsalo para diferenciar las oficinas con varios cargos o posiciones, y para las oficinas generales y no vencidas.

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>