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.

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 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.

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

Esempio: le elezioni legislative di Taiwan

  • Anche se i candidati vengono eletti in distretti diversi, impostali tutti su un singolo Office valore, "Member of the 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 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.
FilingDeadline 0 o 1 PartialDate La data entro la quale un candidato deve presentare la domanda per il concorso per il ufficio.
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.
SelectionMethod 0 o più OfficeSelectionMethod Informazioni su come viene selezionato o nominato il pubblico ufficiale in carica.
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 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.
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.
office-role upper house

Deve essere un valore di OfficeRole. Se non se ne applica nessuno, contatta il tuo referente Google.
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.

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>