Bir seçimi açıklamak ve seçimi ilgili adaylar ve partilerle ilişkilendirmek için Contest öğesini kullanın.
Bu belgede Contest ve alt varlıkları ele alınmaktadır:
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
Türler
Contest, yarışma türüne göre kullanılan üç türü olan soyut bir öğedir:
CandidateContest: BirContestbir makam için bir veya daha fazla aday içerdiğinde bu türü kullanın.PartyContest: BirContest, oy pusulasında parti listesi seçimine sahip olduğunda bu türü kullanın. Bu, daha küçük yarışmaların bir özetini içeren sanal bir yarışma olarak da kullanılabilir.BallotMeasureContest:Contestbir veya daha fazla oylama tedbiri içerdiğinde bu türü kullanın.RetentionContest: Seçilmiş bir yetkilinin görevde kalıp kalmayacağına karar vermek için referandum yapıldığındaContestbu türü kullanın.
Seçim sonuçları bildirildikçe feed'inizi sonuçların farklı aşamalarını (ör. sandık çıkış anketleri veya tahminler) gösterecek şekilde güncelleyebilirsiniz. Google, beklediğimiz seçim aşamaları ve sonuç türleri hakkında rehberlik sağlar. Google, bir veya daha fazla aşama isteyebilir. Bu aşama türü değerleri, seçim gecesi değişebilir. İlk feed değerini, başlangıç aşamasına ayarlayın. Daha fazla bilgi için Öğeler bölümündeki CurrentResultsReportingStage ve ResultsReportingStageCollection konularını inceleyin.
Özellikler
Aşağıdaki tabloda Contest özellikleri açıklanmaktadır:
| Özellik | Zorunlu mu? | Tür | Açıklama |
|---|---|---|---|
objectId |
Zorunlu | ID |
Diğer öğelerin bu öğeye referans vermek için kullandığı benzersiz dahili tanımlayıcı. |
Öğeler
Aşağıdaki tabloda Contest öğeleri açıklanmaktadır:
| Öğe | Çokluk | Tür | Açıklama |
|---|---|---|---|
Abbreviation |
0 veya 1 | string |
Yarışmanın kısa adı. |
AggregateBallotSelection |
0 veya 1 | SpecialBallotSelection |
Oy sayısı toplamları için oy pusulası seçimi (ör. birden fazla adayı "Diğerleri" altında toplama). |
BallotSelection |
0 veya daha fazla | BallotSelection |
Oy pusulasındaki seçimleri yarışmayla ilişkilendirir. Her öğe için |
BallotSubTitle |
0 veya 1 | InternationalizedText |
Yarışmanın alt başlığı. Seçmenlerin oy pusulalarında göründüğü şekilde olmalıdır. |
BallotTitle |
0 veya 1 | InternationalizedText |
Yarışmanın başlığı. Başlık metni, söz dizimi kılavuzuna uygun olmalıdır. Halk oylaması yarışmaları için başlık, oy pusulasındaki ifadeyle eşleşmelidir. |
BlankBallotSelection |
0 veya 1 | SpecialBallotSelection |
Boş oy pusulaları için oy pusulası seçimi. |
ComposingContestIds |
0 veya daha fazla | IDREFS |
Toplu yarışmayı tanımlamak için kullanılır. Örneğin, ABD başkanlık genel seçiminde, eyalet düzeyindeki seçimlerin her biri için yarışma kimlikleri oluşturan ulusal düzeyde bir yarışma vardır.
|
ContestDateStatus |
0 veya 1 |
DateStatus
|
Bu öğe, bir seçimle ilgili planlama güncellemelerini gösterir. Varsayılan değer |
ContestDateType |
0 veya 1 |
ElectionDateType
|
Bu öğe, yarışmanın takvime eklenme şeklini gösterir.
Atlanırsa varsayılan değer, kapsayan |
CountingDate |
0 veya 1 | PartialDate |
Seçim yarışması için sayımın yapıldığı, oy verme işleminden sonraki tarih.
Bu, yalnızca sayım günü oylamanın son gününden farklıysa (ör. Hindistan Lok Sabha seçimi) eklenmelidir. Genellikle oylamanın son günü, yani seçimin EndDate. günü sayım yapılır.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
Yarışma için sonuç raporlamanın mevcut aşaması. |
EarliestPollsClose |
0 veya 1 | dateTime |
İlk sandıklar kapandığında. |
ElectoralDistrictId |
1 | IDREF |
Örneğin, belirli bir yarışma için |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Yarışmayla bir kimliği ilişkilendirir. Sabit bir tanımlayıcı gereklidir. |
EndDate |
0 veya 1 | PartialDate |
Yarışmanın takvimdeki bitiş tarihi. Oylamanın sona erdiği tarihi (ör. 2022-11-08) kullanın. Bitiş tarihi yalnızca Contest başlangıç ve bitiş tarihi, Election başlangıç ve bitiş tarihinden farklıysa ayarlanmalıdır.
|
EstimatedExpectedVotePercentage |
0 veya 1 | float |
Genellikle EEVP olarak kısaltılan bu değer, bu yarışma için bildirilen beklenen toplam oyun tahmini yüzdesidir ve 0 ile 100 arasında bir sayıdır. Örneğin, %24,2'yi |
FilingDeadline |
0 veya 1 | PartialDate |
Adayın yarışma için başvurması gereken son tarih. |
HasRotation |
0 veya 1 | boolean |
Yarışmadaki seçimlerin dönüşümlü olarak gösterilip gösterilmediğini belirtir. Bu öğe yoksa varsayılan değer false olur. |
IsNotable |
0 veya 1 | boolean |
Varlığın dikkate değer olup olmadığı. Belirtilmezse false olduğu varsayılır.
|
LatestPollsClose |
0 veya 1 | dateTime |
Son sandıklar kapandığında. |
Name |
1 | string |
Bu, İngilizce BallotTitle ile eşleşmeli ve başlık söz dizimine karşılık gelmelidir. |
NoneOfTheAboveBallotSelection |
0 veya 1 | SpecialBallotSelection |
Oy pusulasında "Yukarıdakilerin hiçbiri" veya "Hiçbiri", "Bunların hiçbiri" ya da "Kararsız" gibi eşdeğer bir seçeneğe oy vermek için yapılan oy pusulası seçimi. |
NullBallotSelection |
0 veya 1 | SpecialBallotSelection |
Geçersiz veya bozuk oy pusulaları için oy pusulası seçimi. Bunlar, oyun düzgün bir şekilde sayılmasını engelleyecek şekilde işaretlenmiş oy pusulalarıdır. Yırtılmış, kirlenmiş, gereğinden fazla veya az işaretlenmiş ya da seçmenin kimliğini açığa çıkaracak şekilde işaretlenmiş oy pusulaları geçersiz oy pusulalarına örnek olarak verilebilir. |
OutcomeDetermined |
0 veya 1 | boolean |
Seçim sonucunun belirlenip belirlenmediği
|
Seat |
0 veya 1 | string |
Yarışmanın düzenlendiği koltuk. |
SequenceOrder |
0 veya 1 | integer |
Sonuçları görüntülemek için
|
StartDate |
0 veya 1 | PartialDate |
Yarışmanın takvimdeki başlangıç tarihi. Anketin başladığı tarihi (ör. 2022-11-08) kullanın. Başlangıç tarihi, yalnızca Contest başlangıç ve bitiş tarihi, Election başlangıç ve bitiş tarihinden farklıysa ayarlanmalıdır.
|
SubsequentContestId |
0 veya 1 | IDREF |
Aynı ilgili gruptaki daha sonraki bir yarışmaya işaret etmek için kullanılır. Örneğin, ABD seçimlerinde genellikle bir ön seçimden ilgili genel seçime yönlendirir. Ayrıca genel seçimden ikinci tur seçime geçişi de gösterebilir.
|
SubUnitsReported |
0 veya 1 | integer |
Bu yarışma için oyları bildirmeyi tamamlayan alt birimlerin sayısı. |
SummaryCounts |
0 veya daha fazla | SummaryCounts |
Yarışmayla ilişkili çeşitli sayıların özetini sağlar. Bu, yarışmayı içeren toplam oy pusulası sayısını ve toplam çekimser, fazla oy, eksik oy veya yazılı oy sayısını içerir. Özet sayıları, SummaryCounts öğesinin birden fazla örneği kullanılarak yarışmanın tamamıyla veya diğer alt düzey raporlama birimleriyle ilişkilendirilebilir. |
TotalSeats |
0 veya 1 | integer |
Bu yarışmanın seçim bölgesinin makam için sahip olabileceği toplam koltuk sayısı. Bu, seçime gidilen koltuklar + devredilen koltuklar + boş koltukların toplamına eşittir. |
TotalSubUnits |
0 veya 1 | integer |
Bu yarışmanın oy pusulasında yer aldığı alt birimlerin toplam sayısı. |
VoteVariation |
0 veya 1 | VoteVariation |
Yarışmayla ilişkili oy varyasyonunun türü (ör. n-of-m). |
OtherVoteVariation |
0 veya 1 | string |
VoteVariation, other olduğunda özel bir değer sağlamak için kullanılır. |
ResultsEmbargoEnd |
0 veya 1 | dateTime |
Seçim sonuçlarının yayınlanmasıyla ilgili ambargo sona erdiğinde |
ResultsExpected |
0 veya 1 | dateTime |
İlk oy sayımı sonuçlarının feed'de gösterilmesinin beklendiği zaman. |
ResultsLastUpdated |
0 veya 1 | dateTime |
Yarışma sonuçlarının son güncellendiği tarih. |
ResultsReportingStageCollection |
0 veya 1 | Yok |
Birleştirme yarışması için (üst yarışmanın |
CandidateContest
Bir veya daha fazla adayın seçildiği bir yarışmayı açıklamak için CandidateContest kullanın.
Bu varlık, kimliğe göre isteğe bağlı olarak Office veya Party öğesine referans verebilir. Aynı yarışmaya katılan adayların bir biletle temsil edilmesini desteklemiyoruz. Yalnızca bir Office referans verebilirsiniz. Örneğin, başkan ve başkan yardımcısı adayları için iki Candidate yarışması gerekir. Her biri farklı bir ofisi temsil eder.
Öğeler
Aşağıdaki tabloda CandidateContest öğeleri açıklanmaktadır:
| Öğe | Çokluk | Tür | Açıklama |
|---|---|---|---|
NumberElected |
0 veya 1 | integer |
Yarışmada seçilen adayların sayısı. Bu sayı, n-of-m yarışmasının n değeridir. NumberElected, feed'de yoksa varsayılan değer olarak 1 kullanılır. |
OfficeIds |
1 | IDREFS |
Bir veya daha fazla Office öğesi için benzersiz tanımlayıcı. Yarışmayla bir ofis açıklaması ilişkilendirir. |
PrimaryPartyIds |
0 veya daha fazla | IDREFS |
Contest öğesinin partizan ön seçiminin bir parçası olduğunu gösteren bir veya daha fazla Party öğesi için benzersiz tanımlayıcı. PrimaryPartyId yalnızca ön seçimlerde anlamlıdır. |
VotesAllowed |
1 | integer |
Bu yarışmada her seçmenin kullanabileceği maksimum oy veya yazılı oy sayısı. VotesAllowed feed'de yoksa varsayılan değer olarak 1 kullanılır. |
Type |
0 veya daha fazla | ElectionType |
Bir yarışmanın numaralandırılmış türü (ör. birincil veya genel). Contest türü yalnızca Election türünden farklıysa ayarlanmalıdır. |
Örnekler
XML
<Contest xsi:type="CandidateContest" objectId="c-1-001"> <Abbreviation>KENYAPRES</Abbreviation> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kenyatta">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-odinga">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-mudavadi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kenneth">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-dida">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-karua">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kiyiapi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-muite">...</BallotSelection> <BallotTitle> <Text language="en">2022 Kenya Presidential election</Text> <Text language="es">2022 Elecciones presidenciales de Kenia</Text> <Text language="fr">2022 Élection présidentielle au Kenya</Text> </BallotTitle> <CountStatus>...</CountStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <Name>2022 Kenya Presidential election</Name> <StartDate>2022-08-09</StartDate> <SubUnitsReported>48</SubUnitsReported> <SummaryCounts>...</SummaryCounts> <TotalSubUnits>48</TotalSubUnits> <VoteVariation>1-of-m</VoteVariation> <NumberElected>1</NumberElected> <OfficeIds>off-9999a</OfficeIds> <VotesAllowed>1</VotesAllowed> <Type>general</Type> </Contest>
PartyContest
Seçmenlerin oy pusulasında bir parti seçtiği yarışmalar için PartyContest kullanın.
Bu, birleştirilmiş verileri (ör. seçim bölgesi yarışma sonuçlarını birleştiren eyalet düzeyinde bir parti yarışması) iletmek için seçim sonuçları feed'inde sanal bir özet yarışma olarak da kullanılabilir.
Öğeler
Aşağıdaki tabloda PartyContest öğeleri açıklanmaktadır:
| Öğe | Çokluk | Tür | Açıklama |
|---|---|---|---|
NumberElected |
0 veya 1 | integer |
Yarışmada seçilen adayların sayısı. Bu sayı, n-of-m yarışmasının n değeridir. NumberElected, feed'de yoksa varsayılan değer olarak 1 kullanılır. |
VotesAllowed |
0 veya 1 | integer |
Bu yarışmada her seçmenin kullanabileceği maksimum oy veya yazılı oy sayısı. VotesAllowed feed'de yoksa varsayılan değer olarak 1 kullanılır. |
OfficeIds |
1 | IDREFS |
Bir veya daha fazla Office öğesinin benzersiz tanımlayıcısı.
Yarışmayla bir ofis açıklaması ilişkilendirir. |
Type |
0 veya daha fazla | ElectionType |
Bir yarışmanın numaralandırılmış türü (ör. birincil veya genel). Contest türü yalnızca Election türünden farklıysa ayarlanmalıdır. |
Örnekler
XML
<Contest xsi:type="PartyContest" objectId="c-20001"> <BallotSelection objectId="ps-101321" xsi:type="PartySelection"> <PartyIds>par-10132</PartyIds> </BallotSelection> <BallotSelection objectId="ps-101322" xsi:type="PartySelection"> <PartyIds>par-10133</PartyIds> </BallotSelection> <BallotTitle> <Text language="en">Ballot title example</Text> </BallotTitle> <ContestDateStatus>confirmed</ContestDateStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <ExternalIdentifiers>...</ExternalIdentifiers> <Name>Contest name example</Name> <StartDate>2022-08-09</StartDate> <VoteVariation>1-of-m</VoteVariation> <OfficeIds>off-9999a</OfficeIds> <Type>general</Type> <VotesAllowed>1</VotesAllowed> </Contest>
BallotMeasureContest
Oylama tedbirlerini içeren bir yarışma için BallotMeasureContest kullanın.
Öğeler
Aşağıdaki tabloda BallotMeasureContest öğeleri açıklanmaktadır:
| Öğe | Çokluk | Tür | Açıklama |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Oylamanın resmi başlığı (ör. Bazı referandumlarda birden fazla numaralandırılmış soru içeren tek bir ortak başlık bulunur. Bu gibi durumlarda, her soru için oluşturulan |
BallotSubTitle |
0 veya 1 | InternationalizedText |
Varsa oylamanın alt başlığı. |
BallotText |
1 | InternationalizedText |
Oy pusulasında görünen metin. Örneğin: Shall
Article 4 of the Nevada Constitution be amended to require, beginning in
calendar year 2022, that all providers of electric utility services who
sell electricity... in Nevada comes from renewable energy
resources? |
FullText |
0 veya 1 | InternationalizedText |
Oylama tedbirinin tam metninin bir kopyası. Oy pusulasında yer almayan ek metin varsa bu öğeyi sağlayın. 30.000 karakterle sınırlıdır. Oylama ölçüsünün tam metni 30.000 karakterden kısaysa ve feed dosyasında geçersiz olacak herhangi bir biçimlendirme içermiyorsa |
InfoUri |
0 veya 1 | AnnotatedUri |
Başka bir yerde listelenen ek açıklamalar yerine aşağıdaki ek açıklamaları kabul eden ek açıklamalı bir URI:
|
SummaryText |
0 veya 1 | InternationalizedText |
Halk oylamasının özeti. Bir veya iki kısa paragraftan oluşur ve iş ortağı tarafından, oy pusulasının tam metnini özetlemek için oluşturulabilir. Örneğin:
|
ProStatement |
0 veya 1 | InternationalizedText |
Bu oylama ölçütünde Evet oyunun ne anlama geldiğini açıklayan bir ifade. Bu, önlemi destekleyen bir argüman değildir. Örneğin: A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
0 veya 1 | InternationalizedText |
Bu halk oylamasında Hayır oyunun ne anlama geldiğini açıklayan bir ifade. Bu, önleme karşı bir argüman değildir. Örneğin: A
"no" vote opposes this initiative, thus keeping the existing requirement
that electric utilities acquire 25 percent of their electricity from
renewable resources by 2025. |
Type |
0 veya 1 | BallotMeasureType |
Halk oylamasının numaralandırılmış türü. Yargı alanındaki oylama ölçüsünü en iyi açıklayan değeri seçin. |
PassageThreshold |
0 veya 1 | string |
Bir önergenin kabul edilmesi için gereken minimum oy oranı. |
Örnekler
XML
<Contest objectId="c-0" xsi:type="BallotMeasureContest"> <BallotSelection objectId="bms-00" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-00-yes</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms-01" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-01-no</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotSubTitle> <Text language="en">Farm Animal Confinement Initiative</Text> </BallotSubTitle> <BallotTitle> <Text language="en"> California Proposition 12, Farm Animal Confinement Initiative (2018) </Text> </BallotTitle> <ElectoralDistrictId>ru-ca-1</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>c-0</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name> California Proposition 12, Farm Animal Confinement Initiative (2018) </Name> <BallotText> <Text language="en"> Establishes minimum requirements for confining certain farm animals. Prohibits sales of meat and egg products from animals confined in noncomplying manner. Fiscal Impact: Potential decrease in state income tax revenues from farm businesses, likely not more than several million dollars annually. State costs up to $10 million annually to enforce the measure. </Text> </BallotText> <ConStatement> <Text language="en">No means the measure will not be enacted </Text> </ConStatement> <InfoUri Annotation="fulltext"> https://example-government.gov/ballot-measures/California_Proposition_12_2018 </InfoUri> <InfoUri Annotation="wikipedia"> https://en.wikipedia.org/wiki/2018_California_Proposition_12 </InfoUri> <PassageThreshold> <Text language="en">50.01%</Text> </PassageThreshold> <ProStatement> <Text language="en">Yes means the measure will be enacted </Text> </ProStatement> <SummaryText> <Text language="en"> The proposition establishes new minimum requirements on farmers to provide more space for egg-laying hens, breeding pigs, and calves raised for veal. California businesses will be banned from selling eggs or uncooked pork or veal that came from animals housed in ways that did not meet these requirements. </Text> </SummaryText> <Type>ballot-measure</Type> </Contest>
RetentionContest
Seçilmiş bir yetkilinin görevde kalıp kalmayacağına karar vermek için referandum yapılması gereken Contest için bu türü kullanın.
Bu, ABD'nin bazı eyaletlerinde bir hakimin bir dönem daha devam edip etmeyeceğine karar veren yargısal görevde kalma yarışmaları gibi durumları içerir. Bu politika, bir yetkilinin görev süresi sona ermeden önce görevden alınması gerekip gerekmediğine karar verilen geri çağırma seçimleri için de geçerlidir.
Öğeler
BallotMeasureContest'deki tüm öğeler RetentionContest için de geçerlidir.
| Öğe | Çokluk | Tür | Açıklama |
|---|---|---|---|
CandidateId |
1 | IDREF | Mevcut görevliyi temsil eden adayın kimliği |
OfficeId |
0 veya 1 | IDREF | Makam sahibinin şu anda bulunduğu makamın kimliği |
Örnekler
XML
<Contest objectId="c-40001" xsi:type="RetentionContest"> <!-- Retention contest selections are actually BallotMeasureSelection objects, and should use the 'bms-' objectId prefix.--> <BallotSelection objectId="bms-40001a" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-40001a</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms-40001at"> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms-40001b" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-40001b</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms-40001bt"> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotTitle> <Text language="en">Retention of Supreme Court Justice</Text> </BallotTitle> <ElectoralDistrictId>ru-0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>c-vageneral-2013-va16-country-us</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name>Judicial Retention, Supreme Court</Name> <CandidateId>can-12345</CandidateId> <OfficeId>off-20006</OfficeId> </Contest>