Comentários Editar

tipo de recurso place

  • Artigo
  • 3 minutos para o fim da leitura

Namespace: microsoft.graph

Representa atributos de localização básicos, como nome, endereço físico e coordenadas geográficas. Esse é o tipo base para tipos de localização mais avançados, como room e roomList.

Usando a API de locais

Exchange Online administradores podem organizar salas de reunião em um locatário em listas de salas. Usando a API de locais, você pode obter todas as listas de salas ou salas no locatário ou obter todas as salas em uma lista de salas específica.

Locais como room e roomList contêm a ID básica, o nome de exibição e o endereço de email. Além disso, eles contêm informações de navegação, como endereço físico e coordenadas geográficas e, no caso de salas, outras informações relevantes, como recursos da AV, número de piso e capacidade.

As funções findRooms e findRoomLists dão suporte a pesquisas semelhantes para salas e listas de salas em um locatário. A seguir está uma comparação entre a API de locais e essas funções. Se você estiver criando um aplicativo de produção, escolha os locais da API, pois a API agora está em disponibilidade geral na v1.0. Planeje atualizar qualquer código existente que use findRooms ou findRoomLists para usar a API de locais, pois findRooms ou findRoomLists será preterido e uma linha do tempo será anunciada.

API de Locais Funções findRooms e findRoomLists
Dá suporte para obter todas as salas ou listas de salas em um locatário e todas as salas em uma lista de salas Suporte semelhante – obtenha todas as salas ou listas de salas em um locatário e todas as salas em uma lista de salas
Os locais de lista podem retornar mais de 100 salas em um locatário findRooms retorna até as primeiras 100 salas em um locatário
Dá suporte a obter uma lista individual de sala ou sala em um locatário Não dá suporte para obter uma lista individual de sala ou sala em um locatário
Define as entidades específicas de room e roomList que especificam um conjunto de propriedades mais avançado, além do nome de exibição e do endereço SMTP. Cada lista de sala e sala é de um tipo emailAddress de peso mais leve que especifica apenas o nome de exibição e o endereço SMTP
Dá suporte apenas a cenários organizacionais com permissões delegadas (contas corporativas ou de estudante) ou de aplicativo Suporte semelhante para apenas cenários organizacionais com permissões delegadas ou de aplicativo
Dá suporte à atualização de uma lista de sala ou sala individual em um locatário Não dá suporte à atualização de uma lista de sala ou sala individual em um locatário

Métodos

Método Tipo de retorno Descrição
Listar locais Uma coleção do tipo de local solicitado e derivado Obtenha uma coleção do tipo especificado de objetos de local definidos no locatário.
Obter local O tipo de local solicitado e derivado Obtenha as propriedades e as relações de um objeto de local especificado.
Atualizar local O tipo de local solicitado e derivado Atualize as propriedades e as relações de um objeto de local especificado.

Propriedades

Propriedade Tipo Descrição
address physicalAddress O endereço do lugar.
displayName Cadeia de caracteres O nome associado ao local.
geoCoordinates outlookGeoCoordinates Especifica o local do local nas coordenadas de latitude, longitude e altitude (opcionalmente).
id Cadeia de caracteres Identificador exclusivo do local. Somente leitura.
phone Cadeia de caracteres O número de telefone do lugar.

Relações

Nenhum

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "displayName": "String",
  "id": "String (identifier)",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "phone": "String"
}

Confira também