Novedades de Microsoft Graph

Microsoft Graph proporciona un modelo de programación unificado que puede usar para acceder a los datos de 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 de nivel de API, consulte el registro de cambios 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.

Mayo de 2026: nuevo y disponible con carácter general

Agents

• Se ha agregado el tipo de recurso agentUser y los métodos relacionados para administrar el ciclo de vida de las identidades de usuario del agente.
• Se han agregado recursos verifiedIdProfile y configuración de perfil relacionada para configurar Id. verificada por Microsoft Entra.

Identidad y acceso | Administración del directorio

Use el tipo de recurso deviceRegistrationPolicy y sus métodos relacionados para administrar la directiva que controla las restricciones de cuota de registro de dispositivos, la autenticación adicional y las directivas de autorización para el inquilino de Microsoft Entra.

Identidad y acceso | Identidad e inicio de sesión

• Se agregaron los tipos de recursos onVerifiedIdClaimValidationCustomExtension y onVerifiedIdClaimValidationListener y los métodos asociados para admitir la lógica personalizada para la validación de notificaciones de presentaciones de credenciales de Id. verificada durante los flujos de autenticación a través de Microsoft Entra extensiones de autenticación personalizadas en Id. externa.
• Se han agregado funcionalidades de validación de notificaciones y confianza de coincidencia a los perfiles de Id. verificada, lo que permite una comprobación de notificaciones más segura y una coincidencia más flexible.

Mayo de 2026: novedad solo en versión preliminar

Identidad y acceso | Identidad e inicio de sesión

• Se agregaron los tipos de recursos onVerifiedIdClaimValidationCustomExtension y onVerifiedIdClaimValidationListener y los métodos asociados para admitir la lógica personalizada para la validación de notificaciones de presentaciones de credenciales de Id. verificada durante los flujos de autenticación a través de Microsoft Entra extensiones de autenticación personalizadas en Id. externa.
• Se ha agregado compatibilidad con las funcionalidades de directiva de acceso entre inquilinos de Microsoft 365 que permiten a los administradores controlar el acceso a los recursos y datos de Microsoft 365 al colaborar con organizaciones externas. Use los recursos crossTenantAccessPolicyConfigurationDefault y crossTenantAccessPolicyConfigurationPartner con la nueva relación m365Capabilities para administrar funcionalidades como el uso compartido de perfiles, el uso compartido de calendarios, la migración, sugerencias de correo y Places reserva a través de los límites de la organización.

Abril de 2026: nuevo y disponible con carácter general

Aplicaciones

• Se agregó el tipo de recurso approvedClientApp para administrar aplicaciones cliente aprobadas para el acceso a Escritorio remoto.
• Se agregó la propiedad managerApplications a los recursos de aplicación y agentIdentityBlueprint para permitir que las aplicaciones de primera persona de Microsoft se designan como administradores de planos técnicos de agente.

Almacenamiento de copia de seguridad

• Cuando se desactiva una directiva de protección, la actividad de copia de seguridad se detiene inmediatamente, no se realizan copias de seguridad nuevas y los recursos protegidos ya no están cubiertos por la directiva. Las copias de seguridad realizadas antes de la desactivación se conservan de acuerdo con la directiva de retención, después de lo cual se retiran. Puede restaurar datos mediante puntos de restauración anteriores incluso después de la desactivación.
• Una directiva de protección solo se puede eliminar después de desactivarla. Al eliminar una directiva, se quitan todas las unidades de protección asociadas y la protección de copia de seguridad se detiene para los recursos cubiertos anteriormente por la directiva. Los datos de copia de seguridad existentes se conservan según la directiva de retención antes de que se desconecten. Puede restaurar datos mediante puntos de restauración anteriores incluso después de la eliminación.

Archivos

• Use los parámetros de alto y ancho para descargar un archivo en otro formato cuando format=jpg.
• Use la API List activities para recuperar las actividades recientes que tuvieron lugar en una unidad, lista, elemento o dentro de una jerarquía de elementos.
• Se ha agregado compatibilidad con sharePointGroup y sus miembros en un contenedor de SharePoint Embedded, lo que permite que las aplicaciones funcionen con grupos de permisos de SharePoint y administren sus miembros.

Identidad y acceso | Gobernanza

Use approverRemove como nuevo valor admitido para la propiedad requestType del recurso accessPackageAssignmentRequest . Para obtener más información, vea accessPackageAssignmentRequest.

Identidad y acceso | Identidad e inicio de sesión

• Use riskRemediation como parte de los controles de concesión de acceso condicional para aplicar una directiva de acceso condicional de riesgo de usuario. Al seleccionar "Requerir corrección de riesgos" en los controles de concesión de la directiva, Protección de Microsoft Entra ID administra el flujo de corrección adecuado en función de la amenaza observada y del método de autenticación del usuario. En las sesiones de usuario de riesgo sin contraseña, actualiza los detalles de riesgo con microsoftRevokedSessions.

Trabajo en equipo y comunicaciones | Aplicaciones

Administre las aplicaciones de Teams en el nivel de canal dentro de un equipo mediante las siguientes API:

• Enumera las aplicaciones de un canal.
• Obtener una aplicación en un canal.
• Habilite una nueva aplicación de Teams en un canal.
• Deshabilite una aplicación en un canal.

Trabajo en equipo y comunicaciones | Mensajería

• Se han quitado los parámetros y la model guía del modelo de pago de las API de exportación de Microsoft Teams y la documentación relacionada con la notificación de cambios. El model parámetro de consulta ya no es necesario y se omite si se proporciona. Para obtener más información, consulte Modelos de pago y requisitos de licencia para las API de Microsoft Teams.
• Las siguientes API de Microsoft Teams admiten la paginación @odata.nextLink para controlar el aumento de los límites de canal. Cuando el conjunto de resultados abarca varias páginas, la respuesta incluye la propiedad @odata.nextLink con una dirección URL para recuperar la siguiente página de resultados:
  • Enumerar canales
  • Lista de incomingChannels
  • Enumerar allChannels

Abril de 2026: novedad solo en versión preliminar

Agents

Se han agregado avisos de desuso a los recursos agentRegistry, agentCardManifest, agentCollection y agentInstance y sus operaciones relacionadas. Estas API del Registro del Agente se reemplazarán por api basadas en Agent 365 a partir del 1 de mayo de 2026.

Aplicaciones

Se agregó la propiedad deprecationDate al recurso applicationTemplate para indicar cuándo se quitará una aplicación de la galería de aplicaciones de Microsoft Entra.

Almacenamiento de copia de seguridad

• Cuando se desactiva una directiva de protección, la actividad de copia de seguridad se detiene inmediatamente, no se realizan copias de seguridad nuevas y los recursos protegidos ya no están cubiertos por la directiva. Las copias de seguridad realizadas antes de la desactivación se conservan de acuerdo con la directiva de retención, después de lo cual se retiran. Puede restaurar datos mediante puntos de restauración anteriores incluso después de la desactivación.
• Una directiva de protección solo se puede eliminar después de desactivarla. Al eliminar una directiva, se quitan todas las unidades de protección asociadas y la protección de copia de seguridad se detiene para los recursos cubiertos anteriormente por la directiva. Los datos de copia de seguridad existentes se conservan según la directiva de retención antes de que se desconecten. Puede restaurar datos mediante puntos de restauración anteriores incluso después de la eliminación.
• Use la propiedad billingPolicyId en protectionUnitBase, driveProtectionUnit, mailboxProtectionUnit y siteProtectionUnit para obtener o establecer el identificador único de la directiva de facturación asignada a la unidad de protección para la asignación de costos.
• Actualice la propiedad billingPolicyId en un objeto driveProtectionUnit .
• Actualice la propiedad billingPolicyId en un objeto mailboxProtectionUnit .
• Actualice la propiedad billingPolicyId en un objeto siteProtectionUnit .

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

• Los /me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo puntos de conexión y /users/{userId}/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo están en desuso y dejarán de devolver datos el 30 de octubre de 2026. En el futuro, use la API retrieveCloudPcLaunchDetail .
• Se agregó el tipo de recurso cloudPcOnPremisesConnectionSubnetIpDetail para representar los detalles de la dirección IP de subred de una conexión local del equipo en la nube.
• Use la propiedad subnetPrivateIpDetail en cloudPcOnPremisesConnection para obtener información detallada sobre las direcciones IP privadas de la subred asociadas a la subred.

Archivos

• Use los parámetros de consulta de alto y ancho en la API de conversión de contenido driveItem para descargar un archivo en otro formato cuando format=jpg.
• Use la propiedad itemCount en el recurso de lista para acceder rápidamente al número total de elementos de una lista de SharePoint sin recuperar todos los elementos ni realizar consultas adicionales.

Identidad y acceso | Administración del directorio

Se agregaron las relaciones inheritedAppRoleAssignments y inheritedOauth2PermissionGrants al recurso agentIdentity para recuperar los permisos heredados de la entidad de servicio principal de Agent Identity Blueprint.

Identidad y acceso | Gobernanza

• Use default, notVisibley visible como valores admitidos para la propiedad approverInformationVisibility de los recursos accessPackageApprovalStage y approvalStage para indicar si la información del aprobador es visible para el solicitante.
• Se agregó el método cancelProcessing al recurso de flujo de trabajo para cancelar las ejecuciones de flujo de trabajo que están actualmente en curso o en cola.
• Se han agregado la propiedad referenceId y la relación de archivos al recurso customDataProvidedResourceUploadSession para identificar el contexto para el que se cargan los datos, como un identificador de instancia de revisión de acceso, e identificar los archivos cargados durante una sesión de carga, respectivamente. También se ha agregado compatibilidad mejorada con las funcionalidades de consulta para la operación de API List customDataProvidedResourceUploadSession objects .

Identidad y acceso | Identidad e inicio de sesión

Se agregaron las propiedades blueprintId y descriptiva del agente de origen a los recursos agentRiskDetection y riskyAgent .

Correo

Se introdujo la nueva API de notas que permite a los usuarios crear y administrar notas simples en su carpeta Notas . Las notas admiten contenido de texto con datos adjuntos opcionales de imágenes insertadas y son adecuadas para escenarios de captura rápida. Use el recurso de nota y las siguientes API:

• Enumera las notas de la carpeta Notes del usuario.
• Cree una nota en la carpeta Notes del usuario.
• Consigue una nota.
• Actualice una nota.
• Elimine una nota.
• Obtenga delta para realizar un seguimiento de los cambios en las notas.
• Enumera los datos adjuntos de una nota.
• Cree datos adjuntos en una nota.
• Eliminar datos adjuntos de una nota.

Importación y exportación de buzones de correo

Obtenga información sobre cómo controlar los redireccionamientos HTTP al acceder a carpetas y elementos de buzones de archivo con carpetas autoexpandidas mediante las API de importación y exportación de buzones. Para obtener más información, consulte Control de redireccionamientos de buzones de archivo.

Inteligencia de personas y lugar de trabajo | Perfil

Use las propiedades activities, awards y fieldsOfStudy en educationalActivityDetail para obtener o establecer colecciones de actividades, premios o campos de estudio.

Informes: informes de identidad y acceso

Se ha agregado el recurso azureADPremiumLicenseInsight y sus API asociadas para obtener información sobre el uso de licencias premium de Microsoft Entra ID P1 y P2 para el inquilino, incluidos los desgloses de uso de características para las características P1, P2, Internet Access y Private Access.

Seguridad | Cumplimiento

Se han actualizado las funcionalidades del tipo de recurso auditLogQuery y sus métodos asociados de la siguiente manera:

• Se ha actualizado la enumeración auditLogRecordType para representar más de 400 tipos de operaciones de registro de auditoría en los servicios en la nube de Microsoft.
• Se agregaron 135 nuevos tipos derivados del recurso auditData para representar datos de registro de auditoría para servicios y características específicos, incluidas las interacciones de IA y Copilot, la administración de agentes, el cumplimiento y la administración del ciclo de vida de los datos (Microsoft Purview, eDiscovery, DLP), servicios en la nube (Azure Firewall, Microsoft Defender, Sentinel) y servicios de colaboración (Teams, Planner, SharePoint, Viva). Para obtener una lista completa de los tipos de datos de auditoría, consulte tipos derivados auditData.

Seguridad | Microsoft Defender for Identity

Use la propiedad sensorTypes en sensorCandidate para obtener la lista de tipos de dispositivo para el sensor.

Trabajo en equipo y comunicaciones | Mensajería

• Use las API de mensajes de destino para administrar mensajes en Microsoft Teams que solo sean visibles para los destinatarios especificados dentro de los chats o canales de grupo:
  • Use el tipo de recurso targetedChatMessage para representar un mensaje de destino en un chat o canal.
  • Obtenga todos los mensajes dirigidos enviados a un usuario en chats y canales de grupo con fines de cumplimiento y archivado.
  • Obtenga todos los mensajes de destino retenidos para un usuario, incluidos los mensajes eliminados por el remitente pero conservados debido a las directivas de retención de la organización.
  • Elimine un mensaje de destino de un canal proporcionando el identificador de equipo, el identificador de canal y el identificador de mensaje.
  • Elimine un mensaje de destino de un chat proporcionando el identificador de chat y el identificador del mensaje.
• Organice chats, canales y reuniones en secciones personalizadas de la lista de chats de Microsoft Teams de un usuario mediante los nuevos recursos teamworkSection y teamworkSectionItem . Use las API de administración de secciones para enumerar, crear, obtener, actualizar y eliminar secciones, y agregar, quitar y mover elementos dentro de las secciones.

Contribución a Microsoft Graph

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

• Sugiera y vote por 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 en 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 Microsoft 365 y conviértase en 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 proporcionar su opinión sobre nuestras experiencias para desarrolladores.

Contenido relacionado

• Blog para desarrolladores de Microsoft Graph.
• Microsoft Graph API registro de cambios.
• Historial de novedades de Microsoft Graph.