Escritório

Use Office para definir um escritório e as informações associadas ao concurso. Um cargo é identificado pelo distrito eleitoral e pela função do cargo.

O elemento Office se aplica a todos os tipos de feed, mas não precisa ser especificado para uma consulta. No entanto, a definição de um escritório é interpretada de maneira diferente com base no tipo de feed. Em um contexto eleitoral, um Office representa o título do cargo que está sendo disputado, como "Membro da Câmara dos Deputados". Em um contexto de cargo, é um assento específico para uma única pessoa.

Selecione um dos tipos de feed a seguir para saber como usar Office com esse tipo de feed.

Atributos

A tabela a seguir descreve os atributos de Office:

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 Office:

Elemento Multiplicidade Tipo Descrição
ContactInformation 0 ou mais ContactInformation Associa vários dados de contato ao escritório. Se esse elemento for incluído, especifique apenas informações relacionadas ao próprio cargo, não ao candidato ou ao ocupante do cargo.
ElectoralDistrictId 1 IDREF

Informe o objectId do GpUnit que representa o distrito eleitoral. Por exemplo, indique um estado, como "Alasca", para um senador dos EUA, ou um distrito, como "14º distrito congressional de Nova York", para um representante dos EUA.

Para o feed de dados pré-eleitorais , forneça uma única entidade Office para o mesmo office-role. Defina ElectoralDistrict como a entidade de alto nível que representa o nível geográfico principal da eleição.

Exemplo:as eleições legislativas de Taiwan

  • Mesmo que os candidatos sejam eleitos em distritos diferentes, defina todos eles com um único valor Office, "Membro do Yuan Legislativo". Use um ElectoralDistrict de alto nível de ru-country-tw.
ExternalIdentifiers 1 ExternalIdentifiers

Associa um ID ao escritório. Um identificador estável é necessário. Os identificadores estáveis para escritórios precisam ser exclusivos em todos os períodos de permanência. Por exemplo, cada um dos seguintes mandatos precisa de um identificador de escritório estável distinto:

  • A presidência de Grover Cleveland de 1885 a 1889
  • A presidência de Grover Cleveland de 1893 a 1897
  • A presidência de Franklin Roosevelt de 1933 a 1945

O elemento ExternalIdentifiers de Office permite fornecer informações adicionais com valores específicos para OtherType. Para mais detalhes, consulte Outros tipos de ExternalIdentifiers.
FilingDeadline 0 ou 1 PartialDate A data até a qual um candidato precisa se inscrever para a disputa do cargo.
GovernmentBodyIds 0 ou 1 IDREFS Informe o objectId da GovernmentBody a que a agência pertence. Por exemplo, "Senado dos Estados Unidos" para um senador dos EUA
Name 1 InternationalizedText Fornece o nome completo do título genérico do cargo. Ela precisa incluir a jurisdição do cargo, mas excluir qualquer informação relacionada ao distrito eleitoral.

Exemplos:

  • Membro do Parlamento de Singapura
  • Primeiro-ministro da Índia
  • Presidente da Indonésia
  • Senador dos Estados Unidos
SelectionMethod 0 ou 1 OfficeSelectionMethod Informações sobre como o ocupante do cargo é selecionado ou colocado no cargo.
Term 0 ou 1 Term Fornece informações relacionadas ao termo do escritório.

Outros tipos para ExternalIdentifiers

No elemento ExternalIdentifiers de Office, forneça mais dados com um Type de other, além de valores para OtherType e Value. A tabela a seguir mostra os valores possíveis para esses elementos:

OtherType Valores de exemplo Descrição
jurisdiction-id gpu1

Obrigatório

O objectId do GpUnit que especifica a jurisdição do escritório.
government-body United States Senate Veja GovernmentBody.
legislative-session 116th United States Congress
office-level Country Precisa ser um valor de OfficeLevel. Se nenhuma delas se aplicar, fale com seu contato do Google.
office-role upper house

Obrigatório

Precisa ser um valor de OfficeRole. Se nenhuma delas se aplicar, fale com seu contato do Google.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Use isso para diferenciar escritórios com vários assentos ou posições e para escritórios gerais e não expirados.

Exemplos

XML

    <Office objectId="off9999a">
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off9999a</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru0002</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>president</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FilingDeadline>2013-01-01</FilingDeadline>
      <IsPartisan>true</IsPartisan>
      <Name>
        <Text language="en">President</Text>
      </Name>
      <Term>
        <Type>full-term</Type>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off9999a",
        "ElectoralDistrictId": "ru0002",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off9999a"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru0002"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "president"
            }
          ]
        }
        "FilingDeadline": "2013-01-01"
        "IsPartisan": true,
        "Name": {
          "Text": [
            {
              "value": "President",
              "language": "en"
            }
          ]
        },
        "Term": {
          "Type": "full-term"
        }
      },
    ]