Эта страница переведена с помощью Cloud Translation API.

Офис

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

Элемент Office применяется ко всем типам каналов, но его не обязательно указывать для референдумов. Однако определение офиса интерпретируется по-разному в зависимости от типа канала. В контексте выборов Office представляет собой название искомой должности, например «Член Палаты представителей». В контексте должностного лица это особое место для одного человека.

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

Если человек одновременно занимает более одной постоянной должности, обязательно предоставьте информацию об этих нескольких должностях. Например, если кто-то является одновременно канцлером Германии и членом Бундестага, его необходимо определить в обоих офисах.

Когда какое-либо лицо назначается должностным лицом нового округа или новой должности, свяжите этого человека с новым офисом. Не используйте повторно устаревший офис.

Атрибуты

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

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

Элементы

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

Элемент	Множественность	Тип	Описание
`ContactInformation`	0 или более	`ContactInformation`	Связывает различную контактную информацию с офисом. Если этот элемент включен, указывайте только информацию, относящуюся к самой должности, а не к кандидату или текущему должностному лицу.
`ElectoralDistrictId`	0 или 1	`IDREF`	Укажите `objectId` объекта `GpUnit` , который представляет избирательный округ. Например, укажите штат, например «Аляска», для сенатора США или округ, например «14-й избирательный округ Нью-Йорка», для представителя США. Примечание. Требуется `ElectoralDistrictId` . Для назначенных должностных лиц установите значение, равное идентификатору юрисдикции. Для канала должностных лиц мы ожидаем, что на одно место будет по одному `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`	Указывает полное название общего названия этого офиса. Сюда должна быть включена юрисдикция офиса, но исключена любая информация, относящаяся к избирательному округу. Примеры: Член парламента Сингапура Премьер-министр Индии Президент Индонезии Сенатор США
`OfficeHolderPersonIds`	1	`IDREFS`	Укажите `objectId` `Person` , занимающего эту должность.
`SeatStatus`	0 или 1	`SeatStatus`	Перечисляемый тип SeatStatus должностного лица, например `active` или `on-leave` . Значение по умолчанию `active` , если SeatStatus не указан.
`SelectionMethod`	0 или 1	`OfficeSelectionMethod`	Информация о том, как должностное лицо избирается или вводится в должность.
`Term`	1	`Term`	Предоставляет информацию о сроке службы.

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

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

`OtherType`	Примеры значений	Описание
`jurisdiction-id`	`gpu1`	Необходимый `objectId` `GpUnit` , указывающий юрисдикцию офиса.
`government-body`	`United States Senate`	См. `GovernmentBody` . Внешний идентификатор `government-body` устарел. Вместо этого используйте атрибут `GovernmentBodyIds` .
`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`	Используйте это, чтобы дифференцировать офисы с несколькими местами или должностями, а также для расширенных офисов и офисов с неистекшим сроком действия. Примечание: Если `ElectoralDistrict` уникален для выборов, не указывайте `office-seat` . Добавьте `office-seat` для любых должностей в том же органе, избираемых от одного и того же `ElectoralDistrict` . Для внеочередных выборов, таких как дополнительные выборы, `office-seat` должно быть иным, чем на всеобщих выборах. Если места нет, установите значение `special` . Если место уже есть, добавьте в конец `office-seat` `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"
        }
      }
    ]