tipo de recurso place

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 de versão.

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

Usando a API de locais

Os administradores do Exchange Online 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 sala e roomList contêm a ID básica, o nome para 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 de AV, número do piso e capacidade.

As funções findRooms e findRoomLists suportam uma busca semelhante 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 a API de locais, pois a API agora está geralmente disponível na v1.0. Planeje atualizar qualquer código existente que use findRooms ou findRoomLists para usar a API de locais, porque findRooms ou findRoomLists será preterido e uma linha do tempo será anunciada.

Places API	Funções findRooms e findRoomLists
Oferece 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 - obter 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 a 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 rico, além do nome para exibição e endereço SMTP.	Cada sala e lista de sala é de um tipo emailAddress de peso mais claro que especifica apenas o nome de exibição e o endereço SMTP
Dá suporte somente a cenários organizacionais com permissões delegadas (contas de trabalho ou de estudante) ou permissões de aplicativo	Suporte semelhante apenas para cenários organizacionais com permissões delegadas ou de aplicativo
Dá suporte à atualização de uma sala individual ou lista de sala em um locatário	Não dá suporte à atualização de uma lista individual de sala ou sala em um locatário

Métodos

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

Propriedades

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

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

• Para que os administradores criem uma lista de sala, use o cmdlet Do Exchange PowerShell New-DistributionGroup.
• Para que os administradores adicionem uma sala a uma lista de sala, use o cmdlet Do Exchange Powershell Add-DistributionGroupMember.