สำนักงาน

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

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

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

แอตทริบิวต์

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

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

องค์ประกอบ

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

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

ระบุ objectId ของ GpUnit ที่ระบุรัฐที่รับสำหรับสำนักงานทางการทูต
DiplomatSendingStateId 0 หรือ 1 IDREF

ระบุ objectId ของ GpUnit ที่ระบุรัฐที่ส่งสำหรับสำนักงานทางการทูต
ElectoralDistrictId 0 หรือ 1 IDREF

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

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

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

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

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

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

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

  • การดำรงตำแหน่งประธานาธิบดีของโกรเวอร์ คลีฟแลนด์ ตั้งแต่ปี 1885 ถึง 1889
  • การดำรงตำแหน่งประธานาธิบดีของโกรเวอร์ คลีฟแลนด์ ตั้งแต่ปี 1893 ถึง 1897
  • การดำรงตำแหน่งประธานาธิบดีของแฟรงกลิน รูสเวลต์ ตั้งแต่ปี 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 ประเภทที่แจกแจงของสถานะที่นั่งของผู้ดำรงตำแหน่ง เช่น active หรือ on-leave ค่าเริ่มต้นคือ active หากไม่ได้ระบุ SeatStatus
SelectionMethod 0 รายการขึ้นไป OfficeSelectionMethod ข้อมูลเกี่ยวกับวิธีเลือกหรือแต่งตั้งผู้ดำรงตำแหน่ง
Term 1 Term ระบุข้อมูลที่เกี่ยวข้องกับวาระการดำรงตำแหน่ง

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

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

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

objectId ของ GpUnit ที่ระบุ เขตอำนาจศาลของสำนักงาน
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="off-0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-0</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>