สำนักงาน

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

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

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

Attributes

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

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

องค์ประกอบ

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

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

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

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

สำหรับฟีดผู้ดำรงตำแหน่ง เราคาดหวังว่าจะมี Office ต่อที่นั่ง และตั้งค่า ElectoralDistrictId เป็นเขตที่ เลือกบุคคลนั้นให้ดำรงตำแหน่ง

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

  • มอบOfficeที่แตกต่างกันให้แก่สมาชิกแต่ละคนของสภานิติบัญญัติ โดยอิงตามเขตของสมาชิก

อีกตัวอย่างหนึ่ง: ฟีดผู้ดำรงตำแหน่งในวุฒิสภาสหรัฐอเมริกา

  • ระบุออบเจ็กต์ 100 รายการสำหรับวุฒิสภาสหรัฐอเมริกาOffice
ExternalIdentifiers 1 ExternalIdentifiers

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

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

องค์ประกอบ ExternalIdentifiers ของ Office ช่วยให้คุณระบุข้อมูลเพิ่มเติมพร้อมค่าที่เฉพาะเจาะจงสำหรับ OtherType ได้ ดูรายละเอียดเพิ่มเติมได้ที่ ประเภทเพิ่มเติมสำหรับ ExternalIdentifiers
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 ดูตัวเลือกทั้งหมดที่เป็นไปได้ใน ข้อมูลอ้างอิง
OfficeHolderPersonIds 1 IDREFS

ระบุobjectIdของ Person ที่ตั้งสำนักงานนี้
SeatStatus 0 หรือ 1 SeatStatus ประเภทที่แจงนับของ SeatStatus ของผู้ดำรงตำแหน่ง เช่น active หรือ on-leave ค่าเริ่มต้นคือ active หากไม่ได้ระบุ SeatStatus
SelectionMethod 0 ขึ้นไป OfficeSelectionMethod ข้อมูลเกี่ยวกับวิธีเลือกหรือแต่งตั้งผู้ดำรงตำแหน่ง ให้ดำรงตำแหน่ง
Term 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="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>