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

Geben Sie für den Feed mit Daten vor der Wahl eine einzelne Office Entität für dieselbe office-role an. Legen Sie ElectoralDistrict auf die Entität der obersten Ebene fest, die die höchste geografische Ebene der Wahl darstellt.

Beispiel:Parlamentswahl in Taiwan

  • Auch wenn die Kandidaten in verschiedenen Bezirken gewählt werden, legen Sie für alle einen einzelnen Office Wert fest: „Member of the Legislative Yuan“ (Mitglied des Legislativ-Yuan). Verwenden Sie für ElectoralDistrict die Entität der obersten Ebene ru-country-tw.
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.

FilingDeadline 0 oder 1 PartialDate Das Datum, bis zu dem ein Kandidat sich für den Wettbewerb um das Amt bewerben muss.
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.
SelectionMethod 0 oder mehr OfficeSelectionMethod Informationen dazu, wie der Amtsinhaber ausgewählt oder ins Amt eingesetzt wird.
Term 0 oder 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="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>