Офис

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

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

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

Атрибуты

В следующей таблице описаны характеристики Office :

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

Элементы

В следующей таблице описаны элементы Office :

Элемент Множественность Тип Описание
ContactInformation 0 или более ContactInformation Указывается, какая контактная информация связана с конкретным ведомством. Если этот элемент присутствует, следует указывать только информацию, относящуюся к самому ведомству, а не к кандидату или действующему должностному лицу.
ElectoralDistrictId0 или 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 . Значение по умолчанию — active , если параметр SeatStatus не указан.
SelectionMethod 0 или более OfficeSelectionMethod Информация о порядке избрания или назначения должностного лица на должность.
Term1 Term Предоставляет информацию, относящуюся к учебному семестру.

Дополнительные типы для внешних идентификаторов

В элементе 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="off0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</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>