Concurso

Use Contest para descrever um concurso e vincular o concurso aos candidatos e partidos associados.

Este documento discute Contest e as subentidades dela:

  • Contest
    • CandidateContest
    • PartyContest
    • BallotMeasureContest

Concurso

Contest é um elemento abstrato com três tipos que são usados com base no tipo de concurso:

  • CandidateContest: use este tipo quando uma Contest envolve um ou mais candidatos a um cargo.
  • PartyContest: use esse tipo quando um Contest tiver uma seleção de lista de partidos na eleição.
  • BallotMeasureContest: use este tipo quando um Contest envolve um ou mais referendos.

À medida que os resultados de uma eleição são informados, você pode atualizar seu feed para mostrar estágios diferentes dos resultados, como pesquisas de boca de urna ou estimativas. O Google fornece orientações sobre quais fases eleitorais e tipos de resultados esperamos. O Google pode solicitar um ou vários estágios. Esses valores de tipo de estágio podem mudar durante a noite das eleições. Defina o valor do feed inicial como o estágio inicial. Para mais detalhes, consulte ExternalIdentifiers na seção Elementos.

Atributos

A tabela a seguir descreve os atributos para Contest:

Atributo Obrigatório? Tipo Descrição
objectId Obrigatório ID Identificador interno exclusivo usado por outros elementos para referenciar esse elemento.

Elementos

A tabela a seguir descreve os elementos de Contest:

Elemento Multiplicidade Tipo Descrição
Abbreviation 0 ou 1 string Nome abreviado do concurso.
BallotSelection 0 ou mais BallotSelection

Associa as seleções na cédula ao concurso. A ordem dos candidatos ou partes em Contest precisa ser a mesma que está em BallotSelection.

Se BallotSelection.SequenceOrder estiver presente em todos os itens, ele será usado como a ordem padrão das seleções.
BallotSubTitle 0 ou 1 InternationalizedText Subtítulo do concurso, que precisa corresponder a como aparece nas cédulas dos eleitores.
BallotTitle 0 ou 1 InternationalizedText Título do concurso, que precisa corresponder a como aparece nas cédulas dos eleitores.
BallotTitle 0 ou 1 InternationalizedText Título do concurso, que precisa corresponder a como aparece nas cédulas dos eleitores.
ComposingContestIds 0 ou mais IDREFS

Usado para definir um concurso de agrupamento. Por exemplo, nas eleições gerais presidenciais dos EUA, há uma competição em nível nacional com a composição de IDs para cada uma das eleições estaduais.

Uma ComposingContest precisa estar em um escopo menor que o concurso pai e ocorrer no mesmo turno de uma eleição.
ContestDateStatus 0 ou 1 DateStatus

Este elemento indica o agendamento de atualizações para uma eleição. O valor padrão é confirmed. Na maioria dos casos, é melhor que os valores ContestDateStatus correspondam ao ElectionDateStatus do Election que o contém.
ElectoralDistrictId 1 IDREF

Identificador exclusivo de um elemento GpUnit. Associa o concurso a uma unidade de relatório que representa o escopo geográfico do concurso, como um distrito.

Por exemplo, para um concurso específico, ElectoralDistrictId pode referenciar um ReportingUnit definido para o distrito associado ao concurso. Office também inclui uma referência opcional com a mesma finalidade. Por exemplo, para uma competição nacional, você pode reutilizar o mesmo GpUnit definido para o país.
ExternalIdentifiers 1 ExternalIdentifiers Associa um ID ao concurso. Um identificador estável é obrigatório. Para fornecer o estágio dos resultados eleitorais informados pelo seu feed, defina OtherType com um valor de ContestStage.
HasRotation 0 ou 1 boolean Indica se as seleções no concurso são rotacionadas. Se esse elemento não estiver presente, o valor padrão será false.
Name 1 string Nome do concurso como está listado no relatório de resultados, não necessariamente como aparece na cédula.
SequenceOrder 0 ou 1 integer

A ordem padrão de elementos Contest para mostrar resultados. Os concursos são exibidos de acordo com as seguintes regras:

  • Se dois concursos tiverem valores idênticos, eles poderão ser apresentados em uma ordem indefinida.
  • Todos os concursos com um SequenceOrder são apresentados nessa ordem, seguidos por todos os concursos sem um valor de SequenceOrder, em uma ordem indefinida.

SequenceOrder é usado para ordenar os resultados exibidos. Por exemplo, 100 pode indicar um concurso regional, 200 pode indicar uma competição local e assim por diante. SequenceOrder não é adequado para ser usado como a ordem de concurso na cédula. A ordem de contestação em cada cédula pode ser preservada, no entanto, usando a entidade BallotStyle, que associa estilos de votação às unidades geopolíticas correspondentes.
SubsequentContestId 0 ou 1 IDREF

Usado para apontar para um concurso posterior no mesmo conjunto relacionado. Nas eleições dos EUA, por exemplo, geralmente ele aponta de uma primária para a eleição geral relacionada. Também pode apontar de uma eleição geral para uma eleição de segundo turno.

Um SubsequentContest geralmente tem o mesmo escopo que o concurso anterior.
SubUnitsReported 0 ou 1 integer O número de subunidades, como os eleitores que concluíram a geração de relatórios de votos para este concurso.
SummaryCounts 0 ou mais SummaryCounts Fornece um resumo das contagens diversas associadas ao concurso. Isso inclui o número total de cédulas que contêm o concurso e o número total de abstenções, votos negativos, votos reprovados ou inscrições. As contagens de resumo podem ser associadas ao concurso como um todo ou a outras unidades de relatórios de nível inferior pelo uso de várias ocorrências de SummaryCounts.
TotalSubUnits 0 ou 1 integer O número total de subunidades, como os eleitores que têm este concurso na cédula.
VoteVariation 0 ou 1 VoteVariation O tipo de variação de voto associado ao concurso, como n-of-m.
OtherVoteVariation 0 ou 1 string Usado para fornecer um valor personalizado quando VoteVariation é other.
StartDate 0 ou 1 PartialDate A data de início do calendário do concurso. Use a data de início da votação, como 08/11/2022. Defina a data de início apenas se as datas de início e término do Contest forem diferentes das datas de início e término do Election.
EndDate 0 ou 1 PartialDate A data de término do calendário do concurso. Use a data para o término da pesquisa, como 08/11/2022. A data de término só deverá ser definida se as datas de início e término do Contest forem diferentes das datas de início e término do Election.
CountingDate 0 ou 1 PartialDate a data pós-votação em que ocorre a contagem da eleição. Isso só deve ser incluído se o dia da contagem for diferente do último dia de votação, por exemplo, a eleição da Índia Lok Sabha. O caso comum é que a contagem acontece no mesmo dia do último dia da votação, ou seja, o EndDate da eleição.

CandidateContest

Use CandidateContest para descrever um concurso que envolve a seleção de um ou mais candidatos.

Essa entidade pode referenciar Office ou Party por ID. Não aceitamos a representação de um tíquete de candidatos no mesmo concurso. Só é possível referenciar um Office. Por exemplo, para um ingresso de presidente e vice-presidente, você precisa de dois concursos Candidate. Cada uma citaria um escritório diferente.

Elementos

A tabela a seguir descreve os elementos de CandidateContest:

Elemento Multiplicidade Tipo Descrição
NumberElected 0 ou 1 integer O número de candidatos eleitos no concurso, que é o n de um concurso n-of-m. Se NumberElected não estiver presente no feed, um valor padrão de 1 será usado.
OfficeIds 1 IDREFS Identificador exclusivo para um ou mais elementos Office. Associa uma descrição de escritório ao concurso.
PrimaryPartyIds 0 ou mais IDREFS Identificador exclusivo para um ou mais elementos Party, que indicam que Contest faz parte de uma primária partidária. PrimaryPartyId só é significativo em uma eleição primária.
VotesAllowed 1 integer O número máximo de votos ou inscrições permitido por eleitor neste concurso. Se VotesAllowed não estiver presente no feed, um valor padrão de 1 será usado.
Type 0 ou mais ElectionType O tipo enumerado de um concurso, como primário ou geral. O tipo de Contest só precisará ser definido se for diferente do tipo de Election.

Exemplos

XML

    <Contest xsi:type="CandidateContest" objectId="cc1-001">
      <Abbreviation>KENYAPRES</Abbreviation>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenyatta">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-odinga">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-mudavadi">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenneth">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-dida">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-karua">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kiyiapi">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-muite">...</BallotSelection>
      <BallotTitle>
        <Text language="en">President of Kenya</Text>
        <Text language="es">Presidente de Kenya</Text>
        <Text language="fr">Président du Kenya</Text>
        <Text language="id">Presiden Kenya</Text>
      </BallotTitle>
      <CountStatus>...</CountStatus>
      <CountingDate>2022-08-11</CountingDate>
      <ElectoralDistrictId>...</ElectoralDistrictId>
      <EndDate>2022-08-09</EndDate>
      <Name>President of Kenya</Name>
      <StartDate>2022-08-09</StartDate>
      <SubUnitsReported>48</SubUnitsReported>
      <SummaryCounts>...</SummaryCounts>
      <TotalSubUnits>48</TotalSubUnits>
      <VoteVariation>1-of-m</VoteVariation>
      <NumberElected>1</NumberElected>
      <OfficeIds>off9999a</OfficeIds>
      <VotesAllowed>1</VotesAllowed>
      <Type>general</Type>
    </Contest>

JSON

    "Contest": [
      {
        "@type": "CandidateContest",
        "objectId": "cc1-001",
        "Abbreviation": "KENYAPRES",
        "BallotSelection": [
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kenyatta",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-odinga",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-mudavadi",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kenneth",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-dida",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-karua",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kiyiapi",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-muite",
            ...
          }
        ],
        "BallotTitle": {
          "Text": [
            {
              "value": "President and Vice-President of Kenya",
              "language": "en"
            },
            {
              "value": "Presidente y Vice-Presidente de Kenya",
              "language": "es"
            },
            {
              "value": "Président et vice-président du Kenya",
              "language": "fr"
            },
            {
              "value": "Presiden dan Wakil Presiden Kenya",
              "language": "id"
            },
            {
              "value": "राष्ट्रपति और केन्या के उपराष्ट्रपति",
              "language": "hi"
            },
            {
              "value": "Rais na Makamu wa Rais of Kenya",
              "language": "sw"
            }
          ]
        },
        "CountStatus": "...",
        "ElectoralDistrictId": "...",
        "Name": "President of Kenya",
        "SubUnitsReported": 48,
        "SummaryCounts": "...",
        "TotalSubUnits": 48,
        "VoteVariation": "1-of-m",
        "NumberElected": 1,
        "VotesAllowed": 1,
        "Type": "general"
      }
    ]

PartyContest

Use PartyContest para um concurso em que os eleitores escolhem um partido na cédula.

Elementos

A tabela a seguir descreve os elementos de PartyContest:

Elemento Multiplicidade Tipo Descrição
NumberElected 0 ou 1 integer O número de candidatos eleitos no concurso, que é o n de um concurso n-of-m. Se NumberElected não estiver presente no feed, um valor padrão de 1 será usado.
VotesAllowed 0 ou 1 integer O número máximo de votos ou inscrições permitido por eleitor neste concurso. Se VotesAllowed não estiver presente no feed, um valor padrão de 1 será usado.
OfficeIds 1 IDREFS Identificador exclusivo para um ou mais elementos Office. Associa uma descrição de escritório ao concurso.
Type 0 ou mais ElectionType O tipo enumerado de um concurso, como primário ou geral. O tipo de Contest só precisará ser definido se for diferente do tipo de Election.

Exemplos

XML

    <Contest xsi:type="PartyContest" objectId="pc20001">
      <BallotSelection objectId="ps10132" xsi:type="PartySelection">
        <PartyIds>par10132 par10133</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>off9999a</OfficeIds>
      <Type>general</Type>
      <VotesAllowed>1</VotesAllowed>
    </Contest>

JSON

    "Contest": [
      {
        "@type": "PartyContest",
        "objectId": "pc20001",
        "BallotSelection": [
          {
            "@type": "PartySelection",
            "objectId": "ps10132",
            "PartyIds": [
              "par10132", "par10133"
            ]
          }
        ],
        "BallotTitle": {
          "Text": [
            {
              "value": "Ballot title example",
              "language": "en"
            }
          ]
        },
        "ContestDateStatus": "confirmed",
        "CountingDate": "2022-08-11",
        "ElectoralDistrictId": "...",
        "EndDate": "2022-08-09",
        "ExternalIdentifiers": [
          ...
        ],
        "Name": "Contest name example",
        "StartDate": "2022-08-09",
        "VoteVariation": "1-of-m",
        "OfficeIds": "off9999a",
        "Type": "general",
        "VotesAllowed": 1
      }
    ]

BallotMeasureContest

Use BallotMeasureContest para um concurso que envolva referendos.

Elementos

A tabela abaixo descreve os elementos de BallotMeasureContest:

Elemento Multiplicidade Tipo Descrição
BallotTitle 1 InternationalizedText

O título oficial da cédula, como Nevada Renewable Energy Standards Initiative. Verifique se o BallotTitle é exclusivo.

Alguns referendos têm um único título coletivo com várias perguntas numeradas. Nesses casos, o título pode incluir o número da pergunta para distinguir entre as entidades BallotMeasureContest criadas para cada pergunta.
BallotSubTitle 0 ou 1 InternationalizedText O subtítulo da cédula, se houver.
BallotText 1 InternationalizedText O texto que aparece na própria cédula. Exemplo: 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 ou 1 InternationalizedText

Uma cópia do texto completo do referendo. Forneça esse elemento se houver texto adicional que não esteja incluído na eleição. Limitado a 30.000 caracteres.

Se o texto completo do referendo tiver menos de 30.000 caracteres e não incluir nenhuma formatação inválida em um arquivo de feed, inclua-o em FullText. Inclua também InfoUri com um URI com anotação de fulltext. Caso contrário, inclua apenas o URI com uma anotação fulltext.
InfoUri 0 ou 1 AnnotatedUri

Um URI anotado que aceita as seguintes anotações, em vez das listadas em outros lugares:

  • wikipedia: uma página da Wikipédia sobre o referendo.
  • ballotpedia: uma página da Ballotpedia sobre o referendo. Por exemplo, https://ballotpedia.org/Nevada_Renewable_Energy_Standards_Initiative_(2020)
  • official-website: o site oficial do referendo
  • fulltext: se houver mais texto do que o que está incluído na cédula, como uma cópia da lei proposta, esse será um URI para o texto adicional completo. Este é um exemplo: https://www.nvsos.gov/sos/home/showdocument?id=5330
  • logo-uri: a imagem do logotipo
SummaryText 0 ou 1 InternationalizedText

Um resumo do referendo. É composto por um ou dois parágrafos curtos e pode ser gerado pelo parceiro para resumir o texto completo do referendo, como no exemplo a seguir:

Requires utilities to acquire 50 percent of their electricity from renewable resources by 2030

Official Summary:

EXPLANATION—This ballot measure proposes to amend Article 4 of the Nevada Constitution to require all providers of electric utility services that sell electricity to retail customers for consumption in Nevada to meet a Renewable Portfolio Standard (RPS) that would go into effect beginning in calendar year 2022 and increase gradually until the RPS reaches 50 percent in calendar year 2030. According to the Public Utilities Commission of Nevada, an RPS establishes the percentage of electricity sold by an electric utility to retail customers that must come from renewable sources.
ProStatement 0 ou 1 InternationalizedText Uma declaração que explique o que significa um voto Sim nesse referendo. Ele não é um argumento a favor da medida. Por exemplo: A "yes" vote supports this initiative to require electric utilities to acquire 50 percent of their electricity from renewable resources by 2030.
ConStatement 0 ou 1 InternationalizedText Uma declaração que explique o que significa um voto Não neste referendo. Ele não é um argumento na medida. Por exemplo: 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 ou 1 BallotMeasureType Um tipo enumerado de um referendo. Selecione o valor que melhor descreve o referendo na jurisdição correspondente.

Exemplos

XML

     <Contest objectId="bmc0" xsi:type="BallotMeasureContest">
        <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection">
          <ExternalIdentifiers>
            <ExternalIdentifier>
              <Type>other</Type>
              <OtherType>stable</OtherType>
              <Value>bmc0_yes</Value>
            </ExternalIdentifier>
          </ExternalIdentifiers>
          <Selection>
            <Text language="en">Yes</Text>
          </Selection>
        </BallotSelection>
        <BallotSelection objectId="bms01" xsi:type="BallotMeasureSelection">
          <ExternalIdentifiers>
            <ExternalIdentifier>
              <Type>other</Type>
              <OtherType>stable</OtherType>
              <Value>bmc0_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>bmc0</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>
        <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>

JSON

    "Contest": [
      {
        "@type": "BallotMeasureContest",
        "objectId": "bmc0",
        "BallotSelection": [
          {
            "@type": "BallotMeasureSelection",
            "objectId": "bms00",
            "ExternalIdentifiers": {
              "ExternalIdentifier" : [
                {
                  "Type": "other",
                  "OtherType": "stable",
                  "Value": "bmc0_yes"
                }
              ]
            }
          }
            "Text": [
              {
                "value": "Yes",
                "language": "en"
              },
            ]
        ],
        "BallotSelection": [
          {
            "@type": "BallotMeasureSelection",
            "objectId": "bms01",
            "ExternalIdentifiers": {
              "ExternalIdentifier" : [
                {
                  "Type": "other",
                  "OtherType": "stable",
                  "Value": "bmc0_no"
                }
              ]
            }
          }
            "Text": [
              {
                "value": "No",
                "language": "en"
              },
            ]
        ],
        "BallotSubTitle": {
          "Text": [
            {
              "value": "Farm Animal Confinement Initiative",
              "language": "en"
            }
          ]
        },
        "BallotTitle": {
          "Text": [
            {
              "value": "California Proposition 12, Farm Animal Confinement Initiative (2018)",
              "language": "en"
            }
          ]
        },
        "ElectoralDistrictId": "ru_ca_1"
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0"
            }
          ]
        },
        "Name": "California Proposition 12, Farm Animal Confinement Initiative (2018)",
        "BallotText": [
          "Text": [
            {
              "value": "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.",
              "language": "en"
            }
          ]
        ],
        "ConStatement": [
          "Text": [
            {
              "value": "No means the measure will not be enacted",
              "language": "en"
            }
          ]
        ],
        "InfoUri": [
          {
            "value": "https://example-government.gov/ballot-measures/California_Proposition_12_2018",
            "annotation": "fulltext"
          }
        ],
        "InfoUri": [
          {
            "value": "https://en.wikipedia.org/wiki/2018_California_Proposition_12",
            "annotation": "wikipedia"
          }
        ],
        "ProStatement": [
          "Text": [
            {
              "value": "Yes means the measure will be enacted",
              "language": "en"
            }
          ]
        ],
        "SummaryText": [
          "Text": [
            {
              "value": "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.",
              "language": "en"
            }
          ]
        ],
        "Type": "ballot-measure",
      }
    ]