Офис

Используйте 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 Перечисляемый тип статуса должности должностного лица, например active или on-leave . Значение по умолчанию — active , если статус должности не указан.
SelectionMethod 0 или больше OfficeSelectionMethod Информация о порядке избрания и назначения на должность должностного лица.
Term1 Term Предоставляет информацию, связанную с офисными терминами.

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

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

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

objectId объекта GpUnit , который определяет юрисдикцию офиса.

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">
      <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>