사무실

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

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

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

속성

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

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

요소

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

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

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

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

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

선거 전 데이터 피드의 경우 동일한 office-role에 대해 단일 Office 항목을 제공합니다. ElectoralDistrict 을(를) 선거의 최상위 지리적 수준을 나타내는 최상위 항목으로 설정합니다.

예: 타이완 입법 선거

  • 후보자가 다른 선거구에서 선출되더라도 모두 단일 Office 값인 "입법원 구성원"으로 설정합니다. 최상위 ElectoralDistrict ru-country-tw을(를) 사용합니다.
ExternalIdentifiers 1 ExternalIdentifiers

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

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

Office 의 ExternalIdentifiers 요소를 사용하면 OtherType의 특정 값으로 추가 정보를 제공할 수 있습니다. 자세한 내용은 추가 유형을 참고하세요ExternalIdentifiers.
FilingDeadline 0 또는 1 PartialDate 후보자가 공직 선거에 출마하기 위해 등록해야 하는 날짜입니다.
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). 가능한 모든 옵션은 참조를 확인하세요.
SelectionMethod 0개 이상 OfficeSelectionMethod 공직자가 선출되거나 공직에 임명되는 방법에 관한 정보입니다.
Term 0 또는 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-9999a">
      <ElectoralDistrictId>ru-0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-9999a</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <IsPartisan>true</IsPartisan>
      <JurisdictionId>ru-0002</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Role>president</Role>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>