Ufficio

Utilizza Office per definire un ufficio e le informazioni associate al suo concorso. Un ufficio è identificato dal suo distretto elettorale e dal suo ruolo.

L'elemento Office si applica a tutti i tipi di feed, ma non deve essere specificato per i referendum.

---

Seleziona uno dei seguenti tipi di feed per scoprire di più su come utilizzare Office con questo tipo di feed.

Feed dei dati pre-elettorali Feed dei risultati delle elezioni Feed dei pubblici ufficiali in carica

---

Attributi

La tabella seguente descrive gli attributi di Office:

Attributo	Obbligatorio?	Tipo	Descrizione
objectId	Obbligatorio	ID	Identificatore interno univoco utilizzato da altri elementi per fare riferimento questo elemento.

Elementi

La tabella seguente descrive gli elementi di Office:

Elemento	Molteplicità	Tipo	Descrizione
ContactInformation	0 o più	ContactInformation	Associa varie informazioni di contatto all'ufficio. Se questo elemento è incluso, specifica solo le informazioni relative all' ufficio stesso, non al candidato o al pubblico ufficiale in carica.
ElectoralDistrictId	0 o 1	IDREF	Fornisci il objectId di GpUnit che rappresenta il distretto elettorale. Ad esempio, indica uno stato, come "Alaska", per un senatore statunitense o un distretto, come "14° distretto congressuale di New York", per un rappresentante statunitense. ElectoralDistrictId è deprecato per Office elementi. Utilizza invece l'attributo OfficeHolderTenure. Per i feed storici in cui è incluso, nel caso di pubblici ufficiali in carica nominati, il valore deve essere uguale a jurisdiction-id. Per il feed dei pubblici ufficiali in carica, prevediamo un Office per ogni seggio e il ElectoralDistrictId impostato sul distretto che ha eletto la persona in carica. Esempio: le elezioni legislative di Taiwan Assegna a ogni membro dello Yuan legislativo un Office diverso, in base al suo distretto. Un altro esempio: feed dei pubblici ufficiali in carica del Senato statunitense Fornisci 100 oggetti Office per il Senato statunitense.
ExternalIdentifiers	1	ExternalIdentifiers	Associa un ID all'ufficio. È necessario un identificatore stabile. Gli identificatori stabili per gli uffici devono essere univoci per i mandati. Ad esempio, ognuno dei seguenti mandati richiede un identificatore stabile dell'ufficio distinto: Presidenza di Grover Cleveland dal 1885 al 1889 Presidenza di Grover Cleveland dal 1893 al 1897 Presidenza di Franklin Roosevelt dal 1933 al 1945 L'elemento ExternalIdentifiers di Office ti consente di fornire informazioni aggiuntive con valori specifici per OtherType. Per maggiori dettagli, vedi Tipi aggiuntivi per ExternalIdentifiers.
GovernmentBodyIds	0 o 1	IDREFS	Fornisci il objectId di GovernmentBody di cui fa parte questo ufficio. Ad esempio, il Senato degli Stati Uniti per un senatore statunitense
Name	1	InternationalizedText	Fornisce il nome completo del titolo generico di questo ufficio. Deve includere la giurisdizione dell'ufficio, ma escludere qualsiasi informazione relativa al distretto elettorale. Esempi: Member of Parliament of Singapore Prime Minister of India President of Indonesia United States Senator
JurisdictionId	0 o 1	IDREF	Fornisci il objectId del GpUnit che specifica la giurisdizione dell'ufficio.
Level	0 o 1	OfficeLevel	Il tipo enumerato del livello dell'ufficio. Consulta il riferimento per l'elenco completo delle opzioni.
Role	0 o più	OfficeRole	Il tipo enumerato del ruolo dell'ufficio, ad esempio cabinet member o president. Consulta il riferimento per tutte le opzioni possibili.
OfficeHolderPersonIds	1	IDREFS	Fornisci il objectId del Person che ricopre questa carica. OfficeHolderPersonIds è deprecato. Utilizza invece l'elemento OfficeHolderTenure.
SeatStatus	0 o 1	SeatStatus	Il tipo enumerato di SeatStatus del pubblico ufficiale in carica, ad esempio active o on-leave. Se non viene specificato alcun SeatStatus, il valore predefinito è active SeatStatus per Office è deprecato. Fornisci queste informazioni utilizzando l' OfficeHolderTenure elemento invece.
SelectionMethod	0 o più	OfficeSelectionMethod	Informazioni su come viene selezionato o nominato il pubblico ufficiale in carica.
Term	1	Term	Fornisce informazioni relative al mandato. L'elemento Term per Office è deprecato. Fornisci queste informazioni utilizzando invece l'elemento OfficeHolderTenure invece.

Tipi aggiuntivi per ExternalIdentifiers

Nell'elemento ExternalIdentifiers di Office, fornisci dati aggiuntivi con un Type di other, insieme ai valori di OtherType e Value. La tabella seguente mostra i valori possibili per questi elementi:

OtherType	Valori di esempio	Descrizione
jurisdiction-id	gpu1	L'objectId del GpUnit che specifica la giurisdizione dell'ufficio. L'ID esterno jurisdiction-id è deprecato. Utilizza invece l'attributo JurisdictionId.
legislative-session	116th United States Congress
office-level	Country	Deve essere un valore di OfficeLevel. Se non se ne applica nessuno, contatta il tuo referente Google. L'ID esterno office-level è deprecato. Utilizza invece l'attributo OfficeLevel.
office-role	upper house	Deve essere un valore di OfficeRole. Se non se ne applica nessuno, contatta il tuo referente Google. L'ID esterno office-role è deprecato. Utilizza invece l'attributo OfficeRole.
office-seat	Position 1, Seat 2, unexpired, special, Seat 2 special	Utilizza questo attributo per distinguere gli uffici con più seggi o posizioni, e per gli uffici a livello generale e non scaduti. L'ID esterno office-seat è deprecato. Nota: Se il ElectoralDistrict è univoco per le elezioni, non specificare office-seat. Aggiungi office-seat per tutte le posizioni d'ufficio nello stesso organo che vengono elette dallo stesso ElectoralDistrict. Per le elezioni speciali, come le elezioni suppletive, office-seat deve essere diverso da quello delle elezioni generali. Se non è presente alcun seggio, imposta special. Se è già presente un seggio, aggiungi special alla fine di office-seat, ad esempio Seat 2 special.

Esempi

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>