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.

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

Archivos

Use las siguientes API de columnas de contenedor nuevas agregadas para admitir aún más el almacenamiento estructurado de archivos en aplicaciones de SharePoint Embedded:

• Obtener columna
• Actualizar columna
• Eliminar columna

Identidad y acceso | Gobernanza

• Se agregó el allDirectoryAgentIdentities miembro a la enumeración allowedTargetScope para permitir que los paquetes de acceso tengan como destino todas las identidades del agente de directorio.
• Se agregó el tipo de recurso targetAgentIdentitySponsorsOrOwners que define los patrocinadores o propietarios de una identidad de agente específica.

Marzo de 2026: novedad solo en versión preliminar

Almacenamiento de copia de seguridad

Se agregó el includeNewerItems miembro como valor admitido para la propiedad tags en restorePoint para obtener un punto de restauración dentro de un período de tiempo especificado que incluya los elementos más recientes creados durante ese período.

Identidad y acceso | Gobernanza

Se agregó el tipo de recurso targetAgentIdentitySponsorsOrOwners que define los patrocinadores o propietarios de una identidad de agente específica.

Identidad y acceso | Acceso a la red

• Se agregaron las propiedades homeTenantId, crossTenantAccessType y deviceJoinType al recurso de conexión para admitir escenarios de colaboración Bring Your Own Device (BYOD) y Business-to-Business (B2B) en los registros de conexión de tráfico de Acceso seguro global.
• Se agregó el tipo de enumeración crossTenantAccessType .
• Se agregó el tipo de enumeración deviceJoinType .

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

Conexiones a datos externos

Se agregaron etiquetas semánticas de dominio de 19 personas a la enumeración de etiquetas para conectores de Microsoft 365 Copilot. Estas etiquetas permiten a los desarrolladores asignar datos de perfil de personas de sistemas externos a propiedades estandarizadas de Microsoft Graph. Use estas etiquetas en definiciones de esquema para mejorar la detectabilidad y la integración de datos de personas en Microsoft 365 Copilot experiencias. Las nuevas etiquetas incluyen: personEmails, personAddresses, , personAnniversaries, personNotepersonName, personPhones, personCurrentPosition, , personWebAccounts, personWebSite, personSkills, personProjects, personAccount, personAwards, personCertifications, personAssistants, , personColleagues, personManager, personAlternateContactsy personEmergencyContacts.

Archivos

Se ha actualizado el requisito de consentimiento del administrador para los siguientes permisos delegados relacionados con la administración de contenedores de almacenamiento de archivos de SharePoint Embedded:

• El FileStorageContainerType.Manage.All permiso delegado ya no requiere el consentimiento del administrador.
• El FileStorageContainerTypeReg.Manage.All permiso delegado ya no requiere el consentimiento del administrador.

Grupos

• Se agregaron las propiedades resourceBehaviorOptions y resourceProvisioningOptions al recurso de grupo . Estas propiedades permiten especificar comportamientos de grupo y recursos asociados para un grupo de Microsoft 365.
• Se ha agregado un problema conocido: en el caso de los grupos de seguridad eliminados temporalmente, la propiedad securityEnabled devuelve false en lugar de true. Para identificar el tipo de grupo, use la propiedad groupTypes , donde ["Unified"] indica un grupo de Microsoft 365 y una matriz vacía ([]) indica un grupo de seguridad. Para obtener más información, vea Obtener elementos eliminados y Enumerar elementos eliminados.

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

• Se ha agregado configureAgent como una nueva acción para cloudpcexternalpartner.

• Se ha agregado deployAgent como una nueva acción para cloudpcexternalpartner.

• Se ha agregado retrieveDeployAgentActionResults como una nueva acción para cloudpcexternalpartner.

• Se ha agregado retrieveActionReports como una nueva acción para cloudpcexternalpartner.

• Se ha agregado cloudPcExternalPartnerAgentSetting como un nuevo tipo complejo para cloudpcexternalpartner.

• Se ha agregado cloudPcExternalPartnerActionResult como un nuevo tipo complejo para cloudpcexternalpartner.

• Se ha agregado cloudPcExternalPartnerActionReport como un nuevo tipo complejo para cloudpcexternalpartner.

Identidad y acceso | Identidad e inicio de sesión

• El método de autenticación de código QR en Microsoft Entra ID permite administrar el método de autenticación de código QR para los usuarios y cómo pueden iniciar sesión con un código QR y un PIN. Los siguientes recursos clave admiten esta funcionalidad:
  • El recurso qrCodePinAuthenticationMethod y las API relacionadas para administrar métodos de autenticación de PIN de código QR para los usuarios. Este método de autenticación de un solo factor está diseñado para trabajadores de primera línea y combina un código QR con un PIN. También se agregaron los siguientes recursos relacionados: qrCode, qrPin y qrCodeImageDetails.
  • El recurso qrCodePinAuthenticationMethodConfiguration para administrar la directiva de método de autenticación de código QR para un inquilino.
  • Se han actualizado las enumeraciones authenticationMethodModes y baseAuthenticationMethod para agregar el qrCodePin miembro para admitir este nuevo método de autenticación.

Correo | Seguimiento de mensajes

Use la API de seguimiento de mensajes para realizar un seguimiento del flujo de mensajes de correo electrónico a través de la organización Exchange Online. Para obtener más información, vea exchangeMessageTrace.

Búsqueda

• Se agregaron los tipos de datos principal y principalCollection a externalConnection para especificar el tipo de datos de los elementos de propiedad relacionados con personas en la conexión externa.
• Se agregó la propiedad description a las propiedades externalConnection para permitir la adición de una descripción a las propiedades del esquema en la conexión externa.
• Se agregaron más etiquetas o etiquetas semánticas que se pueden agregar a las etiquetas de la propiedad externalConnection en el esquema de conexión externa. Las etiquetas ayudan a Microsoft 365 Copilot comprender la semántica de los datos en la conexión y proporcionan resultados más relevantes.
• Se agregó la propiedad contentCategory a externalConnection para especificar la categoría de dominio del contenido asociado a la conexión externa para mejorar la relevancia y la clasificación.

Seguridad | Seguridad y cumplimiento de datos

• Se agregó el labelNotFoundException miembro al tipo de enumeración usageRights . Este miembro representa una etiqueta sin configuración de protección, por lo que no hay derechos de uso que evaluar en Microsoft Purview.
• Se agregó el restrictWebGrounding miembro a la enumeración dlpAction para admitir la restricción de acciones de conexión a tierra web en las directivas de prevención de pérdida de datos en Microsoft Purview.

Seguridad | Protección contra amenazas

Se ha actualizado el requisito de consentimiento del administrador para los siguientes permisos delegados relacionados con envíos de amenazas:

• El ThreatSubmission.Read permiso delegado ahora requiere el consentimiento del administrador.
• El ThreatSubmission.ReadWrite permiso delegado ahora requiere el consentimiento del administrador.

Trabajo en equipo y comunicaciones | Administración

• Obtenga el identificador de directiva de un nombre de directiva y un tipo de directiva determinados dentro de la administración de Teams.
• Asigne una directiva de Teams a un usuario mediante el identificador de usuario, el tipo de directiva y el identificador de directiva.
• Quite la asignación de una directiva de Teams de un usuario mediante el identificador de usuario y el tipo de directiva.
• Asigne un número de teléfono de Teams a una cuenta de usuario.
• Anula la asignación de un número de teléfono de Teams de una cuenta de usuario.
• Obtenga los detalles de la asignación de un solo número de telehone.
• Actualice un número de teléfono de Teams existente con atributos opcionales.
• Compruebe el estado de la operación de asignación o anulación de la asignación del número de teléfono para una cuenta de usuario.
• Obtenga una lista de números de teléfono de Teams asignados a una cuenta de usuario.

Febrero de 2026: nuevo solo en versión preliminar

Aplicaciones

Use la propiedad requiredResourceAccess en agentIdentityBlueprint para especificar los permisos de Microsoft Graph (ámbitos delegados y roles de aplicación) requeridos por el agente.

Almacenamiento de copia de seguridad

Los usuarios ahora pueden examinar un fastRestore punto de conexión y restaurar archivos y carpetas de forma selectiva mediante la creación de una sesión de exploración.

El proceso de restauración pormenorizada está diseñado para ser sencillo y eficaz y consta de tres pasos principales:

• Creación de una sesión de exploración
  Inicie una sesión de exploración para un punto de restauración específico (instantánea de copia de seguridad).

  • Puede crear una sesión de exploración de SharePoint o una sesión de exploración de OneDrive para la Empresa.

• Examinar elementos
  Una vez creada la sesión, el usuario puede consultarla para enumerar todos los elementos de copia de seguridad disponibles en la sesión de exploración.

  • Los resultados se devuelven como una colección de objetos browseQueryResponseItem , cada uno de los cuales representa un archivo, una carpeta u otro recurso.
  • Puede examinar elementos dentro de una sesión de exploración de SharePoint o una sesión de exploración de OneDrive para la Empresa.

• Creación de una sesión de restauración
  Seleccione uno o varios elementos de la sesión de exploración e inicie una sesión de restauración.

  • Solo los elementos seleccionados se restauran a su estado anterior, dejando el resto del sitio o unidad sin cambios.
  • Puede crear una sesión de restauración granular de SharePoint o una sesión de restauración pormenorizada OneDrive para la Empresa.

Se ha agregado compatibilidad con el estado de retirada de la directiva de protección y el seguimiento de marca de tiempo en el almacenamiento de copia de seguridad:

• Se agregó la propiedad offboardRequestedDateTime al recurso protectionPolicyBase .
• Se agregaron los offboardRequested valores y offboarded a la enumeración protectionPolicyStatus .

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

Use las nuevas API de licencias en la nube para administrar los datos de licencias de inquilino, usuario y grupo para los servicios de Microsoft 365. Estas API proporcionan acceso mediante programación a asignaciones, asignaciones, errores de asignación, ciclos de vida de suscripción y miembros en espera. Para obtener más información, consulte Uso de la API de licencias en la nube en Microsoft Graph (versión preliminar).

Archivos

Se ha agregado driveItem: archive y driveItem: unarchive para permitir que las organizaciones archiven y desarchivos objetos driveItem .

Identidad y acceso | Identidad e inicio de sesión

• Se agregó la enumeración agentIdentityType para representar el tipo de identidad de agente de Microsoft Entra para la detección y administración de riesgos. Use la propiedad identityType en los recursos riskyAgent y agentRiskDetection para clasificar diferentes tipos de identidades de agente.
• Se han agregado nuevos recursos de eventos de autenticación para admitir escenarios de migración de usuarios Just-In-Time (JIT) desde sistemas de autenticación heredados:
  • Use el recurso onPasswordSubmitListener para configurar los agentes de escucha de eventos de autenticación que se desencadenan durante el envío de contraseñas.
  • Use el recurso onPasswordSubmitCustomExtension para configurar extensiones personalizadas que validen contraseñas en sistemas de autenticación heredados externos.
  • Use el recurso onPasswordSubmitHandler como tipo base para los controladores invocados durante los eventos de envío de contraseña.
  • Use el recurso onPasswordMigrationCustomExtensionHandler para configurar controladores que invocan extensiones personalizadas durante la migración JIT.

Búsqueda

Se agregaron los tipos de datos principal y principalCollection al recurso externalConnection para especificar el tipo de datos de los elementos de propiedad relacionados con personas en la conexión externa.

Seguridad | Seguridad y cumplimiento de datos

• Se agregó el labelNotFoundException miembro al tipo de enumeración usageRights . Este miembro representa una etiqueta sin configuración de protección, por lo que no hay derechos de uso que evaluar en Microsoft Purview.
• Desusada la propiedad accessedResources en processConversationMetadata en favor de la propiedad accessedResources_v2 .
• Use la propiedad accessedResources_v2 en processConversationMetadata para obtener información detallada sobre los recursos a los que se accede durante la conversación, incluidos los identificadores, el tipo de acceso y el estado.
• Use la propiedad agents en processConversationMetadata para obtener información sobre los agentes de inteligencia artificial que participaron en la preparación del mensaje.

Seguridad | protección de Email y colaboración

Mejoras en el recurso detonationDetails que representa detalles del análisis de archivos sospechosos y direcciones URL en correos electrónicos de Microsoft Defender para Office 365:

• Se han agregado las siguientes propiedades para proporcionar un análisis de amenazas más detallado:
  • detonationBehaviourDetailsV2 : muestra los eventos que tuvieron lugar durante la detonación en formato JSON
  • entityMetadata : más metadatos sobre la entidad en formato JSON
  • mitreTechniques: técnicas de ataque alineadas con el marco de MITRE ATT&CK
  • staticAnalysis : resultados del análisis estático realizado en el archivo o la dirección URL
  • submissionSource: origen del envío
• La propiedad detonationBehaviourDetails está en desuso y dejará de devolver datos en marzo de 2026. Use la propiedad detonationBehaviourDetailsV2 en su lugar.
• Se agregó el moveToQuarantine miembro a la enumeración remediationAction . Use el encabezado de Prefer: include-unknown-enum-members solicitud para acceder a este miembro de enumeración evolvable.

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.