Ufficio

Utilizza Office per definire un ufficio e le informazioni associate al relativo concorso. Un ufficio viene identificato dal distretto elettorale e dal ruolo dell'ufficio.

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 quel tipo di feed.

Feed dei dati pre-elettorali Feed dei risultati delle elezioni Feed dei titolari di cariche

---

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 titolare di carica attuale.
DiplomatReceivingStateId	0 o 1	IDREF	Fornisci il objectId di GpUnit che specifica lo stato di ricezione per un ufficio diplomatico.
DiplomatSendingStateId	0 o 1	IDREF	Fornisci il objectId di GpUnit che specifica lo stato di invio per un ufficio diplomatico.
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 su OfficeHolderTenure. Per i feed storici in cui è incluso, nel caso di titolari di cariche nominati, il valore deve essere uguale a jurisdiction-id. Per il feed dei titolari di cariche, prevediamo un Office per ogni seggio e il ElectoralDistrictId impostato sul distretto che ha eletto la persona alla carica. Esempio: le elezioni legislative di Taiwan Assegna a ogni membro dello Yuan legislativo un Office diverso, in base al distretto. Un altro esempio: feed dei titolari di cariche 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 tutte le durate delle cariche. Ad esempio, ognuna delle seguenti durate delle cariche 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 questa carica. Deve includere la giurisdizione della carica, 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 della carica.
Level	0 o 1	OfficeLevel	Il tipo enumerato del livello della carica. Consulta il riferimento per l'elenco completo delle opzioni.
Role	0 o più	OfficeRole	Il tipo enumerato del ruolo della carica, 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 titolare di 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 titolare di carica.
Term	1	Term	Fornisce informazioni relative alla durata della carica. 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 per 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 della carica. 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 le cariche con più seggi o posizioni, e per le cariche non scadute e in generale. L'ID esterno office-seat è deprecato. Nota: Se il ElectoralDistrict è univoco per l'elezione, non specificare office-seat. Aggiungi office-seat per tutte le posizioni di carica 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="off-0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-0</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>