Obter lugar

Namespace: microsoft.graph

Obtenha as propriedades e as relações de um objeto place especificado por sua ID ou endereço de email.

O objeto place pode ser um dos seguintes tipos:

• Uma sala que inclui propriedades avançadas, como um endereço de email para a sala, e acessibilidade, capacidade e suporte ao dispositivo.
• Uma lista de salas que inclui um endereço de email para a lista de salas e uma propriedade de navegação para obter a coleção de instâncias de sala nessa lista de salas.

Tanto a sala quanto a roomList são derivadas do objeto place .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Solicitação HTTP

GET /places/{id}

Parâmetros de consulta opcionais

Use $select para obter propriedades específicas do local .

Para obter mais informações, consulte Parâmetros de consulta OData.

Cabeçalhos de solicitação

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta e o objeto de lugar solicitado no corpo da resposta.

Exemplos

Exemplo 1: Obter uma sala

Solicitação

O exemplo a seguir especifica a ID de uma sala para obter suas propriedades.

GET https://graph.microsoft.com/v1.0/places/979e9793-3e91-40eb-b18c-0ea937893956

const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/979e9793-3e91-40eb-b18c-0ea937893956')
	.get();

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado com fins de legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#places/$entity",
    "@odata.type": "#microsoft.graph.roomList",
    "id": "979e9793-3e91-40eb-b18c-0ea937893956",
    "displayName": "Building 2 Rooms",
    "address": null,
    "geoCoordinates": null,
    "phone": "",
    "emailAddress": "Building2Rooms@contoso.com"
}

Exemplo 2: Obter uma lista de salas

Solicitação

O exemplo a seguir especifica o emailAddress de uma roomList para obter suas propriedades.

GET https://graph.microsoft.com/v1.0/places/Building2Rooms@contoso.com

const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/Building2Rooms@contoso.com')
	.get();

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado com fins de legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#places/$entity",
    "@odata.type": "#microsoft.graph.roomList",
    "id": "979e9793-3e91-40eb-b18c-0ea937893956",
    "displayName": "Building 2 Rooms",
    "address": null,
    "geoCoordinates": null,
    "phone": "",
    "emailAddress": "Building2Rooms@contoso.com"
}