사무실

Office를 사용하여 사무실과 사무실의 선거와 관련된 정보를 정의합니다. 사무실은 선거구와 사무실 역할로 식별됩니다.

Office 요소는 모든 피드 유형에 적용되지만 국민투표에는 지정할 필요가 없습니다.

다음 피드 유형 중 하나를 선택하여 해당 피드 유형과 함께 Office를 사용하는 방법을 자세히 알아보세요.

속성

다음 표에서는 Office의 속성을 설명합니다.

속성 필수 여부 유형 설명
objectId 필수 ID 다른 요소에서 이 요소를 참조하는 데 사용되는 고유한 내부 식별자입니다.

요소

다음 표에서는 Office의 요소를 설명합니다.

요소 다중성 유형 설명
ContactInformation 0개 이상 ContactInformation 다양한 연락처 정보를 사무실과 연결합니다. 이 요소가 포함된 경우 후보자 또는 현직 공직자가 아닌 사무실 자체와 관련된 정보만 지정하세요.
DiplomatReceivingStateId 0 또는 1 IDREF

외교 사무실의 수신 상태를 지정하는 GpUnit 의 objectId를 제공합니다.
DiplomatSendingStateId 0 또는 1 IDREF

외교 사무실의 발신 상태를 지정하는 GpUnit 의 objectId를 제공합니다.
ElectoralDistrictId 0 또는 1 IDREF

선거구를 나타내는 GpUnit의 objectId를 제공합니다. 예를 들어 미국 상원의원의 경우 "알래스카"와 같은 주를, 미국 하원의원의 경우 "뉴욕 14번째 하원 선거구"와 같은 선거구를 제공합니다.

공직자 피드의 경우 좌석당 하나의 Office와 해당 공직자를 선출한 선거구로 설정된 ElectoralDistrictId가 필요합니다.

예: 타이완 입법 선거

  • 입법원의 각 구성원에게 선거구에 따라 다른 Office를 제공합니다.

다른 예: 미국 상원 공직자 피드

  • 미국 상원에 100개의 Office 객체를 제공합니다.
ExternalIdentifiers 1 ExternalIdentifiers

ID를 사무실과 연결합니다. 안정적인 식별자가 필요합니다. 사무실의 안정적인 식별자는 공직 기간에 걸쳐 고유해야 합니다. 예를 들어 다음 각 공직 기간에는 고유한 사무실 안정적인 식별자가 필요합니다.

  • 1885~1889년 그로버 클리블랜드 대통령의 재임 기간
  • 1893~1897년 그로버 클리블랜드 대통령의 재임 기간
  • 1933~1945년 프랭클린 루즈벨트 대통령의 재임 기간

Office 의 ExternalIdentifiers 요소를 사용하면 OtherType의 특정 값으로 추가 정보를 제공할 수 있습니다. 자세한 내용은 추가 유형을 참고하세요ExternalIdentifiers.
GovernmentBodyIds 0 또는 1 IDREFS 이 사무실이 속한 GovernmentBody의 objectId를 제공합니다. 예를 들어 미국 상원의원의 경우 미국 상원입니다.
Name 1 InternationalizedText 이 사무실의 일반적인 직책의 전체 이름을 제공합니다. 여기에는 사무실의 관할권이 포함되어야 하지만 선거구와 관련된 정보는 제외해야 합니다.

예:

  • 싱가포르 국회의원
  • 인도 총리
  • 인도네시아 대통령
  • 미국 상원의원
JurisdictionId 0 또는 1 IDREF

사무실의 관할권을 지정하는 GpUnit 의 objectId를 제공합니다.
Level 0 또는 1 OfficeLevel

사무실 수준의 열거된 유형입니다. 옵션의 전체 목록은 참조를 확인하세요.
Role 0개 이상 OfficeRole 사무실 역할의 열거된 유형입니다(예: cabinet member 또는 president). 가능한 모든 옵션은 참조를 확인하세요.
OfficeHolderPersonIds 1 IDREFS

이 사무실을 맡고 있는 Person 의 objectId를 제공합니다.
SeatStatus 0 또는 1 SeatStatus 공직자의 SeatStatus의 열거된 유형입니다(예: active 또는 on-leave). SeatStatus가 지정되지 않은 경우 기본값은 active입니다. Office 의
SelectionMethod 0개 이상 OfficeSelectionMethod 공직자가 선출되거나 공직에 임명되는 방법에 관한 정보입니다.
Term 1 Term 공직 기간 관련 정보를 제공합니다.

ExternalIdentifiers의 추가 유형

Office의 ExternalIdentifiers 요소에서 OtherType 및 Value의 값과 함께 Type이 other인 추가 데이터를 제공합니다. 다음 표에는 이러한 요소의 가능한 값이 나와 있습니다.

OtherType 예시 값 설명
jurisdiction-id gpu1

사무실의 관할권을 지정하는 GpUnit의 objectId입니다.
legislative-session 116th United States Congress
office-level Country `OfficeLevel`의 값이어야 합니다. OfficeLevel. 해당하는 값이 없으면 Google 담당자에게 문의하세요.
office-role upper house

OfficeRole의 값이어야 합니다. 해당하는 값이 없으면 Google 담당자에게 문의하세요.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

이를 사용하여 좌석 또는 직책이 여러 개인 사무실과 비례대표 및 임기가 만료되지 않은 사무실을 구분합니다.

예

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>