Sử dụng Office để xác định một 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 khu vực 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 phải được chỉ định cho các cuộc trưng cầu dân ý.
Chọn một trong các loại nguồn cấp dữ liệu sau đây để tìm hiểu thêm về cách sử dụng Office với loại nguồn cấp dữ liệu đó.
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ộ riêng biệt mà các phần tử khác dùng để tham chiếu đến phần tử này. |
Thành phần
Bảng sau đây mô tả các phần tử của Office:
| Phần tử | Số bội | Loại | Mô tả |
|---|---|---|---|
ContactInformation |
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 thêm phần tử này, hãy chỉ chỉ định thông tin liên quan đến chính văn phòng đó, chứ không phải ứng cử viên hoặc viên chức đương nhiệm. |
ElectoralDistrictId |
1 | IDREF |
Cung cấp Đối với nguồn cấp dữ liệu kết quả bầu cử trước bầu cử, hãy cung cấp một thực thể Ví dụ: Cuộc bầu cử lập pháp ở Đài Loan
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
Liên kết một mã nhận dạng với văn phòng. Bạn phải có một giá trị nhận dạng ổn định. Giá trị nhận dạng ổn định cho các văn phòng phải là riêng biệt trong suốt nhiệm kỳ của văn phòng. Ví dụ: mỗi nhiệm kỳ sau đây cần có một giá trị nhận dạng ổn định riêng biệt cho văn phòng:
Phần tử |
FilingDeadline |
0 hoặc 1 | PartialDate |
Ngày mà ứng cử viên phải nộp đơn tham gia cuộc thi cho văn phòng. |
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 một 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. Tên này phải
bao gồm khu vực pháp lý của văn phòng nhưng không bao gồm bất kỳ thông tin
nào liên quan đến khu vực bầu cử.
Ví dụ:
|
JurisdictionId |
0 hoặc 1 | IDREF |
Cung cấp |
Level |
0 hoặc 1 | OfficeLevel |
Loại được liệt kê của cấp văn phòng. Xem tài liệu tham khảo để biết danh sách đầy đủ các lựa chọn. |
Role |
0 trở lên | OfficeRole |
Loại được liệt kê của Vai trò của văn phòng, chẳng hạn như
cabinet member hoặc president. Xem
tài liệu tham khảo để biết tất cả
các lựa chọn có thể có. |
SelectionMethod |
0 trở lên | OfficeSelectionMethod |
Thông tin về cách viên chức được chọn hoặc được bổ nhiệm vào văn phòng. |
Term |
0 hoặc 1 | Term |
Cung cấp thông tin liên quan đến nhiệm kỳ của 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 thêm dữ liệu có
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 |
|
legislative-session |
116th United States Congress |
|
office-level |
Country |
Phải là một giá trị từ
OfficeLevel.
Nếu không có giá trị nào áp dụng, hãy liên hệ với người liên hệ tại Google.
|
office-role |
upper house |
Phải là một giá trị từ
|
office-seat |
Position 1, Seat 2,
unexpired, special,
Seat 2 special |
Sử dụng giá trị này để phân biệt các văn phòng có nhiều ghế hoặc vị trí, và các văn phòng không giới hạn và chưa hết hạn. |
Ví dụ
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>