Novedades de Microsoft Graph

Microsoft Graph proporciona un modelo de programación unificado que puede usar para acceder a datos en Microsoft 365, Windows y Enterprise Mobility + Security. En este artículo se proporciona información sobre las novedades de las API de Microsoft Graph, la documentación, los SDK y mucho más.

Para obtener actualizaciones más detalladas a nivel de API, consulte el registro de cambios de la API de Microsoft Graph API.

Para obtener más información sobre las actualizaciones anteriores de Microsoft Graph, consulte el historial de novedades de Microsoft Graph.

Importante

Las características en estado de versión preliminar están sujetas a cambios sin previo aviso y es posible que no se promuevan al estado disponible con carácter general (GA). No uses las características de versión preliminar en las aplicaciones de producción.

Septiembre de 2026: nuevo y disponible en general

Calendarios | Horas y ubicaciones de trabajo

Se ha agregado compatibilidad solo de la aplicación a los recursos workHoursAndLocationsSetting, workPlanOccurrence y workPlanRecurrence y métodos relacionados. Las aplicaciones pueden usar el permiso de la aplicación para leer la Calendars.Read.All configuración, las periodicidades y las repeticiones de un usuario, y Calendars.ReadWrite.All para crearlas, actualizarlas y eliminarlas.

Notificaciones de cambios

Se ha promovido el unknownFutureValue miembro de la enumeración changeType de la versión beta a la v1.0. Los recursos changeNotification y commsNotification usan la enumeración para identificar los tipos de cambio de notificación.

Archivos

• Se ha agregado la propiedad isPatternToken al recurso fileStorageContainerCustomPropertyValue para indicar si un valor de propiedad personalizado es un urlTemplate patrón que los consumidores deben resolver antes de usarlo, en lugar de un valor literal.
• Se ha agregado la propiedad isOfficeRestricted a los recursos fileStorageContainerTypeSettings y fileStorageContainerTypeRegistrationSettings y a la enumeración fileStorageContainerTypeSettingsOverride .

Grupos

Se ha agregado la propiedad onPremisesExtensionAttributes al recurso de grupo . Úselo para acceder a los atributos de extensión 1-15 sincronizados desde Active Directory local

Identidad y acceso | Administración del directorio

• Se agregó la acción de aprovisionamiento al recurso de dispositivo en v1.0 para permitir que los proveedores aprobados de Infraestructura de escritorio virtual (VDI) aprovisionen dispositivos en el directorio de un cliente.

Identidad y acceso | Gobernanza

• Se promovieron las API de datos proporcionadas por el cliente de revisiones de acceso de la versión beta a la v1.0. Úselos para revisar los datos de derechos que carga para recursos que Microsoft Entra no detecta por sí mismo, como aplicaciones de terceros. La superficie promocionada incluye:
  • la propiedad description de accessReviewInstanceDecisionItemResource para describir el recurso que se está revisando.
  • accessReviewInstanceDecisionItemPermission y la propiedad de permiso en accessReviewInstanceDecisionItem, que describen el permiso que concede al principal acceso al recurso que se está revisando.
  • accessReviewInstanceDecisionItemCustomDataProvidedResource tipo complejo, que representa un recurso de elemento de decisión cuyos datos de derecho son suministrados por el cliente en lugar de detectados por Microsoft Entra.
  • batchApplyCustomDataProvidedResourceDecisions en accessReviewInstance para establecer el resultado de aplicación en todos los elementos de decisión que coincidan con un recurso proporcionado por el cliente en una llamada.
  • accessReviewInstanceDecisionItemApplyResult para representar el resultado de aplicar una decisión registrada al recurso de destino.
• Se ha aclarado que el método de los recursos de lista devuelve los recursos de SharePoint Online solo cuando se le llama con permisos delegados. Para recuperar información del sitio de SharePoint con permisos de aplicación, use el método sites: getAllSites .

Identidad y acceso | Identidad e inicio de sesión

Se han agregado los tipos de recursos anonymousCalendarSharingFreeBusyDetail, anonymousCalendarSharingFreeBusyRevisor y anonymousCalendarSharingFreeBusySimple . Use estas funcionalidades de la directiva de acceso entre inquilinos para autorizar a los usuarios externos anónimos a ver la información de disponibilidad del calendario con distintos niveles de detalle.

Seguridad | Consulta de registro de auditoría

• Se han agregado las propiedades isRecordCountLimitExceeded, recordCountLimit y approximateReturnedRecordCount al recurso auditLogQuery . Use estas propiedades para determinar si una consulta completada ha superado el límite de registro por búsqueda e inspeccionar el límite aplicable y el recuento aproximado de registros devueltos.

Trabajo en equipo y comunicaciones | Mensajería

Se ha actualizado el método getAllRetainedMessages para admitir la exportación de versiones conservadas de mensajes de canal privado que se editaron o eliminaron después de que el inquilino completara la migración de almacenamiento de canal privado.

Septiembre de 2026: solo nuevo en versión preliminar

Agents

Se ha añadido la propiedad isDisabled al recurso agentIdentityBlueprint . Úselo para desactivar un plano técnico de identidad de agente sin eliminarlo.

Copia de seguridad y recuperación | Copia de seguridad y almacenamiento de Microsoft 365

• Se ha agregado la propiedad policyId al tipo de recurso restoreSessionBase para definir el ámbito de las sesiones de restauración en una directiva de protección.
• Se ha agregado el parámetro policyId opcional al método de búsqueda restorePoint: para validar la pertenencia a la unidad de protección y mejorar el enrutamiento de ámbito de directiva. También puedes filtrar la colección de puntos de restauración por protectionUnit/policyId.

Almacenamiento de copia de seguridad

• Se ha agregado el método getStatisticsByPolicy para recuperar las estadísticas de protección de nivel de directiva para el almacenamiento de copia de seguridad de Copia de seguridad Microsoft 365. Utilice el informe para supervisar los artefactos protegidos y no protegidos en los estados completados, en curso y con errores, revisar la actividad de retirada y determinar cuándo se calcularon las métricas por última vez.

Calendar | Places

• Se ha agregado el tipo de recurso stringDictionary para representar pares clave-valor de cadena personalizados.
• Se ha agregado la propiedadcustomProperties al tipo de recurso place para almacenar los pares clave-valor de cadena definidos por el cliente.
• Se ha agregado la propiedad lastUpdatedTime de solo lectura al tipo de recurso de lugar para indicar cuándo se actualizó por última vez el lugar.

Calendarios | Horas y ubicaciones de trabajo

Se ha agregado compatibilidad solo de la aplicación a los recursos workHoursAndLocationsSetting, workPlanOccurrence y workPlanRecurrence y métodos relacionados. Las aplicaciones pueden usar el permiso de la aplicación para leer la Calendars.Read.All configuración, las periodicidades y las repeticiones de un usuario, y Calendars.ReadWrite.All para crearlas, actualizarlas y eliminarlas.

Notificaciones de cambios

Se agregó el unknownFutureValue miembro a la enumeración changeType utilizada por el recurso changeNotification para admitir tipos de cambio de notificación compatibles con versiones posteriores.

Administración de dispositivos y aplicaciones | PC en la nube

• Se ha agregado la propiedad isDisasterRecoveryActive al recurso cloudPC para indicar si el PC en la nube se ejecuta actualmente en su región de recuperación ante desastres después de un evento de conmutación por error.
• Use failoverInProgress y failbackInProgress como valores admitidos para la propiedad status en los recursos cloudPC y cloudPcStatusSummary .

Archivos

• Se agregó el parámetro userObjectId al método getByUser en el recurso fileStorageContainer para recuperar una lista de contenedores de almacenamiento de archivos propiedad de un usuario pasando el identificador de objeto de Microsoft Entra ID del usuario.
• Se ha agregado la propiedad isPatternToken al recurso fileStorageContainerCustomPropertyValue para indicar si un valor de propiedad personalizado es un urlTemplate patrón que los consumidores deben resolver antes de usarlo, en lugar de un valor literal.

Grupos

• Se ha agregado la propiedad disableNesting al recurso de grupo . Úselo para evitar que otros grupos se agreguen como miembros de un grupo de seguridad.

Identidad y acceso | Administración del directorio

• Se agregó la acción de aprovisionamiento al recurso de dispositivo para permitir que los proveedores de Infraestructura de escritorio virtual (VDI) aprobados aprovisionen dispositivos en el directorio de un cliente.

Identidad y acceso | Gobernanza

Se ha aclarado que el método Get accessPackageResourceEnvironment devuelve los entornos de recursos de SharePoint Online solo cuando se le llama con permisos delegados. Un entorno de recursos de SharePoint Online corresponde a un sitio raíz de SharePoint, por lo que para recuperar información del sitio raíz con permisos de aplicación, use el método List sites con la opción query $filter=siteCollection/root ne null .

Identidad y acceso | Supervisión del estado &

• Se ha agregado compatibilidad con el etiquetado de recomendaciones de Microsoft Entra y sus recursos afectados. Use los métodos recommendation: addTag, recommendation: removeTag, impactedResource: addTag y impactedResource: removeTag para administrar la relación de etiquetas , respaldados por el nuevo recurso recommendationTag . También puede agregar o quitar una etiqueta en hasta 50 recursos afectados en una sola solicitud mediante los métodos impactedResource: addTag e impactedResource: removeTag .
• Se han agregado estados de corrección alternativos para las recomendaciones y los recursos afectados. Use los métodos markPlanned, acceptRisk y applyAlternateMitigationen el recurso recommendation y los métodos correspondientes en el recurso impactedResource .
• Se agregó el needsMoreAction miembro a la enumeración recommendationStatus y el critical miembro a la enumeración recommendationPriority .
• Se han agregado el recurso nistClassification y la propiedad nistClassifications al recurso recommendationBase para asignar recomendaciones a las funciones y categorías de NIST Cybersecurity Framework 2.0.
• Se agregaron la propiedad categoryGroup (y la nueva enumeración recommendationCategoryGroup ), completedBySystemDateTime, completedByUserDateTime, failedReviewDateTime, needsMoreActionResourceCount, remediatedDateTime y statusModifiedDateTime al recurso recommendationBase . Se agregó el microsoftEntraSuite miembro a la enumeración requiredLicenses y la propiedad lastRefreshedDateTime al recurso recommendationConfiguration .

People and workplace intelligence | Análisis

Se ha agregado la propiedad sensitivityLabel al tipo de recurso searchHit para proporcionar información de etiquetas de confidencialidad para el recurso de resultados de búsqueda.

Seguridad | Consulta de registro de auditoría

• Se han agregado las propiedades isRecordCountLimitExceeded, recordCountLimit y approximateReturnedRecordCount al recurso auditLogQuery . Use estas propiedades para determinar si una consulta completada ha superado el límite de registro por búsqueda e inspeccionar el límite aplicable y el recuento aproximado de registros devueltos.

Seguridad | Seguridad y cumplimiento de datos

Se agregó el contentFiltering miembro a la enumeración userActivityTypes usado por los ámbitos de protección de proceso para un usuario y los ámbitos de protección de proceso para las API de inquilino , lo que permite a las aplicaciones determinar si las directivas de prevención de pérdida de datos rigen el filtrado de contenido antes de evaluar el contenido.

Se ha agregado la propiedad policyConfiguration al tipo de recurso policyScopeBase . Los planes de cumplimiento pueden usar la configuración efectiva de seguridad predeterminada devuelta por las API de ámbito de protección para determinar si se auditará o bloqueará contenido cuando no se pueda completar la evaluación de directivas.

Se ha actualizado el recurso contentActivity para admitir la creación de informes de evaluaciones de directivas seguras de forma predeterminada que no se pudieron completar. Los planes de cumplimiento pueden enviar motivos estructurados de inspección incompleta a través de la API de ingesta de actividad de contenido existente

Trabajo en equipo y comunicaciones | Mensajería

Se ha actualizado el método getAllRetainedMessages para documentar la compatibilidad con las versiones de mensajes de canal privado capturadas una vez completada la migración de almacenamiento de canal privado del inquilino.

Contribuir a Microsoft Graph

¿Hay algún escenario para el que le gustaría que Microsoft Graph ofreciese soporte?

• Sugiera y vote nuevas características mediante el Portal de comentarios de Microsoft Graph. Algunas de las nuevas características se originan como solicitudes populares de la comunidad de desarrolladores. El equipo de Microsoft Graph evalúa periódicamente las necesidades de los clientes y publica nuevas características para los puntos de conexión beta (https://graph.microsoft.com/beta) y v1.0 (https://graph.microsoft.com/v1.0).

• Únase a la llamada semanal de la comunidad de la plataforma de Microsoft 365 y conviértase en un miembro activo de la comunidad de Microsoft Graph. Para descubrir el calendario completo de llamadas para desarrolladores, visite la página de la comunidad de Microsoft 365 y Power Platform.

• Únase a nuestro panel de investigación para dar su opinión sobre nuestras experiencias para desarrolladores.

Contenido relacionado

• Blog para desarrolladores de Microsoft Graph.
• Registro de cambios de la Microsoft Graph API.
• Novedades de Microsoft Graph