Office

Utilisez Office pour définir un bureau et les informations associées à son élection. Un bureau est identifié par sa circonscription électorale et son rôle.

L'élément Office s'applique à tous les types de flux, mais n'a pas besoin d'être spécifié pour les référendums.


Sélectionnez l'un des types de flux suivants pour en savoir plus sur l'utilisation de Office avec ce type de flux.


Attributs

Le tableau suivant décrit les attributs de Office :

Attribut Obligatoire ? Type Description
objectId Obligatoire ID Identifiant interne unique utilisé par d'autres éléments pour faire référence à cet élément.

Éléments

Le tableau suivant décrit les éléments de Office :

Élément Multiplicité Type Description
ContactInformation 0 ou plus ContactInformation Associe diverses informations de contact au bureau. Si cet élément est inclus, ne spécifiez que les informations liées à la fonction elle-même, et non au candidat ou à l'élu en place.
ElectoralDistrictId 0 ou 1 IDREF

Indiquez le objectId du GpUnit qui représente la circonscription électorale. Par exemple, indiquez un État (comme "Alaska") pour un sénateur américain ou un district (comme "14e circonscription de New York") pour un représentant américain.

Pour le flux des titulaires de fonctions, nous attendons un Office par siège et le ElectoralDistrictId défini sur la circonscription qui a élu cette personne.

Exemple : Élections législatives à Taïwan

  • Attribuez à chaque membre du Yuan législatif un Office différent, en fonction de sa circonscription.

Autre exemple : flux des titulaires de fonctions sénatoriales aux États-Unis

  • Fournissez 100 objets Office pour le Sénat américain.
ExternalIdentifiers 1 ExternalIdentifiers

Associe un ID au bureau. Un identifiant stable est requis. Les identifiants stables pour les bureaux doivent être uniques pour toutes les durées de mandat. Par exemple, chacun des mandats suivants a besoin d'un identifiant stable de bureau distinct :

  • Présidence de Grover Cleveland de 1885 à 1889
  • Présidence de Grover Cleveland de 1893 à 1897
  • La présidence de Franklin Roosevelt de 1933 à 1945

L'élément ExternalIdentifiers de Office vous permet de fournir des informations supplémentaires avec des valeurs spécifiques pour OtherType. Pour en savoir plus, consultez Types supplémentaires pour ExternalIdentifiers.

GovernmentBodyIds 0 ou 1 IDREFS Indiquez le objectId du GovernmentBody auquel appartient ce bureau. Par exemple, "Sénat des États-Unis" pour un sénateur américain
Name 1 InternationalizedText Indique le nom complet du titre générique de ce bureau. Cela doit inclure la juridiction du bureau, mais exclure toute information liée à la circonscription électorale.

Exemples :

  • Député de Singapour
  • Premier ministre de l'Inde
  • Président de l'Indonésie
  • Sénateur des États-Unis
JurisdictionId 0 ou 1 IDREF

Indiquez le objectId de l'GpUnit qui spécifie la juridiction du bureau.

Level 0 ou 1 OfficeLevel

Type énuméré du niveau de l'établissement. Consultez la documentation de référence pour obtenir la liste complète des options.

Role 0 ou plus OfficeRole Type énuméré du rôle du bureau, par exemple cabinet member ou president. Consultez la documentation de référence pour connaître toutes les options possibles.
OfficeHolderPersonIds 1 IDREFS

Indiquez le objectId du Person qui occupe ce poste.

SeatStatus 0 ou 1 SeatStatus Type énuméré de SeatStatus du titulaire du poste, tel que active ou on-leave. La valeur par défaut est active si aucun SeatStatus n'est spécifié.
SelectionMethod 0 ou plus OfficeSelectionMethod Informations sur la façon dont l'élu est sélectionné ou placé en fonction.
Term 1 Term Fournit des informations sur les termes liés à Office.

Types supplémentaires pour ExternalIdentifiers

Dans l'élément ExternalIdentifiers de Office, fournissez des données supplémentaires avec un Type de other, ainsi que des valeurs pour OtherType et Value. Le tableau suivant indique les valeurs possibles pour ces éléments :

OtherType Exemples de valeur Description
jurisdiction-id gpu1

Le objectId du GpUnit qui spécifie la juridiction du bureau.

government-body United States Senate Voir GovernmentBody.
legislative-session 116th United States Congress
office-level Country La valeur doit être OfficeLevel. Si aucune ne s'applique, contactez votre représentant Google.
office-role upper house

La valeur doit être comprise dans la plage OfficeRole. Si aucune ne s'applique, contactez votre représentant Google.

office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Utilisez-le pour différencier les bureaux avec plusieurs sièges ou postes, ainsi que pour les bureaux non expirés et à grande échelle.

Exemples

XML

    <Office objectId="off0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</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>