사무실

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

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

예:

  • 싱가포르 국회의원
  • 인도 총리
  • 인도네시아 대통령
  • 미국 상원의원
SelectionMethod 0 또는 1 OfficeSelectionMethod 공무원이 선출되거나 취임하는 방법에 관한 정보입니다.
Term 0 또는 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="off9999a">
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off9999a</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru0002</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>president</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FilingDeadline>2013-01-01</FilingDeadline>
      <IsPartisan>true</IsPartisan>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off9999a",
        "ElectoralDistrictId": "ru0002",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off9999a"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru0002"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "president"
            }
          ]
        }
        "FilingDeadline": "2013-01-01"
        "IsPartisan": true,
        "Name": {
          "Text": [
            {
              "value": "President",
              "language": "en"
            }
          ]
        },
        "Term": {
          "Type": "full-term"
        }
      },
    ]