オフィス

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

Office 要素はすべてのフィードタイプに適用されますが、国民投票では指定する必要はありません。

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

属性

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

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

要素

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

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

外交事務所の受け入れ国を指定する GpUnit の objectId を指定します。
DiplomatSendingStateId 0 または 1 IDREF

外交機関の送信状態を指定する GpUnit の objectId を指定します。
ElectoralDistrictId 0 または 1 IDREF

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

公職者フィードでは、1 議席につき 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 を指定します。（例: 米国上院議員の場合は「米国上院」）
Name 1 InternationalizedText この役職の一般的な肩書きのフルネームを提供します。これには、役職の管轄区域を含める必要がありますが、選挙区に関連する情報は含めないでください。

例:

  • シンガポール国会議員
  • インド首相
  • インドネシア大統領
  • 米国上院議員
JurisdictionId 0 または 1 IDREF

オフィスの管轄区域を指定する GpUnit の objectId を指定します。
Level 0 または 1 OfficeLevel

オフィスのレベルの列挙型。オプションの完全なリストについては、リファレンスをご覧ください。
Role 0 以上 OfficeRole オフィスの Role の列挙型（cabinet member や president など）。使用可能なすべてのオプションについては、リファレンスをご覧ください。
OfficeHolderPersonIds 1 IDREFS

この役職を保持する Person の objectId を指定します。
SeatStatus 0 または 1 SeatStatus 役職者の SeatStatus の列挙型（active、on-leave など）。SeatStatus が指定されていない場合、デフォルト値は active です。
SelectionMethod 0 以上 OfficeSelectionMethod 公職者がどのように選出または任命されたかに関する情報。
Term 1 Term オフィス用語に関連する情報を提供します。

ExternalIdentifiers の追加タイプ

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

OtherType 値の例 説明
jurisdiction-id gpu1

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