Ufficio

Utilizza Office per definire un ufficio e le informazioni associate al relativo 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 quel tipo di feed.

Attributi

La seguente tabella descrive gli attributi per Office:

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

Elementi

La seguente tabella descrive gli elementi per 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 alla carica in sé, non al candidato o al pubblico ufficiale in carica.
ElectoralDistrictId 1 IDREF

Fornisci il objectId del GpUnit che rappresenta il collegio 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.

Per il feed dati pre-elettorali , fornisci una singola entità Office per lo stesso office-role. Imposta ElectoralDistrict sull'entità di livello superiore che rappresenta il livello geografico più alto delle elezioni.

Esempio: le elezioni legislative di Taiwan

  • Anche se i candidati vengono eletti in distretti diversi, imposta tutti su un unico valore Office, "Membro del Legislative Yuan". Utilizza un ElectoralDistrict di alto livello di ru-country-tw.
ExternalIdentifiers 1 ExternalIdentifiers

Associa un ID all'ufficio. È necessario un identificatore stabile�. Gli identificatori stabili per gli uffici devono essere univoci per tutti i mandati dell'ufficio. Ad esempio, ognuno dei seguenti incarichi ha bisogno di un identificatore univoco dell'ufficio:

  • 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 particolari per OtherType. Per maggiori dettagli, vedi Tipi aggiuntivi per ExternalIdentifiers.
FilingDeadline 0 o 1 PartialDate La data entro la quale un candidato deve presentare la candidatura per la carica.
GovernmentBodyIds 0 o 1 IDREFS Fornisci il objectId dell'GovernmentBody di cui fa parte questo ufficio. Ad esempio, 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 collegio elettorale.

Esempi:

  • Membro del Parlamento di Singapore
  • Primo ministro dell'India
  • Presidente dell'Indonesia
  • Senatore degli Stati Uniti
JurisdictionId 0 o 1 IDREF

Fornisci il objectId dell'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.
SelectionMethod 0 o più OfficeSelectionMethod Informazioni su come viene selezionato o nominato il pubblico ufficiale.
Term 0 o 1 Term Fornisce informazioni relative al mandato.

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

Il objectId del GpUnit che specifica la giurisdizione dell'ufficio.
government-body United States Senate Vedi GovernmentBody.
legislative-session 116th United States Congress
office-level Country Deve essere un valore compreso tra OfficeLevel. Se nessuna di queste si applica al tuo caso, rivolgiti al tuo contatto Google.
office-role upper house

Deve essere un valore compreso tra OfficeRole. Se nessuna di queste si applica al tuo caso, rivolgiti al tuo contatto Google.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Utilizza questo campo per distinguere gli uffici con più seggi o posizioni e per gli uffici senza scadenza.

Esempi

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>