Trabajar con upsert Places API en Microsoft Graph

La API upsert places permite crear y actualizar de forma eficaz varios lugares en una sola operación asincrónica.

Escenarios admitidos

Se admiten los siguientes escenarios al usar la API upsert places :

  • Cree varios lugares independientes.
  • Cree lugares con jerarquía, incluidos los nuevos lugares secundarios en un lugar existente.
  • Actualice varios lugares independientes.
  • Actualice la jerarquía de lugares, incluido el movimiento de un lugar existente en un nuevo lugar.

Descripción de la carga útil de la solicitud

Las siguientes consideraciones se aplican al realizar operaciones de creación o actualización masivas en lugares:

  • Creación frente a actualización: Places sin una propiedad id se crean y los lugares con una propiedad id se actualizan por identificador.
  • Jerarquía de lugares: use la propiedad children@delta para crear o actualizar lugares secundarios dentro de un lugar primario. La propiedad parentId se establece automáticamente para los lugares secundarios.
  • El modo asignado aún no se admite en lugares upsert .
  • No se admite actualizar un lugar secundario existente en un lugar primario existente mediante children@delta propiedad . Deben actualizarse por separado.

Simultaneidad de nivel de trabajo

La simultaneidad de nivel de trabajo limita el número de operaciones de upsert places que se pueden ejecutar simultáneamente dentro de un inquilino.

  • Solo se permiten tres operaciones de upsert places simultáneas en el nivel de inquilino.
  • Si ya se han creado tres operaciones o están en curso, se rechaza otra PATCH llamada API con un código de 429 Too Many Requests respuesta.