Crear lugar

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Crear un nuevo objeto de posición .

También puede utilizar este método para crear los siguientes tipos de objeto secundario: edificio, suelo, sección, sala, área de trabajo o escritorio.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Place.ReadWrite.All No disponible.

Importante

Para el acceso delegado con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener asignado un rol compatible de Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. El rol de administrador de Exchange es el rol con privilegios mínimos admitido para esta operación.

Al usar permisos de aplicación, debe configurar el rol necesario TenantPlacesManagement (para administrar Places) y el MailRecipient rol (para administrar usuarios y buzones). Para obtener más información sobre cómo configurar estos roles, consulte Role Based Access Control for Applications in Exchange Online.

Solicitud HTTP

POST /places

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto de lugar .

Para obtener una lista de todas las propiedades que están disponibles al crear un objeto de sitio , consulte el recurso de lugar .

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto place en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Crear un edificio

En el siguiente ejemplo se muestra cómo crear un nuevo objeto de construcción .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.building",
  "displayName": "B001"
}

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 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.building",
  "id": "767a31a7-6987-41c9-b829-ab351b8aab53",
  "placeId": "767a31a7-6987-41c9-b829-ab351b8aab53",
  "displayName": "B001"
}

Ejemplo 2: Crear un piso

En el ejemplo siguiente se muestra cómo crear un nuevo objeto de suelo .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.floor",
  "displayName": "F1",
  "parentId": "767a31a7-6987-41c9-b829-ab351b8aab53"
}

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 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.floor",
  "id": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "placeId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "displayName": "F1",
  "parentId": "767a31a7-6987-41c9-b829-ab351b8aab53",
  "tags": [],
  "isWheelChairAccessible": false
}

Ejemplo 3: Crear una sección

En el ejemplo siguiente se muestra cómo crear un nuevo objeto de sección .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.section",
  "displayName": "S1",
  "parentId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955"
}

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 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.section",
  "id": "1ad0f725-6885-49c5-9a47-3b22a1f9409d",
  "placeId": "1ad0f725-6885-49c5-9a47-3b22a1f9409d",
  "displayName": "S1",
  "parentId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "tags": [],
  "isWheelChairAccessible": false
}

Ejemplo 4: Crear un escritorio

En el ejemplo siguiente se muestra cómo crear un nuevo objeto de escritorio .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.desk",
  "displayName": "D1",
  "parentId": "1ad0f725-6885-49c5-9a47-3b22a1f9409d"
}

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 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.desk",
  "id": "fc25d4dc-817a-45bc-a72d-2616cd7566ac",
  "placeId": "fc25d4dc-817a-45bc-a72d-2616cd7566ac",
  "displayName": "D1",
  "parentId": "1ad0f725-6885-49c5-9a47-3b22a1f9409d",
  "tags": [],
  "isWheelChairAccessible": false,
  "mode": {
    "@odata.type": "#microsoft.graph.unavailablePlaceMode",
    "reason": "New"
  }
}

Ejemplo 5: Crear una sala

En el ejemplo siguiente se muestra cómo crear un nuevo objeto de sala .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.room",
  "displayName": "Conf Room 4/3.3G11",
  "parentId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "bookingType": "standard"
}

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 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.room",
  "id": "0be387a4-d53b-410f-9daf-f4fa07e5b05a",
  "placeId": "4923e5a8-453e-4edf-b272-9c33757d4fb3",
  "displayName": "Conf Room 4/3.3G11",
  "parentId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "isWheelChairAccessible": false,
  "emailAddress": "confroom433G115497308f1755150217899@contoso.com",
  "bookingType": "standard"
}

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

En el ejemplo siguiente se muestra cómo crear un nuevo objeto de área de trabajo .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.workspace",
  "parentId": "f7de7265-e420-47b4-9d49-28d728716241",
  "displayName": "testSpace001",
  "tags": ["test"]
}

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 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.workspace",
  "id": "49c2fcfb-163a-4e00-a42b-0615d6789e72",
  "placeId": "d90144aa-8cc4-4d49-97f2-9c365e38ed7e",
  "displayName": "testSpace001",
  "parentId": "f7de7265-e420-47b4-9d49-28d728716241",
  "tags": [
    "test"
  ],
  "emailAddress": "testSpace0015d9988631755150528582@contoso.com",
  "nickname": "testSpace001",
  "mode": {
    "@odata.type": "#microsoft.graph.unavailablePlaceMode",
    "reason": "New"
  }
}