از 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
of 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" } }, ]