사무실

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

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 이 부서의 일반 직함의 전체 이름을 제공합니다. 여기에는 관할권이 포함되어야 하지만 선거구와 관련된 정보는 제외해야 합니다.

예:

  • 싱가포르 국회의원
  • 인도 총리
  • 인도네시아 대통령
  • 미국 상원의원
OfficeHolderPersonIds 1 IDREFS

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

ExternalIdentifiers의 추가 유형

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

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">
      <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>upper house</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru-gpu0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <OfficeHolderPersonIds>per0</OfficeHolderPersonIds>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off0",
        "ElectoralDistrictId": "ru-gpu0",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off0"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "upper house"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru-gpu0"
            }
          ]
        }
        "GovernmentBodyIds": ["gb-1]
        "Name": {
          "Text": [
            {
              "value": "United States Senator",
              "language": "en"
            }
          ]
        }
        "OfficeHolderPersonIds": "per0"
        "SelectionMethod": "directly-elected"
        "Term": {
          "StartDate": "2019-01-02"
        }
      }
    ]