オフィス

Office を使用して、オフィスとそのコンテストに関連付けられた情報を定義します。役職は、選挙区と役職の役割で識別されます。

Office 要素はすべてのフィードタイプに適用されますが、国民投票では指定する必要はありません。ただし、オフィスの定義はフィードタイプによって解釈が異なります。選挙の文脈では、Office は、立候補している公職の役職（「下院議員」など）を表します。公職者のコンテキストでは、1 人の特定の議席です。

次のいずれかのフィードタイプを選択して、そのタイプのフィードで Office を使用する方法の詳細をご覧ください。

属性

次の表に、Office の属性を示します。

属性 必須かどうか 型 説明
objectId 必須 ID 他の要素がこの要素を参照するために使用する一意の内部識別子。

要素

次の表に、Office の要素を示します。

要素 重複 タイプ 説明
ContactInformation 0 以上 ContactInformation さまざまな連絡先情報をオフィスに関連付けます。この要素を含める場合は、候補者や現職の公職者ではなく、公職自体に関連する情報のみを指定します。
ElectoralDistrictId 1 IDREF

選挙区を表す GpUnit の objectId を指定します。たとえば、米国上院議員の場合は「アラスカ」などの州を指定します。米国下院議員の場合は「ニューヨークの第 14 選挙区」などの選挙区を指定します。

選挙前データ フィードの場合は、同じ office-role に単一の Office エンティティを指定します。ElectoralDistrict を、選挙の最上位の地域レベルを表す上位エンティティに設定します。

例: 台湾の立法府選挙

  • 候補者が異なる選挙区で選出されたとしても、すべてを単一の Office 値「立法委員会議員」に設定します。ru-country-tw のハイレベルな ElectoralDistrict を使用します。
ExternalIdentifiers 1 ExternalIdentifiers

オフィスに ID を関連付けます。安定した識別子が必要です。オフィスの安定した識別子は、オフィスの在職期間全体で一意である必要があります。たとえば、次の各在職期間には、個別のオフィスの安定した識別子が必要です。

  • グローバー クリーブランドの大統領時代（1885 ～ 1889）
  • グローバー クリーブランドの大統領任期（1893 ～ 1897 年）
  • フランクリン ルーズベルトの大統領時代（1933 ～ 1945 年）

Office の ExternalIdentifiers 要素を使用すると、OtherType の特定の値で追加情報を提供できます。詳細については、ExternalIdentifiers の追加の型をご覧ください。
FilingDeadline 0 または 1 PartialDate 候補者が公職の選挙に出馬する申請をしなければならない日付。
GovernmentBodyIds 0 または 1 IDREFS このオフィスが属する GovernmentBody の objectId を入力します。たとえば、米国上院議員の場合は「United States Senate」です。
Name 1 InternationalizedText この役職の一般的なタイトルのフルネームを指定します。これには、役職の管轄区域を含める必要がありますが、選挙区に関連する情報は除外する必要があります。

例:

  • シンガポール国会議員
  • インドの首相
  • インドネシアの大統領
  • 米国上院議員
SelectionMethod 0 または 1 OfficeSelectionMethod 公職者が選出または就任する方法に関する情報。
Term 0 または 1 Term オフィスの契約期間に関する情報を提供します。

ExternalIdentifier の追加のタイプ

Office の ExternalIdentifiers 要素で、Type を other に設定し、OtherType と Value の値とともに追加データを指定します。次の表に、これらの要素の有効な値を示します。

OtherType 値の例 説明
jurisdiction-id gpu1

必須

オフィスの管轄区域を指定する GpUnit の objectId。
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"
        }
      },
    ]