Tipo de recurso de local

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa diferentes tipos de espaço em um locatário. Para obter mais informações, consulte Trabalhar com a API do Places no Microsoft Graph.

Tipo base de edifício, mesa, andar, sala, roomList, seção e espaço de trabalho.

Métodos

Método Tipo de retorno Descrição
Listar lugares Coleção Lugar Obtenha uma coleção do tipo especificado de objetos place definidos em um locatário.
Criar local Local Crie um novo objeto de lugar .
Obter lugar Local Leia as propriedades de um objeto de lugar . Retorna o tipo de lugar derivado solicitado.
Local de atualização Local Atualize as propriedades do objeto de lugar que pode ser um edifício, piso, seção, escrivaninha, sala, espaço de trabalho ou roomList.
Excluir local Nenhum Excluir um objeto de lugar .
Listar descendentes Coleção Lugar Coloque todos os descendentes de um tipo específico em um lugar.
Criar declaração de marcação checkInClaim Crie um novo objeto checkInClaim para registrar o status de marcar para um local específico, como uma mesa, sala ou espaço de trabalho, associado a uma reserva de calendário específica.
Upsert de locais Cabeçalho location Executar upsert de um ou mais objetos de colocação no modo assíncrono.
Obter operação placeOperation Obtém um placeOperation por ID.
Listar operações coleção placeOperation Liste todos os objetos placeOperation existentes.

Propriedades

Propriedade Tipo Descrição
address physicalAddress O endereço físico do local, incluindo rua, cidade, estado, país ou região e CEP.
customProperties stringDictionary Propriedades personalizadas para o lugar. Cada propriedade tem uma chave de cadeia de caracteres e um valor de cadeia de caracteres. Anulável.
displayName Cadeia de caracteres O nome que está associado ao local.
coordenadas geográficas outlookGeoCoordinates Especifica a localização do local nas coordenadas de latitude, longitude e (opcionalmente) altitude.
id Cadeia de caracteres O identificador exclusivo do local. Somente leitura. Esse identificador não é imutável e poderá ser alterado se a configuração da caixa de correio ou do locatário for alterada.
isWheelChairAccessible Booliano Indica se o local é acessível para cadeiras de rodas.
rótulo Cadeia de caracteres Descrição definida pelo usuário do local.
lastUpdatedTime DateTimeOffset A data e a hora em que o local foi atualizado pela última vez. O carimbo de data/hora está no formato ISO 8601 e está sempre em UTC. Somente leitura. Anulável.
parentId Cadeia de caracteres A ID de um local pai.
phone Cadeia de caracteres O número de telefone do local.
placeId Cadeia de caracteres Um identificador de nível de serviço estável para o objeto place usado pelas cargas de trabalho do Places.
tags String collection Marcas personalizadas associadas ao local para categorização ou filtragem.

Relações

Relação Tipo Descrição
check-ins Coleção checkInClaim Um sub-recurso de um objeto local que indica a status de marcar de um evento de calendário do Outlook reservado no local.
children Coleção Lugar Uma coleção de locais filhos que é usada somente na API de locais de upsert .

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.place",
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "customProperties": {"String": "String"},
  "displayName": "String",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "id": "String (identifier)",
  "isWheelChairAccessible": "Boolean",
  "label": "String",
  "lastUpdatedTime": "String (timestamp)",
  "parentId": "String",
  "phone": "String",
  "placeId": "String (alternative identifier)",
  "tags": ["String"]
}

Trabalhar com a API do Places no Microsoft Graph