Office を使用して、オフィスとそのコンテストに関連する情報を定義します。オフィスは、選挙区とオフィスの役割で識別されます。
Office 要素はすべてのフィードタイプに適用されますが、国民投票では指定する必要はありません。
次のいずれかのフィードタイプを選択して、そのタイプのフィードで Office を使用する方法の詳細をご覧ください。
属性
次の表に、Office の属性を示します。
| 属性 | 必須かどうか | 型 | 説明 |
|---|---|---|---|
objectId |
必須 | ID |
他の要素がこの要素を参照するために使用する一意の内部識別子。 |
要素
次の表に、Office の要素を示します。
| 要素 | 重複 | タイプ | 説明 |
|---|---|---|---|
ContactInformation |
0 以上 | ContactInformation |
さまざまな連絡先情報をオフィスに関連付けます。この要素を含める場合は、候補者や現職の公職者ではなく、公職自体に関連する情報のみを指定してください。 |
ElectoralDistrictId |
0 または 1 | IDREF |
選挙区を表す 公職者のフィードでは、議席ごとに 1 つの 例: 台湾の立法府選挙
別の例: 米国上院議員のフィード
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
ID をオフィスに関連付けます。安定した識別子が必要です。役職の安定した識別子は、役職の任期全体で一意である必要があります。たとえば、次の各在職期間には、それぞれ異なるオフィス安定版識別子が必要です。
|
GovernmentBodyIds |
0 または 1 | IDREFS |
このオフィスが属する GovernmentBody の objectId を指定します。たとえば、米国上院議員の場合は「米国上院」 |
Name |
1 | InternationalizedText |
この役職の一般的なタイトルのフルネームを提供します。これには、事務所の管轄区域を含める必要がありますが、選挙区に関連する情報は除外する必要があります。 例:
|
JurisdictionId |
0 または 1 | IDREF |
オフィスの管轄区域を指定する |
Level |
0 または 1 | OfficeLevel |
オフィスのレベルの列挙型。オプションの一覧については、リファレンスをご覧ください。 |
Role |
0 以上 | OfficeRole |
オフィスの Role の列挙型(cabinet member、president など)。使用可能なすべてのオプションについては、リファレンスをご覧ください。 |
OfficeHolderPersonIds |
1 | IDREFS |
このオフィスを保持する |
SeatStatus |
0 または 1 | SeatStatus |
active や on-leave などの、役職者の SeatStatus の列挙型。SeatStatus が指定されていない場合、デフォルト値は active です。Office の |
SelectionMethod |
0 以上 | OfficeSelectionMethod |
公職者の選出方法または就任方法に関する情報。 |
Term |
1 | Term |
オフィス用語に関連する情報を提供します。 |
ExternalIdentifiers の追加タイプ
Office の ExternalIdentifiers 要素で、Type が other の追加データと、OtherType と Value の値を指定します。次の表に、これらの要素で使用可能な値を示します。
OtherType |
値の例 | 説明 |
|---|---|---|
jurisdiction-id |
gpu1 |
オフィスの管轄区域を指定する |
government-body |
United States Senate |
GovernmentBody をご覧ください。
|
legislative-session |
116th United States Congress |
|
office-level |
Country |
OfficeLevel の値にする必要があります。いずれにも該当しない場合は、Google の担当者にお問い合わせください。
|
office-role |
upper house |
|
office-seat |
Position 1、Seat 2、unexpired、special、Seat 2 special |
複数の議席や役職があるオフィス、および任期が切れていないオフィスを区別するために使用します。 |
例
XML
<Office objectId="off0"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>stable-off0</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>