สำนักงาน

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

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

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

Attributes

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

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

องค์ประกอบ

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

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

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

สำหรับฟีดข้อมูลก่อนการเลือกตั้ง

ExternalIdentifiers 1 ExternalIdentifiers

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

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

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

ตัวอย่าง

  • สมาชิกสภาผู้แทนราษฎรสิงคโปร์
  • นายกรัฐมนตรีอินเดีย
  • ประธานาธิบดีอินโดนีเซีย
  • สมาชิกวุฒิสภาสหรัฐอเมริกา
SelectionMethod 0 หรือ 1 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>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru0002</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>president</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FilingDeadline>2013-01-01</FilingDeadline>
      <IsPartisan>true</IsPartisan>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off9999a",
        "ElectoralDistrictId": "ru0002",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off9999a"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru0002"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "president"
            }
          ]
        }
        "FilingDeadline": "2013-01-01"
        "IsPartisan": true,
        "Name": {
          "Text": [
            {
              "value": "President",
              "language": "en"
            }
          ]
        },
        "Term": {
          "Type": "full-term"
        }
      },
    ]