استخدِم Office
لتحديد مكتب ومعلومات مرتبطة بمسابقة هذا المكتب. يتم تحديد
المنصب من خلال دائرته الانتخابية ودوره.
ينطبق العنصر Office
على جميع أنواع الخلاصات، ولكن لا يلزم تحديده
لاستفتاءات. ومع ذلك، يتم تفسير تعريف المكتب بشكلٍ مختلف
استنادًا إلى نوع الخلاصة. في سياق الانتخابات، يمثّل الرمز Office
عنوان
المنصب المطلوب، مثل "عضو في مجلس النواب".
في سياق حاملي المناصب، يشير ذلك إلى مقعد محدّد لشخص واحد.
اختَر أحد أنواع الخلاصات التالية لمعرفة المزيد من المعلومات عن كيفية استخدام Office
مع هذا النوع من الخلاصات.
إذا كان الشخص يشغل أكثر من منصب حالي واحد في الوقت نفسه، احرص على تقديم معلومات عن هذه المناصب المتعددة. على سبيل المثال، إذا كان أحد الأشخاص هو مستشار ألمانيا وعضو في البوندستاغ، يجب تحديده في كلا المنصبين.
عندما يتم تعيين شخص كحامل لمنصب في دائرة انتخابية جديدة أو في منصّة جديدة، اربط هذا الشخص بالمنصب الجديد. احرص على عدم إعادة استخدام مكتب قديم.
السمات
يوضّح الجدول التالي سمات Office
:
السمة | مطلوب؟ | النوع | الوصف |
---|---|---|---|
objectId |
مطلوب | ID |
معرّف داخلي فريد يستخدمه العناصر الأخرى للإشارة إلى هذا العنصر. |
العناصر
يصف الجدول التالي عناصر Office
:
العنصر | التعددية | النوع | الوصف |
---|---|---|---|
ContactInformation |
0 أو أكثر | ContactInformation |
ربط معلومات الاتصال المختلفة بالمكتب في حال تضمين هذا العنصر، حدِّد فقط المعلومات ذات الصلة بالمنصب نفسه، وليس المرشّح أو صاحب المنصب الحالي. |
ElectoralDistrictId |
0 أو 1 | IDREF |
أدخِل بالنسبة إلى خلاصة شاغلي المناصب، نتوقع أن يكون هناك مثال: الانتخابات التشريعية في تايوان
مثال آخر: خلاصة موظفي مجلس الشيوخ الأمريكي
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
ربط رقم تعريف بالمكتب يجب إدخال معرّف ثابت. يجب أن تكون المعرّفات الثابتة للمكاتب فريدة على مستوى مدّة تولّي كل مكتب. على سبيل المثال، تحتاج كل فترة من الفترات التالية إلى معرّف ثابت ومميّز لمكتبها:
يتيح لك عنصر |
GovernmentBodyIds |
0 أو 1 | IDREFS |
أدخِل objectId GovernmentBody الذي ينتمي إليه هذا المكتب. على سبيل المثال، مجلس الشيوخ الأمريكي لعضو في مجلس الشيوخ الأمريكي |
Name |
1 | InternationalizedText |
يوفّر الاسم الكامل للعنوان العام لهذا المكتب. يجب أن يشمل ذلك
نطاق السلطة المخوَّلة للمكتب، ولكن يجب استبعاد أي معلومات
ذات صلة بالدائرة الانتخابية.
أمثلة:
|
OfficeHolderPersonIds |
1 | IDREFS |
أدخِل |
SeatStatus |
0 أو 1 | SeatStatus |
النوع المُدرَج لسمة SeatStatus الخاصة بصاحب المنصب، مثل
active أو on-leave تكون القيمة التلقائية هي
active في حال عدم تحديد SeatStatus. |
SelectionMethod |
0 أو 1 | OfficeSelectionMethod |
معلومات عن كيفية اختيار صاحب المنصب أو تعيينه |
Term |
1 | Term |
يوفّر معلومات ذات صلة بفترة تولي المنصب. |
أنواع إضافية لمعرّفات ExternalIdentifiers
في عنصر 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="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" } } ]