این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

دفتر

Office برای تعریف یک دفتر و اطلاعات مرتبط با رقابت آن استفاده کنید. یک دفتر با حوزه انتخابیه و نقش دفتری آن مشخص می‌شود.

عنصر Office برای همه انواع فید اعمال می‌شود، اما نیازی به مشخص کردن آن برای همه‌پرسی‌ها نیست.

برای کسب اطلاعات بیشتر در مورد نحوه استفاده Office با آن نوع فید، یکی از انواع فید زیر را انتخاب کنید.

ویژگی‌ها

جدول زیر ویژگی‌های Office را شرح می‌دهد:

ویژگی	الزامی است؟	نوع	توضیحات
`objectId`	مورد نیاز	`ID`	شناسه داخلی منحصر به فردی که توسط عناصر دیگر برای ارجاع به این عنصر استفاده می‌شود.

عناصر

جدول زیر عناصر مربوط به Office را شرح می‌دهد:

عنصر	چندگانگی	نوع	توضیحات
`ContactInformation`	۰ یا بیشتر	`ContactInformation`	اطلاعات تماس مختلف را با دفتر مرتبط می‌کند. اگر این عنصر گنجانده شده است، فقط اطلاعاتی را مشخص کنید که مربوط به خود دفتر باشد، نه نامزد یا صاحب فعلی دفتر.
`ElectoralDistrictId`	۱	`IDREF`	`objectId` مربوط به `GpUnit` که نشان دهنده حوزه انتخابیه است را وارد کنید. برای مثال، برای سناتور ایالات متحده، یک ایالت مانند "آلاسکا" یا برای نماینده ایالات متحده، یک حوزه انتخابیه مانند "حوزه انتخابیه چهاردهم نیویورک" وارد کنید. `ElectoralDistrictId` برای عناصر `Office` منسوخ شده است. برای فیدهای تاریخی که این مورد در آنها گنجانده شده است، راهنمایی زیر اعمال می‌شود. برایداده‌های پیش از انتخابات feed، یک موجودیت `Office` واحد برای همان `office-role` ارائه دهید. `ElectoralDistrict` را روی موجودیت سطح بالا که نشان دهنده بالاترین سطح جغرافیایی انتخابات است، تنظیم کنید. مثال: انتخابات مجلس قانونگذاری تایوان حتی اگر نامزدها در حوزه‌های انتخابیه مختلف انتخاب شوند، برای همه آنها یک مقدار `Office` واحد، "عضو مجلس قانونگذاری یوان" تنظیم کنید. از یک `ElectoralDistrict` سطح بالا به `ru-country-tw` استفاده کنید.
`ExternalIdentifiers`	۱	`ExternalIdentifiers`	یک شناسه را به دفتر مرتبط می‌کند. یک شناسه پایدار مورد نیاز است. شناسه‌های پایدار برای دفاتر باید در طول دوره‌های تصدی دفتر منحصر به فرد باشند. به عنوان مثال، هر یک از دوره‌های تصدی زیر به یک شناسه پایدار دفتر مجزا نیاز دارند: ریاست جمهوری گروور کلیولند از ۱۸۸۵ تا ۱۸۸۹ ریاست جمهوری گروور کلیولند از ۱۸۹۳ تا ۱۸۹۷ ریاست جمهوری فرانکلین روزولت از سال ۱۹۳۳ تا ۱۹۴۵ عنصر `ExternalIdentifiers` در `Office` به شما امکان می‌دهد اطلاعات بیشتری با مقادیر خاص برای `OtherType` ارائه دهید. برای جزئیات بیشتر، به بخش انواع اضافی برای `ExternalIdentifiers` مراجعه کنید.
`FilingDeadline`	۰ یا ۱	`PartialDate`	تاریخی که یک نامزد باید برای رقابت برای این سمت ثبت نام کند. `FilingDeadline` برای عناصر `Office` منسوخ شده است. به جای آن از این ویژگی در `Contest` استفاده کنید.
`GovernmentBodyIds`	۰ یا ۱	`IDREFS`	`objectId` `GovernmentBody` که این دفتر بخشی از آن است را ارائه دهید. به عنوان مثال، سنای ایالات متحده برای یک سناتور آمریکایی
`Name`	۱	`InternationalizedText`	نام کامل عنوان عمومی این دفتر را ارائه می‌دهد. این باید شامل حوزه قضایی دفتر باشد اما هرگونه اطلاعات مربوط به حوزه انتخاباتی را شامل نمی‌شود. مثال‌ها: نماینده پارلمان سنگاپور نخست وزیر هند رئیس جمهور اندونزی سناتور ایالات متحده
`JurisdictionId`	۰ یا ۱	`IDREF`	`objectId` مربوط به `GpUnit` را که حوزه قضایی دفتر را مشخص می‌کند، ارائه دهید.
`Level`	۰ یا ۱	`OfficeLevel`	نوع طبقه بندی شده دفتر. برای لیست کامل گزینه ها به مرجع مراجعه کنید.
`Role`	۰ یا بیشتر	`OfficeRole`	نوع نقش ذکر شده در دفتر، مانند `cabinet member` یا `president` . برای مشاهده همه گزینه‌های ممکن به مرجع مراجعه کنید.
`SelectionMethod`	۰ یا بیشتر	`OfficeSelectionMethod`	اطلاعات مربوط به نحوه انتخاب یا انتصاب صاحب منصب.
`Term`	۰ یا ۱	`Term`	اطلاعات مربوط به دوره تصدی را ارائه می‌دهد. عنصر `Term` برای `Office` منسوخ شده است. به جای آن، این اطلاعات را با استفاده از عنصر `OfficeHolderTenure` ارائه دهید.

انواع اضافی برای شناسه‌های خارجی

در عنصر ExternalIdentifiers از Office ، داده‌های اضافی با Type other به همراه مقادیر OtherType و Value ارائه دهید. جدول زیر مقادیر ممکن برای این عناصر را نشان می‌دهد:

`OtherType`	مقادیر مثال	توضیحات
`jurisdiction-id`	`gpu1`	`objectId` مربوط به `GpUnit` که حوزه قضایی دفتر را مشخص می‌کند. شناسه خارجی `jurisdiction-id` منسوخ شده است. به جای آن از ویژگی `JurisdictionId` استفاده کنید.
`government-body`	`United States Senate`	به `GovernmentBody` مراجعه کنید. شناسه خارجی `government-body` منسوخ شده است. به جای آن از ویژگی `GovernmentBodyIds` استفاده کنید.
`legislative-session`	`116th United States Congress`
`office-level`	`Country`	باید مقداری از `OfficeLevel` باشد. اگر هیچ کدام صدق نمی‌کند، با مخاطب گوگل خود تماس بگیرید. شناسه خارجی `office-level` منسوخ شده است. به جای آن از ویژگی `OfficeLevel` استفاده کنید.
`office-role`	`upper house`	باید مقداری از `OfficeRole` باشد. اگر هیچ کدام صدق نمی‌کرد، با مخاطب گوگل خود تماس بگیرید. شناسه خارجی `office-role` منسوخ شده است. به جای آن از ویژگی `OfficeRole` استفاده کنید.
`office-seat`	`Position 1` ، `Seat 2` ، `unexpired` ، `special` ، `Seat 2 special`	از این برای تمایز دفاتر با چندین کرسی یا سمت، و برای دفاتر عمومی و دفاتر منقضی نشده استفاده کنید. شناسه خارجی `office-seat` منسوخ شده است.این اطلاعات را با استفاده از ویژگی `Seat` در `Contest` ) ارائه دهید. توجه: اگر `ElectoralDistrict` مختص انتخابات است، `office-seat` مشخص نکنید. برای هر سمت اداری در همان نهاد که از همان `ElectoralDistrict` انتخاب می‌شوند، `office-seat` اضافه کنید. برای انتخابات ویژه، مانند انتخابات میان‌دوره‌ای، مقدار متغیر `office-seat` باید با مقدار آن برای انتخابات عمومی متفاوت باشد. اگر هیچ صندلی وجود ندارد، آن را روی `special` تنظیم کنید. اگر از قبل صندلی وجود دارد، به انتهای `office-seat` `special` اضافه کنید، مانند `Seat 2 special` .

مثال‌ها

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>