Compartilhar via


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"
}
  • 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.