Usa Office para definir una oficina y la información asociada con su concurso. Una oficina se identifica por su distrito electoral y su función de oficina.
El elemento Office se aplica a todos los tipos de feeds, pero no es necesario especificarlo para un referéndum. Sin embargo, la definición de oficina se interpreta de manera diferente según el tipo de feed. En un contexto electoral, una Office representa el cargo del cargo que se busca, como "Miembro de la Cámara de Representantes".
En el contexto de un funcionario público, es un asiento específico para una sola persona.
Selecciona uno de los siguientes tipos de feed si quieres obtener más información para 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 |
Obligatorias | ID |
Identificador interno único que otros elementos usan para hacer referencia a este elemento. |
Elementos
En la siguiente tabla, se describen los elementos de Office:
| Elemento | Multiplicidad | Tipo | Descripción |
|---|---|---|---|
ContactInformation |
0 o más | ContactInformation |
Asocia diversos datos de contacto con la oficina. Si se incluye este elemento, solo especifica la información que esté relacionada con el cargo en sí, no con el candidato o el funcionario actual. |
ElectoralDistrictId |
1 | IDREF |
Proporciona el En el feed dedatos previos a las elecciones , proporciona una sola entidad Ejemplo: Las elecciones legislativas de Taiwán
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
Asocian un ID con la oficina. Se requiere un identificador estable. Los identificadores estables para las oficinas deben ser únicos en cada período de antigüedad. Por ejemplo, cada uno de los siguientes puestos de trabajo necesita un identificador estable de oficina diferente:
El elemento |
FilingDeadline |
0 o 1 | PartialDate |
Es la fecha en la que un candidato debe presentarse para el concurso para el cargo. |
Name |
1 | InternationalizedText |
Proporciona el nombre completo del cargo genérico del cargo, pero lo suficientemente específico como para incluir su jurisdicción. Asegúrate de excluir toda la información relacionada con el distrito electoral. La Ejemplos:
|
OfficeHolderPersonIds |
1 | IDREFS |
Proporciona el |
SeatStatus |
0 o 1 | SeatStatus |
El tipo enumerado de SeatStatus del funcionario, como active o on-leave. Si no se especifica ningún SeatStatus, el valor predeterminado es active. |
SelectionMethod |
0 o 1 | OfficeSelectionMethod |
Información sobre cómo se selecciona o se ubica al funcionario en el cargo. |
Term |
0 o 1 | Term |
Proporciona información relacionada con el período de la 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 |
Obligatorio El |
government-body |
United States Senate |
Es cualquier agencia, comisión, departamento, tribunal u otra organización o organismo gubernamental reconocido de forma similar. Entre los ejemplos, se incluyen los senados, los parlamentos, los ministerios y los gabinetes (entre muchos otros). |
legislative-session |
116th United States Congress |
|
office-level |
Country |
Debe ser un valor de OfficeLevel.
Si no corresponde ninguna, comunícate con tu contacto de Google. |
office-role |
upper house |
Obligatorio Debe ser un valor de |
office-seat |
Position 1, Seat 2,
unexpired, special
y Seat 2 special |
Usa esto para diferenciar las oficinas con varios puestos o licencias, y para las oficinas en general y las no vencidas. |
Ejemplos
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"
}
},
]