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 Versão.
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 sala, workspace e roomList.
Usando a API de locais
Exchange Online administradores podem organizar salas de reunião e workspaces em um locatário em listas de salas. Usando a API de locais, você pode usar a operação de lista para obter todas as salas, workspaces ou listas de salas no locatário ou obter as salas e workspaces em uma lista de salas específica.
Places como sala, workspace 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. | Não dá suporte para obter uma sala individual ou uma lista de quartos em um locatário. |
| Define as entidades específicas de room e roomList que especificam um conjunto de propriedades mais avançado, o nome de exibição e o 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. |
| phone | Cadeia de caracteres | O número de telefone do local. |
| placeId | Cadeia de caracteres | Um identificador exclusivo e imutável para o local. Somente leitura. O valor desse identificador é igual ao ExternalDirectoryObjectId retornado do Get-Mailbox cmdlet. |
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",
"placeId": "String (alternate identifier)"
}
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.