Văn phòng

Sử dụng Office để xác định một văn phòng và thông tin liên quan đến cuộc tranh cử 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 chỉ định cho 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 để 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 cho Office:

Thuộc tính Bắt buộc? Loại Mô tả
objectId Bắt buộc ID Mã nhận dạng nội bộ duy nhất được các phần tử khác dùng để tham chiếu phần tử này.

Phần tử

Bảng sau đây mô tả các phần tử cho 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ỉ nêu rõ 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 đương nhiệm.
DiplomatReceivingStateId 0 hoặc 1 IDREF

Cung cấp objectId của GpUnit chỉ định quốc gia tiếp nhận cho một cơ quan ngoại giao.
DiplomatSendingStateId 0 hoặc 1 IDREF

Cung cấp objectId của GpUnit chỉ định quốc gia cử đại diện ngoại giao.
ElectoralDistrictId 0 hoặc 1 IDREF

Cung cấp objectId của GpUnit đại diện cho khu vực bầu cử. Ví dụ: hãy cung cấp một tiểu bang (như "Alaska") cho một Thượng nghị sĩ Hoa Kỳ hoặc một khu vực bầu cử (như "Khu vực bầu cử thứ 14 của New York") cho một Hạ nghị sĩ Hoa Kỳ.

Đối với nguồn cấp dữ liệu về người đương nhiệm, chúng tôi cần một Office cho mỗi ghế và ElectoralDistrictId được đặt thành học khu đã bầu người đó vào chức vụ.

Ví dụ: Cuộc bầu cử lập pháp ở Đài Loan

  • Cung cấp cho mỗi thành viên của Lập pháp viện một Office khác nhau, dựa trên khu vực của họ.

Ví dụ khác: Nguồn cấp dữ liệu về người đương nhiệm trong Thượng viện Hoa Kỳ

  • Cung cấp 100 đối tượng Office cho Thượng viện Hoa Kỳ.
ExternalIdentifiers 1 ExternalIdentifiers

Liên kết một mã nhận dạng với văn phòng. Bạn cần 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 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:

  • Nhiệm kỳ tổng thống của Grover Cleveland từ năm 1885 đến năm 1889
  • Nhiệm kỳ tổng thống của Grover Cleveland từ năm 1893 đến năm 1897
  • Nhiệm kỳ tổng thống của Franklin Roosevelt từ năm 1933 đến năm 1945

Phần tử ExternalIdentifiers của Office cho phép bạn cung cấp thêm thông tin có các giá trị cụ thể cho OtherType. Để biết thêm thông tin chi tiết, hãy xem phần Các loại bổ sung cho ExternalIdentifiers.
GovernmentBodyIds 0 hoặc 1 IDREFS Cung cấp objectId của GovernmentBody mà văn phòng này trực thuộc. 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. 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 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ụ:

  • Thành viên Quốc hội Singapore
  • Thủ tướng Ấn Độ
  • Tổng thống Indonesia
  • Thượng nghị sĩ Hoa Kỳ
JurisdictionId 0 hoặc 1 IDREF

Cung cấp objectId của GpUnit chỉ định thẩm quyền của văn phòng.
Level 0 hoặc 1 OfficeLevel

Loại được liệt kê của cấp văn phòng. Hãy 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ò trong văn phòng, chẳng hạn như cabinet member hoặc president. Hãy xem tài liệu tham khảo để biết tất cả các lựa chọn có thể có.
OfficeHolderPersonIds 1 IDREFS

Cung cấp objectId của Person nắm giữ chức vụ này.
SeatStatus 0 hoặc 1 SeatStatus Loại được liệt kê của SeatStatus của người nắm 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 trở lên OfficeSelectionMethod Thông tin về cách người đương nhiệm được chọn hoặc bổ nhiệm vào chức vụ.
Term 1 Term Cung cấp thông tin liên quan đến thuật ngữ văn phòng.

Các loại giá trị nhận dạng bên ngoài khác

Trong phần tử ExternalIdentifiers của Office, hãy cung cấp dữ liệu bổ sung bằng 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 những phần tử này:

OtherType Giá trị mẫu Mô tả
jurisdiction-id gpu1

objectId của GpUnit chỉ định quyền tài phán của văn phòng.
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 phù hợp, 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ị trong OfficeRole. Nếu không có trường hợp nào phù hợp, hãy liên hệ với người liên hệ tại Google.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Sử dụng thông tin 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 có phạm vi rộng và chưa hết hạn.

Ví dụ

XML

    <Office objectId="off-0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <JurisdictionId>ru-gpu0</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <Role>upper house</Role>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>