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.
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 |
1 | IDREF |
Geben Sie die Geben Sie für den -Feed mitVorhersagedaten vor der Wahl |
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:
Mit dem Element |
FilingDeadline |
0 oder 1 | PartialDate |
Das Datum, bis zu dem ein Kandidat für das Amt kandidieren muss. |
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:
|
SelectionMethod |
0 oder 1 | OfficeSelectionMethod |
Informationen dazu, wie der Amtsinhaber ausgewählt oder in das Amt berufen wird. |
Term |
0 oder 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 |
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:
|
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 |
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. |
Beispiele
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" } }, ]