استخدِم Office لتحديد مكتب والمعلومات المرتبطة بالمسابقة. يتم تحديد المكتب من خلال الدائرة الانتخابية ودور المكتب.
ينطبق العنصر Office على جميع أنواع الخلاصات، ولكن ليس من الضروري تحديده في الاستفتاءات.
اختَر أحد أنواع الخلاصات التالية لمعرفة المزيد حول كيفية استخدام Office
مع هذا النوع من الخلاصات.
السمات
يوضّح الجدول التالي سمات النوع Office:
| السمة | مطلوب؟ | النوع | الوصف |
|---|---|---|---|
objectId |
مطلوب | ID |
معرّف داخلي فريد تستخدمه عناصر أخرى للإشارة إلى هذا العنصر. |
العناصر
يوضّح الجدول التالي عناصر Office:
| العنصر | التعددية | النوع | الوصف |
|---|---|---|---|
ContactInformation |
0 أو أكثر | ContactInformation |
ربط معلومات الاتصال المختلفة بالمكتب في حال تضمين هذا العنصر، يجب تحديد المعلومات ذات الصلة بالمنصب نفسه فقط، وليس بالمرشّح أو صاحب المنصب الحالي. |
ElectoralDistrictId |
1 | IDREF |
يجب تقديم |
ExternalIdentifiers |
1 | ExternalIdentifiers |
يربط هذا الحقل رقم تعريف بالمكتب. يجب توفير معرّف ثابت. يجب أن تكون المعرّفات الثابتة للمكاتب فريدة على مستوى فترات شغل المكاتب. على سبيل المثال، يحتاج كل من المناصب التالية إلى معرّف ثابت ومميّز:
يتيح لك العنصر |
FilingDeadline |
0 أو 1 | PartialDate |
التاريخ الذي يجب أن يقدّم فيه المرشّح طلبًا للمنافسة على المنصب
تم إيقاف FilingDeadline نهائيًا لعناصر Office. استخدِم السمة في Contest
بدلاً من ذلك. |
GovernmentBodyIds |
0 أو 1 | IDREFS |
يُرجى تقديم objectId GovernmentBody الذي يقع فيه هذا المكتب. على سبيل المثال، "مجلس الشيوخ الأمريكي" لسيناتور أمريكي |
Name |
1 | InternationalizedText |
تعرض هذه السمة الاسم الكامل للعنوان العام لهذا المكتب. يجب أن يتضمّن هذا المستند نطاق سلطة المكتب، ولكن يجب ألا يتضمّن أي معلومات ذات صلة بالدائرة الانتخابية.
أمثلة:
|
JurisdictionId |
0 أو 1 | IDREF |
يُرجى تقديم |
Level |
0 أو 1 | OfficeLevel |
تمثّل هذه السمة النوع المُعدّد لمستوى المكتب. راجِع المَرجع للاطّلاع على القائمة الكاملة بالخيارات. |
Role |
0 أو أكثر | OfficeRole |
تمثّل هذه السمة النوع المُعدَّد لدور المكتب، مثل
cabinet member أو president. اطّلِع على المرجع لمعرفة جميع الخيارات المتاحة. |
SelectionMethod |
0 أو أكثر | OfficeSelectionMethod |
معلومات عن كيفية اختيار صاحب المنصب أو تولّيه المنصب |
Term |
0 أو 1 | Term |
توفّر هذه السمة معلومات ذات صلة بالمدة التي شغل فيها الشخص منصبه.
Term نهائيًا
بالنسبة إلى Office. يمكنك تقديم هذه المعلومات باستخدام العنصر OfficeHolderTenure بدلاً من ذلك. |
أنواع إضافية لـ ExternalIdentifiers
في العنصر ExternalIdentifiers من Office، قدِّم بيانات إضافية مع Type بقيمة other، بالإضافة إلى قيمتَي OtherType وValue. يوضّح الجدول التالي القيم المحتملة لهذه العناصر:
OtherType |
أمثلة على القيم | الوصف |
|---|---|---|
jurisdiction-id |
gpu1 |
تمثّل jurisdiction-id نهائيًا. استخدِم السمة JurisdictionId بدلاً من ذلك |
government-body |
United States Senate |
يمكنك الاطّلاع على GovernmentBody.
government-body نهائيًا. استخدِم السمة GovernmentBodyIds بدلاً من ذلك |
legislative-session |
116th United States Congress |
|
office-level |
Country |
يجب أن تكون القيمة من
OfficeLevel.
إذا لم تنطبق أيّ من هذه الحالات، يُرجى التواصل مع جهة اتصال Google.
office-level نهائيًا. استخدِم السمة OfficeLevel بدلاً من ذلك |
office-role |
upper house |
يجب أن تكون القيمة من
office-role نهائيًا. استخدِم السمة OfficeRole بدلاً من ذلك |
office-seat |
Position 1، Seat 2،
unexpired، special،
Seat 2 special |
استخدِم هذه السمة للتمييز بين المكاتب التي تضم مقاعد أو مناصب متعددة، وكذلك للمكاتب التي لا تتبع أي منطقة جغرافية والمكاتب التي لم تنتهِ مدتها. office-seat نهائيًا.
يُرجى تقديم هذه المعلومات باستخدام السمة Seat ضمن
Contest بدلاً من ذلك.
ملاحظة:
|
أمثلة
XML
<Office objectId="off9999a"> <ElectoralDistrictId>ru0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>stable-off9999a</Value> </ExternalIdentifier> </ExternalIdentifiers> <IsPartisan>true</IsPartisan> <JurisdictionId>ru0002</JurisdictionId> <Level>Administrative Area 1</Level> <Name> <Text language="en">President</Text> </Name> <Role>president</Role> <Term> <Type>full-term</Type> </Term> </Office>