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 |
1 | IDREF |
Proporciona el Para el feed dedatos previos a las elecciones , proporciona una sola entidad Ejemplo: Elecciones legislativas de Taiwán
|
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:
El elemento |
FilingDeadline |
0 o 1 | PartialDate |
Es la fecha límite para que un candidato se inscriba en la contienda por el cargo. |
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:
|
JurisdictionId |
0 o 1 | IDREF |
Proporciona el |
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. |
SelectionMethod |
0 o más | OfficeSelectionMethod |
Información sobre cómo se selecciona o se coloca en el cargo al funcionario. |
Term |
0 o 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 |
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 |
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="off9999a"> <ElectoralDistrictId>ru0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>stable-off9999a</Value> </ExternalIdentifier> </ExternalIdentifiers> <IsPartisan>true</IsPartisan> <JurisdictionId>ru0002</JurisdictionId> <Level>Administrative Area 1</Level> <Name> <Text language="en">President</Text> </Name> <Role>president</Role> <Term> <Type>full-term</Type> </Term> </Office>