Lugares de 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.

Actualizar/insertar (upsert) uno o varios objetos de lugar en modo asincrónico. Esta API le permite crear y actualizar varios lugares de manera eficiente en una sola solicitud.

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

Nota:

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

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

PATCH /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.
OData-Version 4.01. Obligatorio.

Cuerpo de la solicitud

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

Se pueden especificar las mismas propiedades que cuando crea o actualiza un objeto de ubicación .

Respuesta

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

Ejemplo

Solicitud

En el ejemplo siguiente se muestra una solicitud que combina varias operaciones, como 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 mostrar en Demo Building A, 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 un piso Demo Floor 1 secundario que contenga una nueva sección Demo Section A con un escritorio existente y una nueva habitación Demo Room 1.
  • Cree una nueva área de trabajo en modo reservable bajo un elemento primario existente.
  • Actualizar 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