สำนักงาน

ใช้ Office เพื่อกำหนดสำนักงานและข้อมูลที่เชื่อมโยงกับการแข่งขัน โดย สำนักงานจะระบุตามเขตเลือกตั้งและบทบาทของสำนักงาน

องค์ประกอบ Office มีผลกับฟีดทุกประเภท แต่ไม่จำเป็นต้องระบุ สำหรับการลงประชามติ

เลือกประเภทฟีดต่อไปนี้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ Office กับฟีดประเภทนั้น

Attributes

ตารางต่อไปนี้อธิบายแอตทริบิวต์สำหรับ Office

แอตทริบิวต์ จำเป็นหรือไม่ ประเภท คำอธิบาย
objectId ต้องระบุ ID ตัวระบุภายในที่ไม่ซ้ำกันซึ่งองค์ประกอบอื่นๆ ใช้เพื่ออ้างอิงถึง องค์ประกอบนี้

องค์ประกอบ

ตารางต่อไปนี้จะอธิบายองค์ประกอบสำหรับ Office

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
ContactInformation 0 ขึ้นไป ContactInformation เชื่อมโยงข้อมูลติดต่อต่างๆ กับสำนักงาน หากรวมองค์ประกอบนี้ ให้ระบุเฉพาะข้อมูลที่เกี่ยวข้องกับตำแหน่งนั้นๆ ไม่ใช่ผู้สมัครรับเลือกตั้งหรือผู้ดำรงตำแหน่งปัจจุบัน
ElectoralDistrictId 1 IDREF

ระบุobjectIdของGpUnitที่ แสดงถึงเขตเลือกตั้ง เช่น ระบุรัฐ เช่น "อลาสก้า" สำหรับวุฒิสมาชิกสหรัฐอเมริกา หรือเขต เช่น "เขตเลือกตั้งที่ 14 ของนิวยอร์ก" สำหรับสมาชิกสภาผู้แทนราษฎรสหรัฐอเมริกา

เราเลิกใช้งาน

สำหรับฟีดข้อมูลก่อนการเลือกตั้ง ให้ระบุเอนทิตี Office เดียวสำหรับoffice-roleเดียวกัน ตั้งค่า ElectoralDistrict เป็นเอนทิตีระดับสูงที่แสดงถึงระดับภูมิศาสตร์สูงสุดของการ เลือกตั้ง

ตัวอย่าง: การเลือกตั้งสมาชิกสภานิติบัญญัติของไต้หวัน

  • แม้ว่าผู้สมัครรับเลือกตั้งจะได้รับเลือกในเขตเลือกตั้งที่ต่างกัน ให้ตั้งค่าทั้งหมดเป็นค่า Office เดียวกันคือ "สมาชิกสภานิติบัญญัติ" ใช้ElectoralDistrict ระดับสูงของ ru-country-tw
ExternalIdentifiers 1 ExternalIdentifiers

เชื่อมโยงรหัสกับสำนักงาน ต้องมีตัวระบุที่เสถียร ตัวระบุที่เสถียรสำหรับสำนักงานต้องไม่ซ้ำกันตลอดระยะเวลาการดำรงตำแหน่งของสำนักงาน เช่น ระยะเวลาการดำรงตำแหน่งแต่ละรายการต่อไปนี้ต้องมีตัวระบุที่เสถียรของสำนักงานที่แตกต่างกัน

  • การดำรงตำแหน่งประธานาธิบดีของโกรเวอร์ คลีฟแลนด์ตั้งแต่ปี 1885 ถึง 1889
  • การดำรงตำแหน่งประธานาธิบดีของ Grover Cleveland ตั้งแต่ปี 1893 ถึง 1897
  • การดำรงตำแหน่งประธานาธิบดีของ Franklin Roosevelt ตั้งแต่ปี 1933 ถึง 1945

องค์ประกอบ ExternalIdentifiers ของ Office ช่วยให้คุณระบุข้อมูลเพิ่มเติมพร้อมค่าที่เฉพาะเจาะจงสำหรับ OtherType ได้ ดูรายละเอียดเพิ่มเติมได้ที่ ประเภทเพิ่มเติมสำหรับ ExternalIdentifiers
FilingDeadline 0 หรือ 1 PartialDate วันที่ผู้สมัครต้องยื่นเอกสารเพื่อลงสมัครรับเลือกตั้งสำหรับตำแหน่ง ดังกล่าว
GovernmentBodyIds 0 หรือ 1 IDREFS ระบุ objectId ของ GovernmentBody ที่สำนักงานนี้เป็นส่วนหนึ่ง เช่น วุฒิสภาสหรัฐอเมริกาสำหรับวุฒิสมาชิกสหรัฐอเมริกา
Name 1 InternationalizedText ระบุชื่อเต็มของตำแหน่งทั่วไปของสำนักงานนี้ โดยต้อง ระบุเขตอำนาจศาลของสำนักงาน แต่ไม่รวมข้อมูลใดๆ ที่เกี่ยวข้องกับเขตเลือกตั้ง

ตัวอย่าง

  • สมาชิกสภาแห่งสิงคโปร์
  • นายกรัฐมนตรีของอินเดีย
  • ประธานาธิบดีอินโดนีเซีย
  • วุฒิสมาชิกสหรัฐอเมริกา
JurisdictionId 0 หรือ 1 IDREF

ระบุobjectIdของ GpUnit ที่ระบุเขตอำนาจศาลของสำนักงาน
Level 0 หรือ 1 OfficeLevel

ประเภทที่แจงนับของระดับสำนักงาน ดูรายการตัวเลือกทั้งหมดได้ที่ ข้อมูลอ้างอิง

Role 0 ขึ้นไป OfficeRole ประเภทที่แจงนับของบทบาทของสำนักงาน เช่น cabinet member หรือ president ดูตัวเลือกทั้งหมดที่เป็นไปได้ใน ข้อมูลอ้างอิง
SelectionMethod 0 ขึ้นไป OfficeSelectionMethod ข้อมูลเกี่ยวกับวิธีเลือกหรือแต่งตั้งผู้ดำรงตำแหน่ง ให้ดำรงตำแหน่ง
Term 0 หรือ 1 Term ให้ข้อมูลที่เกี่ยวข้องกับคำศัพท์ในสำนักงาน

ประเภทเพิ่มเติมสำหรับ ExternalIdentifiers

ในองค์ประกอบ ExternalIdentifiers ของ Office ให้ระบุข้อมูลเพิ่มเติมโดยมี Type เป็น other พร้อมค่าสำหรับ OtherType และ Value ตารางต่อไปนี้แสดงค่าที่เป็นไปได้สำหรับองค์ประกอบเหล่านี้

OtherType ค่าตัวอย่าง คำอธิบาย
jurisdiction-id gpu1

objectId ของ GpUnit ที่ระบุ เขตอำนาจศาลของสำนักงาน
government-body United States Senate ดู GovernmentBody
legislative-session 116th United States Congress
office-level Country ต้องเป็นค่าจาก OfficeLevel หากไม่มีข้อใดตรงกับกรณีของคุณ โปรดติดต่อตัวแทนของ Google
office-role upper house

ต้องเป็นค่าจาก OfficeRole หากไม่มีข้อใดตรงกับกรณีของคุณ โปรดติดต่อตัวแทนของ Google
office-seat Position 1, Seat 2, unexpired, 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>