OfficeHolderSubFeed 實體

選舉前、選舉或現任官員動態消息。

OfficeHolderSubFeed 實體會說明在職官員的屬性 Feed，並指定包含哪些地理區域和職位層級，以及實際內容何時會在 Feed 中提供。

元素

名稱 標記 類型 附註 多重性
偵錯名稱 DebugName string 這個在職官員動態饋給的描述性名稱。 0 或 1
預期辦公室範圍 OfficeScopeCollection OfficeScope OfficeScope 實體清單，指定這個 OfficeholderScope 中所有在職人員擔任的職位。 1
初始動態饋給傳送日期 InitialDeliveryDate PartialDate 合作夥伴預計何時傳送動態饋給的第一個草稿。 1
完整送達日期 FullDeliveryDate PartialDate 當交付完整的在職人員名單，但部分屬性尚未定案時。 0 或 1
預期在職人數 ExpectedOfficeholders Number 在職者人數 (不得為零)。概略估計即可。 如果不知道確切數字，或對估計值信心不足，這個實體可以留空。 0 或 1

範例

以下範例是包含 OfficeHolderSubFeed 和 OfficeScope 的 Feed。這表示 Feed 將於 2024 年 1 月交付，並包含澳洲的國家和州級官員：

XML

<OfficeHolderSubFeed>
  <DebugName>AU national and state level officeholders</DebugName>
  <OfficeScopeCollection>
    <OfficeScope>
      <DebugName>National level OH</DebugName>
      <OfficeLevel>Country</OfficeLevel>
      <JurisdictionOcdId>ocd-division/country:au</JurisdictionOcdId>
      <OfficeRoles>lower house</OfficeRoles>
      <OfficeRoles>upper house</OfficeRoles>
    </OfficeScope>
    <OfficeScope>
      <DebugName>South Austria OH</DebugName>
      <OfficeLevel>Administrative Area 1</OfficeLevel>
      <JurisdictionOcdId>ocd-division/country:au/state:sa</JurisdictionOcdId>
      <OfficeRoles>state lower house</OfficeRoles>
    </OfficeScope>
    ...
  </OfficeScopeCollection>
  <InitialDeliveryDate>2024-01</InitialDeliveryDate>
</OfficeHolderSubFeed>

JSON

{
  "OfficeHolderSubFeed": {
      "DebugName": "US national level officholders",
      "OfficeScopeCollection": {
        "OfficeScope": [
          {
            "DebugName": "National level OH",
            "OfficeLevel": "Country",
            "JurisdictionOcdId": "ocd-division/country:au",
            "OfficeRoles": [
                "lower house",
                "upper house"
            ]
          },
          {
            "DebugName": "South Austria OH",
            "OfficeLevel": "Administrative Area 1",
            "JurisdictionOcdId": "ocd-division/country:au/state:sa",
            "OfficeRoles": [
                "state lower house"
            ]
          }
          ...
        ]
      }
      "InitialDeliveryDate": "2024-01"
  }
}