Użyj elementu Office, aby zdefiniować urząd i informacje powiązane z konkursem. Urząd jest identyfikowany przez okręg wyborczy i rolę.
Element Office dotyczy wszystkich typów plików danych, ale nie trzeba go określać w przypadku referendów.
Aby dowiedzieć się więcej o tym, jak używać elementu Office z danym typem pliku danych, wybierz jeden z tych typów:
Atrybuty
W tabeli poniżej opisano atrybuty elementu Office:
| Atrybut | Wymagany? | Typ | Opis |
|---|---|---|---|
objectId |
Wymagane | ID |
Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu. |
Elementy
W tabeli poniżej opisano elementy elementu Office:
| Element | Mnogość | Typ | Opis |
|---|---|---|---|
ContactInformation |
0 lub więcej | ContactInformation |
Łączy różne informacje kontaktowe z urzędem. Jeśli ten element jest uwzględniony, podaj tylko informacje związane z samym urzędem, a nie z kandydatem ani osobą sprawującą urząd. |
DiplomatReceivingStateId |
0 lub 1 | IDREF |
Podaj |
DiplomatSendingStateId |
0 lub 1 | IDREF |
Podaj |
ElectoralDistrictId |
1 | IDREF |
Podaj W przypadku
pliku danych przedwyborczych i
podaj 1 encję Przykład: wybory parlamentarne na Tajwanie
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
Łączy identyfikator z urzędem. Wymagany jest stabilny identyfikator. Stabilne identyfikatory urzędów muszą być unikalne w przypadku kadencji. Na przykład każda z tych kadencji wymaga innego stabilnego identyfikatora urzędu:
Element |
FilingDeadline |
0 lub 1 | PartialDate |
Data, do której kandydat musi zgłosić się do konkursu na urząd. |
GovernmentBodyIds |
0 lub 1 | IDREFS |
Podaj objectId elementu GovernmentBody, którego częścią jest ten urząd. Na przykład Senat Stanów Zjednoczonych w przypadku senatora USA. |
Name |
1 | InternationalizedText |
Podaje pełną nazwę ogólnego tytułu tego urzędu. Musi ona zawierać jurysdykcję urzędu, ale nie może zawierać żadnych informacji związanych z okręgiem wyborczym.
Przykłady:
|
JurisdictionId |
0 lub 1 | IDREF |
Podaj |
Level |
0 lub 1 | OfficeLevel |
Wyliczeniowy typ poziomu urzędu. Pełną listę opcji znajdziesz w dokumentacji. |
Role |
0 lub więcej | OfficeRole |
Wyliczeniowy typ roli urzędu, np.
cabinet member lub president. Wszystkie możliwe opcje znajdziesz w dokumentacji. |
SelectionMethod |
0 lub więcej | OfficeSelectionMethod |
Informacje o tym, jak osoba sprawująca urząd jest wybierana lub powoływana na urząd. |
Term |
0 lub 1 | Term |
Zawiera informacje związane z kadencją urzędu. |
Dodatkowe typy elementu ExternalIdentifiers
W elemencie ExternalIdentifiers elementu Office podaj dodatkowe dane z wartością
Type równą other oraz wartościami OtherType i Value. W tabeli poniżej znajdziesz możliwe wartości tych elementów:
OtherType |
Przykładowe wartości | Opis |
|---|---|---|
jurisdiction-id |
gpu1 |
|
legislative-session |
116th United States Congress |
|
office-level |
Country |
Musi to być wartość z
OfficeLevel.
Jeśli żadna z nich nie pasuje, skontaktuj się z osobą kontaktową w Google.
|
office-role |
upper house |
Musi to być wartość z
|
office-seat |
Position 1, Seat 2,
unexpired, special,
Seat 2 special |
Użyj tego elementu, aby odróżnić urzędy z wieloma stanowiskami lub pozycjami, i urzędy z nieograniczoną liczbą stanowisk i urzędy, których kadencja nie wygasła. |
Przykłady
XML
<Office objectId="off-9999a"> <ElectoralDistrictId>ru-0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>off-9999a</Value> </ExternalIdentifier> </ExternalIdentifiers> <IsPartisan>true</IsPartisan> <JurisdictionId>ru-0002</JurisdictionId> <Level>Administrative Area 1</Level> <Name> <Text language="en">President</Text> </Name> <Role>president</Role> <Term> <Type>full-term</Type> </Term> </Office>