オフィス

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

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

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

1 人の社員が複数の役職を同時に兼任している場合は、複数の役職に関する情報を必ず提供してください。たとえば、ドイツ首相とドイツ連邦議会議員の両方である人物は、両方の役職で定義する必要があります。

新しい選挙区または新しい役職の役職者として指定された人物は、新しい役職にリンクします。古いオフィスは再利用しないでください。

属性

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

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

要素

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

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

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

公職者フィードの場合、議席ごとに 1 つの Office が想定され、ElectoralDistrictId は当該人物を当選させた選挙区に設定されます。

例: 台湾の立法府選挙

  • 立法委員会のメンバーには、選挙区に基づいて異なる Office を割り当てます。

別の例: 米国上院議員フィード

  • 米国上院に 100 個の Office オブジェクトを指定します。
ExternalIdentifiers 1 ExternalIdentifiers

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

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

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

例:

  • シンガポール国会議員
  • インドの首相
  • インドネシアの大統領
  • 米国上院議員
OfficeHolderPersonIds 1 IDREFS

この役職を保持する Person の objectId を指定します。
SeatStatus 0 または 1 SeatStatus 役職者の SeatStatus の列挙型（active や on-leave など）。SeatStatus が指定されていない場合、デフォルト値は active です。
SelectionMethod 0 または 1 OfficeSelectionMethod 公職者が選出または就任する方法に関する情報。
Term 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="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"
        }
      }
    ]