사무실

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

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

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

속성

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

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

요소

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

요소 다중성 유형 설명
ContactInformation 0개 이상 ContactInformation 다양한 연락처 정보를 사무실과 연결합니다. 이 요소가 포함된 경우 후보자나 현직 공무원이 아닌 직책 자체와 관련된 정보만 지정하세요.
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을 입력합니다. 예를 들어 미국 상원의원의 경우 United States Senate
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입니다.
SelectionMethod 0개 이상 OfficeSelectionMethod 공무원이 선출되거나 임명되는 방식에 관한 정보입니다.
Term 1 Term 사무실 용어 관련 정보를 제공합니다.

ExternalIdentifier의 추가 유형

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

OtherType 예시 값 설명
jurisdiction-id gpu1

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

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

이 필드는 여러 의석 또는 직위가 있는 직책과 임기가 만료되지 않은 직책을 구분하는 데 사용됩니다.

예

XML

    <Office objectId="off0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</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>