tipo de recurso place

Namespace: microsoft.graph

Representa atributos básicos de localização, como nome, endereço físico e coordenadas geográficas. Esse recurso é 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.

Places como sala e roomList contêm a ID básica, o nome de exibição e o endereço de email. Além disso, elas 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 de AV, número de piso e capacidade.

As funções findRooms e findRoomLists dão suporte a pesquisas semelhantes para salas e listas de quartos em um locatário. A tabela a seguir compara os locais que a API e essas funções.

Nota: As funções findRooms e findRoomLists são preteridas.

Places API	Funções findRooms e findRoomLists (preteridas)
Obtém todas as salas ou listas de salas em um locatário e todas as salas em uma lista de quartos.	Obtém todas as salas ou listas de salas em um locatário e todas as salas em uma lista de quartos.
Os locais de lista podem retornar mais de 100 quartos em um locatário.	findRooms retorna até os primeiros 100 quartos em um locatário.
Dá suporte à obtenção de uma sala ou lista de quartos individuais em um locatário.	Ele não dá suporte para obter uma sala individual ou uma lista de quartos em um locatário.
Define as entidades específicas de sala e roomList que especificam um conjunto de propriedades mais avançado, além do nome de exibição e do endereço SMTP.	Cada sala e lista de salas é de um tipo de email de peso mais leveAddress 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 de trabalho ou de estudante) ou aplicativos.	Dá suporte apenas a cenários organizacionais com permissões delegadas ou de aplicativo.
Dá suporte à atualização de uma sala ou lista de quartos individuais em um locatário.	Não dá suporte à atualização de uma sala ou lista de quartos individuais em um locatário.

Métodos

Método	Tipo de retorno	Descrição
Locais de lista	Uma coleção do tipo de lugar solicitado e derivado	Obtenha uma coleção do tipo especificado de objetos place definidos no locatário.
Obter lugar	O tipo de lugar solicitado e derivado	Obtenha as propriedades e as relações de um objeto local especificado.
Local de atualização	O tipo de lugar 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 da rua do local.
displayName	Cadeia de caracteres	O nome associado ao local.
geoCoordenados	outlookGeoCoordinates	Especifica o local do local em coordenadas de latitude, longitude e (opcionalmente) altitude.
id	Cadeia de caracteres	Um identificador exclusivo para o local. Somente leitura. Esse identificador não é imutável e pode ser alterado se houver alterações na caixa de correio ou na configuração do locatário. A versão beta dessa API tem uma nova propriedade adicionada chamada placeId, que fornece uma ID imutável.
phone	Cadeia de caracteres	O número de telefone do local.

Relações

Nenhum

Representação JSON

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

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

Conteúdo relacionado

• Para os administradores criarem uma lista de salas, use o cmdlet New-DistributionGroup do Exchange PowerShell.
• Para os administradores adicionarem uma sala a uma lista de salas, use o cmdlet Add-DistributionGroupMember do Exchange Powershell.