استخدِم 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 |
تعرض هذه السمة الاسم الكامل للعنوان العام لهذا المكتب. يجب أن يتضمّن هذا المستند نطاق سلطة المكتب، ولكن يجب ألا يتضمّن أي معلومات ذات صلة بالدائرة الانتخابية.
أمثلة:
|
JurisdictionId |
0 أو 1 | IDREF |
يُرجى تقديم |
Level |
0 أو 1 | OfficeLevel |
تمثّل هذه السمة النوع المُعدّد لمستوى المكتب. راجِع المَرجع للاطّلاع على القائمة الكاملة بالخيارات. |
Role |
0 أو أكثر | OfficeRole |
تمثّل هذه السمة النوع المُعدَّد لدور المكتب، مثل
cabinet member أو president. اطّلِع على المرجع لمعرفة جميع الخيارات المتاحة. |
OfficeHolderPersonIds |
1 | IDREFS |
يُرجى تقديم |
SeatStatus |
0 أو 1 | SeatStatus |
تمثّل هذه السمة النوع المُعدَّد لحالة المقعد الذي يشغله صاحب المنصب، مثل
active أو on-leave. القيمة التلقائية هي
active إذا لم يتم تحديد SeatStatus.
تم إيقاف
|
SelectionMethod |
0 أو أكثر | 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"> <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>