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.

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 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 dei dati pre-elettorali , fornisci una singola entità Office per lo stessooffice-role. Imposta ElectoralDistrict sull'entità di alto livello che rappresenta il livello geografico superiore dell'elezione.

Esempio: le elezioni legislative di Taiwan

  • Anche se i candidati vengono eletti in distretti diversi, impostali tutti su un singolo valore Office, "Membro del Legislative Yuan". Utilizza un ElectoralDistrict di ru-country-tw di alto livello.
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.
FilingDeadline 0 o 1 PartialDate La data entro la quale un candidato deve presentare la domanda di partecipazione al concorso per la carica.
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
SelectionMethod 0 o 1 OfficeSelectionMethod Informazioni su come viene selezionato o nominato il detentore della carica.
Term 0 o 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="off9999a">
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off9999a</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru0002</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>president</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FilingDeadline>2013-01-01</FilingDeadline>
      <IsPartisan>true</IsPartisan>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off9999a",
        "ElectoralDistrictId": "ru0002",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off9999a"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru0002"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "president"
            }
          ]
        }
        "FilingDeadline": "2013-01-01"
        "IsPartisan": true,
        "Name": {
          "Text": [
            {
              "value": "President",
              "language": "en"
            }
          ]
        },
        "Term": {
          "Type": "full-term"
        }
      },
    ]