สำนักงาน

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

องค์ประกอบ Office มีผลกับฟีดทุกประเภท แต่ไม่จำเป็นต้องระบุสำหรับการลงประชามติ อย่างไรก็ตาม คำจำกัดความของสำนักงานจะตีความแตกต่างกันไปโดยขึ้นอยู่กับประเภทฟีด ในบริบทการเลือกตั้ง Office จะแสดงถึงชื่อของตำแหน่งที่ต้องการ เช่น "สมาชิกสภาผู้แทนราษฎร" ในบริบทของผู้ดำรงตำแหน่ง ที่นั่งคือที่นั่งเฉพาะสำหรับบุคคลหนึ่งๆ

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

หากบุคคลหนึ่งดำรงตำแหน่งมากกว่า 1 ตำแหน่งพร้อมกัน โปรดระบุข้อมูลเกี่ยวกับตำแหน่งเหล่านี้ เช่น หากบุคคลหนึ่งเป็นทั้งนายกรัฐมนตรีเยอรมนีและสมาชิก Bundestag บุคคลนั้นจะต้องได้รับการกำหนดในทั้ง 2 ตำแหน่ง

เมื่อมีการระบุว่าบุคคลหนึ่งเป็นผู้ดำรงตำแหน่งในเขตเลือกตั้งใหม่หรือตำแหน่งใหม่ ให้ลิงก์บุคคลดังกล่าวกับตำแหน่งใหม่ ตรวจสอบว่าคุณไม่ได้ใช้ Office ที่ล้าสมัยซ้ำ

Attributes

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

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

องค์ประกอบ

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

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

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

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

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

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

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

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

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

  • สมัยประธานาธิบดีของ Grover Cleveland ตั้งแต่ปี 1885 ถึง 1889
  • สมัยประธานาธิบดี Grover Cleveland ตั้งแต่ปี 1893 ถึง 1897
  • สมัยประธานาธิบดี Franklin Roosevelt ตั้งแต่ปี 1933 ถึง 1945

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

ตัวอย่าง

  • สมาชิกสภาผู้แทนราษฎรสิงคโปร์
  • นายกรัฐมนตรีอินเดีย
  • ประธานาธิบดีอินโดนีเซีย
  • สมาชิกวุฒิสภาสหรัฐอเมริกา
OfficeHolderPersonIds 1 IDREFS

ระบุ objectId ของบุคคลที่ Person ดำรงตำแหน่งนี้
SeatStatus 0 หรือ 1 SeatStatus ประเภทที่ระบุของ SeatStatus ของผู้ดำรงตำแหน่ง เช่น active หรือ on-leave ค่าเริ่มต้นคือ active หากไม่ได้ระบุ SeatStatus
SelectionMethod 0 หรือ 1 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">
      <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>upper house</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru-gpu0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <OfficeHolderPersonIds>per0</OfficeHolderPersonIds>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off0",
        "ElectoralDistrictId": "ru-gpu0",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off0"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "upper house"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru-gpu0"
            }
          ]
        }
        "GovernmentBodyIds": ["gb-1]
        "Name": {
          "Text": [
            {
              "value": "United States Senator",
              "language": "en"
            }
          ]
        }
        "OfficeHolderPersonIds": "per0"
        "SelectionMethod": "directly-elected"
        "Term": {
          "StartDate": "2019-01-02"
        }
      }
    ]