Diese Seite wurde von der Cloud Translation API übersetzt.

Büro

Verwenden Sie Office, um ein Amt und Informationen zu dem zugehörigen Wettbewerb zu definieren. Ein Amt wird durch seinen Wahlbezirk und seine Amtsrolle identifiziert.

Das Element Office gilt für alle Feedtypen, muss aber nicht für Referenden angegeben werden. Die Definition eines Büros wird jedoch je nach Feedtyp unterschiedlich interpretiert. Im Wahlkontext steht ein Office für den Titel des angestrebten Amtes, z. B. „Mitglied des Repräsentantenhauses“. Im Kontext eines Amtsinhabers ist es ein bestimmter Sitz für eine einzelne Person.

Wählen Sie einen der folgenden Feedtypen aus, um mehr über die Verwendung von Office mit diesem Feedtyp zu erfahren.

Wenn eine Person mehrere Positionen gleichzeitig innehat, geben Sie Informationen zu diesen Positionen an. Wenn eine Person beispielsweise sowohl Bundeskanzler als auch Mitglied des Bundestags ist, muss sie für beide Ämter definiert werden.

Wenn eine Person als Amtsinhaber für einen neuen Wahlbezirk oder eine neue Position benannt wird, verknüpfen Sie diese Person mit dem neuen Amt. Verwenden Sie kein veraltetes Büro.

Attribute

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

Attribut	Erforderlich?	Typ	Beschreibung
`objectId`	Erforderlich	`ID`	Eindeutige interne Kennung, 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`	Verschiedene Kontaktdaten mit dem Büro verknüpfen. Geben Sie in diesem Fall nur Informationen an, die sich auf das Amt selbst beziehen, nicht auf den Kandidaten oder den amtierenden 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 Wahlbezirk wie „14. Wahlbezirk von New York“ für einen US-Repräsentanten an. Hinweis:`ElectoralDistrictId` ist erforderlich. Legen Sie für ernannte Amtsträger den Wert auf „jurisdiction-id“ fest. Für den Feed mit Amtsinhabern erwarten wir eine `Office` pro Sitz und die `ElectoralDistrictId` muss auf den Wahlbezirk festgelegt sein, in dem die Person gewählt wurde. Beispiel:Wahlen zum taiwanischen Legislativorgan Weisen Sie jedem Mitglied des Legislative Yuan eine andere `Office` zu, je nach Wahlbezirk. Weitere Beispiele:Feed mit Amtsinhabern des US-Senats Geben Sie 100 `Office`-Objekte für den US-Senat an. -Feed mit
`ExternalIdentifiers`	1	`ExternalIdentifiers`	Ordnet der Niederlassung eine ID zu. Eine stabile Kennung ist erforderlich. Stabile Kennungen für Ämter müssen für alle Amtszeiten eindeutig sein. Beispielsweise benötigt jede der folgenden Amtszeiten eine eindeutige stabile Bürokennung: Grover Clevelands Präsidentschaft von 1885 bis 1889 Grover Clevelands Präsidentschaft von 1893 bis 1897 Die Präsidentschaft von Franklin Roosevelt von 1933 bis 1945 Mit dem Element `ExternalIdentifiers` 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 diese Niederlassung gehört. Beispiel: United States Senate für einen US-Senator
`Name`	1	`InternationalizedText`	Der vollständige Name des generischen Titels dieses Amtes. Sie muss die Zuständigkeit des Amtes umfassen, aber alle Informationen zum Wahlbezirk ausschließen. Beispiele: Mitglied des singapurischen Parlaments Premierminister von Indien Präsident von Indonesien US-Senator
`OfficeHolderPersonIds`	1	`IDREFS`	Geben Sie die `objectId` der `Person` an, die diese Position innehat.
`SeatStatus`	0 oder 1	`SeatStatus`	Der aufgezählte Typ des „SeatStatus“ des Amtsträgers, z. B. `active` oder `on-leave`. Der Standardwert ist `active`, wenn kein „SeatStatus“ angegeben ist.
`SelectionMethod`	0 oder 1	`OfficeSelectionMethod`	Informationen dazu, wie der Amtsinhaber ausgewählt oder in das Amt berufen wird.
`Term`	1	`Term`	Bietet Informationen zu Begriffen aus dem Büroalltag.

Zusätzliche Typen für ExternalIdentifiers

Geben Sie im ExternalIdentifiers-Element von Office zusätzliche Daten mit einer 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`	Erforderlich Die `objectId` des `GpUnit`, die die Gerichtsbarkeit des Amts angibt.
`government-body`	`United States Senate`	Der vollständige Name des generischen englischen Titels der Behörde. Dazu gehört die Zuständigkeit der Behörde, aber keine Informationen zum Wahlbezirk. Dies bezieht sich insbesondere auf staatliche, behördliche oder Verwaltungsbehörden, Kommissionen, Abteilungen, Gerichte oder andere ähnlich anerkannte Organisationen oder Organe einer Regierung, z. B. Senate, Parlamente, Ministerien und Kabinette. Beispiele: Ministerium für Bildung (Indien) Parlament von Singapur Russische Staatsduma Senat der Vereinigten Staaten Hinweis:Ämter mit leitender Funktion sind keine Regierungsbehörden und für diese sollte diese Property nicht festgelegt sein. Beispiele für Positionen in der Geschäftsführung: Regierungschefs oder Staatsoberhäupter (z. B. Präsidenten oder Premierminister) Stellvertretende Regierungschefs (z. B. Vizepräsidenten oder stellvertretende Premierminister) Regierungschefs von Bundesstaaten (z. B. Gouverneure) Stellvertretende Regierungsmitglieder (z. B. Vizegouverneure) Bürgermeister (unter anderem) Die externe ID der Behörde wird nicht mehr unterstützt. Verwenden Sie stattdessen das Attribut „GovernmentBodyIds“.
`legislative-session`	`116th United States Congress`
`office-level`	`Country`	Muss ein Wert aus `OfficeLevel` sein. Falls keiner zutrifft, wenden Sie sich an Ihren Google-Ansprechpartner.
`office-role`	`upper house`	Erforderlich Muss ein Wert aus `OfficeRole` sein. Falls keiner zutrifft, wenden Sie sich an Ihren Google-Ansprechpartner.
`office-seat`	`Position 1`, `Seat 2`, `unexpired`, `special`, `Seat 2 special`	Verwenden Sie diese Option, um Ämter mit mehreren Sitzen oder Positionen sowie Ämter, die für alle Wähler offen sind, und Ämter, deren Amtszeit noch nicht abgelaufen ist, voneinander zu unterscheiden. Hinweis: Wenn `ElectoralDistrict` für die Wahl eindeutig ist, geben Sie `office-seat` nicht an. Fügen Sie `office-seat` für alle Ämter in derselben Körperschaft hinzu, die aus derselben `ElectoralDistrict` gewählt werden. Bei Sonderwahlen wie Nachwahlen muss `office-seat` von dem Wert für die allgemeine Wahl abweichen. Wenn kein Sitzplatz vorhanden ist, setzen Sie den Wert auf `special`. Wenn bereits ein Sitzplatz vorhanden ist, fügen Sie am Ende von `office-seat` die Zahl `special` hinzu, z. B. `Seat 2 special`.

Beispiele

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"
        }
      }
    ]