Sử dụng Office để xác định văn phòng và thông tin liên quan đến cuộc thi của văn phòng đó. Một văn phòng được xác định bằng quận bầu cử và vai trò của văn phòng đó.
Phần tử Office áp dụng cho tất cả các loại nguồn cấp dữ liệu nhưng không cần được chỉ định cho một cuộc trưng cầu ý dân. Tuy nhiên, định nghĩa về văn phòng được diễn giải khác nhau dựa trên loại nguồn cấp dữ liệu. Trong bối cảnh bầu cử, Office đại diện cho chức danh của chức vụ được tìm kiếm, chẳng hạn như "Thành viên Hạ viện".
Trong ngữ cảnh của người giữ chức vụ, đây là một ghế cụ thể dành cho một người.
Chọn một trong các loại nguồn cấp dữ liệu sau để tìm hiểu thêm về cách sử dụng Office với loại nguồn cấp dữ liệu đó.
Nếu một người giữ nhiều chức vụ cùng lúc, hãy nhớ cung cấp thông tin về các văn phòng này. Ví dụ: nếu một người vừa là Thủ tướng Đức vừa là Thành viên của Bundestag, thì họ cần được xác định ở cả hai chức vụ.
Khi một người được chỉ định làm người giữ chức vụ cho một khu vực mới hoặc một chức vụ mới, hãy liên kết người này với văn phòng mới. Hãy nhớ không sử dụng lại một văn phòng đã lỗi thời.
Thuộc tính
Bảng sau đây mô tả các thuộc tính của Office:
| Thuộc tính | Bắt buộc? | Loại | Mô tả |
|---|---|---|---|
objectId |
Bắt buộc | ID |
Giá trị nhận dạng nội bộ duy nhất mà các phần tử khác sử dụng để tham chiếu phần tử này. |
Thành phần
Bảng sau đây mô tả các phần tử cho Office:
| Phần tử | Số bội | Loại | Mô tả |
|---|---|---|---|
ContactInformation |
Từ 0 trở lên | ContactInformation |
Liên kết nhiều thông tin liên hệ với văn phòng. Nếu bạn đưa phần tử này vào, hãy chỉ chỉ định thông tin liên quan đến chính chức vụ đó, chứ không phải ứng cử viên hoặc người giữ chức vụ hiện tại. |
ElectoralDistrictId |
0 hoặc 1 | IDREF |
Cung cấp Đối với nguồn cấp dữ liệu về người giữ chức vụ, chúng tôi dự kiến mỗi ghế sẽ có một Ví dụ: Bầu cử lập pháp ở Đài Loan
Ví dụ khác: Nguồn cấp dữ liệu về người giữ chức vụ trong Thượng viện Hoa Kỳ
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
Liên kết mã nhận dạng với văn phòng. Bắt buộc phải có một giá trị nhận dạng ổn định. Giá trị nhận dạng ổn định cho văn phòng phải là duy nhất trong suốt thời gian văn phòng hoạt động. Ví dụ: mỗi nhiệm kỳ sau đây cần có một giá trị nhận dạng cố định khác nhau cho văn phòng:
Phần tử |
GovernmentBodyIds |
0 hoặc 1 | IDREFS |
Cung cấp objectId của GovernmentBody mà văn phòng này thuộc về. Ví dụ: Thượng viện Hoa Kỳ cho Thượng nghị sĩ Hoa Kỳ |
Name |
1 | InternationalizedText |
Cung cấp tên đầy đủ của chức danh chung của văn phòng này. Thông tin này phải bao gồm khu vực tài phán của văn phòng nhưng loại trừ mọi thông tin liên quan đến khu vực bầu cử.
Ví dụ:
|
OfficeHolderPersonIds |
1 | IDREFS |
Cung cấp |
SeatStatus |
0 hoặc 1 | SeatStatus |
Loại được liệt kê của SeatStatus của người giữ chức vụ, chẳng hạn như active hoặc on-leave. Giá trị mặc định là active nếu bạn không chỉ định SeatStatus. |
SelectionMethod |
0 hoặc 1 | OfficeSelectionMethod |
Thông tin về cách thức chọn hoặc bổ nhiệm người giữ chức vụ. |
Term |
1 | Term |
Cung cấp thông tin liên quan đến nhiệm kỳ tại văn phòng. |
Các loại bổ sung cho ExternalIdentifiers
Trong phần tử ExternalIdentifiers của Office, hãy cung cấp dữ liệu bổ sung với Type là other, cùng với các giá trị cho OtherType và Value. Bảng sau đây cho thấy các giá trị có thể có cho các phần tử này:
OtherType |
Giá trị mẫu | Mô tả |
|---|---|---|
jurisdiction-id |
gpu1 |
Bắt buộc
|
government-body |
United States Senate |
Hãy xem GovernmentBody.
|
legislative-session |
116th United States Congress |
|
office-level |
Country |
Phải là một giá trị từ OfficeLevel.
Nếu không có trường hợp nào áp dụng, hãy liên hệ với người liên hệ của bạn tại Google. |
office-role |
upper house |
Bắt buộc Phải là một giá trị từ |
office-seat |
Position 1, Seat 2,
unexpired, special,
Seat 2 special |
Sử dụng thuộc tính này để phân biệt các văn phòng có nhiều ghế hoặc vị trí, cũng như các văn phòng đại diện và văn phòng chưa hết hạn. |
Ví dụ
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" } } ]