Ufficio

Utilizza Office per definire un ufficio e le informazioni associate al relativo concorso. Un incarico viene identificato dal suo collegio elettorale e dal suo ruolo.

L'elemento Office si applica a tutti i tipi di feed, ma non deve essere specificato per un referendum. Tuttavia, la definizione di un ufficio viene interpretata in modo diverso in base al tipo di feed. In un contesto elettorale, un Office rappresenta il titolo della carica che si cerca, ad esempio "Membro della Camera dei rappresentanti". In un contesto di carica, si tratta di un seggio specifico per una singola persona.

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

Se una persona ricopre contemporaneamente più posizioni, assicurati di fornire informazioni su tutti gli incarichi. Ad esempio, se una persona è sia cancelliere della Germania sia membro del Bundestag, deve essere definita in entrambi gli uffici.

Quando una persona viene designata come titolare di un nuovo ufficio o di una nuova carica, collegala al nuovo ufficio. Assicurati di non riutilizzare un ufficio obsoleto.

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 a questo elemento.

Elementi

La tabella seguente descrive gli elementi per Office:

Elemento Molteplicità Tipo Descrizione
ContactInformation 0 o più ContactInformation Associa vari dati di contatto all'ufficio. Se questo elemento è incluso, specifica solo le informazioni relative all'incarico stesso, non al candidato o all'attuale detentore dell'incarico.
ElectoralDistrictId 0 o 1 IDREF

Fornisci il objectId del GpUnit che rappresenta il collegio elettorale. Ad esempio, indica uno stato, come "Alaska", per un senatore degli Stati Uniti o un distretto, come "14° distretto congressuale di New York", per un rappresentante degli Stati Uniti.

Per il feed del titolare della carica, prevediamo un Office per seggio e il ElectoralDistrictId impostato sul distretto che ha eletto la persona in carica.

Esempio: le elezioni legislative di Taiwan

  • Assegna a ogni membro del Legislative Yuan un Office diverso, in base al suo distretto.

Un altro esempio: feed dei titolari di cariche del Senato degli Stati Uniti

  • Fornisci 100 oggetti Office per il Senato degli Stati Uniti.
ExternalIdentifiers 1 ExternalIdentifiers

Associa un ID all'ufficio. È obbligatorio un identificatore stabile. Gli identificatori stabili degli uffici devono essere univoci per tutti gli incarichi. Ad esempio, ciascuna delle seguenti durate richiede un identificativo stabile distinto 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 specifici per OtherType. Per maggiori dettagli, consulta Tipi aggiuntivi per ExternalIdentifiers.
GovernmentBodyIds 0 o 1 IDREFS Fornisci il objectId del GovernmentBody di cui fa parte questo ufficio. Ad esempio, Senato degli Stati Uniti per un senatore degli Stati Uniti
Name 1 InternationalizedText Fornisce il nome completo del titolo generico di questo ufficio. Deve essere inclusa la giurisdizione dell'ufficio, ma devono essere escluse le informazioni relative al collegio elettorale.

Esempi:

  • Membro del Parlamento di Singapore
  • Primo ministro dell'India
  • Presidente dell'Indonesia
  • Senatore degli Stati Uniti
OfficeHolderPersonIds 1 IDREFS

Fornisci il objectId del Person che detiene questa carica.
SeatStatus 0 o 1 SeatStatus Il tipo enumerato di SeatStatus del funzionario, ad esempio active o on-leave. Il valore predefinito è active se non viene specificato SeatStatus.
SelectionMethod 0 o 1 OfficeSelectionMethod Informazioni su come viene selezionato o nominato il detentore della carica.
Term 1 Term Fornisce informazioni relative ai termini dell'ufficio.

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 possibili valori per questi elementi:

OtherType Valori di esempio Descrizione
jurisdiction-id gpu1

Obbligatorio

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

Obbligatorio

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

Utilizzalo per distinguere gli uffici con più seggi o posizioni, nonché per gli uffici a livello generale e non scaduti.

Esempi

XML

    <Office objectId="off0">
      <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>upper house</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru-gpu0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <OfficeHolderPersonIds>per0</OfficeHolderPersonIds>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off0",
        "ElectoralDistrictId": "ru-gpu0",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off0"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "upper house"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru-gpu0"
            }
          ]
        }
        "GovernmentBodyIds": ["gb-1]
        "Name": {
          "Text": [
            {
              "value": "United States Senator",
              "language": "en"
            }
          ]
        }
        "OfficeHolderPersonIds": "per0"
        "SelectionMethod": "directly-elected"
        "Term": {
          "StartDate": "2019-01-02"
        }
      }
    ]