किसी ऑफ़िस और उससे जुड़ी प्रतियोगिता की जानकारी देने के लिए, Office का इस्तेमाल करें. किसी पद की पहचान उसके चुनावी क्षेत्र और पद की भूमिका से होती है.
Office एलिमेंट, सभी फ़ीड टाइप पर लागू होता है. हालांकि, जनमत संग्रह के लिए इसे तय करने की ज़रूरत नहीं होती.
Office को किसी फ़ीड टाइप के साथ इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, यहां दिए गए फ़ीड टाइप में से कोई एक चुनें.
विशेषताएं
यहां दी गई टेबल में, Office के एट्रिब्यूट के बारे में बताया गया है:
| एट्रिब्यूट | ज़रूरी है? | टाइप | ब्यौरा |
|---|---|---|---|
objectId |
ज़रूरी है | ID |
यूनीक इंटरनल आइडेंटिफ़ायर, जिसका इस्तेमाल अन्य एलिमेंट इस एलिमेंट को रेफ़रंस देने के लिए करते हैं. |
एलिमेंट
यहां दी गई टेबल में, Office के एलिमेंट के बारे में बताया गया है:
| एलिमेंट | गुणनफल | टाइप | ब्यौरा |
|---|---|---|---|
ContactInformation |
0 या इससे ज़्यादा | ContactInformation |
यह कुकी, ऑफ़िस से जुड़ी अलग-अलग संपर्क जानकारी को सेव करती है. अगर यह एलिमेंट शामिल किया गया है, तो सिर्फ़ उस ऑफ़िस से जुड़ी जानकारी दें, न कि उम्मीदवार या मौजूदा ऑफ़िसहोल्डर की. |
DiplomatReceivingStateId |
0 या 1 | IDREF |
|
DiplomatSendingStateId |
0 या 1 | IDREF |
|
ElectoralDistrictId |
0 या 1 | IDREF |
पद पर मौजूद व्यक्ति के फ़ीड के लिए, हमें हर सीट के लिए एक उदाहरण: ताइवान में होने वाले लेजिसलेटिव चुनाव
एक और उदाहरण: अमेरिका के सीनेट ऑफ़िसहोल्डर का फ़ीड
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
यह ऑफ़िस के साथ एक आईडी जोड़ता है. स्थिर आइडेंटिफ़ायर डालना ज़रूरी है. ऑफ़िस के लिए स्टेबल आइडेंटिफ़ायर, ऑफ़िस के कार्यकाल के दौरान यूनीक होने चाहिए. उदाहरण के लिए, यहां दिए गए हर कार्यकाल के लिए, ऑफ़िस का अलग स्टेबल आइडेंटिफ़ायर होना चाहिए:
|
GovernmentBodyIds |
0 या 1 | IDREFS |
उस GovernmentBody का objectId दें जिसका यह ऑफ़िस हिस्सा है. उदाहरण के लिए, अमेरिका के सीनेटर के लिए United States Senate |
Name |
1 | InternationalizedText |
इस ऑफ़िस के सामान्य टाइटल का पूरा नाम देता है. इसमें ऑफ़िस के अधिकार क्षेत्र की जानकारी शामिल होनी चाहिए. हालांकि, इसमें चुनावी डिस्ट्रिक्ट से जुड़ी कोई जानकारी शामिल नहीं होनी चाहिए.
उदाहरण:
|
JurisdictionId |
0 या 1 | IDREF |
|
Level |
0 या 1 | OfficeLevel |
कार्यालय के लेवल का क्रम से दिया गया टाइप. विकल्पों की पूरी सूची देखने के लिए, रेफ़रंस देखें. |
Role |
0 या इससे ज़्यादा | OfficeRole |
ऑफ़िस की भूमिका का टाइप, जैसे कि cabinet member या president. सभी संभावित विकल्पों के लिए, रेफ़रंस देखें. |
OfficeHolderPersonIds |
1 | IDREFS |
इस पद पर मौजूद |
SeatStatus |
0 या 1 | SeatStatus |
पद पर मौजूद व्यक्ति की SeatStatus का गिने गए टाइप, जैसे कि active या on-leave. अगर SeatStatus की कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट वैल्यू active होती है.
|
SelectionMethod |
0 या इससे ज़्यादा | OfficeSelectionMethod |
इस बारे में जानकारी कि पद पर मौजूद व्यक्ति को कैसे चुना गया या उसे पद पर कैसे रखा गया. |
Term |
1 | Term |
यह कुकी, ऑफ़िस की अवधि से जुड़ी जानकारी देती है. |
ExternalIdentifiers के लिए अन्य टाइप
Office के ExternalIdentifiers एलिमेंट में, other के Type के साथ-साथ OtherType और Value की वैल्यू के साथ अतिरिक्त डेटा दें. यहां दी गई टेबल में, इन एलिमेंट के लिए संभावित वैल्यू दिखाई गई हैं:
OtherType |
उदाहरण मान | ब्यौरा |
|---|---|---|
jurisdiction-id |
gpu1 |
|
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="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>