Compartir a través de

Lugares upsert

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.

Coloque uno o varios objetos upsert en modo asincrónico. Esta API le permite crear y actualizar varios lugares de forma eficaz en una sola solicitud.

Para obtener más información sobre cómo usar esta API, incluidos escenarios, procedimientos recomendados y límites de simultaneidad, consulte Trabajar con la API de Places upsert en Microsoft Graph.

Nota:

  • Las operaciones se conservan durante 15 días desde su creación.
  • Esta API tiene un límite de limitación de tres llamadas por segundo. Para obtener más información, consulte Límites de limitación específicos del servicio de Microsoft Graph.
  • Todas las solicitudes requieren el OData-Version: 4.01 encabezado .
  • Actualmente, esta API no admite el modo asignado para los escritorios ni la isTeamsEnabled propiedad para salas.
  • Por ahora, la operación de ubicación no puede controlar un gran número de lugares a la vez, especialmente salas, escritorios y áreas de trabajo. El límite actual es aproximadamente de 20 a 30 habitaciones, escritorios o áreas de trabajo.

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.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

PATCH /places

Encabezados de solicitud

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

Cuerpo de la solicitud

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

Se pueden especificar las mismas propiedades que al crear o actualizar un objeto place .

Respuesta

Si se ejecuta correctamente, este método devuelve un 202 Accepted código de respuesta y una dirección URL de operación en el Location encabezado de respuesta que puede usar para obtener la operación.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra una solicitud que combina varias operaciones, incluida la actualización de un edificio existente, la creación de nuevos lugares con una jerarquía y la actualización de propiedades:

  • Actualice un edificio existente para establecer el nombre para Demo Building Amostrar en , habilite Wi-Fi y cree un nuevo piso Demo Floor 1 como elemento secundario del edificio actualizado.
  • Cree un nuevo edificio Demo Building B con una planta Demo Floor 1 secundaria que contenga una nueva sección Demo Section A con un escritorio existente y una nueva sala Demo Room 1.
  • Cree un área de trabajo en modo reservable en un elemento primario existente.
  • Actualice el nombre para mostrar de una sección existente.
PATCH https://graph.microsoft.com/beta/places
Content-Type: application/json
OData-Version: 4.01

{
  "@context": "#$delta",
  "value": [
    {
      "@odata.type": "microsoft.graph.building",
      "id": "25e5905a-7fee-4f36-ba31-29e85c14bf18",
      "displayName": "Demo Building A",
      "hasWifi": true,
      "children@delta": [
        {
          "@odata.type": "microsoft.graph.floor",
          "displayName": "Demo Floor 1"
        }
      ]
    },
    {
      "@odata.type": "microsoft.graph.building",
      "displayName": "Demo Building B",
      "children@delta": [
        {
          "@odata.type": "microsoft.graph.floor",
          "displayName": "Demo Floor 1",
          "children@delta": [
            {
              "@odata.type": "microsoft.graph.section",
              "displayName": "Demo Section A",
              "children@delta": [
                {
                  "@odata.type": "#microsoft.graph.desk",
                  "id": "211ffb37-e880-475a-b73a-43f484609536"
                },
                {
                  "@odata.type": "#microsoft.graph.room",
                  "displayName": "Demo Room 1"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "@odata.type": "microsoft.graph.workspace",
      "parentId": "2cb2701d-0896-4c69-91bb-582d82d7c68c",
      "displayName": "Demo Workspace 1",
      "mode": {
        "@odata.type": "#microsoft.graph.reservablePlaceMode"
      }
    },
    {
      "@odata.type": "#microsoft.graph.section",
      "id": "2cb2701d-0896-4c69-91bb-582d82d7c68c",
      "displayName": "HR"
    }
  ]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/places/getOperation(id='0f5d3cc5-d1bd-4cba-9b0e-e9ad68527ab5')
  • Last updated on