Используйте Office
, чтобы определить офис и информацию, связанную с его конкуренцией. Офис определяется его избирательным округом и ролью офиса.
Элемент Office
применяется ко всем типам каналов, но его не обязательно указывать для референдумов. Однако определение офиса интерпретируется по-разному в зависимости от типа канала. В контексте выборов Office
представляет собой название искомой должности, например «Член Палаты представителей». В контексте должностного лица это особое место для одного человека.
Выберите один из следующих типов каналов, чтобы узнать больше о том, как использовать Office
с этим типом канала.
Атрибуты
В следующей таблице описаны атрибуты Office
:
Атрибут | Необходимый? | Тип | Описание |
---|---|---|---|
objectId | Необходимый | ID | Уникальный внутренний идентификатор, используемый другими элементами для ссылки на этот элемент. |
Элементы
В следующей таблице описаны элементы Office
:
Элемент | Множественность | Тип | Описание |
---|---|---|---|
ContactInformation | 0 или более | ContactInformation | Связывает различную контактную информацию с офисом. Если этот элемент включен, указывайте только информацию, относящуюся к самой должности, а не к кандидату или текущему должностному лицу. |
ElectoralDistrictId | 1 | IDREF | Укажите Дляпредвыборные данные фид, укажите одну сущность Пример: выборы в законодательные органы Тайваня.
|
ExternalIdentifiers | 1 | ExternalIdentifiers | Связывает идентификатор с офисом. Требуется стабильный идентификатор . Стабильные идентификаторы офисов должны быть уникальными в течение всего срока пребывания в должности. Например, для каждого из следующих сроков пребывания необходим отдельный идентификатор стабильного офиса:
Элемент |
FilingDeadline | 0 или 1 | PartialDate | Дата, до которой кандидат должен подать заявку на участие в конкурсе на эту должность. |
GovernmentBodyIds | 0 или 1 | IDREFS | Укажите objectId GovernmentBody , частью которого является этот офис. Например, Сенат США для сенатора США. |
Name | 1 | InternationalizedText | Указывает полное название общего названия этого офиса. Сюда должна быть включена юрисдикция офиса, но исключена любая информация, относящаяся к избирательному округу. Примеры:
|
SelectionMethod | 0 или 1 | OfficeSelectionMethod | Информация о том, как должностное лицо избирается или вводится в должность. |
Term | 0 или 1 | Term | Предоставляет информацию о сроке службы. |
Дополнительные типы для внешних идентификаторов
В элементе ExternalIdentifiers
Office
укажите дополнительные данные с Type
other
, а также значения для OtherType
и Value
. В следующей таблице показаны возможные значения этих элементов:
OtherType | Примеры значений | Описание |
---|---|---|
jurisdiction-id | gpu1 | Необходимый |
government-body | United States Senate | См. GovernmentBody . |
legislative-session | 116th United States Congress | |
office-level | Country | Должно быть значение из OfficeLevel . Если ничего не подходит, обратитесь к своему контакту в Google. |
office-role | upper house | Необходимый Должно быть значение из |
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" } }, ]