Büro

Verwenden Sie Office, um ein Amt und Informationen zu dem entsprechenden Wettbewerb zu definieren. Ein Amt wird durch den Wahlbezirk und die Amtsrolle identifiziert.

Das Element Office gilt für alle Feedtypen, muss aber nicht für Referenden angegeben werden.

Wählen Sie einen der folgenden Feedtypen aus, um mehr darüber zu erfahren, wie Sie Office mit diesem Feedtyp verwenden.

Attribute

In der folgenden Tabelle werden die Attribute für Office beschrieben:

Attribut Erforderlich? Typ Beschreibung
objectId Erforderlich ID Eindeutige interne ID, die von anderen Elementen verwendet wird, um auf dieses Element zu verweisen.

Elemente

In der folgenden Tabelle werden die Elemente für Office beschrieben:

Element Multiplizität Typ Beschreibung
ContactInformation 0 oder mehr ContactInformation Verknüpft verschiedene Kontaktinformationen mit dem Amt. Wenn dieses Element enthalten ist, geben Sie nur Informationen an, die sich auf das Amt selbst beziehen, nicht auf den Kandidaten oder den aktuellen Amtsinhaber.
ElectoralDistrictId 0 oder 1 IDREF

Geben Sie die objectId der GpUnit an, die den Wahlbezirk darstellt. Geben Sie beispielsweise einen Bundesstaat wie „Alaska“ für einen US-Senator oder einen Bezirk wie „14. Kongressbezirk von New York“ für einen US-Abgeordneten an.

Für den Feed mit Amtsinhabern erwarten wir ein Office pro Sitz und die ElectoralDistrictId muss auf den Bezirk festgelegt sein, in dem die Person ins Amt gewählt wurde.

Beispiel:Parlamentswahl in Taiwan

  • Geben Sie für jedes Mitglied des Legislativ-Yuan ein anderes Office an, basierend auf dem jeweiligen Bezirk.

Ein weiteres Beispiel:Feed mit Amtsinhabern des US-Senats

  • Geben Sie 100 Office-Objekte für den US-Senat an.
ExternalIdentifiers 1 ExternalIdentifiers

Verknüpft eine ID mit dem Amt. Eine stabile ID ist erforderlich. Stabile IDs für Ämter müssen über die Amtszeiten hinweg eindeutig sein. Für jede der folgenden Amtszeiten ist beispielsweise eine eigene stabile ID für das Amt erforderlich:

  • Amtszeit von Grover Cleveland von 1885 bis 1889
  • Amtszeit von Grover Cleveland von 1893 bis 1897
  • Amtszeit von Franklin Roosevelt von 1933 bis 1945

Mit dem ExternalIdentifiers Element von Office können Sie zusätzliche Informationen mit bestimmten Werten für OtherType angeben. Weitere Informationen finden Sie unter Zusätzliche Typen für ExternalIdentifiers.
GovernmentBodyIds 0 oder 1 IDREFS Geben Sie die objectId der GovernmentBody an, zu der dieses Amt gehört. Beispiel: US-Senat für einen US-Senator
Name 1 InternationalizedText Gibt den vollständigen Namen des generischen Titels dieses Amtes an. Dieser muss die Gerichtsbarkeit des Amtes enthalten, aber alle Informationen ausschließen, die sich auf den Wahlbezirk beziehen.

Beispiele:

  • Mitglied des Parlaments von Singapur
  • Premierminister von Indien
  • Präsident von Indonesien
  • US-Senator
JurisdictionId 0 oder 1 IDREF

Geben Sie die objectId der GpUnit an, die die Gerichtsbarkeit des Amtes angibt.
Level 0 oder 1 OfficeLevel

Der aufgezählte Typ der Ebene des Amtes. Eine vollständige Liste der Optionen finden Sie in der Referenz.
Role 0 oder mehr OfficeRole Der aufgezählte Typ der Rolle des Amtes, z. B. cabinet member oder president. Eine vollständige Liste der Optionen finden Sie in der Referenz.
OfficeHolderPersonIds 1 IDREFS

Geben Sie die objectId der Person an, die dieses Amt innehat.
SeatStatus 0 oder 1 SeatStatus Der aufgezählte Typ des Sitzstatus des Amtsinhabers, z. B. active oder on-leave. Der Standardwert ist active wenn kein Sitzstatus angegeben ist.
SelectionMethod 0 oder mehr OfficeSelectionMethod Informationen dazu, wie der Amtsinhaber ausgewählt oder ins Amt eingesetzt wird.
Term 1 Term Enthält Informationen zur Amtszeit.

Zusätzliche Typen für ExternalIdentifiers

Geben Sie im Element ExternalIdentifiers von Office zusätzliche Daten mit einem Type von other sowie Werte für OtherType und Value an. In der folgenden Tabelle sind mögliche Werte für diese Elemente aufgeführt:

OtherType Beispielwerte Beschreibung
jurisdiction-id gpu1

Die objectId der GpUnit, die die Gerichtsbarkeit des Amtes angibt.
legislative-session 116th United States Congress
office-level Country Muss ein Wert aus OfficeLevel sein. Wenn keine zutrifft, wenden Sie sich an Ihren Google-Ansprechpartner.
office-role upper house

Muss ein Wert aus OfficeRole sein. Wenn keine zutrifft, wenden Sie sich an Ihren Google-Ansprechpartner.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Verwenden Sie dieses Element, um zwischen Ämtern mit mehreren Sitzen oder Positionen, und für Ämter mit nicht abgelaufener Amtszeit und für Sonderämter zu unterscheiden.

Beispiele

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>