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.

Se uma pessoa ocupar mais de um cargo ao mesmo tempo, forneça informações sobre esses cargos. Por exemplo, se alguém é chanceler da Alemanha e membro do Bundestag, ele precisa ser definido em ambos os cargos.

Quando uma pessoa é designada como ocupante de cargo de um novo distrito ou de um novo cargo, vincule essa pessoa ao novo cargo. Não reutilize um escritório desatualizado.

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 0 ou 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 do cargo, esperamos um Office por assento e o ElectoralDistrictId definido para o distrito que elegeu essa pessoa.

Exemplo:as eleições legislativas de Taiwan

  • Dê a cada membro do Yuan Legislativo um Office diferente, com base no distrito.

Outro exemplo:feed de cargo do Senado dos EUA

  • Forneça 100 objetos Office para o Senado dos EUA.
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.
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
OfficeHolderPersonIds 1 IDREFS

Informe o objectId do Person que ocupa esse cargo.
SeatStatus 0 ou 1 SeatStatus O tipo enumerado do SeatStatus do ocupante do cargo, como active ou on-leave. O valor padrão é active se nenhum SeatStatus for especificado.
SelectionMethod 0 ou 1 OfficeSelectionMethod Informações sobre como o ocupante do cargo é selecionado ou colocado no cargo.
Term 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="off0">
      <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>upper house</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru-gpu0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <OfficeHolderPersonIds>per0</OfficeHolderPersonIds>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off0",
        "ElectoralDistrictId": "ru-gpu0",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off0"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "upper house"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru-gpu0"
            }
          ]
        }
        "GovernmentBodyIds": ["gb-1]
        "Name": {
          "Text": [
            {
              "value": "United States Senator",
              "language": "en"
            }
          ]
        }
        "OfficeHolderPersonIds": "per0"
        "SelectionMethod": "directly-elected"
        "Term": {
          "StartDate": "2019-01-02"
        }
      }
    ]