Compartir a través de

Novedades de Microsoft Graph

  • Artículo

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.

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 de disponibilidad general (GA). No use características en versión preliminar en aplicaciones de producción.

Enero de 2025: nuevo y disponible con carácter general

Archivos

Se ha actualizado el punto de conexión del método fileStorageContainer: restore .

Identidad y acceso | Identidad e inicio de sesión

Se agregó la entrada riskEventType para la detección de tráfico de API sospechosa para las entidades de servicio.

Trabajo en equipo y comunicaciones | Llamadas y reuniones en línea

  • Las plantillas de reunión personalizadas de Microsoft Teams permiten especificar valores para muchas de las opciones de reunión disponibles para los organizadores de reuniones. Use la propiedad meetingTemplateId en onlineMeeting para crear una reunión en línea con una plantilla de reunión.
  • Use allowBreakoutRooms, allowLiveShare, allowPowerPointSharing y allowWhiteboard para indicar si las salas de interrupción, el recurso compartido en vivo, powerPoint en directo y las características de pizarra están habilitadas en una instancia de onlineMeeting o virtualEventSession.
  • Use la propiedad allowedLobbyAdmitters en onlineMeeting para obtener o establecer los usuarios que pueden admitir desde el vestíbulo.

Trabajo en equipo y comunicaciones | Mensajería

  • Obtenga un mensaje de chat con un @mention para todos.
  • Obtenga un mensaje de chat que tenga un mensaje reenviado como datos adjuntos.

Enero de 2025: novedad solo en versión preliminar

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

Archivos

Se ha actualizado el punto de conexión del método fileStorageContainer: restore .

Identidad y acceso | Administración del directorio

  • Use la propiedad alternativeNames en el dispositivo para obtener o establecer nombres alternativos para un dispositivo.
  • Use el recurso deviceTemplate y sus métodos asociados para administrar plantillas de dispositivo para dispositivos en Microsoft Entra ID.
  • Use el recurso mutualTlsOauthConfiguration y sus métodos asociados para administrar las entidades de certificación que pueden emitir certificados para un conjunto específico de objetos utilizados para mTLS.

Identidad y acceso | Identidad e inicio de sesión

Se ha agregado compatibilidad para configurar un proveedor de correo electrónico personalizado para códigos de acceso únicos (OTP) en Id. externa de Microsoft Entra mediante los siguientes objetos:

  • Tipo de recurso onOtpSendCustomExtension para configurar la extensión de autenticación personalizada que contiene los detalles de configuración del servicio externo que podría ser una función de Azure.
  • Tipo de recurso onEmailOtpSendListener para configurar el agente de escucha de eventos que se desencadena para enviar el símbolo del sistema OTP al usuario, en función de los detalles de configuración del objeto onOtpSendCustomExtension .

La funcionalidad también permite configurar la opción de reserva predeterminada cuando la extensión de autenticación personalizada no se llama correctamente.

ETL de datos del sector

Use la operación de inicio en el recurso industryDataRun para realizar una ejecución a petición, con límites de limitación de hasta cinco ejecuciones correctas cada 12 horas.

Importación y exportación de buzones de correo

Use las nuevas API de importación y exportación de buzones de correo en Microsoft Graph para crear soluciones que se integren con recursos de buzón para escenarios de importación y exportación de datos. Para obtener más información, vea Información general sobre las API de importación y exportación de buzones de correo en Microsoft Graph.

Tareas y planes

Use el tipo de contenedor teamsChannel para crear planes en canales compartidos en Microsoft Teams.

Diciembre de 2024: nuevo y disponible con carácter general

Informes

Los registros de actividad de Microsoft Graph, que proporcionan un seguimiento de auditoría de todas las solicitudes HTTP que Microsoft Graph recibió y procesó para su inquilino, ahora están disponibles en China operado por 21Vianet.

Seguridad | Alertas e incidentes

Ha habilitado las propiedades description, displayName, resolvingComment y severity como propiedades admitidas en una solicitud de incidente update .

Trabajo en equipo y comunicaciones | Llamadas y reuniones en línea

  • Use los métodos nuevos siguientes para los eventos virtuales que son del tipo virtualEventTownhall :
    • Enumere todos los ayuntamientos de eventos virtuales creados en un inquilino.
    • Obtenga los ayuntamientos de eventos virtuales donde un usuario especificado es organizador o coorganizador.
    • Obtenga los ayuntamientos de eventos virtuales donde el usuario que ha iniciado sesión es organizador o coorganizador.
  • Vincule la información de eventos externos a virtualEventTownhall o virtualEventWebinar estableciendo un externalEventId.
  • Use externalEventInformation en virtualEventTownhall y virtualEventWebinar para identificar la información de eventos externos de un evento virtual.
  • Use la propiedad externalRegistrationInformation en virtualEventRegistration para obtener o establecer la información externa de un registro de eventos virtuales.

Trabajo en equipo y comunicaciones | Administración de turnos

Usuarios

Se publicaron los siguientes permisos con menos privilegios para administrar escenarios específicos en el objeto de usuario :

Permiso Comentarios
User-Mail.ReadWrite.All Permiso con privilegios mínimos para actualizar la propiedad otherMails .
User-PasswordProfile.ReadWrite.All Permiso con privilegios mínimos para leer y escribir propiedades relacionadas con el restablecimiento de contraseña.
User-Phone.ReadWrite.All Permiso con privilegios mínimos para actualizar las propiedades businessPhones y mobilePhone . Anteriormente, solo se admitía el permiso Directory.AccessAsUser.All para actualizar las propiedades del usuario administrador. En su lugar, se recomienda mover el permiso con menos privilegios.
User.EnableDisableAccount.All Permiso con privilegios mínimos para actualizar la propiedad accountEnabled . También requiere el permiso User.Read.All. Anteriormente, solo se admitía el permiso Directory.AccessAsUser.All para actualizar el estado de la cuenta para los usuarios administradores. En su lugar, se recomienda mover el permiso con menos privilegios.
User.DeleteRestore.All Permiso con privilegios mínimos para eliminar un usuario, restaurar un usuario eliminado de la papelera de reciclaje o eliminar permanentemente un usuario eliminado de la papelera de reciclaje. También permite recuperar usuarios eliminados a través del punto de /directory/deleteditems/microsoft.graph.user conexión.

Diciembre de 2024: novedad solo en versión preliminar

Almacenamiento de copia de seguridad

Use la nueva API de solicitud de adición masiva de restauración para soluciones de restauración más cómodas, eficientes y escalables. Esta API está diseñada para simplificar el proceso de restauración al permitir el envío directo de recursos de restauración en una solicitud masiva. Se admiten los siguientes recursos:

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

Identidad y acceso | Administración del directorio

Al restaurar usuarios eliminados temporalmente, ahora puede especificar si Microsoft Entra ID debe reemplazar userPrincipalName del usuario por un nuevo valor.

Identidad y acceso | Identidad e inicio de sesión

Informes | Informes de supervisión de Microsoft 365

Las API de supervisión de Microsoft 365 proporcionan datos de telemetría para supervisar el estado de varios servicios de Microsoft dentro de una suscripción de Microsoft 365 para su organización. Use las nuevas operaciones en el recurso serviceActivity para obtener datos de telemetría para Exchange Online, Aplicaciones Microsoft 365 y Microsoft Teams.

Seguridad | Alertas e incidentes

Se habilitaron las propiedades description, displayName y severity como propiedades admitidas en una solicitud de incidente update .

Listas y sitios

Trabajo en equipo y comunicaciones | Llamadas y reuniones en línea

Las operaciones get y list de los recursos callRecording y callTranscript admiten la recuperación de grabaciones de llamadas o transcripciones de llamadas de reuniones de chat privadas y reuniones de canal.

Trabajo en equipo y comunicaciones | Mensajería

Use la propiedad firstChannelName del equipo para establecer el nombre del primer canal creado en un equipo.

Noviembre de 2024: nuevo y disponible con carácter general

Archivos

Use una serie de nuevos métodos y recursos para mejorar la administración del almacenamiento de archivos, incluidos los métodos para administrar columnas y elementos de papelera de reciclaje. También puede ejecutar operaciones como restaurar, bloquear, desbloquear y mucho más en los recursos fileStorageContainer, fileStorage y recycleBin .

Aplicaciones | Políticas

Use la propiedad state en keyCredentialConfiguration y passwordCredentialConfiguration para indicar si se evalúa una restricción.

Seguridad | Alertas e incidentes

Habilitados los activeestados , pendingApproval, declined, unremediated, runningy partiallyRemediated en la enumeración evidenceRemediationStatus . Use estos nuevos estados a través de la propiedad remediationStatus de alertEvidence y sus tipos heredados.

Seguridad | Identidades

La API de administración de sensores de Defender for Identity permite crear informes detallados sobre los sensores del área de trabajo, lo que proporciona información como el nombre del servidor, la versión del sensor, el tipo, el estado y el estado de mantenimiento. También permite administrar la configuración del sensor, incluida la adición de descripciones, la habilitación o deshabilitación de actualizaciones retrasadas y la especificación del controlador de dominio al que se conecta el sensor para consultar el id. de entra. Para obtener más información, consulte sensor.

Trabajo en equipo y comunicaciones | Llamadas y reuniones en línea

Use la propiedad administrativeUnitInfos en el participante y el organizador para obtener los identificadores de una o varias unidades administrativas para un participante de llamada.

Noviembre de 2024: novedad solo en versión preliminar

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

  • Se han agregado nuevos puntos de conexión que admiten permisos de aplicación en los métodos siguientes del recurso cloudPC :
  • Use la propiedad reservePercentage en el método [cloudPcProvisioningPolicy: apply] para especificar el porcentaje de equipos en la nube que se mantendrán disponibles para escenarios compartidos de primera línea.
  • Use el método getCloudPCPerformanceReport para obtener informes relacionados con el rendimiento de los equipos en la nube.
  • Use el parámetro reportName con el método getInaccessibleCloudPcReports para especificar el tipo de informe pc en la nube.
  • Se habilitaron las performanceTrendReport opciones y inaccessibleCloudPcTrendReport del parámetro reportName en el método Create cloudPcExportJob .

Administración de dispositivos y aplicaciones | Actualizaciones de dispositivos

Archivos

Bloquee o desbloquee un archivoStorageContainer.

Identidad y acceso | Identidad e inicio de sesión

Identidad y acceso | Acceso a la red

Enumerar, crear, obtener, actualizar y eliminar recursos fqdnFilteringRule y webCategoryFilteringRule que son tipos derivados de filteringRule.

Informes: informes de identidad y acceso

Use la propiedad sessionId en signIn para obtener el identificador de la sesión que se generó durante un inicio de sesión.

Seguridad | Aplicaciones en la nube detectadas

La nueva API de aplicaciones de Microsoft Defender for Cloud en Microsoft Graph está diseñada para proporcionar una manera eficaz y confiable de consultar la información de las aplicaciones detectadas, lo que facilita el análisis de los riesgos asociados a las aplicaciones detectadas. Use los siguientes recursos y sus métodos para obtener datos e información sobre el ecosistema de aplicaciones SaaS detectado:

Seguridad | eDiscovery

Se ha agregado la autenticación de aplicaciones para Microsoft Purview eDiscovery Graph API. Para obtener más información sobre cómo configurar el acceso solo a la aplicación, consulte Configuración de la autenticación de aplicaciones.

Trabajo en equipo y comunicaciones | Interacciones de IA

Use el método getAllEnterpriseInteractions para obtener datos de interacción de Microsoft 365 Copilot, incluidas las indicaciones del usuario para las respuestas de Copilot y Copilot.

Trabajo en equipo y comunicaciones | Llamadas y reuniones en línea

  • Vincule la información de eventos externos a virtualEventTownhall o virtualEventWebinar estableciendo un externalEventId.
  • Use externalEventInformation en virtualEventTownhall y virtualEventWebinar para identificar la información de eventos externos de un evento virtual.
  • Use la propiedad allowedLobbyAdmitters en onlineMeeting para obtener o establecer los usuarios que pueden admitir desde el vestíbulo.
  • Use la propiedad allowedLobbyAdmitters en onlineMeeting para obtener o establecer los usuarios que pueden admitir desde el vestíbulo.
  • Obtenga o establezca si los usuarios de Microsoft 365 Copilot en Teams Meetings pueden recibir respuestas a mensajes relacionados con sentimientos.

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