Офис

Используйте Office, чтобы определить должность и информацию, связанную с выборами на эту должность. Должность определяется избирательным округом и ролью.

Элемент Office применяется ко всем типам фидов, но его не нужно указывать для референдумов.

Выберите один из типов фидов, чтобы узнать, как использовать Office с этим типом фида.

Атрибуты

В таблице ниже описаны атрибуты для Office:

Атрибут Обязательно? Тип Описание
objectId Обязательно ID Уникальный внутренний идентификатор, который используется другими элементами для ссылки на этот элемент.

Элементы

В таблице ниже описаны элементы для Office.

Элемент Множество Тип Описание
ContactInformation 0 или более ContactInformation Связывает с офисом различную контактную информацию. Если вы используете этот элемент, указывайте только информацию, которая относится к самой должности, а не к кандидату или текущему должностному лицу.
DiplomatReceivingStateId 0 или 1 IDREF

Укажите objectId GpUnit, в котором указано государство пребывания дипломатического представительства.
DiplomatSendingStateId 0 или 1 IDREF

Укажите objectId объекта GpUnit, который определяет статус отправки для дипломатического представительства.
ElectoralDistrictId 0 или 1 IDREF

Укажите objectId GpUnit, представляющего избирательный округ. Например, для сенатора США укажите штат, например "Аляска", а для члена Палаты представителей США – округ, например "14-й избирательный округ штата Нью-Йорк".

В фиде должностных лиц для каждого места ожидается один элемент Office, а в элементе ElectoralDistrictId должен быть указан округ, в котором было избрано это должностное лицо.

Пример: выборы в законодательные органы Тайваня.

  • Назначьте каждому члену Законодательного Юаня разные значки Office в зависимости от округа.

Другой пример: фид должностных лиц Сената США

  • Предоставьте 100 объектов Office для Сената США.
ExternalIdentifiers 1 ExternalIdentifiers

Связывает идентификатор с офисом. Требуется стабильный идентификатор. Постоянные идентификаторы офисов должны быть уникальными для каждого срока полномочий. Например, для каждого из следующих сроков владения требуется отдельный постоянный идентификатор офиса:

  • Президентство Гровера Кливленда с 1885 по 1889 год
  • Президентство Гровера Кливленда с 1893 по 1897 год
  • Президентство Франклина Рузвельта с 1933 по 1945 год

Элемент ExternalIdentifiers в Office позволяет указать дополнительные сведения с определенными значениями для OtherType. Подробную информацию вы найдете в разделе Дополнительные типы для ExternalIdentifiers.
GovernmentBodyIds 0 или 1 IDREFS Укажите objectId GovernmentBody, к которой относится этот офис. например "Сенат США" для сенатора США.
Name 1 InternationalizedText Полное название должности. В этом поле должна быть указана юрисдикция, но не должно быть информации об избирательном округе.

Примеры:

  • Член парламента Сингапура
  • Премьер-министр Индии
  • Президент Индонезии
  • Сенатор США
JurisdictionId 0 или 1 IDREF

Укажите objectId объекта GpUnit, который определяет юрисдикцию офиса.
Level 0 или 1 OfficeLevel

Перечисляемый тип уровня офиса. Полный список вариантов приведен в справочной статье.
Role 0 или более OfficeRole Перечисляемый тип роли офиса, например cabinet member или president. Все возможные варианты перечислены в справочнике.
OfficeHolderPersonIds 1 IDREFS

Укажите objectId Person, которая занимает эту должность.
SeatStatus 0 или 1 SeatStatus Перечисляемый тип SeatStatus должностного лица, например active или on-leave. Если значение SeatStatus не указано, по умолчанию используется active.
SelectionMethod 0 или более OfficeSelectionMethod Информация о том, как выбирается или назначается должностное лицо.
Term 1 Term Предоставляет информацию о сроке полномочий.

Дополнительные типы для ExternalIdentifiers

В элементе ExternalIdentifiers объекта Office укажите дополнительные данные с помощью свойства Type со значением other, а также значения свойств OtherType и Value. В таблице ниже приведены возможные значения этих элементов.

OtherType Примеры значений Описание
jurisdiction-id gpu1

objectId объекта GpUnit, который определяет юрисдикцию офиса.
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="off-0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-0</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>