사무실

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

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

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

속성

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

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

요소

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

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

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

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

예: 타이완 입법원 선거

  • 후보자가 서로 다른 지역에서 당선되더라도 모두 단일 Office 값인 '입법원 의원'으로 설정합니다. ru-country-tw의 상위 수준 ElectoralDistrict를 사용합니다.
ExternalIdentifiers 1 ExternalIdentifiers

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

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

Office의 ExternalIdentifiers 요소를 사용하면 OtherType의 특정 값과 함께 추가 정보를 제공할 수 있습니다. 자세한 내용은 ExternalIdentifiers의 추가 유형을 참고하세요.
FilingDeadline 0 또는 1 PartialDate 후보자가 공직 선거에 출마해야 하는 날짜입니다.
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). 가능한 모든 옵션은 참조를 확인하세요.
SelectionMethod 0개 이상 OfficeSelectionMethod 공무원이 선출되거나 임명되는 방식에 관한 정보입니다.
Term 0 또는 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="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>