Compartir a través de

Obtener lugar

Espacio de nombres: microsoft.graph

Lea las propiedades de un objeto place especificado por su identificador.

El objeto place puede ser uno de los siguientes tipos:

  • Un edificio, que incluye propiedades enriquecidas, como vínculos de recursos y tiene una red inalámbrica.
  • Piso, que incluye propiedades enriquecidas, como el criterio de ordenación.
  • Una sección.
  • Un escritorio, que incluye propiedades enriquecidas, como los detalles del buzón y el modo .
  • Una habitación, que incluye propiedades enriquecidas, como una dirección de correo electrónico para la habitación, y accesibilidad, capacidad y compatibilidad con dispositivos.
  • Un área de trabajo, que incluye propiedades como una dirección de correo electrónico para el área de trabajo, y accesibilidad y capacidad.
  • RoomList, que incluye una dirección de correo electrónico para la lista de salas, y una propiedad de navegación para obtener la colección de instancias de sala en esa lista de salas.

Los recursos enumerados se derivan del objeto place .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Place.Read.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Place.Read.All No disponible.

Solicitud HTTP

GET /places/{id}

Parámetros de consulta opcionales

Este método admite el parámetro de $select consulta para ayudar a obtener propiedades específicas. Para obtener información general, vea Parámetros de consulta OData.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto place en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Obtención de un edificio

En el ejemplo siguiente se muestra una solicitud para obtener un edificio.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/places/ca147fcf-ae27-43bb-9d91-f11e626e58bf

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.building",
  "id": "ca147fcf-ae27-43bb-9d91-f11e626e58bf",
  "placeId": "ca147fcf-ae27-43bb-9d91-f11e626e58bf",
  "displayName": "B06",
  "phone": "+1 (425) 615 8888 Ext 06",
  "isWheelChairAccessible": true,
  "label": "This is a building for demo",
  "hasWiFi": true,
  "geoCoordinates": {
    "latitude": 47.644125,
    "longitude": -122.122411,
    "accuracy": null,
    "altitude": null,
    "altitudeAccuracy": null
  },
  "resourceLinks": [
    {
      "name": "Microsoft Web",
      "linkType": "url",
      "value": "www.microsoft.com"
    }
  ]
}

Ejemplo 2: Obtener un piso

En el ejemplo siguiente se muestra una solicitud para obtener una planta.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/places/49558ad4-6ede-46d7-8254-3ca9f90fc4e2

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.floor",
  "id": "49558ad4-6ede-46d7-8254-3ca9f90fc4e2",
  "placeId": "49558ad4-6ede-46d7-8254-3ca9f90fc4e2",
  "displayName": "3",
  "parentId": "ca147fcf-ae27-43bb-9d91-f11e626e58bf",
  "sortOrder": 3
}

Ejemplo 3: Obtener una sección

En el ejemplo siguiente se muestra una solicitud para obtener una sección.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/places/ca163ae1-14a3-4e2a-8a97-5f82d672186f

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.section",
  "id": "ca163ae1-14a3-4e2a-8a97-5f82d672186f",
  "placeId": "ca163ae1-14a3-4e2a-8a97-5f82d672186f",
  "displayName": "Mode Section 1",
  "parentId": "49558ad4-6ede-46d7-8254-3ca9f90fc4e2"
}

Ejemplo 4: Obtener un escritorio

En el ejemplo siguiente se muestra una solicitud para obtener un escritorio.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/places/df7dd4ef-04c4-41dd-816e-35475f4dd546

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.desk",
  "id": "df7dd4ef-04c4-41dd-816e-35475f4dd546",
  "placeId": "df7dd4ef-04c4-41dd-816e-35475f4dd546",
  "displayName": "Desk6",
  "parentId": "ca163ae1-14a3-4e2a-8a97-5f82d672186f",
  "mode": { "@odata.type": "#microsoft.graph.dropInPlaceMode" }
}

Ejemplo 5: Obtener una habitación

En el ejemplo siguiente se muestra una solicitud para obtener una habitación.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/places/0be387a4-d53b-410f-9daf-f4fa07e5b05a

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.room",
  "id": "0be387a4-d53b-410f-9daf-f4fa07e5b05a",
  "placeId": "4923e5a8-453e-4edf-b272-9c33757d4fb3",
  "displayName": "TestRoom-123",
  "parentId": "88d25c73-e9c2-4284-86d7-2cf5685b67b9",
  "isWheelChairAccessible": true,
  "emailAddress": "TestRoom-123@contoso.com",
  "nickname": "TestRoomZihan-123",
  "bookingType": "standard",
  "isTeamsEnabled": true
}

Ejemplo 6: Obtención de un área de trabajo

En el ejemplo siguiente se muestra una solicitud para obtener un área de trabajo.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/places/ec10ce32-2065-40ba-aa2f-ecd5ea175420

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.workspace",
  "id": "ec10ce32-2065-40ba-aa2f-ecd5ea175420",
  "placeId": "8abb4849-b6a0-4c45-baab-92a6b63227a5",
  "displayName": "deskpool 003",
  "parentId": "46e0d2ec-d026-4e1d-861d-80ede4470f67",
  "emailAddress": "deskpool0039052bd811752731134695@contoso.com",
  "nickname": "deskpool 003",
  "capacity": 10
}

Ejemplo 7: Obtener una lista de salas

En el ejemplo siguiente se muestra una solicitud para obtener un roomList.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.roomList",
  "id": "dc404124-302a-92aa-f98d-7b4deb0c1705",
  "displayName": "Building 1",
  "address": {
    "street": "4567 Main Street",
    "city": "Buffalo",
    "state": "NY",
    "postalCode": "98052",
    "countryOrRegion": "USA"
  },
  "emailAddress": "bldg1@contoso.com",
  "placeId": "406bd1b2-237c-4710-bda2-8b7900d61b27"
}
  • Last updated on